Parameters
intensity: intensity: Scales the contribution of this light linearly.
exposure: exposure: Specify the intensity of the light source as a power of 2 (in stops). Increasing the exposure by 1 will double the energy emitted by the light source. A value of 0 produces an intensity of 1, -1 produces .5. You may wonder why you might use Exposure, and the answer is that real world lighting has high energies and typical exposures are low values while you may have to type a really large number for equivalent Intensity. This is also comfortable to artists familiar with photographic measurements.
sunDirection: sunDirection: The apparent direction towards the center of the sun. The zenith is at +Y (for noon light) and the horizon is in the XZ plane (for sunrise/set). Note that the Y component must non-negative. Ignored if a month is given.
haziness: haziness: The turbidity of the sky. The lower limit of the model is 1.7 for an exceptionally clear sky, and 10, for an inversion, is the upper limit.
skyTint: skyTint: Tweak the sky’s contribution and color. The default, white (1,1,1), gives results based on measured physical values.
sunTint: sunTint: Tweak the sun’s contribution and color. The default, white (1,1,1), gives results based on measured physical values. Setting this to black removes the sun contribution.
sunSize: sunSize: Scale the apparent size of the sun in the sky. Leave at 1 for a realistic sun size with an 0.55 degree angular diameter.
month: month: Month of the year, 1 through 12. The default, 0, means to use the explicitly given sun direction instead of automatically computing it.
day: day: Day of the month, 1 through 31. This is ignored if month is 0.
year: year: Four-digit year. This is ignored if month is 0.
hour: hour: Hours since midnight, local standard time. May be fractional to include minutes and seconds. If daylight saving time is in effect, subtract 1 to correct to standard time. This is ignored if month is 0.
zone: zone: Standard time zone offset from GMT/UTC in hours. Positive for east, negative for west. For example, this would be -8 for Pacific time. This is ignored if month is 0.
latitude: latitude: Latitude in degrees. Positive for north, negative for south. Ranges frmo -90 to +90 degrees. This is ignored if month is 0.
longitude: longitude: Longitude in degrees. Positive for east, negative for west. Ranges frmo -180 to +180 degrees. This is ignored if month is 0.
specular: specular: Amount of specular light that is emitted. This is a non-physical control. You could use a light with Specular Amount 0.0 to act purely as a source of diffuse light for your scene objects and avoid adding highlights.
diffuse: diffuse: Amount of diffuse light that is emitted. This is a non-physical control. You could use a light with Diffuse Amount 0.0 to act purely as a source of highlights for your scene objects.
enableShadows: enableShadows: Enable raytraced shadows.
shadowColor: shadowColor: The color of the shadows cast by emitted light.
shadowDistance: shadowDistance: The maximum distance of the shadow starting from the position of the point being shaded. -1.0 is unset which will use the distance between the point being shaded and the point on the light. You may use this control to artificially reduce the distance shadows are cast. This may also increase render speed by not calculating shadows outside this distance
shadowFalloff: shadowFalloff: the distance from the light at which shadow falloff begins. -1.0 turns off shadow falloff. This is used along with Shadow Max Distance to create a false fade for shadows that are reduced or cut off by the Shadow Max Distance parameter.
shadowFalloffGamma: shadowFalloffGamma: The gamma of the shadow strength in the falloff zone. This requires the use of Shadow Max Distance and Shadow Falloff.
shadowSubset: shadowSubset: Set of geometry to consider for traced shadow intersection. If this is not specified, all geometry are considered for traced shadow intersection.
shadowExcludeSubset: shadowExcludeSubset: Set of geometry to ignore for traced shadow intersection. If this is not specified, all geometry is used for traced shadow intersection.
traceLightPaths: traceLightPaths: Enable light and photon tracing from this light. This value enforces a physically-based light and as a side-effect disables the above Shadows controls. Users may use this feature to selectively decide which lights emit photons when using the PxrVCM or PxrUPBP Integrators.
thinShadow: thinShadow: Enable thin shadow.
fixedSampleCount: fixedSampleCount: Specifies an override of the number of light samples to be taken for this light source. If set to something other than zero, it will override the sampling performed by the integrator. You might find need for this if you have unsolvable noise from this light and need more samples.
lightGroup: lightGroup: Specify the light group name used for light group LPEs. This is useful to generate per-light AOVs for later adjustment in compositing.
importanceMultiplier: Importance of this light for noise control.