Skip to content

Commit 52cd871

Browse files
authored
Merge pull request #11099 from skyace65/Spatial-Material-Update
Update Standard Material 3D page for new transform options
2 parents e5fdc75 + b7a07ad commit 52cd871

File tree

1 file changed

+29
-6
lines changed

1 file changed

+29
-6
lines changed

tutorials/3d/standard_material_3d.rst

Lines changed: 29 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -537,6 +537,8 @@ This controls how much light from the lit side (visible to light) is transferred
537537
to the dark side (opposite from the light). This works well for thin objects
538538
such as plant leaves, grass, human ears, etc.
539539

540+
.. image:: img/spatial_material22.png
541+
540542
Refraction
541543
----------
542544

@@ -741,14 +743,35 @@ Point Size
741743

742744
When drawing points, specify the point size in pixels.
743745

744-
Transmission
745-
~~~~~~~~~~~~
746+
Use Particle Trails
747+
~~~~~~~~~~~~~~~~~~~
746748

747-
This controls how much light from the lit side (visible to light) is transferred
748-
to the dark side (opposite from the light). This works well for thin objects
749-
such as plant leaves, grass, human ears, etc.
749+
If true, enables parts of the shader required for GPUParticles3D trails to function.
750+
This also requires using a mesh with appropriate skinning, such as RibbonTrailMesh
751+
or TubeTrailMesh. Enabling this feature outside of materials used in GPUParticles3D
752+
meshes will break material rendering.
750753

751-
.. image:: img/spatial_material22.png
754+
Use Z Clip Scale
755+
~~~~~~~~~~~~~~~~
756+
757+
Scales the object being rendered towards the camera to avoid clipping into things
758+
like walls. This is intended to be used for objects that are fixed with respect to
759+
the camera like player arms, tools, etc. Lighting and shadows will continue to work
760+
correctly when this setting is adjusted, but screen-space effects like SSAO and SSR
761+
may break with lower scales. Therefore, try to keep this setting as close to 1.0 as
762+
possible.
763+
764+
Use FOV Override
765+
~~~~~~~~~~~~~~~~
766+
767+
Overrides the ``Camera3D``'s field of view angle (in degrees).
768+
769+
.. note::
770+
771+
This behaves as if the field of view is set on a ``Camera3D`` with
772+
``Camera3D.keep_aspect`` set to ``Camera3D.KEEP_HEIGHT``. Additionally, it may not
773+
look correct on a non-perspective camera where the field of view setting is
774+
ignored.
752775

753776
Proximity and Distance Fade
754777
---------------------------

0 commit comments

Comments
 (0)