sales@scenomics.com +1 650 396 9674

<Material>

Defines surface rendering parameters for faces or meshes.

Registration

Class registration and implementation information is as follows:

Category Documentation
ImplementationC++
ModuleCore-App-Geometry
Class HierarchyNode » Material
Data Interface NameMaterial
Type StatusActive
Is Final TypeYes

<Material> Properties

Properties are as follows:

Property Documentation
Texture Node Or Group Of Texture NodesA <Texture> or a <Group>'s containing <Texture> nodes.
On Render Data SourceA <Group>'s of uniform VariableNodes that are publicly available to subsequent instances of this <Material>. These uniforms are bound when the <Material>/Program is selected during traversal.
Generic Data SourceA node that serves as a generic data source. This node is not used at render time, but can be useful for extending relationships between objects of type <Material> and other nodes.
Program Link or Link to Program NodeA <Program> or a <NodeLink> to <Program> that contains the shaders for the <Material>.
Ambient ColorSets the <Material>'s ambient color. This option must be implemented per-shader.
Diffuse ColorSets the <Material>'s diffuse color. This option must be implemented per-shader.
Specular ColorSets the <Material>'s specular color. This option must be implemented per-shader.
Emissive ColorSets the <Material>'s emissive color. This option must be implemented per-shader.
ShininessSets the <Material>'s shininess. This option must be implemented per-shader.
Identification ColorSets the <Material>'s identification color. This color is used to implement per-segment colors for curves and to render <Material> wireframes.
Feature Identification IntegerSets the <Material>'s feature identification integer. Range is 0-65536. This can be used to identify a <tMaterial>, such as for deferred shading, or to select polygon faces by Feature ID.
Bind To RenderInfoBinds this node to the <RenderInfo>'s render object list.
Overload ResourcesIf true, this <Material>'s samplers and uniforms can be override externally. This is typically done with a <NodeLink> to a <Material>. The <NodeLink> can have as its children palettes of samplers and uniforms that override its default resources.
Clamp SClamps the texture boundary texels to absolute border along S [U]. ( See also: the same options are in <Texture>. )
Clamp TClamps the texture boundary texels to absolute border along T [V]. ( See also: the same options are in <Texture>. )
TransparentSets the <Material> to render with alpha blending, provided the associated shader program supports this feature.
Texture TransparencySets the <Material> to use texture transparency. ( DEPRECATED. This option is now a shader <Program> feature. Compatibility support only. )
OpacitySets the amount of opacity when Transparent is true. Range is between 0 and 1.
Alpha ReferenceSets the opacity rejection threshold. When this parameter is enabled, texels above or below the specified alpha range are not rendered. Range is between 0 and 1.
Alpha Test Function:Does not perform any alpha threshold rejection.
Alpha Test Function:Reject Texels Less Than Reference. Rejects texels less than the Alpha Reference value.
Alpha Test Function:Reject Texels Less Than Or Equal To Reference. Rejects texels equal to or less than the Alpha Reference value.
Alpha Test Function:Reject Texels Equal To Reference. Rejects texels equal to the Alpha Reference value.
Alpha Test Function:Reject Texels Not Equal To Reference. Rejects texels not equal to the Alpha Reference value.
Alpha Test Function:Reject Texels Greater Than Reference. Rejects texels great than the Alpha Reference value.
Alpha Test Function:Reject Texels Greater Than Or Equal To Reference. Rejects texels equal to or greater the Alpha Reference value.
Solid RenderDetermines whether or not the <Material> is rendered as a solid color or with texturing. This option must be implemented per-shader.
Image Writes EnabledDetermines whether or not to render faces to which this <Material> is applied.
Material Is Two-SidedDetermines whether or not to render faces even if the face is back-facing.
HSR Writes EnabledDetermines whether or not to include faces to which this <Material> is applied in z-buffer calculations.For example: Conserves rendering bandwidth when rendering skyboxes because there is geometry behind the skybox.
HSR Tests EnabledDetermines whether or not to test pixel depths before rendering.

<Node> Properties

Properties are as follows:

Property Documentation
NameSets the name of the node. Do not use / or \ [forward slash and backslash] in the node name as this produces conflicts with resolving link nodes that reference external files.
ClassSets the class of the node.
IDSets the ID of the node. This must be unique for each document, but different documents can use the same ID.
Export DisabledDetermines whether or not the node is exported during an export process, or possibly other purposes.
GuidEnumerates the Node's GUID.