raea scene

Find floating, sunk and clipping 3D parts, say what each part rests on, and meter a shot's light.

View as Markdown

raea scene steps a composition's frames and measures its 3D scene without rendering pictures. lint reports parts that float, sink into what they stand on, clip into each other or tilt, and exits 1 on an error. explain says what every part rests on. light meters the light on the shot's subject; given several compositions, it compares their first and last frames across each cut.

Terminal
raea scene lint room.tsx
raea scene explain room.tsx --frame 90 --json
raea scene light room.tsx --part hero
raea scene light film.tsx --composition shot1,shot2,shot3     # the light across the cuts

Usage

Terminal
raea scene export EDIT.tsx -o DIR [--composition ID] [--frame N | --at A-B]   (the composition's 3D as data other tools build: DIR/scene.json, each part placed (y up, metres) with its shape, material or light, and the camera; meshes/ and models/ beside it)
raea scene lint|explain|light EDIT.tsx [--composition ID] [--frame N] [--part NAME] [--json]   (what each 3D part rests on: floating, sunk and clipping parts; light: the scene's lighting)

Headless: it needs nothing running and opens no window. Takes up to 2 arguments besides its flags.

Flags

FlagTakesWhat it does
--atA-Bexport: each part's placement and the camera's field of view on every frame from A to B, for keyframes in Blender or Godot.
--compositionIDWhich composition to measure. light takes several, comma-separated, to compare the light across their cuts.
--frameNThe frame to measure (0 by default; light also takes last).
--json–Print as JSON: lint its findings (check, level, the parts they are about, frames, says, measure, fix), explain every part with its support, gap and box.
--partNAMEWith light: the part to meter, in place of the shot's subject.
-oDIRexport: the folder scene.json is written to, with meshes/ and models/ beside it.

See also

  • 3D covers building and checking a scene.