Skip to content

Commit 586a2fd

Browse files
authored
Improve next_pass documentation in Standard Material 3D (#9762)
1 parent 7628f87 commit 586a2fd

File tree

2 files changed

+15
-2
lines changed

2 files changed

+15
-2
lines changed

tutorials/3d/img/next_pass.webp

53.7 KB
Loading

tutorials/3d/standard_material_3d.rst

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -738,8 +738,21 @@ The rendering order of objects can be changed, although this is mostly
738738
useful for transparent objects (or opaque objects that perform depth draw
739739
but no color draw, such as cracks on the floor).
740740

741+
Objects are sorted by an opaque/transparent queue, then :ref:`render_priority<class_Material_property_render_priority>`,
742+
with higher priority being drawn later. Transparent objects are also sorted by depth.
743+
744+
Depth testing overrules priority. Priority alone cannot force opaque objects to be drawn over each other.
745+
741746
Next Pass
742747
---------
743748

744-
Sets the material to be used for the next pass. This renders the object
745-
again with a different material.
749+
Setting :ref:`next_pass<class_Material_property_next_pass>` on a material
750+
will cause an object to be rendered again with that next material.
751+
752+
Materials are sorted by an opaque/transparent queue, then :ref:`render_priority<class_Material_property_render_priority>`,
753+
with higher priority being drawn later.
754+
755+
.. image:: img/next_pass.webp
756+
757+
Depth will test equal between both materials unless the grow setting or other vertex transformations are used.
758+
Multiple transparent passes should use :ref:`render_priority<class_Material_property_render_priority>` to ensure correct ordering.

0 commit comments

Comments
 (0)