You are viewing RenderMan 22 documentation which is not the current release. You may view the current documentation by visiting the home page.

Page tree

Versions Compared

Key

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

...

Parameters

Cookie Mode

Specify the cookie mode:

Physical (0): The cookie behaves like a stained glass window through which light falls. The falloff and blur are determined by the size of the light, the distance to the light and distance from the cookie.

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

Analytic (1): The cookie has a fixed projection and manual blur and falloff controls.

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

 

Map

Filename of the projected texture. If you want to control the blur for the projected edge, include the mask into the alpha channel of this map. Otherwise, it will use a white opaque alpha installed on $RMANTREE/lib/textures/white.tex for blurring when Blur is > 0.0.

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

Fill Color

If the texture's tile mode is not repeating, this specifies the color for the region outside of and behind the projected rectangle. When we specify Blur below, the edge of the projected rectangle will be blended with the fill color.

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

Width

Width of the rect which the light is shining through.

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

Height

Height of the rect which the light is shining through.

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

Multiplier

Density

Controls the strength of the projected effect.

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

Invert

Specify whether to invert the projected texture before it is applied.

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

Intensity

Global Multiplier for both the diffuse and specular contribution below.

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

Diffuse

Multiplier of this light filter result for the diffuse contribution.

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

Specular

Multiplier of this light filter result for the specular contribution.

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

Projection (For Analytic Mode Only)

Directional

When this is on, the texture projects along a direction using the orthographic projection. When it is off, the texture projects using a focal point specified by the Apex.

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

Shear X

Shear the projection along the X axis.

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

Shear Y

Shear the projection along the Y axis.

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

Apex

Distance between the center of cookie and the center of projection. This is only applicable when Directional is off.

Use Light Direction

If this is on, the projection direction is determined by the position of the center of the light source. Otherwise, it only follows the orientation of the cookie. WARNING: This does not work with dome and mesh lights.

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

 

Texture Mapping

Tile Mode

Specifies how the texture repeats.
  • No Repeat (0)
  • Edge Extent (1)
  • Tile (2)

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

Invert U

Turn this on only if you want to flip the texture from left to right. By default, the orientation of the texture is matching the orientation as it is viewed in an image viewer.

 

Invert V

Turn this on only if you want to flip texture from bottom to top. By default, the orientation of the texture is matching the orientation as it is viewed in an image viewer. Note that the light filter already takes into the account of flipping the V direction for the correct default orientation.

 

Scale U

Scale of the projected texture in the U direction.

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

Scale V

Scale of the projected texture in the V direction.

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

Offset U

Offset of the projected texture in the U direction.

 

Offset V

Offset of the the projected texture in the V direction.

Use Alpha

If this is off, your result may not be smooth.


Premultiplied Alpha

If using a texture with unpremultiplied Alpha, set this to 0 of off for correct behavior.

 

Blur (for Analytic Mode Only)

Blur

Specify the blur of projected texture from 0-1. This gets multiplied by the blurNear/blurFar interpolation. This blurs between the projected color and the fill color when the texture is not repeating.

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

S Blur Mult

Blur multiplier in S direction.

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

T Blur Mult

Blur multiplier in T direction.

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

Blur Near Dist

Distance from the cookie where the blur interpolation starts.

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

Blur Midpoint

Distance between near and far, where the midValue is located.

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

Blur Far Dist

Distance from the cookie where the blur interpolation ends.

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

Blur Near Value

Blur multiplier where the blur interpolation starts.

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

Blur Mid Value

Blur multiplier in the middle of the blur interpolation.

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

Blur Far Value

Blur multiplier where the blur interpolation ends.

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

Blur Exponent

Power exponent of the blur interpolation.

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

 

Density Falloff (for Analytic Mode Only)

Density Near Dist

Distance from the cookie where the density interpolation starts.

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

Density Midpoint

Distance between near and far, where the midValue is located.

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

Density Far Dist

Distance from the cookie where the density interpolation ends.

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

Density Near Value

Density multiplier where the blur interpolation starts.

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

Density Mid Value

Density multiplier in the middle of the density interpolation.

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

Density Far Value

Density multiplier where the blur interpolation ends.

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

Density Exponent

Power exponent of the density interpolation.

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

 

Saturation, Contrast, Tint

Saturation

Saturation of the result (0=greyscale,1=normal,>1=boosted colors).

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

Midpoint

Midpoint for the contrast control.

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

Contrast

Contrast control (less than 1 = contrast reduction, larger than 1 = contrast increase).

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

White Point

White point for the contrast control if (contrast > 1.0).

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

Tint

Tint of the resulting color after saturation, contrast and clamp.

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

Combine Mode

Combine Mode

mult: The results of all the filters are multiplied together

max: The maximum result from all filters is used.This works best for grey scale light filters.

min: The minimum result from all filters is used.This works best for grey scale light filters.

screen: Similar to the max operation, but it combines gradients in a smoother way. This works best for grey scale light.

Light filters on a light are grouped by their combine mode. Light filters in the same group are executed together and combined by the combine mode.The groups are executed in this order (max, min, screen, and then mult) and are multiplied together, which means a filter that turns things black in the mult group will zero out all other filters.