4plexvid

4plexvid · utilities

4PLEXVID is a 4-in / 4-out video router — the video sibling of the audio 4Plexer. It is NOT a blend or mixer: each of the four outputs carries exactly ONE of the four video inputs, a discrete cross-point switch. Every output has its own selector (sel1..sel4 picking IN1..IN4) and its own gate CV input that advances that selector by one on each rising edge (IN1→IN2→IN3→IN4→IN1, wrapping). The fragment shader is a pure passthrough copy of the selected input texture (it writes the input's RGB straight through, or solid black when that input is unpatched), so there is no color processing — pixels pass straight through. All four outputs render their own FBO every frame regardless of patch state, so downstream modules always sample a fresh texture; OUT1 is also exposed as the canonical single-texture surface. Use it to fan one set of sources out to four destinations, to swap which feed reaches a screen, or to drive rhythmic cuts by clocking the gate inputs from an LFO or sequencer.

the faceplate

8 inputs · 4 outputs · 8 params

about this module

Hover a control, or open the patch panel and hover a jack.

inputs

id	cable	what it does
`in1`	video	Video input 1. A source you can route to any output by setting that output's selector (sel1..sel4) to IN1. RGB video stream
`in2`	video	Video input 2. A source you can route to any output by setting that output's selector to IN2. RGB video stream
`in3`	video	Video input 3. A source you can route to any output by setting that output's selector to IN3. RGB video stream
`in4`	video	Video input 4. A source you can route to any output by setting that output's selector to IN4. RGB video stream
`gate1`	cv	Gate CV for output 1, edge-triggered (paramTarget gate1). On each rising edge it advances the sel1 selector to the next input, wrapping IN1→IN2→IN3→IN4→IN1. Held-high advances exactly once; hysteresis (rise>0.6, fall<0.4) absorbs LFO/ADSR dead-band chatter. control voltage (CV); modulates gate1 (summed directly (the destination DSP scales it))
`gate2`	cv	Gate CV for output 2, edge-triggered (paramTarget gate2). Each rising edge rotates the sel2 selector to the next input, wrapping; held-high fires once via the same hysteresis edge detector. control voltage (CV); modulates gate2 (summed directly (the destination DSP scales it))
`gate3`	cv	Gate CV for output 3, edge-triggered (paramTarget gate3). Each rising edge rotates the sel3 selector to the next input, wrapping; held-high fires once via the same hysteresis edge detector. control voltage (CV); modulates gate3 (summed directly (the destination DSP scales it))
`gate4`	cv	Gate CV for output 4, edge-triggered (paramTarget gate4). Each rising edge rotates the sel4 selector to the next input, wrapping; held-high fires once via the same hysteresis edge detector. control voltage (CV); modulates gate4 (summed directly (the destination DSP scales it))

outputs

id	cable	what it does
`out1`	video	Video output 1 — a discrete tap carrying exactly the input chosen by the sel1 selector (black if that input is unpatched). Also the canonical single-texture surface and the card's live OUT 1 preview. RGB video stream
`out2`	video	Video output 2 — a discrete tap carrying exactly the input chosen by the sel2 selector (black if that input is unpatched). RGB video stream
`out3`	video	Video output 3 — a discrete tap carrying exactly the input chosen by the sel3 selector (black if that input is unpatched). RGB video stream
`out4`	video	Video output 4 — a discrete tap carrying exactly the input chosen by the sel4 selector (black if that input is unpatched). RGB video stream

params

id	label	range	default	curve
`sel1`	OUT 1	0..?	—	discrete
`sel2`	OUT 2	0..?	—	discrete
`sel3`	OUT 3	0..?	—	discrete
`sel4`	OUT 4	0..?	—	discrete
`gate1`	G1	0..1	—	linear
`gate2`	G2	0..1	—	linear
`gate3`	G3	0..1	—	linear
`gate4`	G4	0..1	—	linear

controls

control	what it does
G1	NOT A CONTROL — a synthetic param (linear 0..1) holding the gate1 rising-edge detector's last level. The gate1 CV jack writes it through the cross-domain bridge; nothing in the UI offers it, because setting it by hand past the 0.6 rise threshold would rotate the router. Declared noUserControl (writer: cv-port).
G2	NOT A CONTROL — a synthetic param (linear 0..1) holding the gate2 rising-edge detector's last level, written by the gate2 CV jack through the cross-domain bridge. Declared noUserControl (writer: cv-port), so no knob, encoder or group instrument bar offers it.
G3	NOT A CONTROL — a synthetic param (linear 0..1) holding the gate3 rising-edge detector's last level, written by the gate3 CV jack through the cross-domain bridge. Declared noUserControl (writer: cv-port), so no knob, encoder or group instrument bar offers it.
G4	NOT A CONTROL — a synthetic param (linear 0..1) holding the gate4 rising-edge detector's last level, written by the gate4 CV jack through the cross-domain bridge. Declared noUserControl (writer: cv-port), so no knob, encoder or group instrument bar offers it.
OUT 1	OUT 1 selector — a discrete control choosing which input (IN1..IN4, raw index 0..3) output 1 carries. It has four named detents rather than a scale: the faceplate renders them as a row of IN1..IN4 buttons, and gate1 rotates the selection on each rising edge. A non-finite value resolves to IN1.
OUT 2	OUT 2 selector — a discrete control choosing which input (IN1..IN4, raw index 0..3) output 2 carries. Four named detents rendered as an IN1..IN4 button row on the faceplate; gate2 rotates the selection on each rising edge. A non-finite value resolves to IN1.
OUT 3	OUT 3 selector — a discrete control choosing which input (IN1..IN4, raw index 0..3) output 3 carries. Four named detents rendered as an IN1..IN4 button row on the faceplate; gate3 rotates the selection on each rising edge. A non-finite value resolves to IN1.
OUT 4	OUT 4 selector — a discrete control choosing which input (IN1..IN4, raw index 0..3) output 4 carries. Four named detents rendered as an IN1..IN4 button row on the faceplate; gate4 rotates the selection on each rising edge. A non-finite value resolves to IN1.

source

4plexvid.ts on GitHub.