Lamp(ID)

base classes — bpy_struct, ID

subclasses — AreaLamp, SunLamp, HemiLamp, PointLamp, SpotLamp

class bpy.types.Lamp(ID)

Lamp datablock for lighting a scene

active_texture

Active texture slot being displayed

Type :Texture

active_texture_index

Index of active texture slot

Type :int in [0, 17], default 0

animation_data

Animation data for this datablock

Type :AnimData, (readonly)

color

Light color

Type :float array of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)

cycles

Cycles lamp settings

Type :CyclesLampSettings, (readonly)

distance

Falloff distance - the light is at half the original intensity at this point

Type :float in [0, inf], default 0.0

energy

Amount of light that the lamp emits

Type :float in [-inf, inf], default 0.0

node_tree

Node tree for node based lamps

Type :NodeTree, (readonly)

texture_slots

Texture slots defining the mapping and influence of textures

Type :LampTextureSlots bpy_prop_collection of LampTextureSlot, (readonly)

type

Type of Lamp

• POINT Point, Omnidirectional point light source.
• SUN Sun, Constant direction parallel ray light source.
• SPOT Spot, Directional cone light source.
• HEMI Hemi, 180 degree constant light source.
• AREA Area, Directional area light source.

Type :enum in [‘POINT’, ‘SUN’, ‘SPOT’, ‘HEMI’, ‘AREA’], default ‘POINT’

use_diffuse

Do diffuse shading

Type :boolean, default False

use_negative

Cast negative light

Type :boolean, default False

use_nodes

Use shader nodes to render the lamp

Type :boolean, default False

use_own_layer

Illuminate objects only on the same layers the lamp is on

Type :boolean, default False

use_specular

Create specular highlights

Type :boolean, default False

Inherited Properties

bpy_struct.id_data ID.name ID.users ID.use_fake_user ID.tag

ID.is_updated ID.is_updated_data ID.is_library_indirect ID.library

Inherited Functions

bpy_struct.as_pointer bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.is_property_hidden bpy_struct.is_property_set bpy_struct.items bpy_struct.keyframe_delete bpy_struct.keyframe_insert bpy_struct.keys

bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.property_unset bpy_struct.type_recast bpy_struct.values ID.copy ID.user_clear ID.animation_data_create ID.animation_data_clear ID.update_tag

References

bpy.context.lamp BlendData.lamps

BlendDataLamps.new BlendDataLamps.remove