render.settings.RenderSettings

render.settings.RenderSettings(
    resolution=(200, 200),
    max_steps=96,
    max_distance=20.0,
    hit_epsilon=0.001,
    step_scale=0.9,
    normal_epsilon=0.001,
    shadow_steps=32,
    shadow_distance=20.0,
    shadow_hardness=12.0,
    ambient=0.12,
    aa_samples=1,
    silhouette_smoothing=0.75,
    exposure=1.0,
    tone_mapping='aces',
    gamma=2.2,
    reflect_steps=0,
    refract_steps=0,
)

Quality and performance controls for the forward renderer.

Use :meth:draft, :meth:balanced, or :meth:high_quality as clear starting points, then override individual fields with :func:dataclasses.replace when a scene needs different trade-offs.

Methods

Name	Description
balanced	Balanced default with soft shadows and 2x2 supersampling.
draft	Fast interactive preview with direct light and no secondary visibility.
high_quality	Higher precision, denser visibility sampling, and 3x3 SSAA.

balanced

render.settings.RenderSettings.balanced(resolution=(200, 200))

Balanced default with soft shadows and 2x2 supersampling.

draft

render.settings.RenderSettings.draft(resolution=(200, 200))

Fast interactive preview with direct light and no secondary visibility.

high_quality

render.settings.RenderSettings.high_quality(resolution=(400, 400))

Higher precision, denser visibility sampling, and 3x3 SSAA.