MeshRenderer Component Reference
The MeshRenderer component is used to display a static 3D model. Set the model mesh with the
Mesh property, and change the appearance of the model with the
Click Add Component -> Mesh -> MeshRenderer in the Inspector panel to add the MeshRenderer component.
|Materials||The material used to render the model, one material corresponds to one sub-mesh in the mesh.|
|LightmapSettings||For baking Lightmap, please refer to Lightmapping for details.|
|ShadowCastingMode||Specifies whether the current model will cast shadows, which needs to enable shadow effect in the scene first|
|ReceiveShadow||Specifies whether the current model will receive and display shadow effects generated by other objects, which needs to enable shadow effect in the scene first. This property takes effect only when the shadow type is ShadowMap.|
|Mesh||3D model assets for rendering.|
The component interfaces for the common model are described in MeshRenderer API.
The component interfaces for the skinning model are described in SkinnedMeshRenderer API.
Mesh assets are necessary for rendering meshes. Currently, meshes are mainly generated automatically by Creator when importing models into Creator.
A Mesh asset contains a set of vertices and multiple sets of indices. The index points to the vertex in the vertex array, and every three sets of indices form a triangle. A mesh is composed of multiple triangles and is the most basic graphical element in the 3D world. Multiple triangles are stitched together to form a complex polygon, and multiple polygons are stitched together to form a 3D model.
Creator provides several simple static 3D models with basic models such as the cube, cylinder, etc. Developers can create a few in the Hierarchy panel as needed to get a first look.
Model Group Rendering
The group rendering function is determined by the Visibility property of the camera component and the Layer property of the node. Users can set the
Visibility value through code to complete the group rendering. All nodes belong to the
DEFAULT layer by default and are visible on all cameras.
The current static batching scheme is static batching at run time. Static batching can be performed by calling
BatchingUtility.batchStaticModel. This function receives a node, and then merges all
MeshRenderer under that node into one, and hangs it under another node.
After batching, the original transform of
MeshRenderer cannot be changed, but the transform of the root node after batching can be changed. Only nodes that meet the following conditions can be statically batched:
- The child node can only contain
- The vertex data structure of
MeshRendererunder child nodes must be consistent.
- The material of
MeshRendererunder child nodes must be the same.
The engine currently provides two sets of dynamic batching systems, instancing batching and VB-merging batching. The two methods cannot coexist, and the priority of instancing is greater than that of dynamic merging VB. To enable batching, simply check the
USE_BATCHING switch in the material used in the model.
Note: the current batching process introduces several limitations:
- The transparent models in the same batch are not sorted, this may lead to incorrect blending results.
- The inverse-transpose world matrix is not uploaded into batches, models with non-uniform scale will have inaccurate normals.
- Only plain models and skinning models under pre-baked skeletal animation are supported. (i.e. real-time skeletal animations, 2D objects, UIs and particles do not support dynamic batching)
The batch through instancing is suitable for drawing a large number of dynamic models with the same vertex data. When enabled, drawing will be grouped according to the material and vertex data, and the instanced attributes information will be organized in each group, and then complete the drawing at one time.
Note: for the support and related settings of the skinning model, refer to the Skeletal Animation Component documentation.
In addition, inside each group, the instanced attributes supports custom additional instanced attributes, which can pass more per-instance data between different instances (such as the difference in appearance of a diffuse color between different characters, or the influence of wind in a large grass field). This requires the support of custom effects. For more detailed instructions, please refer to the Syntax Guide documentation.
VB-merging batching is suitable for drawing a large number of non-skinned dynamic models with low number of faces and different vertex data. When enabled, drawing will be grouped according to the material, and then the vertex and world transformation information will be merged in each frame of each group, and then completed in batches1.
Batch Best Practices
Generally speaking, the priority of the batch system is: static batching -> instancing batching -> VB-merging batching.
The material must be insured that it is consistent, under this premise:
- If you are certain that certain models will remain completely static during the game cycle, use static batching.
- If there are a large number of the same model repeated drawing, there is only a relatively controllable small difference between each other, use instancing batching.
- If there are a large number of models with very low number of triangles but different vertex data, consider trying VB-merging batching.
1. Currently use uniforms to upload the batched world transformation matrix, taking into account the WebGL standard uniform quantity limit, the current batch draws up to 10 models, so for a large number of same For the material model, the number of drawcalls is expected to be reduced by up to 10 times after enabling VB-merging batching. ↩
2. There have been many discussions in the industry on the topic of batching and performance, you can refer to this nVidia slide. ↩