This page has been translated automatically.
Видеоуроки
Interface
Essentials
Advanced
Подсказки и советы
Основы
Программирование на C#
Рендеринг
Принципы работы
Свойства (properties)
Компонентная Система
Рендер
Физика
Редактор UnigineEditor
Обзор интерфейса
Работа с ассетами
Настройки и предпочтения
Работа с проектами
Настройка параметров ноды
Setting Up Materials
Настройка свойств
Освещение
Landscape Tool
Sandworm
Использование инструментов редактора для конкретных задач
Extending Editor Functionality
Встроенные объекты
Ноды (Nodes)
Объекты (Objects)
Эффекты
Декали
Источники света
Geodetics
World Nodes
Звуковые объекты
Объекты поиска пути
Players
Программирование
Основы
Настройка среды разработки
Примеры использования
C++
C#
UnigineScript
Унифицированный язык шейдеров 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
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
Работа с контентом
Оптимизация контента
Материалы
Material Nodes Library
Art Samples
Tutorials

Unigine::LandscapeMapFileCompression Class

Header: #include <UnigineObjects.h>

Landscape Map File Compression class is used to compress and decompress .lmap file data using Zlib, LZ4, or Unigine's compression algorithm. The latter provides better compression results for 2D and 3D textures than LZ4 and Zlib without quality reduction.

LandscapeMapFileCompression Class

Enums

COMPRESSOR_TYPE#

NameDescription
COMPRESSOR_TYPE_NONE = 0No compression is used.
COMPRESSOR_TYPE_JACKALLESS = 1Our Method compression is used. It is optimized for compressing 2D and 3D textures and provides better results than LZ4 and Zlib without deteriorating the quality.
COMPRESSOR_TYPE_LZ4 = 2LZ4 compression is used (temporary option, planned to be removed in the upcoming releases).
COMPRESSOR_TYPE_ZLIB = 3Zlib compression (can provide up to 2 times higher compression ratio, but takes up to 20 times longer).

Properties

Members


LandscapeMapFileCompression ( ) #

Constructor.

bool isCompressing ( ) const#

Returns the value indicating if the compression is in progress.

Return value

true if the compression is running; otherwise, false.

bool isDecompressing ( ) const#

Returns the value indicating if the decompression is in progress.

Return value

true if the decompression is running; otherwise, false.

int getProgress ( ) const#

Returns the current landscape map file compression progress.

Return value

Current landscape map file compression progress (percentage).

bool run ( bool decompress, bool is_safe ) #

Runs the landscape map file compression/decompression process.

Arguments

  • bool decompress - true — the landscape map file will be decompressed, false — the landscape map file will be compressed.
  • bool is_safe - true to make the Engine automatically call filesClose()/fileOpen() methods when performing operations (before modifying an .lmap file the Engine should release files via filesClose(), while after modification fileOpen() should be called), false — to call filesClose()/fileOpen() methods manually.

    The Landscape class has two overloads for the filesClose() method:

    • filesClose() — to be called in case of moving an .lmap file (no data reloading is performed as the file itself was not modified — saves time on reloading data)
    • filesClose(reload_files) — to be called in case of deleting or modifying an .lmap file.
    Notice
    When is_safe = true the Engine shall always call filesClose(reload_files) with complete data reloading.

Return value

true if the operation is successful; otherwise, false.

void stop ( ) #

Stops the landscape map file compression/decompression process.

bool isLoaded ( ) const#

Returns a value indicating if the landscape map file (.lmap) is loaded.

Return value

true if the .lmap is loaded; otherwise, false.

bool load ( const UGUID& guid ) #

Loads the landscape map file (.lmap) having the specified GUID.

Arguments

  • const UGUID& guid - GUID of the landscape map file (.lmap) to be loaded.

Return value

true if the operation is successful; otherwise, false.

void setHeightCompressor ( LandscapeMapFileCompression::COMPRESSOR_TYPE compressor ) #

Sets the type of the compressor used for height data compression.

Arguments

LandscapeMapFileCompression::COMPRESSOR_TYPE getHeightCompressor ( ) const#

Returns the current type of the compressor used for height data compression.

Return value

Compressor type:
  • 0 – None
  • 1 – Our Method
  • 2 – LZ4
  • 3 – Zlib

void setAlbedoCompressor ( LandscapeMapFileCompression::COMPRESSOR_TYPE compressor ) #

Sets the type of the compressor used for albedo data compression.

Arguments

LandscapeMapFileCompression::COMPRESSOR_TYPE getAlbedoCompressor ( ) const#

Returns the current type of the compressor used for albedo data compression.

Return value

Compressor type:
  • 0 – None
  • 1 – Our Method
  • 2 – LZ4
  • 3 – Zlib

void setOpacityHeightCompressor ( LandscapeMapFileCompression::COMPRESSOR_TYPE compressor ) #

Sets the type of the compressor used for compression of the opacity height data.

Arguments

LandscapeMapFileCompression::COMPRESSOR_TYPE getOpacityHeightCompressor ( ) const#

Returns the current type of the compressor used for compression of the opacity height data.

Return value

Compressor type:
  • 0 – None
  • 1 – Our Method
  • 2 – LZ4
  • 3 – Zlib

void setMaskCompressor ( int mask, LandscapeMapFileCompression::COMPRESSOR_TYPE compressor_type ) #

Sets the type of the compressor used for the specified mask.

Arguments

void setMaskOpacityCompressor ( int mask, LandscapeMapFileCompression::COMPRESSOR_TYPE compressor_type ) #

Sets the type of the compressor used for the opacity data of the specified mask.

Arguments

void setCompressorAll ( LandscapeMapFileCompression::COMPRESSOR_TYPE compressor_type ) #

Sets the type of the compressor used to compress all data.

Arguments

bool isCompressed ( ) const#

Returns the value indicating if the .lmap file is compressed.

Return value

true if the file is compressed; otherwise, false.

int getMaskCompressor ( int mask ) #

Returns the current type of the compressor used for the specified mask.

Arguments

  • int mask - Mask number.

Return value

Compressor type:
  • 0 – None
  • 1 – Our Method
  • 2 – LZ4
  • 3 – Zlib

int getMaskOpacityCompressor ( int mask ) #

Returns the current type of the compressor used for the opacity data of the specified mask.

Arguments

  • int mask - Mask number.

Return value

Compressor type:
  • 0 – None
  • 1 – Our Method
  • 2 – LZ4
  • 3 – Zlib

void setEnabledAlbedoTextureCompression ( bool compression ) #

Sets the albedo texture compression enabled or disabled.

Arguments

  • bool compression - true to enable albedo texture compression; otherwise, false.

bool isEnabledAlbedoTextureCompression ( ) const#

Returns the value indicating if the albedo texture compression is enabled.

Return value

true if the albedo texture compression is enabled; otherwise, false.

void setEnabledOpacityHeightTextureCompression ( bool compression ) #

Sets the compression of the opacity height texture enabled or disabled.

Arguments

  • bool compression - true to enable compression of the opacity height texture; otherwise, false.

bool isEnabledOpacityHeightTextureCompression ( ) const#

Returns the value indicating if the compression of the opacity height texture is enabled.

Return value

true if the compression of the opacity height texture is enabled; otherwise, false.

void setEnabledMaskTextureCompression ( int mask, bool enable ) #

Enables or disables compression of the specified mask texture.

Arguments

  • int mask - Mask number.
  • bool enable - true to enable the mask texture compression; otherwise, false.

void setEnabledMaskOpacityTextureCompression ( int mask, bool enable ) #

Enables or disables compression of the specified mask opacity texture.

Arguments

  • int mask - Mask number.
  • bool enable - true to enable the compression of the mask opacity texture; otherwise, false.

bool isEnabledMaskTextureCompression ( int mask ) #

Returns a value undicating if the mask texture compression is enabled.

Arguments

  • int mask - Mask number.

Return value

true if the mask texture compression is enabled; otherwise, false.

bool isEnabledMaskOpacityTextureCompression ( int mask ) #

Returns the value indicating if the compression of the mask opacity texture is enabled.

Arguments

  • int mask - Mask number.

Return value

true if the mask opacity texture compression is enabled; otherwise, false.

UGUID getGUID ( ) const#

Returns a GUID of the .lmap file containing landscape map data.

Return value

GUID of the .lmap file.

void setCacheDirectory ( const char * directory ) #

Sets a path to the directory that is used to store the cache. By default the cache is located in the same place where the UnigineEditor's cache is (you can find it in the UnigineEditor Settings tab). If there is not enough memory, you can use another disk. A full copy of the current terrain will be temporarily stored in the cache directory, so you should take this into account when estimating the cache size. SSD is recommended for fast data copying.

Arguments

  • const char * directory - The path to the directory that stores the cache.

const char * getCacheDirectory ( ) const#

Returns the current path to the directory that is used to store the cache.

Return value

The path to the directory that stores the cache.
Last update: 29.09.2021
Build: ()