Tweak StandardMaterial3D's default height properties

[Calinou]

• Set the default height scale to 5.0 and multiply it by 0.01 in the shader.
• Document heightmap properties in BaseMaterial3D class reference.

[reduz]

I dont think this is a great idea, if you are making a mobile game, deep parallax is very expensive and makes the technique unusable.

[Calinou]

I dont think this is a great idea, if you are making a mobile game, deep parallax is very expensive and makes the technique unusable.

I amended the pull request to leave Deep Parallax disabled by default. Hopefully, #50383 should make non-deep parallax more usable on most materials.

[reduz]

Regarding this, what is generally the value range expected in similar applications/materials? I would think its the same spaces as the world.

[akien-mga]

We discussed this in PR review meeting and agreed that it should be scaled by 0.01 (so if you interpret the unit as meter this property would be edited as cm, though this shouldn't be mentioned as is in the docs probably).

The scaling should be explained in the docs.

[Calinou]

We discussed this in PR review meeting and agreed that it should be scaled by 0.01 (so if you interpret the unit as meter this property would be edited as cm, though this shouldn't be mentioned as is in the docs probably).

Does this mean the default height should be 5 now?

[akien-mga]

Yes.

[Calinou]

Rebased and tested again, with the default height changed to 5.0. I also filled in the documentation for all heightmap properties in BaseMaterial3D. I think the note on heightmap normalization will be helpful in particular, as it's something I've found to improve the effect in many cases 🙂

We could add an import option to normalize an image, so that you don't need to use an image editor for this.

[akien-mga]

You need to convert the > in XML.
We should maybe add validation for this to makerst so that the precommit hook can catch it.

[akien-mga]

Thanks!