UnigineScript
The Language
Core Library
Engine Library
Node-Related Classes
GUI-Related Classes
Plugins Library
High-Level Systems
Samples
C++ API
API Reference
Integration Samples
Usage Examples
C++ Plugins
Content Creation
Materials
Unigine Material Library
Tutorials

Materials Editor

This panel allows to organize and modify the materials and can be invoked by pressing the M key (for other materials hotkeys see Controls and Navigation ) or choosing Materials tab on the Editor interface panel.

Materials Editor consists of three parts: preview panel, material tree hierarchy list and data related to the selected material (material tabs).

Materials editor settings

Preview Panel and Material Tree

The left part of the Materials panel consists of the following elements:

  • Preview panel — display the current material over the geometric figure, selected in the drop-down list: box, sphere or dodecahedron.
  •   List of preloaded material libraries — set load order, add, save or remove material libraries from the list.
  •   Save materials — save the material.
  •   Clone material — clone the selected material to the library with specified name.
  •   Inherit material — inherit the selected material in the library with specified name.
  •   Rename/move material — rename or move the material in the library.
  •   Remove material — remove material and all its children from the list.
  •   Assign material — assign material to one selected surface of the selected node.
  • Library filter — show all material libraries in the hierarchy list or filter the specific ones for displaying.
  • Search — search material in the hierarchy list by name.
  • Materials hierarchy list — hierarchically structured list of the materials giving material names and parent-child links. It enables showing only the parent materials and hide the child ones if necessary.

Material Tabs

The material-related data is grouped into four tabs:

  • The Common tab contains common material settings. These properties are the same for all materials.
  • The States tab contains a set of flags that will be used for a shader corresponding to the material.
  • The Textures tab contains paths to textures used by the material.
  • The Parameters tab contains parameters associated with the selected states.

The details about type dependent properties can be found in Material Class article in the Programming section.

Common Tab

The common tab has the following options:

Info

This section provides the information about the selected material:

LibraryA library for the current material.
NameA name of the material.
ParentA name of the parent material.
ChildrenThe number of child materials.

Blending

This section contains parameters used for alpha blending:

SrcOption used to scale the source color (the color of an overlaying material).
DestOption used to scale the destination color (the color of an obscured material).

Options

This section contains common material options:

DownsizeA downsize value indicating if a transparent surface should be rendered into a smaller buffer. The default value is none - to use a full-sized image.
Render groupAn option, affecting opacity objects rendering; inside a group all the renderable objects will be sorted with the respect to material order.
Render orderSort order used by rendering transparent objects with alpha blending. Transparent objects should be set lowest order numbers and thus rendered first, while opaque objects should be set highest order numbers to be rendered last.
Notice
In order to control the rendering order, you need to set Materials settings -> States tab -> Ambient pass to Transparent for the selected material.
Polygon offsetPolygon offset level used for the material.
LightA light mask of the material. The material is illuminated by a light source, if they both have corresponding masks.
ViewportA viewport mask that allows to selectively render materials and reflections from them. (See the detailed info).
Depth maskRender material into the deferred depth buffer. Transparent objects will be written into Z-buffer only if Post deferred option is enabled. For opaque objects this option should always be enabled.
Glow maskUse deferred buffer glow mask for the current material (alpha channel or emission texture is used).
Parallax maskUse deferred buffer parallax mask for the current material.
Alpha testEnable alpha testing for the current material (alpha channel of base diffuse texture is used). Material is rendered only if in a given pixel its alpha is 0.5 or higher.
Post deferredRender a transparent surface with the current material into deferred depth buffer and thus override the depth. It allows to test the distance to the transparent object when rendering light scattering, but objects behind it will not be considered in calculations (will not have distance attenuation).
Post scatteringRender a transparent surface after the light scattering pass
Post refractionRender a transparent surface with the current material after the refraction pass. It overrides the disabled Post scattering option (i.e. the material that should be rendered before the light scattering pass will still be rendered after the refraction pass).
Two sidedRender polygons, to which the material is applied, two times by lighting pass.
Light blendingFor the material blending mode onto light rendering passes.
Cast shadowRender polygons, to which the material is applied, casting shadows from omni, projected or cubemap light sources.
Cast world shadowRender polygons, to which the material is applied, casting shadows from world light sources.
Receive shadowRender polygons, to which the material is applied, receiving shadows from omni, projected or cubemap light sources.
Receive world shadowRender polygons, to which the material is applied, receiving shadows from world light sources.
Cast translucenceEnable casting translucence from the translucent lights.
Receive translucenceEnable receiving translucence from the translucent lights.
CopyCopy all material settings.
PasteApply the previously copied settings of the material to the current one.

Options contains common material options:

Last update: 2017-07-03