This is RenderMan 21 Documentation you are viewing. The Rmanwiki home page will redirect you to the current documentation.

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

Parameters

 

Intensity

Scales the contribution of this light linearly.

 

Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFilterintensity
gutterSize20
titleIntensity
animatefalse
captionstrue

Exposure

Specifies the exposure of the area light as a power of 2. Increasing the exposure by 1 will double the energy emitted by the light source. A value of 0 produces an intensity of 1 at the source, -1 produces 0.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.


Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFilterexposure
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Direction

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/sunset). Note that the Y component must non-negative. Ignored if a month is given. In some DCC applications, like Maya for example, you can manually alter the Sun direction using a manipulator in the viewport (press 't' with the Daylight icon selected in the viewport.)

 

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.

 

Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFilterhaziness
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Sky Tint

Tweak the sky's contribution and color. The default, white, gives results based on measured physical values. You may be able to create some interesting alien skies this way. Setting this to black removes the sky contribution shown in the first image.

 

Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFilterskytint
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Sun Tint

Tweak the sun's contribution and color. The default, white, gives results based on measured physical values. Setting this to black removes the sun contribution like the first image (in case you want to create your own).

 

Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFiltersuntint
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Sun Size

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. At 0.1 you'll barely notice that the sun's contribution has decreased. Notice that at 80.0 we have a very large sun in the sky that casts softer shadows since the light size has increased diameter.

 

Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFiltersunsize
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Ground Mode

This menu allows the user to change the appearance and effect of the virtual ground plane. The Legacy Mode operates as always. Horizon Clamping provides a better simulation of the virtual ground mode with a blurred horizon. Diffuse Ground allows the user to color an infinite virtual ground plane (this plane .

 

Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFiltergroundmode
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Ground Color

Use this color as the rendered ground color. This is not texturable and does not accept shadows and is not currently textureable.)

 

Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFiltergroundmodegroundcolor
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Month

Month of the year, 1 through 12. The default, use direction, means to use the explicitly given sun direction instead of automatically computing it.

 

Day

Day of the month, 1 through 31. This is ignored if the month is set to use direction.

 

Year

Four digit year. This is ignored if the month is set to use direction.

 

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 the month is set to use direction.

 

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 the month is set to use direction.

 

Latitude

Latitude in degrees. Positive for north, negative for south. Ranges from -90 to +90 degrees. This is ignored if the month is set to use direction.

 

Longitude

Longitude in degrees. Positive for east, negative for west. Ranges from -180 to 180 degrees. This is ignored if the month is set to use direction.

 

 


Refine

 

Specular Amount

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.

 

Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFilterspecularamount
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Diffuse Amount

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.

 

Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFilterdiffuseamount
gutterSize20
titleIntensity
animatefalse
captionstrue

 


Shadows

Note

All shadow parameters will be ignored if the light's  Trace Light Paths  is enabled in Advanced. The below options are all non-physical controls when used out of their default state. If  Trace Light Paths  is enabled then their physical nature is enforced.

 

Enable Shadows

Enable raytraced shadows. Below is on (default) and off.


Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFiltershadow
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Shadow Color

The color of the shadows cast by emitted light.

 

Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFiltershadowcolor
gutterSize20
titleIntensity
animatefalse
captionstrue

.0 0.0 0.0

Shadow Max Distance

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. Here it's used to remove the shadow off the back wall from the sunlight.


Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFiltershadowdistance
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Shadow Falloff

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. Below is an example with both parameters being used and the falloff is increased.  Note this parameter may impact performance on complex lighting setups.


Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFiltershadowfalloff
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Shadow Falloff Gamma

The gamma of the shadow strength in the falloff zone. This requires the use of  Shadow Max Distance  and  Shadow Falloff .


Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFiltershadowfalloffgamma
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Trace Subset

Set of geometry to consider for traced shadow intersection. If this is not specified, all geometry are considered for traced shadow intersection.

 

Don't Trace Subset

Set of geometry to ignore for traced shadow intersection. If this is not specified, all geometry is used for traced shadow intersection.

 

 


Advanced

 

Trace Light Paths

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.

 

Thin Shadow

Enable thin shadow and disable refraction caustics for this light. This parameter will ignored if  Trace Light Paths  is enabled. This is a non-physical control that creates "fake" colored shadows for transmissive objects without needing to generate photons for caustics. Below we go from On (default) to Off (opaque shadowing). Notice we lose the colored shadows and interior colored reflection choosing Off, but we gain some render speed instead.


Carousel Image Slider
includepxrDome_intensity05.jpg, pxrDome_intensity10.jpg, pxrDome_intensity20.jpg
maxNumber3
dotsfalse
columns3
infinitefalse
sliderHeight190
arrowsfalse
labelsFilterthinshadow
gutterSize20
titleIntensity
animatefalse
captionstrue

 

Light Samples

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.

 

Light Group

Specify the light group name used for light group LPEs. This is useful to generate per-light AOVs for later adjustment in compositing.

 

Importance Multiplier

Rather than setting explicit Light Samples, users can change the amount of samples the light will be assigned internally by changing this value. RenderMan creates a set of samples at render time for all lights in the scene and changing this value rebalances the samples across the lights. Note that increasing this value will cause more samples to be selected from this light while reducing it for others in the scene. Lower than the default will decrease the samples while providing more to others in the scene.

 

 

...