Skip to content

Conversation

JMS55
Copy link
Contributor

@JMS55 JMS55 commented Jul 25, 2025

17-year old me struggled to get a game made in Godot to look good. I had no idea how to light a scene or setup materials.

We frequently get questions from users on how to use rendering internals, as they're not documented.

Let's fix that.

Explain and showcase each StandardMaterial property
In Bevy, the main `Material` the engine provides is the `StandardMaterial`.

StandardMaterial, like most of the functionality in `bevy_pbr`, implements an idea called "physically based rendering", or PBR.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tbh not my favorite wikipedia page. It's kinda generic and not very informative. I'll see if I can find something better.


## Theory

While `Material`s in Bevy implement fragment shaders (TODO: reference rendering stuff and the custom material chapter) that run arbitrary functions for computing the color of each pixel, `StandardMaterial` and PBR materials in general are based on the concept of a bidirectional reflectance distribution function (BRDF).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rendering noob commentary: I got a little confused here as it sounds like PBR materials do not implement fragment shaders. Is that true? I thought everything basically had a shader. I assume that BRDF is how colors are calculated? Or am I incorrect in my assumptions here

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh I see later down this is clarified.

Copy link
Contributor Author

@JMS55 JMS55 Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for the feedback.

Your assumptions were correct - all materials have fragment shaders (well unless you're rendering depth-only but that's out of scope... anyways). You can do whatever you want in a fragment shader. Hardcode the result to blue, return a value based on the current time, etc. StandardMaterial's fragment shader implements physically based lighting. It loops over the list of lights in the scene, and multiplies the light contribution by the BRDF. The sum of these values is the final pixel color.

I'll reword the section.


## Theory

While `Material`s in Bevy implement fragment shaders (TODO: reference rendering stuff and the custom material chapter) that run arbitrary functions for computing the color of each pixel, `StandardMaterial` and PBR materials in general are based on the concept of a bidirectional reflectance distribution function (BRDF).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh I see later down this is clarified.


While `Material`s in Bevy implement fragment shaders (TODO: reference rendering stuff and the custom material chapter) that run arbitrary functions for computing the color of each pixel, `StandardMaterial` and PBR materials in general are based on the concept of a bidirectional reflectance distribution function (BRDF).

In the real world, when light hits a surface, a portion of the energy is absorbed, and a portion is reflected and bounces in a different direction. Given an incoming ray of light, a BRDF is a formula that outputs the possible directions the ray can bounce, and the amount of energy reflected.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Making a quick real world example connection up front might help my understanding while in the flow of reading, though I see its mentioned later on. It kind of sounds like the BRDF is a description of the roughness of a surface

Copy link
Contributor Author

@JMS55 JMS55 Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Somewhat. A BRDF just describes how light bounces off a surface.

StandardMaterial roughness is one property (among many) that go into building the final BRDF that StandardMaterial uses.

Tbh I debated between including the BRDF stuff or not. Is it useful? Idk.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can see the usefulness in building an intuition on the building blocks of PBR and breaking it down like this taught me something I didn't know that seems important to understanding the pipeline, so I think it is useful to include it in some capacity!

@NthTensor NthTensor self-requested a review October 6, 2025 13:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants