Edit command

addTextClip

Places a title: a clip with no media behind it, named after the text's first line.

Fields

  • startnumberrequired

    Timeline position in seconds, floored at 0.

  • abovebooloptional · default false

    When trackId is None and this is true, the clip lands on the first free lane above the highest one occupied over its span, minting a new lane at the top when every one above is taken. What the editor sets for a caption and for a title alike, so words sit over the video rather than under it; false keeps the bottom-first walk of addClipAtFirstFree. Ignored when trackId names a track.

  • durationnumberoptional

    Seconds on the timeline; the editorial default when absent. Here so a caption run can land as one batch instead of add-then-trim per clip - a batch cannot trim a clip whose id it cannot know yet.

  • offsetYnumberoptional

    Vertical placement as a frame-height fraction, clamped like SetClipTransform. Lower thirds are made of this.

  • styleTextStyleoptional

    The words and their look. None means TextStyle.

  • trackIdstringoptional

    The lane to place it on. None picks the first free track like addClipAtFirstFree; naming a vanished track errs.

{
  "op": "addTextClip",
  "start": 1,
  "duration": 3,
  "style": {
    "content": "Chapter one",
    "fontSize": 0.12,
    "color": "#ffcc00"
  },
  "offsetY": 0.35
}