bevyengine / bevyengine/bevy

Setting 'Specular Transmission' to a value higher than 0.0 on a standard material (or ext material) -> it wont write to depth buffer

Open
#13,518 1 comment 1 reaction 0 assignees View on GitHub
A-Rendering C-Bug C-Docs
Dominant language
Rust
Stars
48.2k
Forks
4.8k
Avg merge
3d 16h
Merged PRs (30d)
171

Description

## How can Bevy's documentation be improved?

Provide a link to the documentation and describe how it could be improved. In what ways is it incomplete, incorrect, or misleading?

**Setting 'Specular Transmission' to a value higher than 0.0 on a standard material (or ext material) -> it wont write to depth buffer**

If you have suggestions on exactly what the new docs should say, feel free to include them here. Or alternatively, make the changes yourself and [create a pull request](https://bevyengine.org/learn/book/contributing/code/) instead.

Perhaps here,

https://docs.rs/bevy/latest/bevy/prelude/struct.StandardMaterial.html#structfield.perceptual_roughness

Add notes on these properties in very clear warnings that certain properties , when set above 0.0, will cause the material to not write to the depth buffer. I was shocked to learn that a float is acting like a boolean in this sense esp since checking a float for == 0.0 is not a common pattern in computer science in general.

Contributor guide

Open the contributing guide

Research direction

Start with the StandardMaterial documentation at the linked docs.rs page and review the description of specular transmission and the referenced material properties. Confirm which values affect depth-buffer writing, then update the relevant documentation with clear warnings and verify that the stated behavior matches the material implementation.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
documentation, game-dev
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.