This page has been translated automatically.
Видеоуроки
Интерфейс
Основы
Продвинутый уровень
Подсказки и советы
Основы
Программирование на C#
Рендеринг
Профессиональный уровень (SIM)
Принципы работы
Свойства (properties)
Компонентная Система
Рендер
Физика
Редактор UnigineEditor
Обзор интерфейса
Работа с ассетами
Контроль версий
Настройки и предпочтения
Работа с проектами
Настройка параметров ноды
Setting Up Materials
Настройка свойств
Освещение
Sandworm
Использование инструментов редактора для конкретных задач
Расширение функционала редактора
Встроенные объекты
Ноды (Nodes)
Объекты (Objects)
Эффекты
Декали
Источники света
Geodetics
World-ноды
Звуковые объекты
Объекты поиска пути
Player-ноды
Программирование
Основы
Настройка среды разработки
Примеры использования
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Плагины
Форматы файлов
Материалы и шейдеры
Rebuilding the Engine Tools
Интерфейс пользователя (GUI)
Двойная точность координат
API
Animations-Related Classes
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
Работа с контентом
Оптимизация контента
Материалы
Визуальный редактор материалов
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Учебные материалы

Unigine::TerrainDetailMask Class

Header: #include <UnigineObjects.h>

This class is used to manage detail masks of the Landscape Terrain Object. Each detail mask can have an unlimited number of details, defining its appearance. Detail masks are rendered in accordance with their rendering order (the one with the highest order shall be rendered above all others).

TerrainDetailMask Class

Members


void setName ( const char * name ) #

Sets a new name for the detail mask.

Arguments

  • const char * name - New terrain detail mask name to be set.

const char * getName ( ) #

Returns the name of the detail mask.

Return value

Current name of the detail mask.

void setEnabled ( bool enabled ) #

Sets a value indicating if the terrain detail mask is enabled.

Arguments

  • bool enabled - true to enable the terrain detail mask, false - to disable it.

bool isEnabled ( ) #

Returns a value indicating if the terrain detail mask is enabled.

Return value

true if the terrain detail mask is enabled; otherwise, false.

int getRenderOrder ( ) #

Returns rendering order of the detail mask. Rendering order of masks can be changed via the swapRenderOrder()method.

Return value

Rendering order of the detail mask in the [0; 19] range.

void swapRenderOrder ( const Ptr<TerrainDetailMask> & mask ) #

Swap rendering order of this detail mask with the specified one.

Arguments

  • const Ptr<TerrainDetailMask> & mask - Target detail mask.

Ptr<TerrainDetail> addDetail ( ) #

Adds a new detail for this mask.

Return value

New detail added for this mask.

int getNumDetails ( ) #

Returns the number of details of this detail mask.

Return value

Number of details of this detail mask.

Ptr<TerrainDetail> getDetail ( int num ) #

Returns a detail by its index.

Arguments

  • int num - Detail index.

Return value

Detail with the specified index (if it exists); otherwise, an assertion failure error is reported.

int isDetail ( const Ptr<TerrainDetail> & detail ) #

Checks if the specified detail belongs to this detail mask.

Arguments

Return value

1 if the specified terrain detail belongs to this mask; otherwise, 0.

int findDetailIndex ( const char * name ) #

Returns a detail index by its name.

Arguments

  • const char * name - Detail name.

Return value

Index of the detail having the specified name (if it exists); otherwise, -1.

Ptr<TerrainDetail> findDetail ( const char * name ) #

Returns a detail attached to the detail mask by its name.

Arguments

  • const char * name - Detail name.

Return value

Detail with the specified name (if it exists); otherwise, nullptr.

void setDetailIndex ( const Ptr<TerrainDetail> & detail, int index ) #

Replaces a detail with a given index with the specified detail.

Arguments

  • const Ptr<TerrainDetail> & detail - Detail to be set instead of the one with the given index.
  • int index - Index of the detail to be replaced with the specified one.

int getDetailIndex ( const Ptr<TerrainDetail> & detail ) #

Returns the index of the specified detail.

Arguments

Return value

Index of the specified detail (if it exists); otherwise, -1.

void swapDetail ( int num_0, int num_1 ) #

Swaps the two details with given indices.

Arguments

  • int num_0 - First detail index.
  • int num_1 - Second detail index.

int getIndex ( ) #

Returns the index of the detail mask.

Return value

Index of the detail mask in the [0; 19] range.

void setDithering ( float dithering ) #

Sets a new dither amount for the detail mask of the landscape terrain. Dithering enables reduction of graphical artefacts in case of increased Mask Contrast values set for details. This value is multiplied by the global dither amount.

Arguments

  • float dithering - New dither amount to be set for the detail mask in the [0.0f; 1.0f] range.

float getDithering ( ) const#

Returns the current dither amount for the detail mask of the landscape terrain. Dithering enables reduction of graphical artefacts in case of increased Mask Contrast values set for details. This value is multiplied by the global dither amount.

Return value

Current dither amount for the detail mask in the [0.0f; 1.0f] range.

void setDefaultValue ( float value ) #

Sets a default (background) value to be used for the mask.

Arguments

  • float value - Value to be used for the mask as default.

float getDefaultValue ( ) const#

Returns the current default (background) value for the mask.

Return value

Value currently used for the mask as default.

void setMaskByAlbedo ( const Math::vec4 & albedo ) #

Sets a new albedo color to be used as a mask.

Arguments

  • const Math::vec4 & albedo - Albedo color to be used as a mask, as a four-component vector (R,G,B,A)..

Math::vec4 getMaskByAlbedo ( ) const#

Returns the albedo color currently used as a mask.

Return value

Albedo color currently used as a mask, as a four-component vector (R,G,B,A).
Last update: 08.09.2022
Build: ()