Short Contents

8.12 OpenEXR display driver

This display driver writes out ILM's EXR files using the `half' and `float' formats. There is no need to install any external libraries to use this display driver. The following parameters can be specified to the EXR display driver:

"uniform string exrcompression" ["zip"]
"uniform string compression" ["zip"]
Specifies which compression to use. Valid compression schemes are:
"none"
Disable compression.
"zip"
Enable `deflate' compression using the `zlib' library. This is the default compression scheme.
"zips"
Like `zip' but each scanline is compressed separately. Compression is not as good but the files will load faster in some software.
"uniform string exrlineorder" ["increasing"]
Specifies if the image is to be written in `increasing' or `decreasing' Y. Default is `increasing'. When writing an image in decreasing Y order, the display driver has to buffer the entire image before writing it to the file. This could require a significant amount of temporary disk space.
"uniform string exrpixeltype" ["half"]
Specifies the precision of image data in the file. Set to `float' for full precision, at the cost of larger files.
"int asrgba" [0]
When set to 1, the channels will be recorded as Y, RGB or RGBA instead of being named based on the variable being output. This only works for 1, 3 or 4 channels and is useful for compatibility with poor software.
"int autocrop" [0]
When set to 1, this will shrink the data window of the file to the smallest window containing all non black pixels. Since there is less data written to the file, other applications may load it faster. This option causes the data to be buffered as for exrlineorder.
"string comment" [""]
Attaches a comment to the produced EXR file.
"int margins[4]" [0 0 0 0]
Specifies in pixels how much of the frame is assumed to be overscan on the left, top, right and bottom side. The data and display windows of the file are adjusted accordingly. Note that this does not actually add the overscan to the render. That must be done separately.
"string exrheader_attrname" [""]
Adds a string attribute named `attrname' (which can be any desired name) to the file's header.
"int exrheader_attrname" [0]
As above but adds an integer attribute.
"int exrheader_attrname[2]" [0 0]
As above but adds a `v2i' attribute.
"int exrheader_attrname[3]" [0 0 0]
As above but adds a `v3i' attribute.
"int exrheader_attrname[4]" [0 0 0 0]
As above but adds a `box2i' attribute.
"float exrheader_attrname" [0]
As above but adds a float attribute.
"float exrheader_attrname[2]" [0 0]
As above but adds a `v2f' attribute.
"float exrheader_attrname[3]" [0 0 0]
As above but adds a `v3f' attribute.
"float exrheader_attrname[4]" [0 0 0 0]
As above but adds a `box2f' attribute.

`rendermn.ini' Entries

The EXR display drivers recognizes the following parameter:

/display/exr/compression
Contains the default compression to use if no compression mode is passed to the display driver.
/display/exr/pixeltype
Contains the default pixel type to use if none is specified to the display driver.
/display/exr/asrgba
Changes the name of channels written to the file. See "asrgba" in the table above.
/display/exr/autocrop
Sets the autocrop feature

More about the `rendermn.ini' configuration file in Configuration file (`rendermn.ini').

3Delight 10.0. Copyright 2000-2011 The 3Delight Team. All Rights Reserved.