# Spot#

(LightPhysicalSpot)

• Category: /Light/Physical/Area
• Default object name: spot

Go to Technical page.

## Description#

A physical light that is sending the same illumination in all directions from its center.

## Attributes#

Name Type Description
Translate double[3] Set the XYZ position of the item relative to its parent item.
Rotate double[3] Set the XYZ rotation of the item relative to its parent item.
Scale double[3] Set the XYZ scaling of the item relative to its parent item.
Shear double[3] Set the XYZ shear of the item relative to its parent item.
Rotation Order long Specify on which order the Euler rotations are composed. By default Clarisse's uses YXZ
Parent reference (SceneItem) Set the parent item of the item.
Inherit Transform bool Does the current object inherits its parent transformation ?
Reference Frame long Set the reference frame that defines the base transform and deformation state of the item. This reference is used when computing texture projections or when generating point cloud (in Global Base) on the base geometry.
Constraints object[] (Constraint) Stack of constraint operators. Constraints like Target, Point, Orient... are applied to a Scene Item in order to drive the transformation of the item.
Scale Pivot double[3] Set the coordinates of the scale pivot.
Rotate Pivot double[3] Set the coordinates of the rotation pivot.
Translate Offset double[3] Set the XYZ position of the pivot point of the item.
Rotate Offset double[3] Set the XYZ rotation of the pivot point of the item.
Scale Offset double[3] Set the XYZ scaling of the pivot point of the item.
Rotation Offset Order long Set the rotation axis mode.
Display Visible bool Set whether the item is shown in the 3D View or not.
Display Pickable bool Set whether the item is pickable in the 3D View or in the Image View.
Display Color long Set the item color for constant or simple shading display in the 3D View.
Display Custom Color double[3] Set the item custom color used for display in the 3D View when the Display Color attribute is set to Custom.
Enable Motion Blur bool Set whether the renderer will do motion blur on the item or not.
Enable bool Enable the illumination of the light during the computation of the shading for all objects.
Color double[3] Emission color of the light.
Exposure double Exposure of the light.
Intensity double The gain factor of the light.
Contribution double[3] Contribution of the light on the surface.
Mode long Set the mode to use when computing the illumination. The physical mode takes in account the surface of the light to compute its intensity.
Saturation double Saturation of the light.
Sample Count long Set the number of samples per pixel to use to evaluate the light.
Low Light Threshold double Unshadowed illumination below which a light sample is readily assumed to be occluded, hence bypassing the calculation of its actual visibility to a given shading point so as to increase rendering speed.
Diffuse Weight double Multiply the light contribution on the diffuse lobes.
Reflection Weight double Multiply the light contribution on the reflection lobes.
Transmission Weight double Multiply the light contribution on the transmission lobes.
Subsurface Weight double Multiply the light contribution on the subsurface lobes.
Volume Weight double Multiply the light contribution on the volumes.
Indirect Diffuse Weight double Multiply the light contribution on the diffuse lobes.
Indirect Reflection Weight double Multiply the light contribution on the reflection lobes.
Indirect Transmission Weight double Multiply the light contribution on the transmission lobes.
Indirect Subsurface Weight double Multiply the light contribution on the subsurface lobes.
Indirect Volume Weight double Multiply the light contribution on the volumes.
Unseen By Camera bool Set whether the object is hidden from the camera (primary rays) or not.
Enable Light Occlusion bool Set whether the light is occluder or not.
Shadow Color double[3] Shadow color of the light.
Shadow Group reference (Group) Group of objects that have to be considered when casting a ray for shadows or global illumination. If not set, the corresponding groups in the layer are taken by default.
Diffuse Max Depth long Set whether the light is hidden from the diffuse reflections and transmissions after a number of diffuse bounces.
Reflections Max Depth long Set whether the light is hidden from the specular and glossy reflections after a number of reflections bounces.
Transmissions Max Depth long Set whether the light is hidden from the specular and glossy transmissions after a number of transmissions bounces.
Volume Max Depth long Set whether the light is hidden from volume scattering after a number of scattering bounces.
Shadows Max Depth long Set whether the light casts shadows after a number of bounces.
Total Max Depth long Set whether the light is hidden from reflections and transmissions after a total number of indirect bounces.
Attenuation Mode long Enable the light intensity attenuation that multiplies the falloff to get the final light intensity decay.
Attenuation Near Start double Set the distance from the light at which near attenuation starts. Any object whose distance is shorter than the specified value will not receive any illumination from the light.
Attenuation Near End double Set the distance from the light at which near attenuation ends. Any object whose distance is longer than the specified value will receive the full illumination from the light.
Attenuation Far Start double Set the distance from the light at which far attenuation starts. Any object whose distance is shorter than the specified value will receive the full illumination from the light.
Attenuation Far End double Set the distance from the light at which far attenuation ends. Any object whose distance is longer than the specified value will not receive any illumination from the light.
Attenuation Curve curve Multiplies the light intensity profile. The specified curve uses the distance of the object to the light as input.
Light Path Expression Label string Set the light label in light path expressions.
Aov Exclusive bool If turned on, this light will not contribute to the beauty but only to Light Path Expression AOVs, and under the 'X' symbol instead of the usual 'L'. When enabled, this light will not contribute to the unoccluded results ('U' symbol in LPEs) either and will not be seen by the camera.
Sampling Resolution long[2] Set the resolution at which the texture must be sampled to detect light sources. A high value gives a better result but increases memory usage and initialization time.
Radius double Set the radius of the light source.
Cone Angle double Set the field angle of the outgoing beam of light.
Falloff Angle double Set the angle at the border of the outgoing cone of light for which the illumination is reduced.
Projection Mode long Set the spotlight model. The legacy model corresponds to a disk area light with an abrupt attenuation clipping all illumination outside the light cone, while mimicking soft edges using a fall-off angle, and possibly projecting a sharply-imaged texture. Instead, the lens defocus model simulates an actual projector with a thin lens refocusing the light beams in order to create a natural blur effect away from the specified focus plane.
Focus Distance double Set the distance from the light at which the projection is in focus.
Focus Object reference (SceneItem) Use the input object to compute the focus distance. If none then focus_distance is used.
Display Aim Distance double Set the length of the display of the cone in the 3D view.