Page tree


This file in your installation can be used to provide global settings for your installation or preferences. We highly recommend making a backup of the file.


All of the settings in the rendermn.ini file are site-configurable, but we highly recommend that, rather than editing the file in your installation directory ($RMANTREE/etc), you create a duplicate file containing your site-specific overrides. The renderer will check for any site-specific .ini files in your $HOME directory and any directory indicated by the $RDIR environment variable, as well as the current directory. Note that the file in the $HOME directory can optionally have a leading "." to make it a hidden file.

The configuration file format is a set of lines containing strings. The first string on the line is the name of the default and the rest of the line specify its default value. Environment variables may be referenced inside the configuration file using the following special syntax:


Undefined environment variables default to the empty string, except for ${RMANTREE}, which defaults to /usr/local/prman. Lines beginning with a # are ignored.

The following is a list of some of the defaults that can be set in configuration files that are relevant to PhotoRealistic RenderMan. Note that there are also various display drivers that also read defaults from this file.



This sets the compression type for the OpenEXR output of renders. Valid options are: rle, zip, zips, piz, pxr24, b44, or b44a



This tells RenderMan where to look for display driver plugins



Sets the compression algorithm to be used for the internal texture driver when creating OpenEXR format textures. The default value is none. Alternate values are rle, zip, piz, pxr24, b44, or b44a



Tiff files are composed of strips containing part of the image. Strips may also be compressed individually. These strips contain rows and this setting can define the number of rows in each strip



Sets the compression algorithm to be used for the internal tiff driver. The default value is zip. Alternate values are zip, packbits, pixarlog, lzw, deflate, or none.


/displaytype/framebuffer | /displaytype/file

Allows a one level translation of the display type framebuffer or file, as specified in an RiDisplay call, to an alternate display type. The default translations for file is tiff, and the default translation for framebuffer is to use the value of the RMANFB environment variable if set, otherwise it will use x11 or windows, depending on the system.

${RMANFB-it} | tiff
/dspyserver${RMANTREE}/etc/dspysrvr -hostclient rman-display


Sets the directory where the error message files are to be found. The renderer and tools will look in this directory when reporting errors.



Specifies a fully qualified name of the license file. Usage of /licenseserver can include either a pointer to a license server machine, e.g. 9010@hostname (where "hostname" is the name of the license server), or an explicit path to a pixar.license file, e.g. ${RMANTREE}/etc/pixar.license. Note that the pixar.license file, in the latter case, can be either a node-locked license or a redirect to a license server.



This sets the tile or bucket size for rendering images. This can often be overridden from bridge applications but farm rendering may rely on this setting and may affect distributed rendering. Larger bucket sizes are more efficient but consume more memory. This is equivalent to:

RiOption("limits", "bucketsize", (RtPointer)&*bs*, RI_NULL);

16 16


*maximum on Windows is 2048