Page tree

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

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 $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:

${*environment-variable-name*}

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.


Parameter
Default
/dirmap/zone/linux-x86NFS
/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.so
/display/dso/slim${RMANTREE}/lib/plugins/d_socket.so
/display/dsomappingd_%s.so
/display/dsopath/usr/yourdisplaydrivers/etc/
/display/externserver${RMANTREE}/etc/dspysrvr
/display/openexr/compression

This sets the compression type for the OpenEXR output of renders. Valid options are: rle, zip, zips, piz, pxr24, b44, or b44a
zips
/display/socket/itappit
/display/socket/itport4001
/display/socket/socketappit
/display/socket/socketport4001
/display/standarddsopath${RMANTREE}/lib/plugins/
/display/texture/compression

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
none
/display/tiff/rowsperstrip32
/display/tiff/compression

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.
zip
/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
/displaytype/pointcloudpointcloud
/dspyserver${RMANTREE}/etc/dspysrvr -hostclient rman-display
/errorpath

Sets the directory where the error message files are to be found. The renderer and tools will look in this directory when reporting errors.
${RMANTREE}/etc/messages

/licenseserver


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.

empty
/platform/linux/rtldglobalextensionsog
/prman/bucketsize16 16
/prman/checkpoint/interval0
/prman/constantmemorylimit1
/prman/deepshadow/version6
/prman/gridsize256
/prman/lpe/user2Albedo,DiffuseAlbedo,SubsurfaceAlbedo,HairAlbedo
/prman/matrixcachememory102400
/prman/ptexturemaxfiles128
/prman/ptexturememory1048576
/prman/raytrace/geocachememory2097152
/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.xml
/prman/statistics/radioevictwarnratio.01
/prman/statistics/stylesheet${RMANTREE}/etc/statsview/rmanStatsEmbed_2.0.xml
/prman/statistics/xmlfilenameempty
/prman/textureformattiff

/prman/texture/maxfiles
*maximum on Windows is 2048

512
/prman/texturememory2097152
/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
/texturepath.:@