This page has been translated automatically.
Interface Overview
Settings and Preferences
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Landscape Tool
Using Editor Tools for Specific Tasks
Setting Up Development Environment
Usage Examples
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine and Tools
Double Precision Coordinates
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
CIGI Client Plugin
Rendering-Related Classes
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.

Texture Import Guide

You can import textures in convenient formats (such as .tga, .jpg, .png .hdr etc.). As you import a texture via the Asset Browser, using drag and drop or the Import button, the following import settings are displayed. These settings can also be changed later via the Parameters window

Import settings for a texture asset.

Specify the following parameters:

Common Parameters#


Defines whether the texture is to be used "as is" or a runtime will be created for it in accordance with the specified import options.

When enabled the texture is used by the Engine and will be put to the final build "as is". E.g., you can use this option for your custom HDR texture.

Texture Preset

This preset determines what sort of texture is to be generated, it defines compression algorithms and color channels to be used. The list of available presets includes the following:

Image Type

Type of the texture to be generated. Available options are:

  • 2D - 2D texture. This is the most commonly used type of texture. These textures are used in various materials and be mapped to 3D meshes, GUI elements, etc.
  • 3D - 3D texture. This type of textures can be used for volumetric effects or color variations.
  • Cube - cubemap texture. It can be used for your world's environment or for Environment Probes. The imported cubemap will be oriented the following way:

    The following layouts of source cubemaps are supported:
    Horizontal cross layout Vertical cross layout Cylindrical Panorama
  • 2D Array - array of 2D textures. These textures can be used for terrain details, etc.

Image Format

Defines image pixel format: bit depth and channels used. Compressed formats are supported. The default format is RGB8.

Mipmap Type

Type of filtering to be used for mipmap generation. Available options are:

  • Box - choose this type to use simple box filter for mipmap generation.

    If a texture contains very narrow features (e.g., lines), then aliasing artifacts may be very pronounced. In this case it might be better to choose the Combined option.
  • Point - choose this type to use point filtration for mipmap generation.

  • Combined - choose this type to get mipmaps from the source image.

    If the width and/or height of the source image are not power of 2, set the corresponding resolution parameter to Original.

Mipmaps SRGB Correction

Enables sRGB gamma correction for mipmaps.

Resolution Parameters#


Texture width (a power of 2).

  • Original - use source image width
  • Auto (default) - use the power of 2 value closest to the source image width.


Texture height (a power of 2).

  • Original - use source image height
  • Auto (default) - use the power of 2 value closest to the source image height.

Other Parameters#

Invert G Channel

Enable inversion of the green channel of the imported image. Depending on the game engine or 3D software package you use, normal maps can be handled differently. This option is used to simplify conversion of normal maps from different source platforms.

Texture Postfixes#

Texture postfix is important, as it defines compression algorithms and color channels to be used. Postfixes correspond to certain texture presets. The list of available postfixes includes the following ones:

  • texture_alb for albedo textures (RGB - color, A - transparency).
  • texture_d for diffuse textures (RGB - color, A - detail mask or transparency).
  • texture_n for normal textures(RG - surface normal components).
  • texture_nrgb for normal textures that store an alpha value in the B channel (RG - surface normal components, B - alpha value).
  • texture_s for specular textures (RGB - reflection color, A - specular power).
  • texture_sh for shading textures (R - metalness, G - roughness, B - specular, A - microfiber).
  • texture_a for ambient occlusion textures (R - AO map).
  • texture_h for height maps (parallax effect) (R - height map).
  • texture_l for light maps (RGB - light color).
  • texture_e for emission textures (RGB - glow color).

You can define default import options for a texture by simply adding a postfix to its name.

When you import a texture with a postfix, make sure that it corresponds to texture's type and purpose. E.g. if you name an albedo texture as "color_n.jpg", it will be imported as a 2-channel normal map by default.

Assigning Imported Texture#

To assign the imported texture to a material you can choose one of the following ways:

  • Drag the icon of the texture asset from the Asset Browser window to the destination field in the Parameters window.
  • Use the button next to the destination field in the Parameters window to select the desired asset.
  • Type the name of the asset to the destination field in the Parameters window manually. If an asset with the specified name exists in the project it will be shown while you type.

Texture Conversion#

Texture Conversion is a feature that allows optimizing a texture at a later stage of the project without changing the asset GUID, thus preserving all necessary links. Any texture asset used in your project can be converted to one of the available formats.

To convert a texture, right-click the texture in the Asset Browser to open the context menu, and select Convert To and the required file format. The file immediately will be converted to a selected format.

Last update: 2019-08-16
Build: ()