Skip to content

docs: restructure Cameras section into multi-page, workflow-agnostic docs#1041

Open
willeastcott wants to merge 1 commit into
mainfrom
docs/restructure-cameras-section
Open

docs: restructure Cameras section into multi-page, workflow-agnostic docs#1041
willeastcott wants to merge 1 commit into
mainfrom
docs/restructure-cameras-section

Conversation

@willeastcott

Copy link
Copy Markdown
Contributor

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

Page Content
index.md (rewritten) Section overview: what cameras are, creating one (4-way workflow tabs), clearing the render target, section tour
projection.md (new) Perspective vs orthographic, FOV/orthoHeight, clip planes & depth precision, aspect ratio, frustum culling
tone-mapping.md (new) Per-camera tone mapping curves, gamma correction, physically based exposure (aperture/shutter/sensitivity)
multiple-cameras.md (new) Priority ordering, viewports (split-screen), layers, camera stacking, render targets, performance notes
camera-controls.md (new) The engine's camera-controls.mjs script (orbit/fly/pan) across all four workflows, key attributes
screen-and-world.md (new) screenToWorld / worldToScreen patterns: mouse rays, object placement, HTML overlays

The existing scene-picker.md and depth-layer.md pages are unchanged and remain in the section.

Notes

  • All pages use the <Tabs groupId="workflow"> pattern (Engine / Editor / React / Web Components) where implementation differs.
  • Engine facts (property defaults, constants, script attributes) verified against current engine source.
  • Live <EngineExample> embeds used instead of new screenshots (camera/multi, camera/orbit, camera/fly, graphics/render-to-texture, graphics/light-physical-units).
  • Japanese translations mirrored for all six pages.
  • Sidebar updated with the five new pages.
  • Dropped the standalone camera-icon.png usage (viewport entity icons are now documented on the Viewport page); camera-create.png moved inside the Editor tab.

🤖 Generated with Claude Code

…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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant