# Distant#

(LightPhysicalDistant)

• Category: /Light/Physical/Infinite
• Default object name: distant

Go to Technical page.

## Description#

A physical light that is at an infinite distance from the scene. Thus, the position of the light doesn't affect the illumination. The sun is a typical use for this light.

## 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.
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.
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.
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.
Angle double Set the angle of the incoming cone of light. An angle over 0° enables soft shadows.