add_effect
Apply a Nuke soft effect such as Grade, Transform, or Text2 to a shot or frame range, with optional knob values and track or sequence targeting.
Instructions
Add a soft effect (Nuke node class, e.g. "Grade", "Transform", "Text2") over a shot or a frame range.
`knobs` sets node knob values, e.g. {"white": 1.2}. Without item or range it covers the whole sequence.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"effect_type": "<effect_type>"
},
"name": "add_effect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | ||
| knobs | No | ||
| track | No | ||
| project | No | ||
| sequence | No | ||
| effect_type | Yes | ||
| timeline_in | No | ||
| timeline_out | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||