Contents
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. |