Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Add TOC

Table of Contents

Common

Name
Type
Default
Description
hider:adaptallint0Enable adaptive sampling of all AOVs. When enabled, all channels (beauty pass + AOVs) are considered when deciding if a pixel is converging. The default (off) will ignore the AOVs and only the beauty pass is considered for pixel convergence. So turning off "adaptall" may speed up your render if some of your AOVs never reach the specified variance threshold. Value range: true/false.
hider:darkfallofffloat0.025De-prioritize low luminance samples in the adaptive sampler. Use this parameter to avoid oversampling dark areas while maintaining overall image quality. Higher values cull more samples, speeding up render time while increasing noise in darker areas. Value range: 0 to 1.
hider:extrememotiondofint0Enable improved sampling accuracy. In some cases where a large amount of motion blur is used with depth of field, sampling artifacts could cause an undesirable result. This flag causes a slower but more accurate sampling method to be used to alleviate the artifacts. Due to the performance degradations of this sampling method, this flag should only be used when necessary. Value range: true/false.
hider:incrementalint0Enables the progressive display of results (rather than bucketed results). Value range: true/false.
hider:maxsamplesint0An explicit limit for the number of samples. If maxsamples is equal to its default then the maximum number of samples will be set equal to 64. Note that minsamples defaults to the square root of the maxsamples setting. Value range: 0 or more.
hider:minextrasamplesint-1This is the minimum number of extra samples that a pixel should continue shooting with after a sample fails to meet its convergence test with the adaptive sampler. Defaults to matching minsamples.
hider:minsamplesint-1Specifies the minimum number of samples for adaptive sampling. The default value is the square root of maxsamples.
hider:pixelfiltermodestringweightedSpecifies how pixel filtering of camera samples is performed. "Weighted" is the standard method and blends together samples from neighboring pixels. "Importance" warps the samples in screen space around the pixel center and does not share samples between pixels. It may be noisier, but is needed by some postprocessing algorithms. It is also needed to produce variance AOVs. Supported values: weighted, importance.
hider:samplemotionint1This option toggles the sampling of motion blurred micropolygon in the hider, and is thus only meaningful if motion blur is being used in your scene. By default, this hider option is enabled (set to 1), meaning that micropolygons will be blurred and sampled in the hider. When disabled (set to 0), micropolygons will no longer be blurred before sampling; however, the dPdtime variable will still be computed for all objects. This variable can be output into a separate image using an arbitrary output variable (aov) and used to perform motion blur as a postprocess. Value range: true/false.
hider:sampleoffsetint0This allows several images to be rendered in parallel (with different sampleoffset values) and then combined. With non-adaptive sampling: Let's say you render four images with 256 samples each, with sampleoffsets 0, 256, 512, and 768. If you combine those four images, you'll get exactly the same image as if you had rendered a single image with 1024 samples. With adaptive sampling: Let's say you again render four images, each with "maxsamples" 256, with sampleoffsets 0, 256, 512, and 768. Let's say that due to adaptive sampling, some given pixel only gets 64 pixel samples in each of the four images. Then the combined image has been rendered with sample numbers 0-63, 256-319, 512-575, and 768-831. Due to the stratification of the samples, this is not quite as good as if you had rendered a single image with 256 consecutive samples. However, it is still better than rendering a single image with only 64 samples.
hider:typestringraytraceRender mode. Supported values: raytrace, bake.
Ri:Frameint0Frame number.
Ri:PixelVariancefloat0.001Controls adaptive sampling. This sets the upper bound on the acceptable estimated variance of the pixel values from the true pixel values. Value range: 0 to 1.
Ri:Shutterfloat[2]0 0Scene motion shutter.
Shutter:offsetfloat0Offset shutter open/close.

...