shadow - display driver for shadow map texture file output

DESCRIPTION

Shadow is a PhotoRealistic RenderMan display driver which produces an output file containing depth (z) information in the shadow map texture file format. The file format is peculiar to PhotoRealistic RenderMan. The shadow map texture format is accepted by the renderer and light shaders which produce shadows.

The shadow driver creates a file whose name is specified in the RiDisplay call.

Like most other image file display drivers, the shadow driver must receive image data in raster scan order, one scanline at a time. The display server buffers image data as necessary to reorder it into raster scan order before sending it to the shadow driver.

DEFAULTS

resolution		512 × 512


pixel aspect ratio	1.0


shadow name		ri.shd

ERROR MESSAGES

The following messages can be produced by the shadow display driver. Each message will be preceded by the generic message number D00001.

DspyOpen_shadow: Only Z data, please

The driver can be used only to display Z data. It is an error to select the driver when display modes other than RI_Z are specified.

DspyOpen_shadow: Z must be 32-bit IEEE float.

The depth data received by the driver must be in 32-bit IEEE floating point format. This message probably results from an inappropriate RiQuantize command. It is best not to specify Z quantization (ie. let it default) if you wish to use this driver.

DspyOpen_shadow: Can not open "name"

The output shadow name could not be created or opened for writing by the driver.

DspyOpen_shadow: File is already open

DspySetW_shadow: Not open

These messages should never occur, and indicate bugs in the display driver or display server.

DspySetW_shadow: Bad scanline window

This message should never occur. It may result from improper installation of the display driver (DSPY_SCANLINE flag missing), or a bug in the display server.