docs: restructure Cameras section into multi-page, workflow-agnostic docs#1041
Merged
Conversation
…docs Following the pattern established by the shadows page rewrite (#1037), this restructures the Cameras section from a single Editor-focused page into a full multi-page section with Engine/Editor/React/Web Components tabs throughout: - index.md: rewritten as a section overview covering camera creation, render target clearing, and links to all subpages - projection.md (new): perspective vs orthographic, FOV, clip planes, aspect ratio, and frustum culling - tone-mapping.md (new): per-camera tone mapping curves, gamma correction, and physically based exposure - multiple-cameras.md (new): priority, viewports, layers, camera stacking, and render targets - camera-controls.md (new): the engine's camera-controls.mjs script (orbit/fly/pan) across all workflows - screen-and-world.md (new): screenToWorld/worldToScreen patterns All engine facts verified against engine source. Japanese translations mirrored for all pages. Sidebar updated with the new pages. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…le Cameras Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Clearing applies to single-camera setups too (background color, transparent canvases), so it doesn't belong on the Multiple Cameras page. Promote it to a dedicated Clearing page, adding coverage of transparent backgrounds over the web page. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
camera/multi demonstrates the combined CameraControls scheme, not multi-camera rendering - move it to the Camera Controls page and use graphics/multi-view (two cameras with separate rects and layers) on the Multiple Cameras page instead. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Drop the pc. prefix from constants mentioned in prose and link them to their api.playcanvas.com variable pages (ASPECT_*, TONEMAP_*, GAMMA_*), matching the convention used elsewhere in the manual. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Restructures the User Manual “Cameras” section from a single page into a multi-page, workflow-agnostic set of docs (EN + JA) and updates the Docusaurus sidebar accordingly.
Changes:
- Rewrites the Cameras index page to introduce the section and add workflow-specific creation guidance (Engine / Editor / React / Web Components).
- Adds new focused sub-pages (projection, clearing, tone mapping/exposure, multiple cameras, camera controls, screen/world coordinate conversion) with shared structure across workflows.
- Mirrors the full restructure in Japanese translations and updates the sidebar nav ordering.
Reviewed changes
Copilot reviewed 15 out of 15 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| sidebars.js | Adds the new Cameras sub-pages to the Graphics → Cameras sidebar list. |
| docs/user-manual/graphics/cameras/index.md | Rewrites the Cameras landing page into an overview + section tour with workflow tabs. |
| docs/user-manual/graphics/cameras/projection.md | New page covering perspective/orthographic projection, clip planes, aspect ratio, frustum culling. |
| docs/user-manual/graphics/cameras/clearing.md | New page documenting camera clear behavior, transparent backgrounds, and disabling clear. |
| docs/user-manual/graphics/cameras/tone-mapping.md | New page documenting per-camera tone mapping, gamma correction, and physical exposure. |
| docs/user-manual/graphics/cameras/multiple-cameras.md | New page documenting composition via priority, viewports, layers, stacking, render targets, performance. |
| docs/user-manual/graphics/cameras/camera-controls.md | New page documenting the engine’s camera-controls script across workflows. |
| docs/user-manual/graphics/cameras/screen-and-world.md | New page documenting screenToWorld/worldToScreen patterns and picking. |
| i18n/ja/docusaurus-plugin-content-docs/current/user-manual/graphics/cameras/index.md | Japanese mirror of the updated Cameras landing page. |
| i18n/ja/docusaurus-plugin-content-docs/current/user-manual/graphics/cameras/projection.md | Japanese mirror of the Projection page. |
| i18n/ja/docusaurus-plugin-content-docs/current/user-manual/graphics/cameras/clearing.md | Japanese mirror of the Clearing page. |
| i18n/ja/docusaurus-plugin-content-docs/current/user-manual/graphics/cameras/tone-mapping.md | Japanese mirror of the Tone Mapping & Exposure page. |
| i18n/ja/docusaurus-plugin-content-docs/current/user-manual/graphics/cameras/multiple-cameras.md | Japanese mirror of the Multiple Cameras page. |
| i18n/ja/docusaurus-plugin-content-docs/current/user-manual/graphics/cameras/camera-controls.md | Japanese mirror of the Camera Controls page. |
| i18n/ja/docusaurus-plugin-content-docs/current/user-manual/graphics/cameras/screen-and-world.md | Japanese mirror of the Screen/World Coordinates page. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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
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.
Summary
Restructures the Cameras section of the user manual from a single thin, Editor-focused page into a full multi-page section, following the workflow-agnostic pattern established by the shadows rewrite (#1037).
New section structure
index.md(rewritten)projection.md(new)clearing.md(new)tone-mapping.md(new)multiple-cameras.md(new)camera-controls.md(new)camera-controls.mjsscript (orbit/fly/pan) across all four workflows, key attributesscreen-and-world.md(new)screenToWorld/worldToScreenpatterns: mouse rays, object placement, HTML overlaysThe existing
scene-picker.mdanddepth-layer.mdpages are unchanged and remain in the section.Notes
<Tabs groupId="workflow">pattern (Engine / Editor / React / Web Components) where implementation differs.<EngineExample>embeds used instead of new screenshots:graphics/multi-viewandgraphics/render-to-texture(Multiple Cameras),camera/orbit,camera/flyandcamera/multi(Camera Controls),graphics/light-physical-units(Tone Mapping & Exposure).api.playcanvas.com/engine/variables/...).camera-icon.pngusage (viewport entity icons are now documented on the Viewport page);camera-create.pngmoved inside the Editor tab.🤖 Generated with Claude Code