Below are the current options and their defaults.
Name and parameters | Type | Default | Description |
---|---|---|---|
bucket:order | string | [“horizontal”] | Render bucket order: “horizontal”, “vertical”, “zigzag-x”, “zigzag-y”, “spacefill”, “random”, “spiral”, or “circle”. |
bucket:orderorigin | integer[2] | [-1 -1] | First bucket for “spiral” and “circle” order. Image center is [-1 -1]. |
checkpoint:asfinal | integer | [0] | Write checkpoint as final image or remove display channels. |
checkpoint:command | string | [] | Command to run at each checkpoint. |
checkpoint:exitat | string | [] | Time to checkpoint and abort render, e.g. “1h30m” for 1 hour 30 min. |
checkpoint:interval | string | [] | Time between checkpoints, e.g. “1h30m” for 1 hour 30 min. |
checkpoint:keepfiles | integer | [0] | Individually name and preserve checkpoint renders. |
curve:minwidth | float | [0] | Minimum curve width in raster coordinates. Curves smaller than minwidth |
deep:flagvolumes | integer | [1] | Off [0], auto (off for dtex, on otherwise) [1], or on [2] |
dice:offscreenmultiplier | float | [1] | Dicing rate multiplier for objects outside the viewing frustum. See dice:micropolygonlength. |
dice:triangle | string | [“trim”] | The method used for dicing “triangles”. The default method “trim” renders triangles by trimming a quad. The “blp” method renders a quad with two points being coincident. |
hider:adaptall | integer | [0] | Enable adaptive sampling of all AOVs. Otherwise adaptive sampling is driven by “Ci,a”, i.e. rgba, the Beauty render |
hider:darkfalloff | float | [0.025] | This prevents oversampling in dark areas of an image. Higher values may erode sampling in brighter areas |
hider:extrememotiondof | integer | [0] | |
hider:incremental | integer | [0] | Incremental rendering renders passes of samples instead of bucket/tile-based. Some integrators (PxrVCM) enforce incremental |
hider:maxsamples | integer | [0] | The upper limit of samples per pixel |
hider:minextrasamples | integer | [-1] | Takes additional samples when recovering from a checkpoint to determine variance and then continues to sample |
hider:minsamples | integer | [-1] | The minimum samples per pixel. 0 is a special case where minsamples is the square root of the maxsamples |
hider:pixelfiltermode | string | [“weighted”] | Weighted pixel filtering may appear to converge more quickly but Importance is required for all denoising applications as well the improved adaptive sampler (enforced) |
hider:samplemotion | integer | [1] | Take more motion samples to improve the shape of curved paths. While this is a global control, it's more efficient to set on shape that require it |
hider:sampleoffset | integer | [0] | Offset RNG sample sequence. |
hider:type | string | [“raytrace”] | Render mode “raytrace” or “bake”. |
limits:brickmemory | integer | [2097152] | Brickmap cache size in kB (2048 MB). |
limits:bucketsize | integer[2] | [16 16] | Sets the bucket size in pixels |
limits:deepshadowerror | float | [0.01] | Useful for rendering deep images where samples can be merged |
limits:geocachememory | integer | [2097152] | Geometry cache size in kB (2048 MB). |
limits:gridsize | integer | [289] | Description (17 x 17 = 289) |
limits:matrixcachememory | integer | [0] | Matrix cache in kB. |
limits:nurbcurvaturedicefactor | integer | [3] | NURBs max curvature multiplier. |
limits:octreememory | integer | [20480] | None cache size in kB (20 MB). |
limits:opacitycachememory | integer | [1048576] | Opacity cache in kB (1024 MB). |
limits:othreshold | float[3] | [0.99609375 0.99609375 0.99609375] | Opacity threshold (255/256). |
limits:pointmemory | integer | [20480] | Point cache size in kB (20 MB). |
limits:proceduralbakingclumpsize | integer | [0] | Description. Only used for `prman -capture` |
limits:ptexturemaxfiles | integer | [128] | |
limits:ptexturememory | integer | [32768] | PTex cache size in kB (32 MB). |
limits:rendermemory | float | [0] | Memory limit as percentage of machine memory. |
limits:rendertime | integer | [0] | Maximum render time in minutes. |
limits:shadesize | integer | [289] | The maximum number of vertices, not grid (17 x 17 = 289). |
limits:texturememory | integer | [2097152] | Texture cache size in kB (2048 MB). |
limits:textureperthreadmemoryratio | float | [0.5] | |
limits:threads | integer | [0] | Number of render threads. |
lpe:customLPE:<name> | string | <lpe> | Name custom LPE |
lpe:diffuse1 | string | [] | D1 diffuse lobe name for light path expressions. |
lpe:specular1 | string | [] | S1 specular lobe name for light path expressions. |
lpe:user1 | string | [] | U1 user lobe name for light path expressions. |
procedural:splitmode | integer | [0] | Split on demand [0], up front [1], or hybrid [2]. |
Ri:CropWindow | float[4] | [0 1 0 1] | Crop window [left right top bottom] in NDC space. |
Ri:FormatPixelAspectRatio | float | [1] | Device pixel aspect ratio. |
Ri:FormatResolution | integer[2] | [640 480] | Device resolution. |
Ri:Frame | integer | [0] | Frame number. |
Ri:FrameAspectRatio | float | [-1] | |
Ri:PixelVariance | float | [0.001] | The main control for frame quality, lowers numbers improve quality at the cost of computation, 0.001 is extremely high quality |
Ri:ScreenWindow | float[4] | [0 0 0 0] | Screen window [left right top bottom] in screen space. |
Ri:Shutter | float[2] | [0 0] | Scene motion shutter, open and close |
ribparse:varsubst | string | [] | RIB parse only. |
scenedump:filename | string | [] | Path to dump RIB scene for rendermode “catrib”. |
searchpath:archive | string | [] | Search path for Rib archives and DelayedReadArchive. |
searchpath:dirmap | string | [] | Search path remapping. |
searchpath:display | string | [] | Search path for display plug-ins. |
searchpath:procedural | string | [] | Search path for DynamicLoad procedural plug-ins. |
searchpath:rifilter | string | [] | Search path for Rif plug-ins. |
searchpath:rixplugin | string | [] | Search path for shading plug-ins. |
searchpath:shader | string | [] | Search path for OSL pattern plug-ins. |
searchpath:texture | string | [] | Search path for texture files. |
shade:debug | integer | [0] | Shading debug level. |
shade:derivsfollowdicing | integer | [1] | |
shade:frequencyframetime | float | [-inf] | Shading time for frequency “frame”. |
Shutter:offset | float | [0] | Offset shutter open/close. |
statistics:displace_ratios | float[2] | [0.1 1] | |
statistics:filename | string | [] | |
statistics:iotracefilename | string | [] | |
statistics:level | integer | [0] | The verbosity of stats output |
statistics:maxdispwarnings | integer | [100] | |
statistics:shaderprofile | string | [] | |
statistics:stylesheet | string | [] | |
statistics:texturestatslevel | integer | [0] | |
statistics:trackassetobjects | integer | [0] | |
statistics:xmlfilename | string | [] | The name of the xml stats file to write |
stitch:refwarning | integer | [1] | Enable stitch warnings. |
trace:depthmode | string | [“separate”] | Integrators track diffuse/specular depth “separate” or “combined”. |
trace:maxdepth | integer | [25] | Maximum ray depth. |
trace:worldoffset | float[3] | [0 0 0] | World origin offset value when trace:worldorigin is set to “worldoffset”. |
trace:worldorigin | string | [“camera”] | Compute world origin offset value as “camera”, “world”, or “worldoffset”. |
user:<name> | <type> | <value> | Arbitrary global user data. |
volume:aggregateprecision | float | [1] | Aggregate volume precision, effecting memory usage. |