UnigineEditor
界面概述
资产工作流程
设置和首选项
项目开发
调整节点参数
Setting Up Materials
Setting Up Properties
照明
Landscape Tool
Sandworm (Experimental)
使用编辑器工具执行特定任务
Extending Editor Functionality
编程
基本原理
搭建开发环境
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine Tools
GUI
双精度坐标
应用程序接口
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

Voxel Probe

Voxel Probe is a light source which provides static voxel lighting and shading on an object inside the probe by using a prebaked 3D lighting map. Unlike Environment Probe, Voxel Probe provides physically accurate light spreading inside interiors and outdoor static scenes but supports diffuse reflections only.

Also, Voxel Probe is great solution for shading dynamic objects within static areas.

Notice
Surfaces with Lightmaps enabled are not illuminated by voxel probes.

See Also#

Overview#

Voxel Probe provides box volume composed of voxels and contains parameters used for light baking inside it.

Voxel Probe projects a 3D lighting texture on objects inside it thus providing indirect lighting simulation.

Notice
For a transparent object (with Alpha Blending enabled) to be affected by Voxel Probes you should toggle on the Multiple Environment Probes state of its material and enable the Multiple Environment Probes feature (via Rendering -> Transparent -> Multiple Environment Probes).
The texture should have an appropriate resolution which is calculated the following way:

Resolution = Width × Height × (Depth × 6)

Each pixel of a texture defines the illuminance of a certain voxel face.

An example of a 3D lighting texture

Voxel Probe is a required object for the Bake Lighting feature, which enables you to generate a lighting texture for the probe and simulate global illumination with indirect lighting for both, interiors and outdoor scenes.

Notice
By default Voxel Probes are used for lighting only, as for reflectons, it is recommended to simulate them using Environment Probes. This approach ensures the best result, however you can still enable reflections for a Voxel Probe.

Adding Voxel Probe#

To add a Voxel Probe object to the scene via UnigineEditor, do the following:

  1. On the Menu bar, click Create -> Light -> Voxel Probe.

  2. Place the probe somewhere in the world.
  3. Bake Lighting or set the Texture parameter by choosing a prebaked lighting texture from assets.
Notice
Use the Cast GI option to define if a surface should be baked to voxel probes.

Voxel Probe Settings#

Parameters of the voxel probe light are available in the Node tab of the Parameters window. It includes both the common and the specific parameters. A set of parameters specific for voxel probes is described below.

Warning
Do not use the SCALE transform parameter to change the probe size as it causes visual artifacts.

Voxel Probe parameters

Common Parameters#

Box Size Specifies the size of the box volume.
Voxel Size Sets the size of a voxel.
Notice
If the Box Size is not divisible to the Voxel Size without remainder, the voxel probe uses the lowest volume of voxels covering the box.
Notice
These two parameters define the resolution of the voxel probe. Note that the memory usage is cubically dependent on the resolution, double growth of the voxel size causes eight-times growth of the size of the lighting texture.

Render Parameters#

Additive Blending Enables the additive blending mode for the voxel probe. This option offers more flexibility in lighting control. You can use it to blend lighting of several voxel probes together and control them separately (e.g. make a separate voxel probe for an indoor emissive light source and blend it with another voxel probe with lighting baked from the sky, having the ability to enable and disable them separately).
Notice
Voxel probes with additive blending enabled cannot be used as insets to add lighting details (e.g. creating a small high-detail voxel probe inside a large low-detail one). Such probes do not replace each other, as they are blended instead.
Use Sun Color Enables the influence of sun light color on the voxel probe. When enabled, this option makes the voxel probe color black at night, or orange at sunset.
Notice

To bake lighting from the sky separately with this option enabled, it is recommended to enable baking visibility for the sky only, while disabling it for other light sources.

Changing this option requires the lighting to be re-baked.

Ambient Parameters#

Bias Sets the bias of ambient lighting by adjusting the voxels offset for fine tuning.
Cubic Filtering Enables the cubic filtering of ambient lighting.
Notice
When disabled, the linear filtering is used.

Reflections Parameters#

Enabled Enables reflections for the Voxel Probe. By default Voxel Probes are used for lighting only, as for reflectons, it is recommended to simulate them using Environment Probes. This approach ensures the best result, however you can still enable reflections for a Voxel Probe via this option.
Visibility Roughness Min Sets the lower bound of the roughness range within which the reflections of the voxel probe are visible.
Visibility Roughness Max Sets the higher bound of the roughness range within which the reflections of the voxel probe are visible.
Notice
The roughness range helps to choose between diffuse reflection of the voxel probe and other ones (reflection from an environment probe, the environment cubemap) for all materials having the Roughness parameter.
Bias Sets the bias of reflection by adjusting the voxels offset for fine tuning.
Cubic Filtering Enables the cubic filtering of reflection.
Notice
When disabled, the linear filtering is used.

Baking Settings#

Notice
The following parameters describe the way the light shall be baked inside the probe, so you need to re-bake lighting, when you make changes to these parameters.
Baking Viewport Mask Sets the baking viewport mask which specifies the surfaces to be baked basing on their material's Viewport Mask.
Far Clipping Sets the distance to the far clipping plane used for every voxel during light baking.
Notice
An extremely big difference between the Near and Far Clipping Planes can cause baking the space into black. Therefore, if the required Far Clipping Plane value is outside the range, adjust the Near Clipping value proportionately.
Bake Quality Defines the baking quality preset for the voxel probe.
  • Draft option provides the highest iterativity with the lowest sampling quality and number of rays simulated.
  • Low option provides low sampling quality and number of light rays simulated.
  • Medium option corresponds to stable quality level which is good for most cases.
  • High option corresponds to high sampling quality and number of light rays simulated intended for release production.
  • Ultra baking quality might be useful to get rid of small inconsistencies on the release production.
Bake Internal Volume Defines the mode of internal volume baking of Voxel Probe.
  • Off option allows baking the voxels that cover geometry and skipping the empty ones. The lighting inside the empty voxels is interpolated between neighboring baked voxels.
  • Full option corresponds to baking all voxels of the probe in the full resolution.
  • Half option corresponds to baking all voxels of the probe as follows: voxels that cover geometry are baked in the full resolution and empty voxels are baked in the half resolution.
Notice
Having baked internal volume makes it possible to realistically shade dynamic objects that move inside the voxel probe as the lighting texture is projected onto all the geometry.
Notice
You can use the following 7 visibility options together with additive blending to provide more flexibility in light baking. Thus, you can make voxel probes independent of each other and combine them to produce some sort of dynamic GI effect.
Visibility Sky Enables baking of lighting from the sky to the voxel probe.
Visibility Light World Enables baking of world light sources to the voxel probe.
Visibility Light Omni Enables baking of omni light sources to the voxel probe.
Visibility Light Proj Enables baking of projected light sources to the voxel probe.
Visibility Voxel Probe Enables baking of other voxel probe light sources to the voxel probe.
Visibility Environment Probe Enables baking of environment probe light sources to the voxel probe.
Visibility Emission Enables baking of emission light sources to the voxel probe.
Visibility Lightmap Enables baking of lightmapped surfaces to the voxel probe.
Texture Sets the 3D lighting texture.
Notice
Every bake lighting procedure makes changes to the asset which is set for this parameter.
You can leave the field empty to avoid losing content. In this case a new generated lighting texture will be set for this parameter after the bake lighting procedure. Generated textures are stored in the data/bake_lighting folder.
Last update: 2020-11-11