Page tree

Contents

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.

Important

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 $RMAN_CONFIG_OVERRIDE 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 specifies its default value. Environment variables may be referenced inside the configuration file using the following special syntax:

${*environment-variable-name*}

Undefined environment variables default to the empty string.

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 RenderMan. Note that various display drivers also read defaults from this file.


Parameter
Default
Additional Information
/dirmap/zone/linux-x86NFSArchitecture-specific directory remapping zones.
/dirmap/zone/linux-x86-64NFS
/dirmap/zone/osx-x86NFS
/dirmap/zone/osx-x86-64NFS
/dirmap/zone/windows-x86UNC
/dirmap/zone/windows-x86-64UNC
/display/dso/it${RMANTREE}/lib/plugins/d_socket.soDefault display driver for Pixars Image Tool ('it'). See Display Drivers
/display/dsomappingd_%s.so
/display/dsopath/usr/yourdisplaydrivers/etc/
/display/externserver${RMANTREE}/etc/dspysrvr
/display/openexr/compressionzipsThis sets the compression type for the OpenEXR output of renders. Valid options are: rle, zip, zips, piz, pxr24, b44, or b44a. See Display Drivers
/display/openexr/typefloatSee Display Drivers
/display/socket/itappit
/display/socket/itport4001
/display/socket/socketappit
/display/socket/socketport4001
/display/standarddsopath${RMANTREE}/lib/plugins/
/displaytype/filetiffAllows a one-level translation of the display type file, as specified in an RiDisplay call, to an alternate display type. The default translation for file is tiff.
/displaytype/framebuffer${RMANFB-it}Allows a one-level translation of the display type framebuffer, as specified in an RiDisplay call, to an alternate display type. 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.
/displaytype/pointcloudpointcloud
/dspyserver${RMANTREE}/etc/dspysrvr -hostclient rman-display
/licenseserveremptySpecifies 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.
/platform/linux/rtldglobalextensionsog
/prman/bucketsize16 16
/prman/checkpoint/interval0
/prman/constantmemorylimit1If constantmemorylimit is 0, memory sizes are per thread. If constantmemorylimit is 1, then they are total sizes.
/prman/deepshadow/version6
/prman/gridsize256
/prman/lpe/user2Albedo,DiffuseAlbedo,SubsurfaceAlbedo,HairAlbedo
/prman/matrixcachememory102400

If constantmemorylimit is 0, this size is per thread. If constantmemorylimit is 1, this is the total size.

/prman/ptexturemaxfiles128
/prman/ptexturememory1048576If constantmemorylimit is 0, this size is per thread. If constantmemorylimit is 1, this is the total size.
/prman/raytrace/geocachememory2097152If constantmemorylimit is 0, this size is per thread. If constantmemorylimit is 1, this is the total size.
/prman/recover/verbosity3
/prman/shading/debug0
/prman/shadingrate1.0
/prman/statistics/filenamestdout
/prman/statistics/maxdispwarnings100
/prman/statistics/patterntimerlevel1
/prman/statistics/profilestylesheet${RMANTREE}/etc/statsview/rmProfileEmbed_1.0.xmlLocation of shader profile XML stylesheet (legacy stats).
/prman/statistics/radioevictwarnratio.01The threshold at which the opacity cache code will emit an eviction rate warning (R25006).
/prman/statistics/stylesheet${RMANTREE}/etc/statsview/rmanStatsEmbed_2.0.xmlLocation of default XML stylesheet (legacy stats).
/prman/statistics/xmlfilenameemptyLocation of XML stats report (legacy stats, RIS only).
/prman/textureformattiff

/prman/texture/maxfiles

512The maximum on Windows is 2048.
/prman/texturememory2097152
/prman/texture/missingudimwarning

1

A value of 1 allows reporting of error TT02041, where a texture atlas cannot be opened if no valid texture maps can be found for it. A value of 0 silences the error.

/proceduralpath.:@
/rifpath.:@
/rixpluginpath.:@
/shaderpath.:@
/standardproceduralpath.:${RMANTREE}/lib/plugins
/standardrifpath${RMANTREE}/lib/plugins
/standardrixpluginpath${RMANTREE}/lib/plugins
/standardshaderpath${RMANTREE}/lib/shaders:${RMSTREE}/lib/shaders
/standardtexturepath${RMANTREE}/lib/textures:${RMANTREE}/lib/plugins

/stats/configpath   

.:${RMANTREE}/etcSpecifies the path to search for the stats configuration file
/stats/listenerpath.:${RMANTREE}/lib/plugins/listenersSpecifies the path to search for stats listener plugins
/texturepath.:@