This page has been translated automatically.
Видеоуроки
Interface
Essentials
Advanced
Подсказки и советы
Программирование на C#
Рендеринг
Принципы работы
Свойства (properties)
Компонентная Система
Рендер
Физика
Редактор UnigineEditor
Обзор интерфейса
Работа с ассетами
Настройки и предпочтения
Работа с проектами
Настройка параметров узла
Setting Up Materials
Setting Up Properties
Освещение
Landscape Tool
Sandworm
Использование инструментов редактора для конкретных задач
Extending Editor Functionality
Встроенные объекты
Nodes
Objects
Effects
Decals
Geodetics
World Objects
Sound Objects
Pathfinding Objects
Players
Программирование
Основы
Настройка среды разработки
Примеры использования
UnigineScript
C++
C#
Унифицированный язык шейдеров UUSL
File Formats
Rebuilding the Engine Tools
GUI
Двойная точность координат
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
Работа с контентом
Оптимизация контента
Материалы
Art Samples
Tutorials
Внимание! Эта версия документация УСТАРЕЛА, поскольку относится к более ранней версии SDK! Пожалуйста, переключитесь на самую актуальную документацию для последней версии SDK.
Внимание! Эта версия документации описывает устаревшую версию SDK, которая больше не поддерживается! Пожалуйста, обновитесь до последней версии SDK.

Planar Reflection Probe

Planar Reflection Probe represents a planar surface that captures and projects a reflection relative to the camera onto a surface just like a mirror. For each visible Planar Reflection Probe on the scene a new temporary texture is created every frame.

The texture is projected on a surface placed behind the Planar Reflection Probe. With Planar Reflection Probe you can create flat mirrors and flat dynamic reflective surfaces: parquet, flat varnished surfaces, etc.

Notice
The reflections of one Planar Reflection Probe will not be rendered in the reflections of another Planar Reflection Probe (there are no "reflections in reflections").

See also#

Adding a Planar Reflection Probe#

To add a Planar Reflection Probe node to the scene via UnigineEditor, do the following:

  1. On the Menu bar, click Create -> Lights -> Planar Reflection Probe.
  2. Place the Planar Reflection Probe onto the surface that you want to make reflective so that the probe would intersect the surface.

  3. Decrease the Roughness parameter of the surface so that it doesn't go beyond the Roughness Visibility Min and Roughness Visibility Max range.
  4. Adjust the Metalness parameter of the surface material: higher values make the reflection more visible.

  5. Adjust Planar Reflection Probe settings to achieve the desired reflection result. Available parameters are described below.
    Notice
    Each Planar Reflection Probe renders the scene one more time, thus, using multiple reflections may significantly affect performance.

Planar Reflection Probe Settings#

The Planar Reflection Probe settings can be found in the Node tab of the Parameters window. This tab includes both the parameters attributable to all light sources and the parameters specific for the probe. Planar Reflection Probe parameters are split into:

  1. Common Parameters for light and rendering configuration.
  2. Planar Reflection Parameters for reflection configuration.

Common Parameters#

Projection Size Defines the box-shaped influence volume around the probe, in units, in which reflective surfaces (having the appropriate roughness values) shall use the results captured by the probe.
Attenuation Power Sets the attenuation power for the projection. The higher the value, the faster the projection decays within the attenuation area.
Attenuation Distance The attenuation distance specifies how far the projection can reach any surfaces from the Probe position. It also specifies the attenuation area around the Probe at which the projection starts to fade out at the specified rate.
Color Sets the color modifier in the RGBA format for the projection that works like a filter. It can be useful when you need to artificially paint over the reflection in some color, or darken it. But if you need a physically correct reflection, then the color has to be strictly white.
Intensity

Sets the light color multiplier, which provides fine control over color intensity of the projection:

  • The minimum value of 0 removes projection brightness and makes it invisible.
  • The higher values make a more bright and intense color of projection.
Viewport Mask Sets the viewport mask for the Planar Reflection Probe.
Visibility Distance Distance from the camera in units, up to which reflected projection will be rendered.
Fade Distance Distance from the camera in units, starting from which the Planar Reflection Probe starts to fade out gradually.
Render on Water Toggles rendering of reflections on the water surface.
Render on Transparent Toggles rendering of reflections on transparent objects.

Planar Reflection Parameters#

Reflection Viewport Mask The reflection mask that controls rendering of the Planar Reflection Probe reflections into the reflection camera viewport. Objects with matching viewport masks will be rendered.
Map Size

Specifies the reflection’s texture resolution in pixels. The texture is squared (height and width are equal).

Notice
Using high-resolution maps for reflections may significantly affect performance, as dynamic reflections are rendered each frame.
Two Sided Enables projection for both sides. If this parameter is on, then the reflection will be projected from both sides of the Planar Reflection Probe in opposite directions.
Roughness Samples

Sets the number of samples used to adjust quality of the blurring effect for the reflection on rough surfaces.

  • The lowest value of 0 means that the blurring of projection is made using only mipmaps.
  • Higher values result in better blurring quality, as more more randomized samples are used.
Notice
Rougher materials require more samples for smoother blurring reflection, but setting too high number of samples may cause a performance drop.
Roughness Visibility Min Lower surface roughness limit, starting from which the reflection starts to fade out gradually.
Roughness Visibility Max Upper surface roughness limit, starting from which the reflection completely disappears.
Distance Scale Global distance multiplier within the range of [0.0f;100.0f] for the reflection LODs visibility distance. Distance Scale is applied to the distance measured from the reflection camera to the node (surface) bound.
Notice
This option enables rendering of less detailed LODs for reflections to increase performance.
Reflection Distance The render distance for the reflection that specifies how far from the camera the reflection will be rendered.
Parallax

Degree of reflection distortion within the range of [0;1]. Distortion depends on an angle between the probe plane and the surface onto which the probe projects reflection. Increasing the value amplifies visual distortion as a result of increasing this angle.

Noise Intensity Additional jitter for roughness samples that creates a noise effect on the reflection. Higher values make the noise effect more noticeable.
Reflection Offset Z axis offset (relative to the probe local coordinate system) for the reflection. Can be used to change the viewpoint of the reflection camera moving it forward or backwards relative to the probe.
ZNear Distance to the near clipping plane defining a frustum to be used for grabbing reflections.
ZFar Distance to the far clipping plane defining a frustum to be used for grabbing reflections.
Notice
The higher the value, the more distant objects will be rendered, therefore high values are not recommended due to possible performance hit.
Visibility Sky Renders sky in the reflection. Can be used, when the reflection is supposed to reflect closeby objects only.
Last update: 09.04.2021
Build: ()