Skip to content

Commit

Permalink
Improve next_pass documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
huwpascoe committed Aug 16, 2024
1 parent 4f2c07c commit 311f169
Showing 1 changed file with 13 additions and 2 deletions.
15 changes: 13 additions & 2 deletions tutorials/3d/standard_material_3d.rst
Original file line number Diff line number Diff line change
Expand Up @@ -738,8 +738,19 @@ The rendering order of objects can be changed, although this is mostly
useful for transparent objects (or opaque objects that perform depth draw
but no color draw, such as cracks on the floor).

Objects are Sorted by opaque/transparent queue, then :ref:`render_priority<class_Material_property_render_priority>`.
With higher priority being drawn later.

Depth testing overrules priority. Priority alone cannot force opaque objects to be drawn over each other.

Next Pass
---------

Sets the material to be used for the next pass. This renders the object
again with a different material.
Setting :ref:`next_pass<class_Material_property_next_pass>` material will cause an object to be rendered again with that next material.

Sorted by opaque/transparent queue, then :ref:`render_priority<class_Material_property_render_priority>`, then depth.

.. image:: img/next_pass.webp

Depth will test equal between both materials unless the grow setting or other vertex transformations are used.
Multiple transparent passes should use :ref:`render_priority<class_Material_property_render_priority>` to ensure correct ordering.

0 comments on commit 311f169

Please sign in to comment.