This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
UnigineEditor
Interface Overview
Assets Workflow
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Landscape Tool
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Camera Effects

A camera effects list contains features specific to the usual SLR camera. To tweak, use Rendering panel -> Camera Effects.

Camera Effects Applied to Viewport

Camera Effects

Exposure#

Exposure settings
Camera Mode The camera mode, which determines the way the exposure is set. Either of the following:
  • Physically-Based - the real-world values are used to set up lighting and camera exposure: ISO, shutter speed, F-stop. With the default values of these parameters, the static exposure value is near 1.
    Notice
    For the physically-based mode, the exposure mode should be set to Static to avoid exposure issues.
  • Classic - the exposure is set by the Exposure value.
Option #1 is selected by default (see above).
Console access: render_camera_mode
Exposure Mode The mode of the adaptive exposure effect.
  • Static — a static exposure. The amount of luminance is determined by the Exposure depending on the Camera Mode parameter.
  • Logarithmic adaptive — adaptive logarithmic mapping technique.
  • Quadratic adaptive — adaptive quadratic mapping technique.
Option #1 is selected by default (see above).
Console access: render_exposure_mode

Classic Camera Model Settings#

Exposure The camera exposure (a multiplier of the scene luminance and brightness).

It determines the resulting amount of luminance:

  • By the minimum value of 0.0f, the image is rendered black.
  • The higher the value, the more luminance and the brighter the scene lit.
Available only when the Camera Mode is set to Classic.
Range of values: [0.0f, 4.0f]. The default value is 0.0f.
Console access: render_exposure
Exposure = 0.2
Exposure = 1

Physically Based Camera Model Settings#

ISO The ISO value used for static exposure calculation. This value is available for the physically-based camera and represents the sensitivity of the camera sensor. The higher the ISO number, the more light is collected and the brighter the image is.
Range of values: [0, inf]. The default value is 100.
Console access: render_iso
Shutter Speed The shutter speed used for static exposure calculation. This setting is available for the physically-based camera and indicates how long the sensor of the camera is actively collecting light. Higher values make the shutter speed faster and the image — darker.
Range of values: [0, inf]. The default value is 250.
Console access: render_shutter_speed
F-Stop The f-stop value used for static exposure calculation. This setting is available for the physically-based camera and represents the ratio of the focal length (f) and the diameter of the lens opening (D): f / D. It is the reciprocal of the relative aperture. The higher the value, the darker the image is.
Range of values: [0, inf]. The default value is 11.
Console access: render_f_stop

Logarithmic or Quadratic Adaptive Settings#

Adaptation The time for the camera to adjust exposure, in seconds. 0.0f - means instant adaptation. If a too small or even negative value is provided, 1E-6 will be used instead.
Range of values: [0.0f, inf]. The default value is 1.0f.
Console access: render_exposure_adaptation
Min Luminance

The minimum luminance offset relative to the default luminance of the scene used for rendering of the adaptive exposure effect. The higher the value, the darker the adapted image is.
The parameter can take on negative values.

Notice
If the specified value is greater than the current maximum luminance, the maximum luminance value will be changed to the specified minimum luminance so that they are equal.
Min Luminance = -1
Min Luminance = 2
Max Luminance

The maximum luminance offset relative to the default luminance of the scene used for rendering of adaptive exposure effect. The lower the value, the brighter the adapted image is.
The parameter can take on negative values.

Notice
If the specified value is less than the current minimum luminance, the minimum luminance value is changed to the specified maximum luminance so that they are equal.

Motion Blur#

Motion Blur The value indicating if the motion blur effect is enabled. Enabled by default.
Console access: render_motion_blur
Preset The Motion Blur preset. One of the following values:
  • Low (by default)
  • Medium
  • High
  • Ultra
  • Custom

Console access: render_motion_blur_preset
Notice
Presets override user-defined custom settings. When any preset other than Custom is active, modification of the parameters via API has no effect. The parameter value set via the last API call shall be used only when the Custom preset is active. When checking the current parameter value via API you'll get the corresponding setting stored in the active preset (default or custom one).

Customizable Settings#

The following settings are available when the Custom preset is selected.

Motion Blur custom settings

Motion Blur Settings
Velocity The scale value of bodies' linear and angular velocities used for the motion blur. The higher the value, the more blurred the objects will appear when moving. To use this option, rendering of the motion blur effect should be enabled.
Range of values: [0.0f, inf]. The default value is 1.0f.
Console access: render_motion_blur_velocity_scale
Maximum Velocity The maximum possible amount of motion blur for moving physical objects. When their body velocity exceeds the set value, they will be blurred as if they have the maximum velocity set by the parameter.

This parameter should be used:

  • To avoid excessive blurring of fast moving objects.
  • To save performance, as increasing the object's velocity leads increasing the radius of the motion blur effect that drops performance at too high values.
To use this option, rendering of the motion blur effect should be enabled.
Range of values: [0.0f, inf]. The default value is 1.0f.
Console access: render_motion_blur_max_velocity
Num Steps The number of steps used in the motion blur. The higher the value, the more correct the motion blur effect is. At low values, moving objects may look doubled, however, performance will increase. To use this option, rendering of the motion blur effect should be enabled.
Range of values: [2, 64]. The default value is 8.
Console access: render_motion_blur_num_steps
Noise Intensity The intensity of the noise used in the motion blur. To use this option, rendering of the motion blur effect should be enabled.
Range of values: [0.0f, 1.0f]. The default value is 0.5f.
Console access: render_motion_blur_noise_intensity
Neat Silhouettes The value indicating if neat silhouettes option for motion blur is enabled. This option keeps contours of objects in front of the camera unblurred. To use this option, rendering of the motion blur effect should be enabled. Enabled by default.
Console access: render_motion_blur_neat_silhouettes
Camera Velocity The value indicating if camera velocity contributes to the motion blur effect (false to take into account velocities of objects only). To use this option, rendering of the motion blur effect should be enabled.
Notice
Disabled in VR mode by default.
Enabled by default.
Console access: render_motion_blur_camera_velocity

Depth Of Field#

Depth Of Field The value indicating if the DOF (Depth Of Field) effect is enabled. Enabled by default.
Console access: render_dof
Preset The DoF effect quality preset. One of the following values:
  • Very Low (by default)
  • Low
  • Medium
  • High
  • Ultra
  • Extreme
  • Custom

Console access: render_dof_preset
Notice
Presets override user-defined custom settings. When any preset other than Custom is active, modification of the parameters via API has no effect. The parameter value set via the last API call shall be used only when the Custom preset is active. When checking the current parameter value via API, you'll get the corresponding setting stored in the active preset (default or custom one).
Focal Distance The focal distance of the camera, i.e. a point where objects are in-focus and visible clearly.
Range of values: [0.0f, inf]. The default value is 1.0f.
Console access: render_dof_focal_distance

Blur The intensity of blur for the DOF (Depth Of Field) effect.
Range of values: [0.0f, inf]. The default value is 1.0f.
Console access: render_dof_blur

Chromatic Aberration The intensity of chromatic aberration for the DOF (Depth Of Field) effect.
Range of values: [0.0f, inf]. The default value is 0.0f.
Console access: render_dof_chromatic_aberration

Near#

Distance The near DOF limit of the camera: the distance between the camera and the first element that is considered to be acceptably sharp. Black zone on the DOF mask means in-focus zone.
Range of values: [0.0f, inf]. The default value is 10.0f.
Console access: render_dof_near_distance
Near Distance = 10
Near Distance = 10
Near Distance = 1.5
Near Distance = 1.5
The black zone on the DoF mask means in-focus zone.
Focal offset The offset from the focal to the nearest blurred zone. In other words, the distance when foreground (near) is in focus.
Range of values: [0.0f, inf]. The default value is 0.0f.
Console access: render_dof_near_focal_offset

Far#

Distance The far DOF limit of the camera: the distance between the camera and the furthest element that is considered to be acceptably sharp. Black zone on the DOF mask means in-focus zone.
Range of values: [0.0f, inf]. The default value is 10.0f.
Console access: render_dof_far_distance
Far Distance = 10
Far Distance = 10
Far Distance = 1.5
Far Distance = 1.5
The black zone on the DoF mask means in-focus zone.
Focal offset The Sets the offset from the focal to the farthest blurred zone for the DOF effect. In other words, the distance when background (far) is in focus.
Range of values: [0.0f, inf]. The default value is 0.0f.
Console access: render_dof_far_focal_offset

Bokeh#

Shape The shape of the Bokeh for the DOF effect. This parameter determines the way the lens renders out-of-focus points of light.
Notice
For the DOF effect, the Bokeh effect is enabled by default.
One of the following values:
  • ring (by default)
  • circle

Console access: render_dof_bokeh_mode

Customizable Settings#

The following settings are available when the Custom preset is selected.

DOF custom settings

DOF Settings
Quality The quality of the DOF (Depth Of Field) effect. One of the following values:
  • Low - low quality
  • Medium - medium quality (by default)
  • High - high quality
  • Ultra - ultra quality

Console access: render_dof_quality
Resolution The resolution of the DOF (Depth Of Field) effect. One of the following values:
  • quarter
  • half
  • full (by default)

Console access: render_dof_resolution
Increased Accuracy The value indicating if the increased accuracy option is enabled for the DOF (Depth Of Field) effect. When enabled, focusing calculation is performed with increased accuracy. Enabled by default.
Console access: render_dof_increased_accuracy

Focus Improvement The value indicating if the focus improvement option is enabled for the DOF (Depth Of Field) effect. When enabled, transitions between the focused and unfocused parts of the scene become more accurate. Enabled by default.
Console access: render_dof_focus_improvement

Glare Effects#

Threshold The brightness threshold, which is used to detect if an object should be blurred in the HDR mode. By the minimum value of 0, the bright areas can become overexposed.
Range of values: [0.0f, inf]. The default value is 1.0f.
Console access: render_camera_effects_threshold
Threshold = 0.6
Threshold = 1.2
Dirt Scale The intensity of lens dirt effect modulating the pattern of lens flares defined by the Dirt Texture. For example, it can be used to create an effect of unclean optics when the camera looks at the sun.
Range of values: [0.0f, 1.0f]. The default value is 0.5f.
Console access: render_dirt_scale
Dirt

A texture that creates an effect of dirty camera lens. For example, it can be used to create an effect of light reflections or unclean optics when the camera looks at the sun.

Example of dirt texture
No dirt texture
Custom dirt texture
Notice
If you can't see any effect of the Dirt texture, try tweaking the Threshold parameter.
Temporal Filtering The value indicating if temporal filtering for camera effects is enabled. Temporal filtering reduces flickering of the bloom effect on the small bright objects (such flickering may appear when the camera moves). For example, it can be used in scenes with industrial pipes. Enabled by default.
Console access: render_camera_effects_temporal_filtering

Bloom#

Bloom settings
Enabled The value indicating if the Bloom effect is enabled. Enabled by default.
Console access: render_bloom
Resolution The resolution of the Bloom effect. One of the following values:
  • quarter
  • half
  • full (by default)

Console access: render_bloom_resolution
Scale The scale of the Bloom effect.
Range of values: [0.0f, 1.0f]. The default value is 0.3f.
Console access: render_bloom_scale
Power The power of the Bloom effect.
  • 0.0f (min) - the Bloom effect is blurred.
  • 1.0f (max) - the Bloom effect is more contrast.

Range of values: [0.0f, 1.0f]. The default value is 0.7f.
Console access: render_bloom_power
Passes The number of passes for the bloom effect. During the pass a Bloom texture is generating. Up to 8 Bloom textures can be generated: each texture has lower resolution (original size, original size /2, original size /4, so forth) with Bloom effect. After that, all these Bloom textures with the different resolution form the final Bloom texture.
Notice
The higher the value, the smoother the effect is. However, this option significantly affects performance.

Range of values: [2, 8]. The default value is 6.
Console access: render_bloom_passes

Cross#

Cross Settings
Enabled The value indicating if cross flares are enabled. Enabled by default.
Console access: render_cross
Color The color of the cross flares. To use this option, rendering of cross flares should be enabled.
vec4_one - default value (white)
Console access: render_cross_color
Scale The color multiplier.cross color scale — a multiplier for the color of cross flares. Higher values produce more pronounced flares. To use this option, rendering of cross flares should be enabled.
Range of values: [0.0f, inf]. The default value is 1.0f.
Console access: render_cross_scale
Scale = 0.4 (by default)
Scale = 0.7
Shafts The number of shafts in a cross flare. High number of flares can cause a FPS drop on low-performance hardware. To use this option, rendering of cross flares should be enabled.
Range of values: [2, 32]. The default value is 4.
Console access: render_cross_shafts
Shafts = 2 (minimum)
Shafts = 6 (by default)
Shafts = 32 (maximum)
Length The length of a cross flare relative to the screen width. Increasing this value also leads to fading of the shafts across their length. To use this option, rendering of cross flares should be enabled.
Range of values: [0.0f, 2.0f]. The default value is 0.2f.
Console access: render_cross_length
Length = 0.2 (by default)
Length = 0.4
Angle The cross flares orientation angle. To use this option, rendering of cross flares should be enabled.
Range of values: [-inf, inf]. The default value is 45.0f.
Console access: render_cross_angle
Angle = 45 (by default)
Angle = 90
Threshold The brightness threshold for areas to produce flare. The higher the threshold value, the brighter the area should be to produce a flare. To use this option, rendering of cross flares should be enabled.
Range of values: [0.0f, inf]. The default value is 0.0f.
Console access: render_cross_threshold

Lens#

Lens settings
Enabled The value indicating if lens flares are enabled. Enabled by default.
Console access: render_lens
Color The color of HDR lens flares. To use this option, rendering of lens flares should be enabled.
vec4_one - default value (white)
Console access: render_lens_color
Scale The multiplier for color of HDR lens flares. To use this option, rendering of lens flares should be enabled.
Range of values: [0.0f, inf]. The default value is 1.0f.
Console access: render_lens_scale
Scale = 0.25
Scale = 0.5
Length The length of the radial lens flare 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. To use this option, rendering of lens flares should be enabled.
Range of values: [0.0f, 1.0f]. The default value is 0.5f.
Console access: render_lens_length
Radius The radius of the spherical lens flares on the screen. 1.0f corresponds to a screen-wide radius (a lens flare is not visible). To use this option, rendering of lens flares should be enabled.
Range of values: [0.0f, 1.0f]. The default value is 0.5f.
Console access: render_lens_radius
Radius = 0.07
Radius = 0.1
Threshold The value of the brightness threshold for areas to produce lens flares. The higher the threshold value, the brighter the area should be to produce flares. To use this option, rendering of lens flares should be enabled.
Range of values: [0.0f, 1.0f]. The default value is 0.5f.
Console access: render_lens_threshold
The color displacement for red, green, and blue channels of the lens flares. Can be used to create light dispersion (chromatic aberrations). If a negative value is set for a channel, 0 will be used instead. To use this option, rendering of lens flares should be enabled.
vec3_one - default value
Console access: render_lens_dispersion
Red

Color displacement for the red channel of lens flares.

Red = 0.9
Red = 1
Red = 1.1
Green

Color displacement for the green channel of lens flares.

Green = 0.9
Green = 1
Green = 1.1
Blue

Color displacement for the blue channel of lens flares.

Blue = 0.9
Blue = 1
Blue = 1.1

Sharpness#

Sharpness The value indicating if the sharpening post-processing effect is enabled. Enabled by default.
Console access: render_sharpen
Sharpen Intensity The intensity of the sharpening effect.intensity of the sharpening effect. To use this option, sharpening post-processing effect should be enabled.
Range of values: [0.0f, inf]. The default value is 0.5f.
Console access: render_sharpen_intensity
Last update: 2021-12-13
Build: ()