Skip to content

Commit 1a8f49a

Browse files
committed
Added notes on different model materials
1 parent 541ff60 commit 1a8f49a

File tree

1 file changed

+14
-2
lines changed

1 file changed

+14
-2
lines changed

docs/en/manuals/model.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,12 @@ Apart from the properties *Id*, *Position* and *Rotation* the following componen
2626
: This property should refer to the glTF *.gltf* or Collada *.dae* file that contains the mesh to use. If the file contains multiple meshes, only the first one is read.
2727

2828
*Material*
29-
: Set this property to a material you have created that is suitable for a textured 3D object. There is a built-in *model.material* file that you can use as a starting point.
29+
: Set this property to a material you have created that is suitable for a textured 3D object. There are a number of built-in materials that you can use as a starting point:
30+
31+
* Use *model.material* for static non-instanced models
32+
* Use *model_instances.material* for static instanced models
33+
* Use *model_skinned.material* for skinned (animated) non-instanced models
34+
* Use *model_skinned_instances.material* for skinned (animated) instanced models
3035

3136
*Texture*
3237
: This property should point to the texture image file that you want applied to the object.
@@ -92,7 +97,14 @@ A model also has a number of different properties that can be manipulated using
9297

9398
3D software commonly allows you to set properties on your object vertices, like coloring and texturing. This information goes into the glTF *.gltf* or Collada *.dae* file that you export from your 3D software. Depending on the requirements of your game you will have to select and/or create appropriate and _performant_ materials for your objects. A material combines _shader programs_ with a set of parameters for rendering of the object.
9499

95-
There is a simple 3D model material available in the built-in materials folder. If you need to create custom materials for your models, see the [Material documentation](/manuals/material) for information. The [Shader manual](/manuals/shader) contains information on how shader programs work.
100+
There are a number of built-in materials that you can use as a starting point:
101+
102+
* Use *model.material* for static non-instanced models
103+
* Use *model_instances.material* for static instanced models
104+
* Use *model_skinned.material* for skinned (animated) non-instanced models
105+
* Use *model_skinned_instances.material* for skinned (animated) instanced models
106+
107+
If you need to create custom materials for your models, see the [Material documentation](/manuals/material) for information. The [Shader manual](/manuals/shader) contains information on how shader programs work.
96108

97109

98110
### Material constants

0 commit comments

Comments
 (0)