rendermn.ini
rendermn.ini
Many of the internal defaults of PhotoRealistic RenderMan can be controlled by configuration files named rendermn.ini. These configuration files are read at the time of the call to RiBegin, before any other Ri calls are processed. For defaults that correspond to an Ri call, the Ri call, if present, will override the default value. The initial configuration file is found in the ${RMANTREE}/etc directory.
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, and those defaults are documented in the Display Drivers reference section.
/errorpath
/licenseserver
/displaytype/framebuffer | /displaytype/file
/display/displaytype/xres
/display/displaytype/yres
/display/displaytype/par
/display/displaytype
/display/dsomapping/
/display/standarddsopath/
/display/dsopath/
/display/dso/displaytype
/display/tiff/compression
Sets the compression algorithm to be used for the internal tiff driver. The default value is zip. Alternate values are packbits, pixarlog, lzw or none. Note: At this time many third party software packages do not support the default, zip, compression scheme. Packbits or no compression may be most convenient for images for use with these other software packages (PhotoShop, DeBabelizer, etc). Files that are rendered using the zip compression scheme can be converted using the utility program tiffcopy to change the compression.
zip - provides compression with the algorithm used by the popular gzip program. Output files are usually smaller than those produced using lzw compression. zip is purported to be unencumbered by patents and is supported by the libtiff library available for free from Silicon Graphics. The actual zip compression is implemented using a freely available library written by Jean-loup Gailly and Mark Adler.
pixarlog - If TIFF files with more than eight bits per pixel are required and portability is not an issue, sixteen bit or floating point pixel data can be written using pixarlog compression. pixarlog compands the input data preserving more data that is usually detectable by the human eye while creating files that compress much better than regular sixteen bit data. Pixar is donating pixarlog compression to the libtiff library maintained at Silicon Graphics so it will be available for use in other software.
packbits - provides Macintosh PackBits compression as defined in the TIFF 6.0 specification Section 9. This compression very portable. It is handled by most readers of TIFF files. Its drawback is that it does not compress as well as the other compression choices.
lzw - provides Lempel-Ziv & Welch compression as defined in TIFF 6.0 specification Section 13.
none - stores the file without compression. Output files can be quite large, but virtually any valid TIFF reader should be able to read them.
/display/texture/compression
/display/displaytmp/dir
/rixpluginpath
Sets the file search path for RIS shading plug-ins. This is equivalent to the call:
RiOption("searchpath", "rixplugin", (RtPointer)&*spath*, RI_NULL);
except that the configuration file changes the search path before any RIS shading plug-ins are loaded. See PRMan Options: Search Paths for details of the path format.
/standardrixpluginpath
Sets the string that will be the translation of the @ character for the /rixpluginpath default or RiOption call. The default value is:
${RMANTREE}/lib/RIS/pattern:${RMANTREE}/lib/RIS/bxdf:${RMANTREE}/lib/RIS/light:${RMANTREE}/lib/RIS/integrator:${RMANTREE}/lib/RIS/projection
/shaderpath
Sets the file search path for shader files. This is equivalent to the call:
RiOption("searchpath", "shader", (RtPointer)&*spath*, RI_NULL);
except that the configuration file changes the search path before any shaders (including defaultsurface) are loaded. See PRMan Options: Search Paths for details of the path format.
/standardshaderpath
/texturepath
Sets the file search path for texture files. This is equivalent to the call:
RiOption("searchpath", "texture", (RtPointer)&*tpath*, RI_NULL);
See PRMan Options: Search Paths for details of the path format.
/standardtexturepath
/prman/bucketsize
Sets the default bucketsize used by the renderer. The value should be two decimal numbers separated by a space. This is equivalent to the call:
RiOption("limits", "bucketsize", (RtPointer)&*bs*, RI_NULL);
See PRMan Options: Limits: Bucket Size for more details.
/prman/gridsize
Sets the default maximum gridsize used by the renderer. This is equivalent to the call:
RiOption("limits", "gridsize", (RtPointer)&*gs*, RI_NULL);
See PRMan Options: Limits: Grid Size for more details.
/prman/checkpoint/asfinal
Sets the renderer to output final images as checkpoints, allowing continued rendering even on images deemed complete.
**/prman/lpe/enableuserlobes **
/prman/texturememory
Sets the default size in kilobytes of the texture memory cache used by the renderer. This is equivalent to the call:
RiOption("limits", "texturememory", (RtPointer)&*tm*, RI_NULL);
See PRMan Options: Limits: Texture Memory for more details.
/prman/brickmemory
Sets the default size in kilobytes of the brick cache used by the renderer. This is equivalent to the call:
RiOption("limits", "brickmemory", (RtPointer)&*tm*, RI_NULL);
See PRMan Options: Limits: Texture Memory for more details.
/prman/raytrace/geocachememory
Sets the default size in kilobytes of the geometry cache used by the renderer for ray tracing. This is equivalent to the call:
RiOption("limits", "geocachememory", (RtPointer)&*tm*, RI_NULL);`
See PRMan Options: Ray Tracing for more details.
/prman/textureformat
/prman/texture/filesmargin
/prman/texture/maxfiles
/prman/texture3d/maxfiles
/prman/shadingrate
/prman/shading/debug
Sets the default shader debugging level. This is equivalent to the call:
RiOption("shading", "int debug", (RtPointer)&*debug*, RI_NULL);`
See PRMan Options: Shading for more details.
/prman/shading/defcache
Sets the default size of the shader definition cache. This is equivalent to the call:
RiOption("shading", "float defcache", (RtPointer)&*dc*, RI_NULL);
See PRMan Options: Shading for more details.
/prman/shading/objectcache
Sets the default size of the shader object cache. This is equivalent to the call:
RiOption("shading", "float objectcache", (RtPointer)&*oc*, RI_NULL);
See PRMan Options: Shading for more details.
/prman/lpe/macro/name
Declares a new Light Path Expression macro, for example:
/prman/lpe/macro/myDiffuse CD<L.>
See Light Path Expressions documentation for more details.
/prman/lpe/usernumber
Set a user signal LPE number (from 1 to 8). For example:
/prman/lpe/user2 Albedo
See Light Path Expressions documentation for more details.
/prman/RiSystem_ok
/prman/ribvarsubstchar
Sets the character used by the RIB parser to indicate variable expansion should occur. This is equivalent to:
RiOption("ribparse", "string varsubst", (RtPointer)&*vs*, RI_NULL);
See PRMan Options: RIB Authoring for more details.
/prman/hider/mpcachedir
Sets the default directory used for micropolygon cache files. This is equivalent to:
RiOption("stochastic", "string mpcachedir", (RtPointer)&*mpcd*, RI_NULL);
See PRMan Options: Hiders: Micropolygon Caching for more details.
/platform/linux/rtldglobalextension
Appendix A
Following is an example of typical overrides in a custom configuration file:
/displaytype/file tiff /display/tiff/compression zip /display/tiff/xres 640 /display/tiff/yres 480 /display/tiff/par 1 /errorpath ${RMANTREE}/etc/messages /dspyserver ${RMANTREE}/etc/dspyserver /licensefile ${RMANTREE}/etc/license.dat /licenseserver ${RMANTREE}/etc/pixar.license /standardshaderpath ${RMANTREE}/lib/shaders /standardtexturepath ${RMANTREE}/lib/textures /shaderpath .:@ /texturepath .:@ /prman/bucketsize 12 12 /prman/gridsize 512 /prman/texturememory 8192 /prman/shadingrate 1