Defines surface rendering parameters for faces or meshes.
Class registration and implementation information is as follows:
| Category | Documentation |
|---|---|
| Implementation | C++ |
| Module | Core-App-Geometry |
| Class Hierarchy | Node » Material |
| Data Interface Name | Material |
| Type Status | Active |
| Is Final Type | Yes |
Properties are as follows:
| Property | Documentation |
|---|---|
| Texture Node Or Group Of Texture Nodes | A <Texture> or a <Group>'s containing <Texture> nodes. |
| On Render Data Source | A <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 Source | A 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 Node | A <Program> or a <NodeLink> to <Program> that contains the shaders for the <Material>. |
| Ambient Color | Sets the <Material>'s ambient color. This option must be implemented per-shader. |
| Diffuse Color | Sets the <Material>'s diffuse color. This option must be implemented per-shader. |
| Specular Color | Sets the <Material>'s specular color. This option must be implemented per-shader. |
| Emissive Color | Sets the <Material>'s emissive color. This option must be implemented per-shader. |
| Shininess | Sets the <Material>'s shininess. This option must be implemented per-shader. |
| Identification Color | Sets the <Material>'s identification color. This color is used to implement per-segment colors for curves and to render <Material> wireframes. |
| Feature Identification Integer | Sets 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 RenderInfo | Binds this node to the <RenderInfo>'s render object list. |
| Overload Resources | If 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 S | Clamps the texture boundary texels to absolute border along S [U]. ( See also: the same options are in <Texture>. ) |
| Clamp T | Clamps the texture boundary texels to absolute border along T [V]. ( See also: the same options are in <Texture>. ) |
| Transparent | Sets the <Material> to render with alpha blending, provided the associated shader program supports this feature. |
| Texture Transparency | Sets the <Material> to use texture transparency. ( DEPRECATED. This option is now a shader <Program> feature. Compatibility support only. ) |
| Opacity | Sets the amount of opacity when Transparent is true. Range is between 0 and 1. |
| Alpha Reference | Sets 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 Render | Determines whether or not the <Material> is rendered as a solid color or with texturing. This option must be implemented per-shader. |
| Image Writes Enabled | Determines whether or not to render faces to which this <Material> is applied. |
| Material Is Two-Sided | Determines whether or not to render faces even if the face is back-facing. |
| HSR Writes Enabled | Determines 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 Enabled | Determines whether or not to test pixel depths before rendering. |
Properties are as follows:
| Property | Documentation |
|---|---|
| Name | Sets 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. |
| Class | Sets the class of the node. |
| ID | Sets the ID of the node. This must be unique for each document, but different documents can use the same ID. |
| Export Disabled | Determines whether or not the node is exported during an export process, or possibly other purposes. |
| Guid | Enumerates the Node's GUID. |