Sets fit (cover, contain or none) and merges the given crop sides with the current ones. Each side is a fraction of the asset from 0 to 1; left plus right and top plus bottom must stay below 1.
Arguments#
| Argument | Type | Required | Description |
|---|---|---|---|
crop | object | no | Sides to crop, fractions 0 to 1; sides not given keep their value. |
fit | cover, contain, none | no | cover (default), contain or none. |
item_id | string | yes | A clip. |
Example#
As one operation of an edit batch (the edit tool of MCP, vukem-video edit --ops, or POST /api/v1/projects/{id}/edit):
{
"op": "clip.set_framing",
"args": {
"crop": {
"left": 0.1,
"right": 0.1
},
"fit": "contain",
"item_id": "itm_m1n2p3q4r5"
}
}Errors#
E_VALIDATION, E_NOT_FOUND, E_TYPE_MISMATCH
Scope and phase#
Scope edit, phase alpha. Run vukem-video command:help clip.set_framing for the same description from the binary.