The RenderMan Interface - Paul Bourke

Name
Type
”ShadingRate”
uniform float
”Sides”
uniform float
”Matte”
uniform float
”GeometricApproximation:motionfactor”
uniform float
”displacementbound:sphere” (*)
uniform float
”displacementbound:coordinatesystem” (*)
uniform string
”identifier:name”
uniform string
(*) Note that ”displacementbound:sphere” does not return the value exactly as specified
in the RIB file, but rather returns its length in the coordinate system returned by
”displacementbound:coordinatesystem” (which currently always returns ”camera”).
Table 15.4: Data names known to the attribute function.
variable, the named data will be written into variable and option() will return a value
of 1.0. If the data is unknown or the types do not match, variable will be unchanged
and option() will return 0.0. Note that option data is always uniform. If variable is
varying, the appropriate uniform-to-varying conversion will take place.
The standard data names supported by option are listed in Table 15.5. A particular
implementation may support additional option queries.
Name Type Description
”Format” uniform float [3] x resolution, y resolution, pixel aspect ratio.
”DeviceResolution” uniform float [3] The resolution in x and y and the pixel aspect
ratio. These are usually the three numbers
passed to RiFormat, but may be different when
RiFrameAspectRatio or RiScreenWindow are
non-square.
”FrameAspectRatio” uniform float Frame aspect ratio.
”CropWindow” uniform float [4] Boundaries of the crop window.
”DepthOfField” uniform float [3] Fstop, focallength, focaldistance.
”Shutter” uniform float [2] Shutter open and close time.
”Clipping” uniform float [2] Near and far clip depths.
Table 15.5: Data names known to the option function.
float rendererinfo ( string name; output type variable )
Returns data that about the renderer itself. The name specifies the piece of information
that will be returned in variable. The the data name is known to the renderer
and its type and storage class match that of variable, the named data will be written
into variable and rendererinfo() will return a value of 1.0. If the data is unknown
or the types do not match, variable will be unchanged and rendererinfo() will return
0.0. Note that renderer data is always uniform. If variable is varying, the appropriate
uniform-to-varying conversion will take place.
149