scene camera

---

navigation: title: Camera & Viewport parent: index.md position: 166 categories:

• scenes

---

Camera & Viewport

Viewport size variants, camera presets, and pan/offset tests.

Viewport Size Variants

256×96 (wide/short):

128×128 (square):

384×256 (large):

Camera Presets

<GameScene> / <Scene> new attributes:

• perspective="isometric_north_east" / "isometric_north_west" / "up" — pick a yaw/pitch/roll preset;
• rotateX / rotateY / rotateZ — explicit per-axis overrides applied on top of the preset;
• offsetX / offsetY — screen-space pan (units: blocks);
• centerX / centerY / centerZ — explicit world-space rotation center (overrides auto-center).

NE vs NW preset:

Top-down view (up):

Pan Offset

offsetX / offsetY pan — right scene offset by +2 / +1 blocks:

DiamondAnnotation Default Color

Without color, the diamond defaults to bright green (compare against an explicit red diamond):

Default green diamond (no `color` attribute) Explicit red

IsometricCamera Yaw / Pitch / Roll

<IsometricCamera> inside a <GameScene> sets explicit yaw / pitch / roll angles, overriding any perspective preset.

• yaw — horizontal rotation around the Y-axis (degrees, 0–360).
• pitch — vertical tilt (degrees, –90 to 90; positive looks downward).
• roll — in-plane rotation (degrees, –180 to 180).

NE preset vs explicit yaw 45° pitch 30° (should look identical):

Top-down with yaw 90° (rotated 90° clockwise vs the default up preset):

Roll test — left: roll 0°, right: roll 15°: