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

Page tree


PxrDirt renders local geometric occlusion. This is useful for applying shading effects to nooks and crevices.

A traditional ambient occlusion effect can be accomplished by setting the occluded color to black and unoccluded color to white.


Occluded and Unoccluded

Resulting colors for occluded and unoccluded shading.

Num Samples

Controls the number of occlusion samples per camera hit point. More samples reduces can the noise at the cost of increased render time.

Sample Distribution

Possible values are uniform and cosine (Lambertian).

UniformRays are not weighted in any particular direction in the hemisphere above the shading point.
CosineCosine distribution is a commonly used to render ambient occlusion.

Cosine Spread

Sample spread of rays when using cosine distribution. A value of 1.0 gives a perfect Lambertian distribution.


Falloff can be used to control the softness of the occlusion effect.

Max Distance

The max distance at which objects may occlude. Zero is infinite (all objects occlude).


Trace rays in the direction of the surface normal (outside), inverse to the normal (inside), or in both directions.

Bias Normal

Add a directional bias to the normal vector. Values must be specified in world space.