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 orthe 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. This flag is set to No and current Simdify exporters ignore it (but it can be very useful if you need to modify the exporters). |
| Guid | Enumerates the Node's GUID. |