StandardMaterial docs: Make clear that lighting won't look correct if is_srgb is true

[772]

Objective

• Fix Document loading texture normals in linear RGB #12123

Solution

• Add a code example found here: https://github.com/bevyengine/bevy/blob/main/examples/3d/parallax_mapping.rs#L209 to https://docs.rs/bevy/latest/bevy/pbr/struct.StandardMaterial.html

Testing

• This pull request if only changing docs. But I tested the formatting via cargo doc --no-deps --open.

[alice-i-cecile]

@DGriffin91 does this look right to you?

[DGriffin91]

Yes, this looks correct. A few of the examples do exactly this, and the GLTF loader deals with it here:

bevy/crates/bevy_gltf/src/loader/mod.rs

Line 1062 in fb2bbb0

let is_srgb = !linear_textures.contains(&gltf_texture.index());

[alice-i-cecile]

@772, please ping me once CI is passing and I'll get this merged for you :) It looks like you're going to need to add a bit of boilerplate above your code snippet. Feel free to just mock it if needed and then use # to hide the mocked lines.

[BD103]

Thank you very much for working on this!

[772]

@alice-i-cecile
ping :) @BD103 fixed CI.

[alice-i-cecile]

Alright, let's try that :)