Command · Remove Mask
mask.remove
Removes a mask from its effect.
- v1
- Capability EditSequence
- Tool
mask_remove
Request
{
"command": "mask.remove",
"params": {
"clip": 42,
"mask": 1
}
}Parameters
clipinteger | object (1..)Required- The clip. A clip id, or {"track", "time"} for the clip there.
effectinteger (1..)- The effect instance id (clip.details lists them). mask.add: omit for the clip's opacity mask (cut-outs); the others: default the effect holding the mask.
maskinteger (1..)Required- The mask id.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
Discussion
Removes a mask from its effect.
Run it with wabcut-cli cmd <project> --json, from an MCP client as mask_remove, or from an extension. See Edit commands for requests, references and results.
See also
mask.*
- mask.add
Add Mask. Adds a mask to a clip: to an effect ("effect"; the effect then only changes the masked area - a local correction, including the colour grade) or, without "effect", to the clip's opacity mask (it cuts the clip out).
- mask.list
List Masks. A clip's masks by effect, with their parameters (keys at media times) and paths.
- mask.objectSelect
Select Object. AI Object Mask: segments the person or object you click on (positive and negative clicks), draw a box around, or name ("subject": a face, a person, a car...) on a frame of a clip with SAM 2.1 (local, on this computer), and tracks it through the shot.
- mask.propagate
Track Object Mask. Tracks an object mask's object through the clip (or In / Out) from its last clicked frame: after a selection made with "propagate": "none", or across a shot cut with acrossShots.
- mask.refine
Refine Object Mask. More clicks (positive: part of the object; negative: not) or a new box on a frame of an object mask: segments it again there and re-tracks from that frame.
- mask.update
Update Mask. Changes a mask: only the fields given (name, shape, mode, inverted, enabled, params, path / pathKeys).