godotengine / godotengine/godot-docs

Add info to the docs and a warning when enabling the StandardMaterial Height without having enabled and added a Normal map

Open
#7,442 2 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
reStructuredText
Stars
5.7k
Forks
3.8k
Avg merge
1d 20h
Merged PRs (30d)
25

Description

**Your Godot version:**
Godot 4.0.3

**Issue description:**
Currently if you enable Height in the Standard Material without a Normal map, nothing happens. In the docs pages it says "For the best results Depth should be used together with Normal mapping." [Direct Link](https://docs.godotengine.org/en/stable/tutorials/3d/standard_material_3d.html#height)

This is confusing because a) there is no such thing as "Depth" or a Depth map in Godot4 and b) because using it together does not seem optional as it is suggested here.

Enabling any property which has a requirement of something else being enabled or set (even a texture) should always result in at least a yellow warning triangle ⚠️ and when hovering over the warning triangle Godot should display a tooltip and tell the user what they have to do in order to get the expected result.

For example in case of the Height property: "Normal must be enabled for this property to work and both Normal as well as Height need to have a texture assigned."

However there are a lot of other properties in the Editor to which this applies. For example in the StandardMaterial still, I have no idea what I have to do in order for Transmittance to have any effect whatsoever.

**URL to the documentation page (if already existing):**
https://docs.godotengine.org/en/stable/tutorials/3d/standard_material_3d.html

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.