mesh_triplanar_base
A mesh_triplanar_base material is used to texture meshes without using UV texture coordinates. Textures are simply projected onto a mesh along three axes (projection does not depend on the orientation of the object in the world). Can be applied to meshes, dynamic meshes and skinned meshes.
States
In the States tab you can set rendering passes and available options. Enabling some of the states activates additional textures and parameters in the Textures and Parameters tabs respectively.
The states divide into 2 groups: Passes and Options.
Possible values for an Ambient pass:
| GUI name | XML name | Description |
|---|---|---|
| Skip | none | Material is not rendered. |
| Opacity | opacity | Material diffuse colors are blended with the ambient color. |
| Transparent | transparent | Material diffuse colors are not modulated by the ambient color. |
| LightMap | lightmap | Material is rendered lit by a light map. Material diffuse colors are multiplied by the light map and the ambient color. To create and automatically set a light map for an object, a Lightmap Generation Tool can be used. |
Possible values for all the other passes:
| GUI name | XML name | Description |
|---|---|---|
| Skip | none | Material is not rendered during the pass. |
| Default | default | Material is rendered during the pass. |
All the options can be either enabled or disabled by ticking the respective boxes.
All the states can be set to default ones - click a Set to parent button near the state (if the state is different from the default one, its field will be highlighted with green).
The states available for this kind of materials are listed below.
Passes
Passes specify during which rendering pass the material should be rendered. They are modified in the Passes field of the States tab.
| GUI name | XML name | Description |
|---|---|---|
| Deferred | deferred | Deferred rendering pass. Specifies if the material should be rendered during the deferred pass. For the transparent surfaces see also a Post deferred option. |
| Auxiliary | auxiliary | Auxiliary rendering pass. Specifies if the material should be rendered into the auxiliary buffer to create a custom post-process. |
| Ambient | ambient | Ambient rendering pass. Specifies, how the material should be rendered during the Ambient light pass for the opaque objects. The actual opacity or transparency of the material depends solely on the set blending options. |
| Light prob | light_prob | Probe lights rendering pass. Specifies, if the material should be rendered illuminated by the Probe light sources during the light and shadows rendering passes. |
| Light spot | light_spot | Spot lights rendering pass. Specifies, if the material should be rendered illuminated by the Spot light sources during the light and shadows rendering passes. |
| Light omni | light_omni | Omni-directional lights rendering pass. Specifies, if the material should be rendered illuminated by the Omni light sources during the light and shadows rendering passes. |
| Light proj | light_proj | Projected lights rendering pass. Specifies, if the material should be rendered illuminated by the Projected light sources during the light and shadows rendering passes. |
| Light world | light_world | World lights rendering pass. Specifies, if the material should be rendered illuminated by the World light sources during the light and shadows rendering passes. |
Options
The following options are set in the Options field of the States tab.
| GUI name | XML name | Description |
|---|---|---|
| Separable | parallax | Specifies if three separate materials should be projected onto the three axes of the mesh instead of one material to be projected along all three axes. |
| Shadow shafts | volumetric | Specifies if volumetric shadows from world lights will be rendered from surfaces with the applied material. |
Textures
In the Textures tab of the Materials Editor you can:
Load the textures - click a Load button near the texture and specify the path to the texture or type the path in the texture field manually
Open the view window to see texture's details - click a View button near the texture- Set the current texture to default one - click a Set to parent button near the texture (if the texture is different from the default one, its field will be highlighted with green)
The textures available for this kind of materials are listed below.
Base Textures
Base textures are loaded and modified in the Base field of the Textures tab. Diffuse Y, Diffuse Z, Normal Y, Normal Z, Specular Y and Specular Z textures are present only if Separable option in the States tab is enabled.
| GUI name | XML name | Description | Channels |
|---|---|---|---|
| Diffuse X | diffuse_0 | Diffuse map. A texture to define a surface's main color and to be projected onto the mesh.
Notice
In case if Separable option is enabled, this texture will projected only onto X axis. |
RGBA:
Notice
An alpha (A) value will store transparency values if an Alpha test option is enabled. Otherwise it will store a detail mask. |
| Normal X | normal_0 | Normal map. A texture to store information about a surface's normals deviation and to be projected onto the mesh.
Notice
In case if Separable option is enabled, this texture will projected only onto X axis. |
RG:
|
| Specular X | specular_0 | Specular map. A texture to define a surface's shininess and highlight color and to be projected onto the mesh.
Notice
In case if Separable option is enabled, this texture will projected only onto X axis. |
RGBA:
|
| Diffuse Y | diffuse_1 | Diffuse map. A texture to define a surface's main color and to be projected onto the mesh along Y axis. |
RGBA:
Notice
An alpha (A) value will store transparency values if an Alpha test option is enabled. Otherwise it will store a detail mask. |
| Normal Y | normal_1 | Normal map. A texture to store information about a surface's normals deviation and to be projected onto the mesh along Y axis. |
RG:
|
| Specular Y | specular_1 | Specular map. A texture to define a surface's shininess and highlight color and to be projected onto the mesh along Y axis. |
RGBA:
|
| Diffuse Z | diffuse_2 | Diffuse map. A texture to define a surface's main color and to be projected onto the mesh along Z axis. |
RGBA:
Notice
An alpha (A) value will store transparency values if an Alpha test option is enabled. Otherwise it will store a detail mask. |
| Normal Z | normal_2 | Normal map. A texture to store information about a surface's normals deviation and to be projected onto the mesh along Z axis. |
RG:
|
| Specular Z | specular_2 | Specular map. A texture to define a surface's shininess and highlight color and to be projected onto the mesh along Z axis. |
RGBA:
|
Additional Textures
Additional parallax and emission textures are present only if an Ambient emission and Parallax mapping options are enabled and are modified in the Additional field of the Textures tab.
| GUI name | XML name | Description | Channels |
|---|---|---|---|
| Ambient | ambient | Ambient map. A texture to modulate the global environment illumination (when an object is lighter at the top from sky above, darker at the bottom from the ground below etc). The texture takes effect only if the scene environment texture is loaded. |
RGBA:
Second UV map channel. |
LightMap Textures
Light map texture is present if a LightMap option is selected to be used during an Ambient pass. The texture can be loaded and modified in the LightMap field of the Textures tab.
Parameters
In the Parameters tab you can set or modify base and additional parameters.
Parameters of different types are set in different ways:
- expression - vector values can be set either in the field near the parameter or in the dialog window opened when double clicking this field
- slider - the value can be set either by smoothly moving the slider of the scroll box or manually in the box near the parameter (if required, the value bigger than maximum one for the slider can be set)
- color - the color can be chosen in the dialog window, activated after double clicking the color field
All the parameters can be set to default ones - click a Set to parent button near the parameter (if the parameter is different from the default one, its field will be highlighted with green).
The parameters available for this kind of materials are listed below.
Transform Parameters
Texture transformation parameters are modified in the Transform field of the Parameters tab. Base Y and Base Z parameters are present only if Separable option in the States tab is enabled.
| GUI name | XML name | Type | Description |
|---|---|---|---|
| Base X | base_0_transform | expression | Projected base texture coordinates transformation. A vector of the four float components, consisting of two pairs of vector elements:
Notice
In case if Separable option is enabled, this parameter sets coordinates transformation only onto X axis. |
| Base Y | base_1_transform | expression | Projected base texture coordinates transformation along Y axis. A vector of the four float components, consisting of two pairs of vector elements:
|
| Base Z | base_2_transform | expression | Projected base texture coordinates transformation along Z axis. A vector of the four float components, consisting of two pairs of vector elements:
|
Auxiliary Parameters
Auxiliary color parameter is present only if an Auxiliary pass is set as a Default. The parameter is modified in the Auxiliary field of the Parameters tab.
| GUI name | XML name | Type | Description |
|---|---|---|---|
| Auxiliary | auxiliary_color | color | A color picker to choose an auxiliary color for the Auxiliary rendering pass. |
Ambient Parameters
Ambient parameter is modified in the Ambient field of the Parameters tab.
| GUI name | XML name | Type | Description |
|---|---|---|---|
| Environment | environment_scale | slider | Environment lighting scale. A coefficient to scale how much the global environment texture illuminates the surface. The higher the value, the more the colors will be corrected (lightened or darkened) according to the environment component. |
Lightmap Parameters
Light map parameter is present only if an LightMap option is set during the Ambient Emission rendering pass. The parameter is modified in the Lightmap field of the Parameters tab.
| GUI name | XML name | Type | Description |
|---|---|---|---|
| Scale | lightmap_scale | slider | A coefficient to scale the intensity of illumination by the light map. By the value of 0 the light map does not illuminate the surface with this material applied. The higher the value, the more visible and the brighter a light map is. |
Shading Parameters
Shading parameters are modified in the Shading field of the Parameters tab.
| GUI name | XML name | Type | Description |
|---|---|---|---|
| Power | triplanar_power | slider | A coefficient to scale the smoothness of interpolation between three projected textures. By the minimum value of 1, textures are interpolated as smoothly as possible. The higher the value, the more visible the line between projected textures and the narrower blended area is. |
| Diffuse | diffuse_color | color |
A color picker to choose the color of the diffuse map. |
| Diffuse | diffuse_scale | slider | A coefficient to scale the brightness of the diffuse map. The higher the value, the brighter the diffuse map is. |
| Specular | specular_color | color |
A color picker to choose the color of the specular map. |
| Specular | specular_scale | slider | A coefficient to scale the brightness of the specular map reflections. The default value of 1 grants the correct color. The higher the value, the brighter the specular reflections are. |
| Glossiness | specular_power | slider |
A coefficient to modify size of the highlight (Phong lighting) of the specular map:
|
| Phong rim width | phong_rim_width | slider |
A coefficient to modify the width of an additionally lightened rim of an object, where incident light is perpendicular to surface being lit:
|
| Phong rim scale | phong_rim_scale | slider |
A coefficient to scale brightness of the additionally lightened rim at the edges of an object, where incident light is perpendicular to surface being lit:
|
| Fresnel bias | fresnel_bias | slider | A coefficient to compensate for the Fresnel effect and set the minimum necessary reflectance level. By the minimum value of 0, there is no compensation for the Fresnel effect. Increasing the value leads to more prominent overall reflections. By the maximum value of 1, reflections are at their maximum and the Fresnel power parameter does not influence the rendered image. |
| Fresnel power | fresnel_power | slider |
A coefficient to scale Fresnel effect that defines the amount of reflectance depending on the viewing angle:
|