This pattern transforms the input displacement values to a customized range of values for the input to PxrDisplace.  This includes remapping the displacement center, transforming it to a different displacement scale and space.

Input Parameters

Displacement Type

Specify the displacement type for the input.

• 1: Scalar.  
  This is a float type.  
• 2: Generic Vector.  
  This can be any vector created procedurally or textured which does not need any special decoding like in Mudbox or ZBrush vector displacement maps.
• 3: Mudbox Vector.  
  This is the extracted vector displacement map from Mudbox. 
• 4: Zbrush Vector. 
  This is the extracted vector displacement map from ZBrush. 

Scalar Displacement

Scalar displacement input.  This is a float displacement.  Connect a PxrTexture or any float pattern node to this parameter.

Vector Displacement

Vector displacement input. Vector displacement data is a three channel data XYZ. Connect a PxrTexture or any RIS vector pattern node's resultXYZ or resultRGB to this parameter. 

Vector Space

Specify which space the vector was created in. For Mudbox and ZBrush vector type, this would be the space that the vector displacement was exported from.  

• 1: World
• 2: Object
• 3: Tangent
• 4: Current

It is very important to set the right vector space otherwise the resulting vector displacement will be rendered incorrectly. 

Displacement Height

Displacement height applies to the displacement value that is displacing out.

Displacement Depth

Displacement depth applies to the displacement value that is displacing in.

Remapping Mode

Specify how to remap the displacement values:

• 1:  None.  
  Reads the displacement value as is without any remapping.  Use Displacement Height to scale the displacement value.
•  2:  Centered: 
  The displacement value is centered at the Displacement Center specified. If the value is equal to the center, there is no displacement.  
  Any values below the center will be displacing in whereas any values above the center will be displacing out.

• 3: Interpolate Depth and Height:

  Fits the displacement depth and height specified through a catmull-rom spline (spline("catmullrom", -depth, -depth, 0, height, height). This mode does not use the Displacement Center.

Displacement Center

Displacement center for the "Centered" Remapping Mode.

Displacement Scale Space

Space in which displacement units are measured.  E.g. "world", "object", or user-defined coordinate system.

We offer two rendering spaces for specifying displacement, world and object space.

By default, RenderMan will displace in Object space. This is typically desired for sculpted models. But for some objects this can result in discontinuities. For example, a set of objects displaced together like a set of planes made into an environment piece. In object space these may result in gaps or discontinuity between patches like below.

To correct for this particular scenario, you can select World Space to achieve the result below using the same eight patches. This will solve issues like ocean planes, cliffs, and rocks, where displacement is shared across the shapes.

Use Displacement Direction

When on, displacement will be along the displacement direction provided below instead of along the surface normal.

Displacement Direction

Displacement will be in the direction this points to rather than along the surface normal. Note that the displacement direction vector will be normalized before its use.

Displacement Direction Space

Space in which the displacement direction vectors are in.  E.g. "world", "object", or user-defined coordinate system.

Output Parameters

resultXYZ

The vector result.