Create transition (A→B)
create_transitionBuild a parameterized A→B transition with a Progress knob and five styles like dissolve or luma_wipe. Outputs a Null for post-processing with exposed controls.
Instructions
Build a parameterized A→B transition over a single 0–1 Progress knob — the executable core of VJ cutting. Creates a new baseCOMP under parent_path holding two sources (brought in via Select TOPs, or built-in contrasting test looks when omitted) and one of five transition styles: 'dissolve' (a Cross TOP crossfade), 'luma_wipe' (a Ramp-gradient-driven moving edge via GLSL), 'slide' (B pushes in from the right over A), 'zoom' (B scales in over A), or 'glitch_cut' (a hard A→B switch at 0.5 with a brief RGB-split tear). Progress 0 = full A, 1 = full B. Exposes live 'Progress' + 'Duration' knobs; drive Progress from manage_cue / bind_to_channel to run the transition on a beat or cue. Output is a Null ready for post-processing or setup_output. Returns a summary plus a JSON block with the container path, created node paths, the output path, exposed controls, any node errors, warnings, and an inline preview image.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for the transition system COMP. | transition |
| parent_path | No | Where to build it. | /project1 |
| source_a | No | TOP path for the A (outgoing) look. Omitted → a built-in test source (Constant/ramp) so it previews standalone. | |
| source_b | No | TOP path for the B (incoming) look. Omitted → a contrasting built-in test source. | |
| style | No | Transition style: dissolve (crossfade), luma_wipe (gradient-driven edge), slide (B pushes A), zoom (B scales in), glitch_cut (RGB-shift hard cut). | dissolve |
| progress | No | Initial transition position 0=full A, 1=full B (exposed as a live knob). | |
| duration | No | Seconds for an auto Progress sweep when triggered (exposed as a knob; the knob can also be driven by manage_cue/bind_to_channel). | |
| resolution | No | Output resolution [w,h]. |