# Lamp(ID)

base classes — `bpy_struct`, `ID`

subclasses — `AreaLamp`, `HemiLamp`, `PointLamp`, `SpotLamp`, `SunLamp`

class `bpy.types.``Lamp`(ID)

  Lamp data-block 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 data-block

    Type: | `AnimData`, (readonly)

  `color`

    Light color

    Type: | float array of 3 items in [0, 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` `ID.preview`

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_readonly` `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`