Appearance
ADR 0014: Clipper output modes
Context
The Clipper made one kind of output: a finished 9:16 video with a subject-following crop, captions and loudness set. Editors who cut the main video need the moments as they are in the source: the source's own size and frame rate, with handles to trim into, and a way to see which moments matter before opening each file. A footage videographer who receives a clip needs the uncropped cut, not the 9:16 version. The processed output cannot give either.
Decision
- Three output modes.
processed(the default) makes the finished 9:16 video.unprocessedmakes raw cuts for the editor.bothmakes the two. The mode isClipSettings.output, set by--outputor the studio's Output setting. - Unprocessed clips. Each moment is cut from the source at the source's size and frame rate, with handles (
ClipSettings.handleSeconds, default 1.5 s, 0 to 10 s, kept before the start and after the end). There is no crop, no burned captions and no loudness change. The cut is a re-encode (H.264, CRF 16) so cut points are exact. Subtitles are a sidecar.srtthat follows the censor setting, which is on by default. - Markers. Up to six per clip, each a time in seconds from the clip start, a kind, a strength between 0 and 1 and a label of at most 70 characters. Kinds:
movement(picture change),sound(loudness rise),line(the longest spoken sentence that is not profane),cut(scene change),peak(the strongest moment),visual(a moment the model saw in the picture, online only). Markers closer than one second merge and the stronger label is kept. Peaks of one kind are at least two seconds apart. In the raw file the times are offset by the handle. Labels are always profanity-masked, whatever the censor setting. - Importance.
high,mediumorlow, judged against the other clips in the same project. The top third by score is high, the middle third medium, the rest low. A clip is raised one level when the model saw a moment in the picture or it has at least three strong markers (strength 0.6 or more, not countingcut). - Review proxy. A scan copy for each unprocessed clip: 480 px tall, 30 fps, source timecode, a HANDLE flag outside the clip, the label, and a timeline bar with a tick per marker. It exists only to be looked at. Handoff never sends it.
- Handoff variant. The sender chooses the file. The default is
raw(the unprocessed cut) for a footage video andprocessedfor an edit video. Both the CLI and the studio's Send dialog offer the choice. The server stores the file as a version, as ADR 0012 describes. - Raw-only projects have no frame board. The frame board is cut from rendered 9:16 clips (ADR 0012).
Consequences
- Unprocessed cuts are large: they keep the source's size and frame rate, and each one is re-encoded. A
bothrun takes longer and needs more disk thanprocessedalone. - Importance and the markers' strength are relative to the project. Scores and importance from two projects are not directly comparable.
- Visual markers exist only where the model saw the picture (ADR 0013). Offline, a clip has the sound, movement, line, cut and peak markers only.
- The EDL (
markers.edl) follows CMX 3600 and has been checked against the format, not yet opened in an editor. Until it has been, it is described as unverified. - Handoff can now send raw cuts, which are source-size files. It is the same path ADR 0012 allows (video leaves the machine only at handoff), with bigger files.
Revisit when
Editors need cuts without re-encoding (stream copy, fast but less exact), a second output format is requested, or importance thresholds prove wrong in practice (editors override most of the high-importance clips, or the low ones are often used).