Page tree

Versions Compared

Key

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

...

NameTypeDefaultDescription
dice:micropolygonlengthfloat0Object micropolygon length expressed in pixel size
dice:minlengthfloat-1(Volumes) By default, minlength is not enabled: there is no minimum constraint on dicing rate. Setting minlength to a positive value specifies the minimum length of the voxel, as measured in a space denoted by the "minlengthspace" parameter.
dice:minlengthspacestringnull

 This space is allowed to be "world", "object", "camera", or any other space marked by a RiCoordinateSystem call. Setting minlength to a negative value indicates that the minlength is to be computed in a different fashion:

  • For a RiVolume where the "type" is not blobbydso, the minlength is automatically half the size of a voxel measured in object space.
  • For a RiVolume where the "type" is blobbydso (i.e. the volume is defined by an implicit field plugin), the minlength is set to be the return value of the MinimumVoxelSize method from the ImplicitField API, and the dicing rate will be constrained to be less than this length measured in object space.
  • For RiBlobby, if there is a DSO in the DAG defining the blobby, the minlength is set to be the smallest non-zero return value returned by calls to all MinimumVoxelSize methods from the DSOs in the graph implementing the ImplicitField API. If there are no DSOs in the DAG the minlength is zero (there is no minimum dicing rate constraint).
dice:offscreenstrategystring"viewfrustumdistance"Defines the dicing strategy used for offscreen objects that may be traced indirectly, the options are: "clamped", "sphericalprojection, "viewfrustumdistance", "worlddistance", "planarprojection"
dice:rasterorientinteger1Turning this off, by setting it to 0, enables  nonraster-oriented dicing , a mode of dicing that computes micropolygon sizes using an un-oriented raster space metric rather than the standard screen-aligned raster metric. This is useful in situations where it is important that the dicing rate on an object doesn't change due to camera orientation. For example, it can help in situations where objects that are viewed edge on result in large micropolygons (but small in screen space), which are then displaced leading to micropolygons that are large in screen space.
dice:referencecamerastringnullRenderMan has support for specifying the camera and strategy to use during dicing. These are chosen via the  "strategy"  and  "referencecamera"  parameters of "dice". This reference camera is required to define the dicing when doing multi-camera rendering. RenderMan does not choose the best/finest camera automatically, it must be set by the user.
dice:referenceinstancestringnullSpecify the reference instance used for dicing and displacement shading. The reference instance is used to drive dicing and displacement based on its position, scale, user attributes, and scoped coordinate systems. Reference instances are specified by its identifier:name attribute (instance name). If no reference instance is specified, RenderMan will automatically pick the nearest instance inside the primary camera's view frustum.
dice:strategystring"instanceprojection"Defines the dicing strategy used for objects on screen, the options are: "instanceprojection", "sphericalprojection", "worlddistance"
dice:worlddistancelengthfloat-1Object micropolygon length expressed in world space units
Ri:GeometricApproximationFocusFactorfloat-1Allows the renderer to dice more coarsely for out of focus objects
Ri:GeometricApproximationMotionFactorfloat0Allows the renderer to dice more coarsely for blurry or fast moving objects

...