Captions

Captions in Pireel Studio are a global preset layer laid from the spoken transcript: ONE setting styles the WHOLE video. They are not per-block edits — a single set_captions call turns them on, restyles them, or repositions them everywhere at once, and cutting the video re-lays them automatically (never hand-fix captions after a cut).

The keyword-slam "花字" effect is a different thing: that is an overlay block (BYO flow via compose_block_brief → apply_block), not the caption layer.

Tools

• set_captions {preset?, yPct?, scale?} — turn captions on and/or restyle:
  • preset — a style id from the catalog below. Passing it (re)builds the layer from the transcript, enabling captions if off; ASR runs first automatically if there is no transcript yet. Never invent an id.
  • yPct — the caption baseline's distance from the TOP as a percentage. Smaller = higher on screen. Omit to keep current.
  • scale — size multiplier; 1 = the preset's default. Omit to keep current.
  • Omit preset to only reposition/resize the current captions (e.g. "move the subtitles up a bit" → set_captions {yPct: <smaller>}; "make them bigger" → set_captions {scale: 1.2}).
• remove_captions — turn the whole layer off. It does not touch keyword blocks (delete those with delete_block).
• set_caption_translations {items?, shotId?, clear?} — bilingual subtitles (see below).

get_state reports the current caption status (Captions: ON — preset …, baseline …% from top or off).

Bilingual subtitles (translation line)