Switcher
Cut or transition between up to four sources; outputs the program. The face of the switcher widget.
- Video
- Since 0.2.0
- switcher
- program
- transition
Switcher cuts or transitions between up to four sources and outputs the program.
What it does#
Program chooses the source on the output and Preview the next one. Changing Program starts the Transition, which lasts Duration milliseconds. Inputs are in1 to in4, one stream each.
When to use it#
Use it as a live vision mixer. The switcher widget is planned as its Frame face; the parameters stay the authority.
Ports#
| Port | Direction | Signal | Lanes |
|---|---|---|---|
in1 | Input | Video | 1 |
in2 | Input | Video | 1 |
in3 | Input | Video | 1 |
in4 | Input | Video | 1 |
video | Output | Video | 1 |
Parameters#
| Parameter | Label | Range | Default | Unit | Scale | Notes |
|---|---|---|---|---|---|---|
program | Program | 1 to 4 | 1 | linear | The source on air; changing it starts the transition. | |
preview | Preview | 1 to 4 | 2 | linear | The source cued next; Take swaps it with the program. | |
transition | Transition | 0 to 4 | 1 | linear | How a program change moves between sources. Choices: 0 Cut, 1 Dissolve, 2 Wipe left, 3 Wipe right, 4 Wipe down. | |
duration_ms | Duration | 0 to 5000 | 400 | ms | linear | Length of a dissolve or wipe. |
Program (program)#
The source shown on the output, 1 to 4.
Preview (preview)#
The source ready for the next take, 1 to 4.
Transition (transition)#
How a change of Program happens; 0 is a cut.
Duration (duration_ms)#
Length of a transition in milliseconds.
Tips#
- Make Program a public parameter so a Frame or MIDI control can take it.
- Video needs the browser's WebGPU video engine. The Player and exports do not run video yet and report it unavailable. To see a video output, bind a live Screen in the Frame to it.
See also#
Video crossfade, Multiview, Composite, Video, Control lanes.
Help patches
Each help patch is an ordinary Toy that teaches one idea. The diagram shows the Patch; the preview shows its Frame. Open it in TuneToys to play and edit it.
1. Four-source switcher
intermediate Teaches: program, preview, transition, duration_ms
Four text sources cut or transition to the program.
FieldsAuto
Video1 stream
Font size in pixels of the rendered frame. Range: 8–400 px. Default: 64 px. Logarithmic scale. Units: px.
px
Horizontal anchor position across the frame. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Vertical anchor position down the frame. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Text alignment at the anchor. Range: 0–2. Default: 1. Linear scale. Units: unitless.
Red component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Green component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Blue component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Opacity of the text. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Strength of the drop shadow behind the text. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Decimal places shown for lane values. Range: 0–4. Default: 0. Linear scale. Units: unitless.
Width of the rendered frame. Range: 64–3840 px. Default: 1280 px. Linear scale. Units: px.
px
Height of the rendered frame. Range: 64–2160 px. Default: 720 px. Linear scale. Units: px.
px
FieldsAuto
Video1 stream
Font size in pixels of the rendered frame. Range: 8–400 px. Default: 64 px. Logarithmic scale. Units: px.
px
Horizontal anchor position across the frame. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Vertical anchor position down the frame. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Text alignment at the anchor. Range: 0–2. Default: 1. Linear scale. Units: unitless.
Red component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Green component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Blue component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Opacity of the text. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Strength of the drop shadow behind the text. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Decimal places shown for lane values. Range: 0–4. Default: 0. Linear scale. Units: unitless.
Width of the rendered frame. Range: 64–3840 px. Default: 1280 px. Linear scale. Units: px.
px
Height of the rendered frame. Range: 64–2160 px. Default: 720 px. Linear scale. Units: px.
px
FieldsAuto
Video1 stream
Font size in pixels of the rendered frame. Range: 8–400 px. Default: 64 px. Logarithmic scale. Units: px.
px
Horizontal anchor position across the frame. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Vertical anchor position down the frame. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Text alignment at the anchor. Range: 0–2. Default: 1. Linear scale. Units: unitless.
Red component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Green component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Blue component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Opacity of the text. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Strength of the drop shadow behind the text. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Decimal places shown for lane values. Range: 0–4. Default: 0. Linear scale. Units: unitless.
Width of the rendered frame. Range: 64–3840 px. Default: 1280 px. Linear scale. Units: px.
px
Height of the rendered frame. Range: 64–2160 px. Default: 720 px. Linear scale. Units: px.
px
FieldsAuto
Video1 stream
Font size in pixels of the rendered frame. Range: 8–400 px. Default: 64 px. Logarithmic scale. Units: px.
px
Horizontal anchor position across the frame. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Vertical anchor position down the frame. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Text alignment at the anchor. Range: 0–2. Default: 1. Linear scale. Units: unitless.
Red component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Green component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Blue component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Opacity of the text. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Strength of the drop shadow behind the text. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Decimal places shown for lane values. Range: 0–4. Default: 0. Linear scale. Units: unitless.
Width of the rendered frame. Range: 64–3840 px. Default: 1280 px. Linear scale. Units: px.
px
Height of the rendered frame. Range: 64–2160 px. Default: 720 px. Linear scale. Units: px.
px
In 11 stream
In 21 stream
In 31 stream
In 41 stream
Video1 stream
The source on air; changing it starts the transition. Range: 1–4. Default: 1. Linear scale. Units: unitless.
The source cued next; Take swaps it with the program. Range: 1–4. Default: 2. Linear scale. Units: unitless.
How a program change moves between sources. Range: 0–4. Default: 1. Linear scale. Units: unitless.
Length of a dissolve or wipe. Range: 0–5000 ms. Default: 400 ms. Linear scale. Units: ms.
ms
Audio2ch
Connections as text
- Text layer “one” video output connected to Switcher in1 input
- Text layer “two” video output connected to Switcher in2 input
- Text layer “three” video output connected to Switcher in3 input
- Text layer “four” video output connected to Switcher in4 input
- Program is the source on the output; changing it starts the transition.
- Transition 0 is a cut; Duration sets the others.
Related nodes
- Video crossfade Blend two streams with one mix control.
- Multiview Tile a bundle of streams into one picture with labels, for monitoring.
- Composite Stack up to four layers over a base at the base's size with blend mode, opacity, position and scale per layer.