Skip to main content

Meta_StdMaterial

Module: Metanodes / Definitions

A StdMaterial describes a standard material that can be applied to numerous 3D objects (geogroups, visuals, etc)

#include <meta_importables.hpp>

Public Types​

TypeName
enumBlendMode { Blend_None, Blend_Alpha, Blend_Add, Blend_Mult }
Values for Idx_BlendMode.
enumIDX { Idx_Diffuse, Idx_Ambient, Idx_Specular, Idx_Emissive, Idx_Reflectivity, Idx_Smoothness, Idx_Metalness, Idx_Opacity, Idx_DiffuseMap, Idx_AmbientMap, Idx_ReflectivityMap, Idx_EmissiveMap, Idx_EnvironmentMap, Idx_SmoothnessMap, Idx_MetalnessMap, Idx_OpacityMap, Idx_NormalMap, Idx_BumpMap, Idx_TwoSidedLighting, Idx_Fresnel, Idx_MapMatrix, Idx_EmissiveIntensity, Idx_BumpScale, Idx_BlendMode, Idx_AlphaTest, Idx_AlphaTestRef, Idx_Enabled, Idx_LineWidth, Idx_ReliefMapping, Idx_LinePattern, Idx_Lit, Idx_AlphaToCoverage, Idx_HalfLambert, Idx_AmbientMapChannel, Idx_ReflectivityMapChannel, Idx_SmoothnessMapChannel, Idx_MetalnessMapChannel, Idx_InvertSmoothness, Idx_PreviewShape }
Property index.
enumLinePatterns { FullLine = 0x0001FFFF, NoLine = 0x00010000, DoubleDashed = 0x00010F0F, DashedLine = 0x000100FF }
Values for Idx_LinePattern.
enumTextureChannels { TextureChannel_Red = 0, TextureChannel_Green = 1, TextureChannel_Blue = 2, TextureChannel_Alpha = 3 }

Public Types Documentation​

enum BlendMode​

EnumeratorValueDescription
Blend_NoneNo alpha blending. Opacity related options are ignored (Symbols - C: "BlendNone", Lua: __StdMaterial_BlendNone)
Blend_AlphaAlpha blending (Symbols - C: "BlendAlpha", Lua: __StdMaterial_BlendAlpha)
Blend_AddAdditive blending (Symbols - C: "BlendAdditive", Lua: __StdMaterial_BlendAdditive)
Blend_MultMultiplicative blending (Symbols - C: "BlendMultiplicative", Lua: __StdMaterial_BlendMultiplicative)

Values for Idx_BlendMode.

enum IDX​

EnumeratorValueDescription
Idx_Diffusevec3f - Constant diffuse colour; RGB 0.0 to 1.0
Idx_Ambientfloat - Ambient scalar.
Idx_Specularvec3f - Constant specular colour; RGB 0.0 to 1.0
Idx_Emissivevec3f - Constant emissive colour; RGB 0.0 to 1.0
Idx_Reflectivityfloat - Constant which modulates the colour sampled from the reflection map before adding to result.
Idx_Smoothnessfloat - Constant smoothness value (0=minimum exponent, 1=maximum exponent).
Idx_Metalnessfloat - Constant metalness value (0=not metal, 1=metal).
Idx_Opacityfloat - Constant opacity value (0=fully transparent, 1=fully opaque).
Idx_DiffuseMaplink - Texture providing per-pixel diffuse colour. Alpha is used to modulate Idx_Opacity value unless Idx_OpacityMap is present.
Idx_AmbientMaplink - Texture providing per-pixel ambient colour.
Idx_ReflectivityMaplink - Texture providing per-pixel specular colour. Alpha is used to modulate Idx_Smoothness value unless Idx_SmoothnessMap is present.
Idx_EmissiveMaplink - Texture providing per-pixel emissive colour. Adds on to Idx_Emissive value.
Idx_EnvironmentMaplink - Texture providing per-pixel reflection colour.
Idx_SmoothnessMaplink - Texture providing per-pixel smoothness, modulates Idx_Smoothness value.
Idx_MetalnessMaplink - Texture providing per-pixel metalness, modulates Idx_Metalness value.
Idx_OpacityMaplink - Texture providing per-pixel opacity, modulates Idx_Opacity value.
Idx_NormalMaplink - Texture providing per-pixel object-space normal vector (XYZ scaled and biased into RGB).
Idx_BumpMaplink - Texture providing per-pixel tangent-space normal vector (XYZ scaled and biased into RGB).
Idx_TwoSidedLightingbool - Tf true, back faces are lit using the inverted normal (which results in an expensive branch in the shader).
Idx_FresnelUnused.
Idx_MapMatrixmat4f - Transformation matrix for the texture coordinates
Idx_EmissiveIntensityfloat - Constant emissive intensity.
Idx_BumpScalefloat - Constant bump scale.
Idx_BlendModeBlendMode (int) - Blend mode
Idx_AlphaTestbool - Enables alpha testing - required for any blend mode other than "None"
Idx_AlphaTestReffloat - Determines the level at what point in an opacity map is it counted as transparent or not.
Idx_Enabledbool - When disabled, objects with this material are not rendered
Idx_LineWidthfloat - Width of any lines drawn with this material
Idx_ReliefMappingWhether or not relief mapping is enabled.
Idx_LinePatternLinePatterns (int) - Sets line drawing pattern (factor and pattern combined)
Idx_Litbool - if true (default) the material is affected by scene lighting, if false it isn't (only emits light).
Idx_AlphaToCoveragebool - Use the alpha of this material for a screen-door transparency effect (Note: MSAA must be enabled)
Idx_HalfLambertbool - Use special diffuse lighting to prevent the rear of an object losing its shape and looking too flat
Idx_AmbientMapChannelint - Specifies which channel of the ambient map contains the ambient values, allowing a single RGB/RGBA texture to be shared between several maps.
Idx_ReflectivityMapChannelint - Specifies which channel of the reflectivity map contains the reflectivity values, allowing a single RGB/RGBA texture to be shared between several maps.
Idx_SmoothnessMapChannelint - Specifies which channel of the smoothness map contains the smoothness values, allowing a single RGB/RGBA texture to be shared between several maps.
Idx_MetalnessMapChannelint - Specifies which channel of the metalness map contains the metalness values, allowing a single RGB/RGBA texture to be shared between several maps.
Idx_InvertSmoothnessbool - Inverts smoothness and smoothness map values, enabling use of a roughness map.
Idx_PreviewShapelink - the model used for previewing the material

Property index.

enum LinePatterns​

EnumeratorValueDescription
FullLine0x0001FFFFSymbols - C: "LinePatternFullLine", Lua: __StdMaterial_LinePatternFullLine
NoLine0x00010000Symbols - C: "LinePatternNoLine", Lua: __StdMaterial_LinePatternNoLine
DoubleDashed0x00010F0FSymbols - C: "LinePatternDoubleDashed", Lua: __StdMaterial_LinePatternDoubleDashed
DashedLine0x000100FFSymbols - C: "LinePatternDashedLine", Lua: __StdMaterial_LinePatternDashedLine

Values for Idx_LinePattern.

enum TextureChannels​

EnumeratorValueDescription
TextureChannel_Red0
TextureChannel_Green1
TextureChannel_Blue2
TextureChannel_Alpha3