Command · Add Hold Segment
timeRemap.addHold
Holds the frame shown at a timeline time for a duration inside a remapped clip; the rest of its remap plays later.
- v1
- Capability EditSequence
- Tool
timeRemap_addHold
Request
{
"command": "timeRemap.addHold",
"params": {
"clip": 42,
"duration": "00:00:01:00",
"extendClip": true,
"time": "00:00:02:00"
}
}Parameters
clipinteger | object (1..)Required- The clip. A clip id, or {"track", "time"} for the clip there.
durationinteger | stringRequired- How long the frame holds. Timecode in the sequence's rate ("00:01:02:03") or ticks.
extendClipboolean- Lengthen the clip by the time the remap gains (or shorten it by what it loses), moving later clips like a ripple trim. Default false: the clip keeps its length.
linkedboolean- Linked partners take part too (default true).
sequenceinteger (1..)- Sequence id; only needed when the project has several.
timeinteger | stringRequired- Where the hold starts (inside the clip). Timecode in the sequence's rate ("00:01:02:03") or ticks.
Discussion
Holds the frame shown at a timeline time for a duration inside a remapped clip; the rest of its remap plays later.
Run it with wabcut-cli cmd <project> --json, from an MCP client as timeRemap_addHold, or from an extension. See Edit commands for requests, references and results.
See also
timeRemap.*
- timeRemap.addKey
Add Time Remap Key. Adds a remap key at the sampled source position of a timeline time inside a remapped clip.
- timeRemap.addReverse
Add Reverse Segment. From a timeline time inside a remapped clip, plays the media backwards at 100 % for a duration, then forwards again over the same frames (a boomerang); the rest of the remap plays later by twice the duration.
- timeRemap.enable
Time Remapping. Turns time remapping on (speed ramps, holds and reverse inside one clip; the clip shows the same frames, also beyond its ends for transitions and trims; keyframes of a clip that was not at 100 % then animate at timeline rate) or off (back to a constant speed: the one it shows if a single straight segment covers it, else 100 % from its first frame).
- timeRemap.moveKey
Move Time Remap Key. Moves a remap key to another timeline time.
- timeRemap.removeKey
Remove Time Remap Key. Removes a remap key (not the only one).
- timeRemap.setInterpolation
Set Time Remap Interpolation. Shapes the remap around keys: linear (constant speed between keys), hold (the frame holds until the next key, then jumps), or easeIn / easeOut / easeInOut / bezier for a smooth speed ramp.
- timeRemap.setKey
Set Time Remap Key. Changes a remap key's source position, interpolation and Bezier handles together.
- timeRemap.setSpeed
Set Segment Speed. Sets the speed of one segment of a remapped clip (between two keys; the one playing at "time", or "segment" by index): its end key and the keys after it move, so later material plays earlier or later.