Command · New Synthetic Item

media.newSynthetic

Makes a synthetic project item (File > New): "colorMatte" (params color.r/g/b, 0..1: a background for text, a flash), "blackVideo" or "transparentVideo" (a layer of its own for effects that draw).

• v1
• Capability EditProject
• Tool media_newSynthetic

Request

{
  "command": "media.newSynthetic",
  "params": {
    "kind": "colorMatte",
    "params": {
      "color.b": 0.6,
      "color.g": 0.2,
      "color.r": 0.1
    }
  }
}

Parameters

bininteger (1..)

The bin to put it in (bin id). Default: the root.

kind`blackVideo` | `colorMatte` | `transparentVideo`Required

What to make.

namestring

The item's name. Default: the kind's name ("Color Matte").

paramsobject

Settings by key; missing ones take the defaults (white).

params.color.bnumber (0.0..1.0)

colorMatte: blue, 0..1.

params.color.gnumber (0.0..1.0)

colorMatte: green, 0..1.

params.color.rnumber (0.0..1.0)

colorMatte: red, 0..1.

sequenceinteger (1..)

Sequence id; only needed when the project has several.

Discussion

Run it with wabcut-cli cmd <project> --json, from an MCP client as media_newSynthetic, or from an extension. See Edit commands for requests, references and results.