Rendering Settings
This panel allows adjusting the rendering settings of the world and can be invoked by pressing the R key (see Controls and Navigation). The panel has a set of tabs given below.
Common
This tab contains the basic settings.
Distance scale | Global distance scale for all distance parameters, such as the world rendering distance, shadow distance, LOD distances etc. This option allows a developer to easily increase or decrease rendering performance by changing the world extent.
|
||
---|---|---|---|
World distance | Distance after which all nodes are not rendered or simulated (infinite by default). The distance is measured from the camera to the node. If the camera is within node bounds, the node is rendered no matter the World distance set (as in case with a ground on the picture below).
|
||
Light distance | Distance after which the dynamic lights are not be rendered.
|
||
Object distance | Distance after which objects are not be rendered. | ||
Shadow distance | Distance after which the shadows from light sources are not be rendered.
|
||
Physics distance | Distance after which physical interactions will not be calculated. All physics-based nodes freeze if the distance between them and the camera is bigger than the Physics distance.
|
||
Decal distance | Distance after which decals will not be rendered. | ||
Clutter distance | Distance after which clutter objects will not be rendered. | ||
Reflection distance | Distance after which reflection will not be rendered. | ||
Field distance | Distance, at which (and farther) fields are not rendered. | ||
World budget | World generation time budget for the Grass and Clutter objects in frames per second. | ||
Physics budget | Physics simulation time budget in frames per second. | ||
Render budget | Render creation time budget in frames per second. The render budget limits the number of loaded / created graphics resources during frame according to the loading / creation time. | ||
Ambient color | The color used to color all objects during the ambient rendering passes.
|
||
Reflection color | Color that allows to adjust reflections of all meshes with reflective materials, i.e.:
|
||
Background color | Solid color rendered on the scene background. It For example, this option allows to create brighter, richer sky colors with light scattering.
|
||
Environment | Environment cube map texture for image-based ambient lighting (light that is independent of direction). It realistically simulates light that comes from six main directions (per cube side). For example, objects are rendered bluish at the top (due to the sky color) and grayish or brownish at the bottom (due to the ground color).
Load, view or clear the environment cube-mapped texture. To grab an environment texture, use Tools -> Grabber -> Mode: Cube. A very small texture can be used, 32x32 pixels is enough.
Environment texture (can be smaller)
Here is how the environment texture can increase the quality of the rendered scene.
|
||
Exposure | The brightness of ambient lighting according to the environment texture.
|
||
Render | Render postprocess materials applied before all other Unigine postprocess (such as HDR, DOF, etc.) are rendered. Several materials are separated by a comma (without whitespace). Custom postprocesses can also be set. For example, post_filter_scattering is set here. This way, subsurface scattering will be rendered first, and then correctly blurred with DOF. |
||
Composite | This field allows to set the name of a custom composite shader. It will be used for the final composition of the full-screen image instead of the default one. | ||
Post | Post postprocess materials applied at the end, after all other postprocess (such as HDR, DOF, etc.) are rendered. Such postprocesses, when applied to the screen image, affect HDR flares, glowing areas and so on. Several materials are separated by a comma (without whitespace). Custom postprocesses can also be set.
Here is an example with post_blur_radial material.
Radial blur post material
|
Parameters
The tab contains different parameters that control some node or material settings across the whole world. That includes tessellation, vegetation animation and light probes.
Stereo distance | This option is only for custom stereo rendering (available stereo modes have their own viewing settings). The focal distance. It is the distance in the world space to the point where two views line up, i.e. distance to the zero parallax plane. |
---|---|
Stereo radius | This option is only for custom stereo rendering (available stereo modes have their own viewing settings). The radius of stereo (half of the separation distance between the cameras, i.e. between eyes). |
Stereo offset | A virtual camera offset (an offset after the perspective projection). |
Animation stem | Global scale for movement amplitude of vegetation stems. It scales Stem offset parameter for mesh_stem_base, mesh_leaf_base and grass_base materials. |
Animation leaf | Global scale for rotation angle of vegetation leaves. It scales the Leaf offset parameter for mesh_leaf_base material. |
Animation scale | Global scale for speed of vegetation swaying. It scales Stem scale and Leaf scale parameters for mesh_stem_base, grass_base and mesh_leaf_base materials. |
Animation wind | A multiplier for the stem offset under wind. It sets the direction of wind for all vegetation (grass and trees). |
Global mask | A mask that determines rendering of the LightProb-based global illumination. For the LightProb to light a scene around it, at least one bit of this mask should match the light mask.of the probe light. |
Global distance | A distance up to which the LightProb-based global illumination is rendered. |
Global attenuation | An attenuation factor for the LightProb-based global illumination. The larger this value is, the smoother and across the larger distance the global illumination fades out. |
Global bias | The Fresnel effect bias for specular highlights when rendering the LightProb-based global illumination. The higher the value, the brighter specular highlights are at all viewing angles. |
Global power | The Fresnel effect power for specular highlights when rendering the LightProb-based global illumination. It defines the amount of reflectance depending on the viewing angle:
|
Global diffuse | A diffuse light multiplier for the LightProb-based global illumination. |
Global specular | A specular light multiplier for the LightProb-based global illumination. |
Occlusion
The tab contains settings related to both screen-space ambient occlusion mapping and indirect illumination.
The following settings are used for the screen-space ambient occlusion:
Ambient screen radius | Distance in the screen space, within which the geometry is sampled to compute self-shadowing. The number of sampled points is strictly defined and depends on shader quality.
|
---|---|
Ambient sample radius | Distance for each of the points in the world space, up to which they can shadow their neighbouring points:
|
Ambient perspective | Perspective compensation for the ambient occlusion. When at the far distance, the sample radius will be automatically increased, if a value higher than 1 is set. |
Ambient attenuation | Coefficient that compensates for falloff of the ambient occlusion with a distance, making it more prominent. The lower the value, the less the ambient occlusion effect fades out with the distance. |
Ambient threshold | Depth threshold used to filter ambient occlusion. It specifies the maximum possible depth between sampled points in two pixels, to filter them together. This option allows you to have sharp edges, while having smooth ambient occlusion on flat surfaces. |
Ambient emitter normal | Coefficient indicating if the points can shadow their neighbouring points in all directions or only along their normal vectors.
|
Ambient receiver normal | Coefficient indicating if the points can be shadowed by other points from all directions or only along their normal vectors.
|
Ambient scale | Brightness of shadows:
|
Ambient power | Power of the ambient occlusion. For this parameter the Ambient scale should not equal 0.
|
The following settings are used for the screen-space indirect illumination:
Light screen radius | Distance in the screen space, within which the geometry and its color are sampled to compute indirect illumination. The number of sampled points is strictly defined and depends on shader quality.
|
---|---|
Light sample radius | Distance for each of the points in the world space, up to which they can illuminate their neighbouring points:
|
Light perspective | Perspective compensation for the light (directional) occlusion. When at the far distance, the sample radius will be automatically increased, if a value higher than 1 is set. |
Light attenuation | Coefficient that compensates for falloff of the light (directional) occlusion with a distance, making it more prominent. The lower the value, the less the global illumination effect fades out with the distance. |
Light threshold | Depth threshold used to filter light (directional) occlusion. It specifies the maximum possible depth between sampled points in two pixels, to filter them together. This option allows you to have sharp edges, while having smooth global illumination on flat surfaces. |
Light emitter normal | Coefficient indicating if the points can illuminate their neighbouring points in all directions or only along their normal vectors.
|
Light receiver normal | Coefficient indicating if the points can be illuminated by other points from all directions or only along their normal vectors.
|
Light scale | Brightness scale for indirect illumination.
|
Light power | Power of indirect illumination.
|
Scattering
The tab contains settings of atmospheric light scattering.
In the editor and in the world camera clipping settings may differ, causing different colors.
Sun color | The color of the solar disk. |
---|---|
Ray color | The color used for the Rayleigh scattering (scattering of small molecules). |
Mie color | The color used for the Mie scattering (scattering of larger particles). |
Inner angle | The angle forming the inner circle of the solar disk, which has the defined brightness.
|
Outer angle | The angle forming the fading outer circle of the solar disk.
|
Refractive | Atmosphere refractive index (for Rayleigh scattering):
|
Density | The number of molecules per unit volume (for Rayleigh scattering):
|
Depolarization | The depolarization factor (for Rayleigh scattering):
|
Turbidity | The atmosphere turbidity (for Mie scattering):
|
Ground level | The ground zero level:
|
Aerial | Aerial perspective scale:
|
Ray height | The height in units up to which Rayleigh scattering is spread. |
Mie height | The height in units up to which Mie scattering is spread. |
Angularity | A coefficient that compensates for the angular distribution of Rayleigh light scattering. This compensation allows creating a uniformly lit sky instead of a physically-correct one that depends on the sun angle. |
Threshold | Distance threshold for Mie scattering:
|
Direction | Direction of light scattering. |
Default | The default scattering settings. |
Greenstein | The directionality factor of light scattering by small particles (for Mie scattering):
|
Energy | The intensity of the sunlight.
|
Power | Scattering power that determines the distance to apply scattering attenuation (both Mie and Rayleigh):
|
Sun | The brightness of the solar disk. |
Ray | Rayleigh scattering intensity. |
Mie | Mie scattering intensity. |
Earth | Sets all of the scattering parameters to the Earth's ones. |
Postprocess
The tab contains settings for rendering post-processes: motion blur, volumetric shadows and glow.
Refraction red | Refraction displacement for red channel (based on the refraction texture of refractive materials). It can be used to create light dispersion (chromatic aberrations).
|
||
---|---|---|---|
Refraction green | Refraction displacement for green channel (based on the refraction texture of refractive materials). It can be used to create light dispersion (chromatic aberrations).
|
||
Refraction blue | Refraction displacement for blue channel (based on the refraction texture of refractive materials). It can be used to create light dispersion (chromatic aberrations).
|
||
Motion blur linear | Amount of the motion blur when the player moves linearly.
|
||
Motion blur angular | Amount of the motion blur when the player rotates.
|
||
Motion blur velocity | Amount of the motion blur for the moving physical objects (with physical bodies assigned).
|
||
Maximum velocity | The maximum possible amount of the motion blur for moving physical objects. When their body velocity exceeds the the set value, they still will not be blurred any further. | ||
Volumetric exposure | The exposure used for rendering volumetric shadows:
|
||
Volumetric length | The length of volumetric shadows:
|
||
Volumetric attenuation | How fast volumetric shadows fade out along their length:
|
||
Glow threshold | The brightness threshold, which is used to detect, if an object is bright enough to produce glow:
|
||
Glow small | Brightness of the small-radius glow. This glow effect is rendered most close to the glowing surface and creates object-shaped highlight.
|
||
Glow medium | Brightness of the medium-radius glow. This glow effect creates a medium-sized halo close to the glowing surface.
|
||
Glow large | Brightness of the large-radius glow. This glow effect creates a large-sized halo around the glowing surface.
|
DOF
The tab contains settings used to create the depth of field effect.
Effect is represented as Gaussian blur DOF and set via render_dof 1 console command.
To create the DOF effect in your application, you need to do three basic things:
- Set the point of focus with the Focal distance.
- Set the length of in-focus area with non-zero Near blur range (before the point of focus) and Far blur range (after the point of focus).
- Set the Far blur radius and Near blur radius.
Focal distance | The focal distance of the camera. It sets a line where objects are in focus and can be seen clearly.
If the Focal distance is set to 0 (i.e. objects right in front of the camera are in focus), there is no near blurring distance. It means that all the other Near parameters are ignored.
|
||
---|---|---|---|
Far blur range | Far blur range is measured from the Focal distance point and away from the camera. It sets the length of the area (in units) within which objects are focused out, i.e. become blurred in the background.
|
||
Far blur radius | Far blur radius is used for the out-of-focus objects that are outside Far blur range.
|
||
Far blur power | Far blur power acts the same way as the Near blur power — it determines how fast the objects become blurred across the far blur range.
|
||
Far focal range | Far focal range determines the area between the focal point and objects in crisp focus (not blurred). | ||
Far focal scale | Far focal csale is an interpolation coefficient between a non-blurred screen image and a blurred one. Shifts the Far blur range closer to the camera.
|
||
Far focal power | Far focal power also acts the same way as the Near focal power. It allows to adjust the DOF across the far blur range. But unlike the Far blur power, it tweaks both the rate of blurring and intensity of bokeh at the same time.
|
||
Near blur range | Near blur range is measured from the Focal distance point towards the camera. It sets the length of the area (in units) within which objects are focused on, i.e. become clearly seen.
|
||
Near blur radius | Near blur radius is used for the out-of-focus objects that are outside Near blur range.
|
||
Near blur power | Near blur power determines how fast the objects become blurred across the near blur range.
|
||
Near focal range | Near focal range determines the area between the focal point and objects in crisp focus (not blurred). | ||
Near focal scale | Near focal csale is an interpolation coefficient between a non-blurred screen image and a blurred one. Shifts the Near blur range closer to the camera.
|
||
Near focal power | Near focal power also allows to adjust the DOF across the near blur range. But unlike the Near blur power, it tweaks both the rate of blurring and intensity of bokeh at the same time.
|
HDR
The tab contains properties of high-dynamic range rendering.
Filmic
The filmic HDR provides better image quality. It lightens the darkest image regions and makes the lightest regions darker.
- HDR is enabled on the Main Settings panel
- The Use filmic and Use srgb options are checked on the Tools->Render panel
Shoulder Scale | The Shoulder Strength filmic tone mapping parameter value that is used to change bright values.
|
||
---|---|---|---|
Linear Scale | The Linear Strength filmic tone mapping parameter value that is used to change grey values. The Linear Scale controls the length of the tone mapping curve linear part.
|
||
Linear Angle | The Linear Angle filmic tone mapping parameter value. This parameter controls the slope of the linear part of the tone mapping curve.
|
||
Toe Scale | The Toe Strength filmic tone mapping parameter value that is used to change dark values. The Toe Scale controls the slope of the tone mapping curve toe (the area of underexposure).
|
||
Toe Numerator | The Toe Numerator filmic tone mapping parameter value. | ||
Toe Denominator | The Toe Denominator filmic tone mapping parameter value. | ||
White Level | The Linear White Point filmic tone mapping parameter value, which is mapped as pure white in the resulted image.
|
All of this parameters represent the tone mapping curve, which is constructed by using the following formula:
- A - Shoulder Scale
- B - Linear Scale
- C - Linear Angle
- D - Toe Scale
- E - Toe Numerator
- F - Toe Denominator
For more details about tone mapping curve construction see the article on An efficient and user-friendly tone mapping operator.
Cross Flares
Enabled | Enable cross flares.
Cross flares
|
---|---|
Color | The color of a cross flares. |
Scale | A multiplier for a color of HDR cross flares. |
Shafts | The number of shafts in a cross flare.
|
Length | The length of cross flare shafts. |
Angle | Cross flares orientation angle. The default is 45 degrees. |
Threshold | Brightness threshold for areas to produce flare:
|
Bokeh
The bokeh effect is rendered only if HDR and DOF options are enabled at the same time (Esc to open the Main menu -> Render tab -> Post-processing -> DOF and HDR checked).
Enabled | Enable the bokeh effect. It is rendered for bright lights or emissive materials only across the DOF-blurred range.
Bokeh effect
|
||
---|---|---|---|
Color | The color multiplier for the bokeh effect. It allows to change the tint of the bokeh effect or decrease its brightness if a dark color is set. | ||
Scale | The numerical multiplier for the bokeh effect. The higher the value, the brighter the bokeh effect is. | ||
Far size | The size of the bokeh effect across the far blur range of DOF.
|
||
Far power | Controls how fast the bokeh effect appears between objects in focus and out of focus across the far blur range of DOF.
|
||
Near size | The size of the bokeh effect across the near blur range of DOF.
|
||
Near power | Controls how fast the bokeh effect appears between out-of-focus and objects in focus across the near blur range of DOF.
|
||
Threshold | Brightness threshold for areas to create a bokeh effect:
Threshold = 0.5
Threshold = 2 (only the brightest objects have the bokeh effect)
|
||
Iris | A custom texture for the bokeh effect. |
Shaft Flare
Enabled | Enable light shaft. Light shaft is a halo only around the sun. Unlike other types of flares, light shaft is not produced by bright surfaces.
Shaft flare around the sun
|
---|---|
Color | The color of light shaft. |
Scale | A multiplier for a color of HDR shaft flares. |
Length | Length of light shaft. |
Attenuation | How fast the flares fade out along their length:
|
Threshold | Brightness threshold for sun to generate light shaft:
|
Lens Flares
Enabled | Enable lens flares.
Lens flares
|
---|---|
Color | The color of lens flares. |
Scale | A multiplier for a color of HDR lens flares. |
Length | Length indicating if the whole radial lens flare is rendered on the screen or only a part of it. This option controls how lens flares pattern is distributed. |
Radius | A radius of the spherical lens flares on the screen. |
Threshold | The brightness threshold for areas to produce flare:
|
Red | Color displacement for the red channel of the lens flares. |
Green | Color displacement for the green channel of the lens flares. |
Blue | Color displacement for the blue channel of the lens flares. |
Dirt | A texture that modulates the pattern of lens flares. For example, it can be used to create an effect of light reflections or unclean optics when the camera looks at the sun. |
Color
The tab contains settings for color correction of the scene.
Brightness | Correction of the overall scene brightness:
|
---|---|
Contrast | Correction of the overall scene contrast:
|
Saturation | Correction of the overall scene saturation:
|
Gamma | Correction of the overall scene gamma. |
White | White balance of the scene. |
LUT texture | The loading, viewing or clearing of the Look-Up Table texture for color transformation. |