GroupMaterial
- Last UpdatedOct 22, 2025
- 2 minute read
The GroupMaterial node creates a visual aspect, defined by a shader and its corresponding material fields, and applies it to one or multiple geometry meshes. With the setFromMesh function, the GroupMaterial can import the settings of shader and material from an existing mesh and apply these to multiple other meshes.
Any modification made to the GroupMaterial will be immediately reflected on all its referenced meshes.
Note: Applying GroupMaterial on multi-material type meshes can produce unexpected results.
Platform support
This element is fully supported on XR-Windows, XR-Portable Windows, XR-Portable iOS, XR-Portable Android, and XR-P WASM platforms.
|
XR-WIN |
XR-P-WIN |
XR-P-IOS |
XR-P-AND |
XR-P-WASM |
|---|---|---|---|---|
|
Full support |
Full support |
Full support |
Full support |
Full support |
|
|
|
|
|
|
GroupMaterial Fields
These are the fields for GroupMaterial node. Only the node-specific fields are indicated, not fields obtained by inheritance.
Field inheritance: NodeBase > GroupMaterial
Depending on the shader type, other fields may be available to customize how the shader renders the mesh.
|
Fields |
Type |
Use |
Default value |
Description |
|---|---|---|---|---|
|
meshes |
mstring |
Optional |
A list of fully-qualified mesh names (file|parent|mesh) to which to apply the GroupMaterial shader and material parameters. |
|
|
setFromMesh |
sfunction |
Optional |
Copies the shader and material parameters from an existing mesh. It requires the fully-qualified name of the mesh. |
|
|
shader |
sstring |
Mandatory |
EngineLib|shDc|default |
The name of the shader to use to render meshes with the material param settings. |