godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2026-01-07 02:12:07 +03:00
Code Issues Packages Projects Releases Wiki Activity

Document StandardMaterial3D refraction limitations (#7301)

Browse Source 
Co-authored-by: Clay John <claynjohn@gmail.com>
Co-authored-by: Max Hilbrunner <mhilbrunner@users.noreply.github.com>
This commit is contained in:
Hugo Locurcio
2023-05-08 16:03:43 +02:00
committed by GitHub
parent a4b1d7a5d8
commit 34350f8a12
2 changed files with 25 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
tutorials/3d/standard_material_3d.rst
View File

@@ -30,7 +30,7 @@ the mesh.
The *Material Overlay* property will render a material **over** the current one being used by
the mesh. As an example, this can be used to put a transparent shield effect on a mesh.
BaseMaterial 3D Settings
BaseMaterial 3D settings
------------------------
StandardMaterial3D has many settings that determine the look of a material. All of these are
@@ -372,13 +372,35 @@ such as plant leaves, grass, human ears, etc.
Refraction
----------
When refraction is enabled, it supersedes alpha blending, and Godot attempts to
fetch information from behind the object being rendered instead. This allows
distorting the transparency in a way similar to refraction in real life.
Remember to use a transparent albedo texture (or reduce the albedo color's alpha
channel) to make refraction visible, as refraction relies on transparency to
have a visible effect.
A normal map can optionally be specified in the **Refraction Texture** property
to allow distorting the refraction's direction on a per-pixel basis.
.. image:: img/spatial_material23.png
.. note::
Refraction is implemented as a screen-space effect and forces the material
to be transparent. This makes the effect relatively fast, but this results
in some limitations:
- :ref:`Transparency sorting <doc_3d_rendering_limitations_transparency_sorting>`
issues may occur.
- The refractive material cannot refract onto itself, or onto other
transparent materials. A refractive material behind another transparent
material will be invisible.
- Off-screen objects cannot appear in the refraction. This is most
noticeable with high refraction strength values.
- Opaque materials in front of the refractive material will appear to have
"refracted" edges, even though they shouldn't.
Detail
------