/
Environment Variables

Environment Variables

Environment Variables are a way to communicate vital information to RenderMan before rendering, including the locations for installation directory, licensing, plugins, custom shaders, and more.

 

RenderMan Pro Server

Env Variable

Type

Default

Description

Env Variable

Type

Default

Description

RMANTREE

string

Linux: /opt/pixar/RenderManProServer-26.0

Windows: C:\Program Files\Pixar\RenderManProServer-26.0

macOS: /Applications/Pixar/RenderManProServer-26.0

Location of RenderMan Pro Server

RMAN_CONFIG_OVERRIDE

string

 

Additional directory to search for Rendermn.ini

RMAN_STATS_CONFIG_PATH

string

 

Directory to search for stats.ini; see Configuration of Stats

RMAN_DUMP_DEFAULTS

string

 

For debugging purposes only. If set to any value, all settings read from Rendermn.ini will be printed on startup

RMAN_DUMP_FILELOG

string

 

For debugging purposes only. If set to value, a log of all files opened directly by the renderer will be reported on stdout.

RMAN_SHADERPATH

 

string

$RMANTREE/lib/shaders

Location of OSL shaders

RMAN_RIXPLUGINPATH

 

string

$RMANTREE/lib/plugins

 

Location of C++ plugins

PIXAR_LICENSE_FILE

string

Linux: /opt/pixar/pixar.license

Windows: C:\Program Files\Pixar\pixar.license

macOS: /Applications/Pixar/pixar.license

Large site: 9010@license-server

Location of the RenderMan license file

OCIO

string

 

Location of OpenColorIO configuration file.

RILEY_CAPTURE

string

 

Location of Disgust trace for scenegraph serialization output. Useful for submitting interactive bugs.

RILEY_CAPTURE_FORMAT

string

 

Format for Disgust trace. Can be either python or json.

RMAN_ASSET_LIBRARY

string

$RMANTREE/lib/RenderManAssetLibrary/

Location for Preset Browser Library

RIFORMAT

string

ascii

Controls RIB output. Setting this variable to the value “binary” overrides format of RIB output to be binary if the format isn’t directly specified.

RIASCIISTYLE

string

 

Controls RIB output. If the current output is ascii, and the RIASCIISTYLE variable contains the substring “indented”, the output will be indented by enclosing Begin/End blocks. If this substring contains “wide”, the individual RIB statements will not be broken by newlines.

RICOMPRESSION

string

 

Controls RIB output. If set to the value “gzip” and no compression is explicitly selected, the output will be compressed using the gzip algorithm.

RIPRECISION

integer

 

Controls RIB output. If the format is current ASCII, setting RIPRECISION to a numerical value controls the number of decimal points used to representing float values.

 

RenderMan XPU

Env Variable

Type

Default

Description

Env Variable

Type

Default

Description

CUDA_CACHE_DISABLE, CUDA_CACHE_PATH, CUDA_CACHE_MAXSIZE

string

 

Configure the CUDA JIT Cache. Please refer to https://docs.nvidia.com/cuda/cuda-c-programming-guide/index.html#env-vars for more details

CUDA_VISIBLE_DEVICES

string

 

 

 

Configure the GPU devices visible to XPU, which may be useful to ensure execution on a particular device. Please refer to https://docs.nvidia.com/cuda/cuda-c-programming-guide/index.html#env-vars for more details.

 

Solaris / openUSD / hdPrman

Env Variable

Type

Default

Description

Env Variable

Type

Default

Description

HD_PRMAN_NTHREADS

int

 

Limits the number of threads for hdPrman

 

RenderMan for Maya

Env Variable

Type

Default

Description

Env Variable

Type

Default

Description

RFMTREE

string

Linux: /opt/pixar/RenderManForMaya-26.0

Windows: C:\Program Files\Pixar\RenderManForMaya-26.0

macOS: /Applications/Pixar/RenderManForMaya-26.0

Location of RenderMan for Maya

MAYA_MODULE_PATH

string

Linux: ~/maya/2024/modules

Windows: ~\Documents\maya\2024\modules

macOS: ~/Library/Preferences/Autodesk/maya/2024/modules

 

 

Location of module file which contains RfM install location

MAYA_PLUG_IN_PATH

string

$RMANTREE/plug-ins/

Location of RenderMan for Maya

 

RenderMan for Katana

Env Variable

Type

Default

Description

Env Variable

Type

Default

Description

KATANA_RESOURCES

 

string

Linux: /opt/pixar/RenderManForKatana-26.0/plugins/katana6.5

Windows: C:\Program Files\Pixar\RenderManForKatana-26.0\plugins\katana6.5

macOS: /Applications/Pixar/RenderManForKatana-26.0/plugins/katana6.5

Location of RenderMan for Katana

DEFAULT_RENDERER

string

prman

Change default Katana renderer to RenderMan

RFK_REDIRECT_OUTPUT

string

 

Path to render log

FNPXR_PLUGINPATH

string

$KATANA_RESOURCES/plugins/katana6.0/usd

Location of hdPrman plugin that ships with RfK

 

RenderMan for Houdini

Env Variable

Type

Default

Description

Env Variable

Type

Default

Description

RFHTREE

 

string

Linux: /opt/pixar/RenderManForHoudini-26.0/

Windows: C:\Program Files\Pixar\RenderManForHoudini-26.0

macOS: /Applications/Pixar/RenderManForHoudini-26.0

Location of RenderMan for Houdini

HOUDINI_PATH

string

$RFHTREE/3.9/19.5.805:&

Version of Houdini plugin

RMAN_PROCEDURALPATH

string

$RFHTREE/3.9/19.5.805/openvdb:&

Location of VDB procedural

 

RenderMan for Blender

Env Variable

Type

Default

Description

Env Variable

Type

Default

Description

RMAN_SHADERPATH

string

$RMANTREE/lib/shaders

Location of OSL shaders

RMAN_RIXPLUGINPATH

string

$RMANTREE/lib/plugins

Location of C++ plugins

RMAN_TEXTUREPATH

string

$RMANTREE/lib/textures

Location of textures

RFB_SITE_PATH

string

 

Path to custom configuration. See Customizing Blender

RFB_LOG_LEVEL

string

WARNING

Changes the log level. This overrides the level set in the preferences.

RFB_DUMP_RIB

int

 

If set to 1, a RIB file will be written for each render. On macOS and Linux this is written to: /var/tmp. On Windows: C:/tmp/

Related content