Command · Zoom Punch
clip.zoomPunch
A punch-in zoom on a moment of a video clip: Motion Scale keys ease in to "scale" times the clip's scale, hitting at "at", hold, and ease back out ("attack" and "release" are shares of "seconds").
- v1
- Capability EditSequence
- Tool
clip_zoomPunch
Request
{
"command": "clip.zoomPunch",
"params": {
"at": "00:00:12:10",
"clip": 42,
"scale": 1.4
}
}Parameters
atinteger | stringRequired- When the punch hits (full zoom). Timecode in the sequence's rate ("00:01:02:03") or ticks.
attacknumber (0.05..0.9)- Share of the punch easing in. Default 0.2.
clipinteger | object (1..)Required- The video clip. A clip id, or {"track", "time"} for the clip there.
easing`linear` | `easeIn` | `easeOut` | `easeInOut`- The keys' easing. Default easeInOut.
focusobject- The point the zoom closes in on. Default: the clip's anchor.
focus.xnumber (0.0..1.0)Required- Across, a fraction of the frame width.
focus.ynumber (0.0..1.0)Required- Down, a fraction of the frame height.
releasenumber (0.0..0.9)- Share easing back out (0 = cut back). Default 0.4.
scalenumber (1.01..10.0)- Zoom at the peak, a factor of the clip's scale. Default 1.3.
secondsnumber (0.02..30.0)- The whole punch. Default 0.5. Seconds.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
Discussion
A punch-in zoom on a moment of a video clip: Motion Scale keys ease in to "scale" times the clip's scale, hitting at "at", hold, and ease back out ("attack" and "release" are shares of "seconds"). With "focus" the zoom closes in on that point of the frame (Position keys too). Keys already inside the punch are replaced. One undo step; the keys stay editable.
Run it with wabcut-cli cmd <project> --json, from an MCP client as clip_zoomPunch, or from an extension. See Edit commands for requests, references and results.
See also
clip.*
- clip.addEffect
Apply Effect. Adds an effect to the stack of each clip (video effects on video clips, audio effects on audio clips).
- clip.addKeyframe
Add Keyframe. Adds a keyframe at a timeline time inside the clip (or replaces the one there).
- clip.details
Clip Details. Everything about one clip: track, timeline and source range (ticks and timecode), media, stream, speed, enabled, label colour, linked clips and all parameter values.
- clip.enable
Enable. Enables or disables clips (Premiere Shift+E).
- clip.fade
Fade. Fades clips in and/or out with keyframes: opacity on video clips (to 0), level on audio clips (to -144 dB).
- clip.find
Find Clips. Finds clips by name (case-insensitive substring), by a time they cover, by track and by media.
- clip.frameHold
Frame Hold. Holds the frame at a time.
- clip.insert
Insert. Insert edit (Premiere ','): puts a media source range onto the patched tracks at a time and pushes later material on those tracks and every sync-locked track later, cutting through clips there.
- clip.instantReplay
Instant Replay. Replays a moment right after itself in slow motion, Premiere-style instant replay in one step: the moment's clips are copied and inserted right after it (everything later moves, sync-locked tracks stay in sync) with a speed ramp (100 % easing into "speed" and back), the REPLAY stinger template over the replay and a white flash at each cut.
- clip.link
Link. Links clips so they select and edit together.
- clip.move
Move. Moves clips in time and across tracks.
- clip.moveEffect
Reorder Effect. Moves an effect to another position in the clip's stack.
- clip.moveKeyframe
Move Keyframe. Moves a keyframe to another timeline time inside the clip.
- clip.openNested
Open Nested Sequence. The sequence a nested or multicam clip plays (open it to edit inside), the range of it the clip shows and, for a multicam clip, its active angles.
- clip.overwrite
Overwrite. Overwrite edit (Premiere '.'): puts a media source range onto the patched tracks at a time, replacing whatever is there.
- clip.pasteAttributes
Paste Attributes. Premiere's Paste Attributes (Ctrl+Alt+V): the chosen attributes of the clipboard's clip (the first one of each target's kind: video attributes from the copied video clip, audio ones from the audio clip) or of "source" onto "clips".
- clip.removeAttributes
Remove Attributes. Premiere's Remove Attributes: the chosen parameters go back to their defaults (keyframes too), time remapping is turned off (the clip plays at 100 % from the frame it started on), effects are removed by id (or all).
- clip.removeEffect
Remove Effect. Removes an effect instance from a clip's stack.
- clip.removeKeyframe
Remove Keyframe. Removes a keyframe; removing the last one leaves the parameter constant at its value.
- clip.rename
Rename Clip. Renames clips (the name shown on the timeline; the media keeps its name).
- clip.rippleTrim
Ripple Edit. Ripple edit (B): moves a clip's In or Out point and ripples later material (sync-locked tracks too).
- clip.roll
Rolling Edit. Rolling edit (N): moves the edit point at a clip's edge, trimming the neighbour the other way.
- clip.setAnimated
Toggle Animation. Premiere's stopwatch.
- clip.setBlendMode
Set Blend Mode. Sets the blend mode of video clips (the Opacity section's Blend Mode, Premiere's list): how each clip combines with what is below it.
- clip.setColor
Set Label Color. Sets the label colour of clips (0-15).
- clip.setEffect
Set Effect. Turns an effect on or off or sets its parameters (constants; animate them with clip.addKeyframe and "effect").
- clip.setKeyframe
Set Keyframe. Changes a keyframe's value, interpolation (hold, linear, bezier, easeIn, easeOut, easeInOut) or Bezier handles (slope in units per second, influence 0..1 of the segment).
- clip.setParam
Set Clip Parameter. Sets one effect parameter (motion, opacity, volume, pan) on clips.
- clip.shake
Camera Shake. A camera shake on a video clip from "at": Motion Position (and Rotation) keys of a seeded random pattern that decays over "seconds", plus a slight zoom so the clip's edges do not show ("cover").
- clip.slide
Slide. Slide (U): moves a clip between its neighbours, trimming them to compensate.
- clip.slip
Slip. Slip (Y): shifts which source frames clips show, keeping their place and length.
- clip.speedDuration
Speed/Duration. Ctrl+R: plays each clip's material at a new speed (percent; 200 = twice as fast) or fits it into a new duration; can reverse it and keep audio pitch.
- clip.splitAtShots
Split at Shots. Razors each clip at the cuts in its video (scene-edit detection), with its linked partners.
- clip.trim
Trim. Trim an edge (selection tool): moves a clip's In or Out point without moving anything else.
- clip.unlink
Unlink. Takes clips out of their link groups.