stan220/godot-docs
1
0
Fork 0
mirror of https://github.com/stan220/godot-docs.git synced 2026-09-08 18:29:11 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clarify the behavior of MeshInstance3D automatic instancing

Browse Source
This commit is contained in:
Hugo Locurcio
2025-03-13 22:39:38 +01:00
parent 0b174c6df3
commit 146182c1f2
2 changed files with 20 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
contributing/development/core_and_modules/internal_rendering_architecture.rst
+4 -3
View File
@@ -456,9 +456,10 @@ used to calculate particle collisions in 2D.
Batching and instancing
~~~~~~~~~~~~~~~~~~~~~~~
In the Forward+ renderer, Vulkan instancing is used to group rendering
of identical objects for performance. This is not as fast as static mesh
merging, but it still allows instances to be culled individually.
In the Forward+ renderer, Vulkan instancing is used to group rendering of
identical opaque or alpha-tested objects for performance. (Alpha-blended objects
are never instanced.) This is not as fast as static mesh merging, but it still
allows instances to be culled individually.
Light, decal and reflection probe rendering
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
tutorials/performance/optimizing_3d_performance.rst
+16 -2
View File
@@ -104,8 +104,22 @@ the viewer a considerable distance for the angle of view to change
significantly. This can be complex to get working, but may be worth it depending
on the type of project you are making.
Use instancing (MultiMesh)
~~~~~~~~~~~~~~~~~~~~~~~~~~
Use automatic instancing
~~~~~~~~~~~~~~~~~~~~~~~~
*This is only implemented in the Forward+ renderer, not Mobile or Compatibility.*
If you have many identical objects in your scene, you can use automatic
instancing to reduce the number of draw calls. This automatically happens for
MeshInstance3D nodes that use the same mesh and material: no manual setup is required.
For automatic instancing to be effective, the material must be opaque or
alpha-tested (alpha scissor or alpha hash). Alpha-blended or depth pre-pass
materials are never instanced this way. Instead, you must use MultiMesh as
described below.
Use manual instancing (MultiMesh)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If several identical objects have to be drawn in the same place or nearby, try
using :ref:`MultiMesh <class_MultiMesh>` instead. MultiMesh allows the drawing