Skip to content

Commands

item.trim

Moves the start edge or the end edge of an item to a timeline position.

Last updated:

Moves an edge to an absolute position and keeps the source range, the keyframes and the caption words consistent. The end edge is exclusive: it is the first frame after the item.

Arguments#

ArgumentTypeRequiredDescription
edgestart, endyes
item_idstringyes
tostringyesAbsolute position of the edge; the end is exclusive.

Example#

As one operation of an edit batch (the edit tool of MCP, vukem-video edit --ops, or POST /api/v1/projects/{id}/edit):

JSON
{
  "op": "item.trim",
  "args": {
    "edge": "start",
    "item_id": "itm_m1n2p3q4r5",
    "to": "97f"
  }
}

Errors#

E_VALIDATION, E_INVALID_TIME, E_NOT_FOUND, E_INVALID_STATE, E_OUT_OF_SOURCE, E_OVERLAP

Scope and phase#

Scope edit, phase prototype. Run vukem-video command:help item.trim for the same description from the binary.