Cameras Book Page - #2545
Draft
Based-A wants to merge 16 commits into
Draft
Conversation
cookie1170
suggested changes
Jul 28, 2026
alice-i-cecile
requested changes
Jul 28, 2026
alice-i-cecile
left a comment
alice-i-cecile
left a comment
Member
There was a problem hiding this comment.
Lots to fix, but it's a good place to start. Really need to nail the central dogma (core data flow), and then use that throughout to thread the pedagogical structure. How about big idea -> simple one camera case -> tools for working with multiple cameras -> a few worked examples of multiple camera setups?
More suggested additions:
- Clear color (really easy to footgun yourself with multiple cameras)
- Viewport-to-world / world-to-viewport + viewport node widget breadcrumb
Zeophlite
reviewed
Jul 28, 2026
cookie1170
suggested changes
Jul 29, 2026
Contributor
|
i would also still like to see the section on |
alice-i-cecile
added
A-Book
S-Needs-Review
X-Contentious
cookie1170
suggested changes
Aug 12, 2026
cookie1170
approved these changes
Aug 25, 2026
cookie1170
left a comment
cookie1170
left a comment
Contributor
There was a problem hiding this comment.
i'm happy with the contents now, just a few nits from a final pass
|
|
||
| However, a `Camera` component doesn't contain enough information on it's own. | ||
| Like we mentioned above, a [`CameraRenderGraph`] component also needs to be present in order for the camera to actually produce a rendered image. | ||
| If you forget to include a `CameraRenderGraph` component, your game will emit an `error` at runtime. |
Contributor
There was a problem hiding this comment.
Suggested change
| If you forget to include a `CameraRenderGraph` component, your game will emit an `error` at runtime. | |
| If you forget to include a `CameraRenderGraph` component, your game will emit an error at runtime. |
| } | ||
| ``` | ||
|
|
||
| A render layer is just a `bitmask` value, which means we aren't limited to only a single render layer. |
Contributor
There was a problem hiding this comment.
Suggested change
| A render layer is just a `bitmask` value, which means we aren't limited to only a single render layer. | |
| A render layer is a bitmask value, which means we aren't limited to only a single render layer. |
| ) { | ||
| // Add all entities with a `RenderLayers` component to layer 3. | ||
| layer_query.iter_mut().for_each(|mut layers| { | ||
| layers.with(3); |
Contributor
There was a problem hiding this comment.
This function doesn't modify the RenderLayers itself, instead, it consumes the value and returns a new instance
|
|
||
| If you start using multiple cameras, you can use the [`UiTargetCamera`] component to indicate a specific camera to render the UI to. | ||
| `UiTargetCamera` is a wrapper around an `Entity` id value for a `Camera` entity. | ||
| Add it to the entity containing the UI elements and your UI will be rendered to the `Camera`s [`RenderTarget`] while also respecting the `Camera`s `Viewport` and scale. |
Contributor
There was a problem hiding this comment.
Suggested change
| Add it to the entity containing the UI elements and your UI will be rendered to the `Camera`s [`RenderTarget`] while also respecting the `Camera`s `Viewport` and scale. | |
| Add it to the entity containing the UI elements and your UI will be rendered to the `Camera`'s [`RenderTarget`] while also respecting the `Camera`'s `Viewport` and scale. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Last "core" part of the rendering chapter, Cameras! I would appreciate some reviews on this, as information is scattered and buried for the intricacies of cameras in Bevy. I think I have a good understanding and laid out everything relevant, but let me know if I've missed anything.
I also went back and added in links to this page from the Render Pipelines page to better link them together. Might still have to expand and clarify some of the connections, but I think they currently work.