raea check

raea check has two speeds. On a composition with --quick, it renders three stills and measures the text: clipped, cramped, inside the safe areas, large enough to read, and what the stills' render found (3D parts clipping). The stills are a quarter in, the middle and the last frame of the length a render of frame 0 reports, however durationInFrames is written, and the report names them (ok looked at frames 75, 150 and 299 of 300). That takes about a second, so run it after every save. On an exported video, it measures everything the floor asks of a finished piece. Each finding is an error, a warn or a note (raea's one finding, as raea scene lint and a render's manifest have it), says on which frames and how to fix it, and the command exits 1 while an error stands. A check of a file in a raea project keeps its findings in the project's record (.raea/record/), beside its renders', which raea findings and raea next read.

raea check piece.tsx --quick --platform tiktok
raea render piece.tsx -o piece.mp4 --manifest render.json
raea check piece.mp4 --manifest render.json --words words.json --platform tiktok -o check.json

What a full check can see depends on what you give it. The file alone gives loudness, true peak, sound that stops dead, frozen stretches and blotching in dark areas. The render's manifest adds text clipped off the frame, text under the platform's buttons, captions held too briefly and caption contrast. The transcript adds cues away from their word and music fighting the voice; the perception adds text over a face. A taste file adds the person's own rules, each an error when broken, since their rule beats the floor's default.

#Every rule a project holds

On a project, or a composition's file, with no --quick, raea check runs every rule that applies to each composition: raea's floor on its newest render, your taste's measurable lines, and the rules in the workspace's and the project's controllers. A rule is a controller field of type rule: its words, and the check that holds it, either one of raea's by name with its values or a .ts check of your own.

raea's reading check, text-read, runs on the newest render too, with nothing asking for it. Each text's reading time (0.3 s a word, at least a second) is held to the frames it can be read on (in the frame, at an opacity, size and contrast that read, and not covered), not the frames it's on, and the finding says which frames were lost and why. Text that can be read where OCR doesn't read it is an error: it's broken. Render with --layers so what covers a text is counted.

// controllers/rules.ts
{ label: "Captions clear the button band", type: "rule", check: "../checks/caption.ts", values: { band: 0.8 } }

A check is a system over the composition's world, the same world raea world prints, so it reads a caption, a footage cut, a cue and a 3D part the same way. It says which frames it ranges over and whether it needs a render, and calls found for each thing that breaks the rule; it never prints.

// checks/caption.ts
import { check, found, type Layer, type Text } from "raea/check";

export default check({ id: "caption", text: "a caption clears the platform's button band" }, (world, _frame, values) => {
  const band = Number(values.band ?? 0.8);
  for (const t of world.find({ with: ["Text", "Layer"] })) {
    if (world.component<Layer>(t, "Layer")!.medium !== "2d-type") continue;
    const box = world.component<Text>(t, "Text")!.box; // in frame fractions: left, top, right, bottom
    if (box && box[3] > band) found({ about: [t], says: `the caption reaches ${Math.round(box[3] * 100)}% down the frame` });
  }
});

What needs a render and has none waits, and the report says what it waits for. A render older than the composition's last change is still joined, with a note that what it measured may have moved.

#Usage

raea check EDIT.tsx --quick [--shape S] [--platform P] [--taste T] [-o check.json]   (three stills of a composition checked for text: clipped, cramped, safe areas, sizes; about a second)
raea check [PROJECT|EDIT.tsx] [--composition ID] [--only ID] [--taste T] [--render OUT | --no-render] [--json]   (every check that applies to each composition, over its frames: raea's floor on its newest render, the person's taste, the workspace's and the project's rules (a controller's rule fields: one of raea's checks by name, or a project's .ts check); what needs a render and has none waits, and says so)
raea check VIDEO.mp4 [--manifest render.json] [--words W.json] [--perception P.json] [--things T.json] [--shape 16:9|9:16|4:5|1:1] [--platform tiktok|reels|shorts] [--taste taste.ts|DIR] [-o check.json]   (an export against the floor: clipped text, contrast, safe areas, freezes, flashing, cues, loudness, blotching, a placeholder brand kit, and with --things what `raea fingerprint things --json` found: a thing floating or passing through another, the camera lurching mid-move, an empty frame; its findings errors, warns and notes)

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

#Flags

#See also

• Rendering and checking lists what the full check measures and how loudness is set.