SimpleSceneChanger Pro

What Pro adds #

SimpleSceneChanger Pro is a separate .tox built from the same network as Base, so everything on the Base page applies: switching, the A/B fader, cooking and memory, Auto Advance, the Python API and the callbacks. Pro adds:

• Per-scene settings on every Inputs block: transition, timing and cooking for that scene.
• A cue table: play a show from a Table DAT, on its own clock, locked to the timeline, from a CHOP channel, from timecode, or step through it with the A/B fader.
• A CHOP output that blends each scene's control data in lockstep with the picture.

Leave every Pro setting at its default and the component behaves exactly like Base. In Python, use your Pro component's name, for example op('SimpleSceneChangerPro1').Switch('intro').

Per-scene settings #

Every Inputs block carries its own transition, timing and cook settings. Leave a menu on Global or a time on -1 and the scene uses the component's setting.

Setting	For this scene
Mode In	How it arrives: Crossfade, Fade Through Black or Cut.
Mode Out	How it leaves, used when the arriving scene's Mode In is Global.
Fade In	Seconds to arrive: the crossfade length, or the fade-up half of Fade Through Black.
Fade Out	Seconds to fade to black when it leaves in Fade Through Black.
Easing In / Easing Out	Curve for arriving (the crossfade, or the fade-up half) / for leaving (the fade-to-black half).
Pre-Roll	Seconds it cooks before its transition starts.
Outro	Seconds it keeps cooking after it has left.
Cook	Global: Control Cook decides. Always Cook: cooks even while hidden, for a scene other scenes read from. Leave As Is: never touched by Control Cook, Unload, Colorize or Active.
CHOP	The CHOP it contributes to the CHOP output.

Who decides a switch. The arriving scene owns Mode In, Fade In, Easing In and Pre-Roll; the leaving scene owns Mode Out, Fade Out, Easing Out and Outro. When both scenes name a mode, Mode In wins. In the two A/B Fader Switch Modes the block modes are ignored: the Fader always drives the switch.

Order of precedence, for every value (the first one set wins): Switch() arguments, then the cue row (while a cue list plays), then the Inputs block setting, then the scene COMP's own Fadeintime / Fadeouttime / Fadeincurve / Fadeoutcurve parameters, then the component's global parameter.

The block settings are ordinary sequence parameters:

op('SimpleSceneChangerPro1').seq.Inputs[2].par.Modein = 'cut'
op('SimpleSceneChangerPro1').seq.Inputs[2].par.Fadein = 0.5

Cue table #

Describe a show as a Table DAT and play it: which scene, for how long, and how it arrives. The table is a Timer CHOP Segments DAT, so every Timer CHOP idiom works.

Set Cue Mode and point Cue Table at the DAT, or press Create Table for a new Table DAT beside the changer with one cue per scene, every column filled in from the current settings. Then Start.

Cue Mode	Cue time follows
Off	Nothing: the table is ignored and Select works as usual.
Play	Its own clock: Start, Stop, Previous / Next Cue, Go to Cue, Play, Speed, Loop.
A/B Fader	The A/B fader, see Cue Mode A/B Fader.
Locked to Timeline	The timeline.
External CHOP Channel	External CHOP / External Channel, in External Units.
External Timecode	Timecode Source: a Timecode CHOP, or a DAT whose first cell is a timecode string.

Columns, by header name. Blank cells fall back to the block, scene COMP and global settings.

Column	Meaning
scene	Scene index or scene name. Required.
length	Seconds the cue is in charge, its arrival transition included.
mode	cross, fade or cut.
fadein	Arrival time: crossfade length, or the fade-up half.
fadeout	Fade-to-black time of the scene that is leaving.
easingin, easingout	Curve names from the Easing menu.
outro	Outro of this cue's scene when it later leaves.
cycleendalert	Seconds before this cue ends that the next cue's scene starts cooking (its pre-roll).
label	Free text, shown in Cue Label and passed to onCueEnter.
delay, cycle, cyclelimit, maxcycles, speed	Timer CHOP columns. A cue with cycle 1 and cyclelimit 0 holds until Next Cue.
anything else	Passed to onCueEnter untouched.

scene      length  mode   fadein  cycleendalert  label
intro      8       fade   1.5     1              Opening
tunnel     12      cross  2       0.5            Build
finale     6       cut                           Drop

A cue switch never waits for Pre-Roll (the table owns timing: use cycleendalert) and never waits for the A/B Fader. Current Cue, Cue Label and Cue Count show where the show is. Auto Advance steps aside while a cue list has cues.

With Cue Mode on but no cues (no Cue Table, or only a header row), nothing is cued: the component shows a warning, Auto Advance keeps working, and in Cue Mode A/B Fader the Fader follows Switch Mode.

Cue Mode A/B Fader #

No clock: the cue list is the order for the A/B Fader, whatever Switch Mode says. Start lines up cue 0 (its scene goes into Select and starts its Pre-Roll). Each time the Fader completes a switch, that cue takes charge (Current Cue, onCueEnter) and the next one is lined up.

The row's mode picks what the Fader does: cross is a Fader crossfade, fade a Fader through black, and cut switches the moment the Fader leaves home (the far end becomes home once the Fader arrives). A blank mode uses the block modes and Switch Mode. length, cycleendalert and the other timing columns are ignored.

Next Cue, Previous Cue and Go to Cue change which cue is lined up. Picking a scene by hand is a detour: after that switch the same cue is lined up again. With Loop off, onCueListDone fires when the last cue takes charge; with Loop on, cue 0 is lined up after it.

CHOP output #

Scenes can carry control data too: turn on CHOP Output and the changer blends the scenes' CHOPs in lockstep with the picture, on its second output connector. Each scene's CHOP is its Inputs block CHOP, or else the scene COMP's Out CHOP; a scene with neither contributes no channels.

The blend weight is the picture's own crossfade, so the A/B Fader, Finish Transition, cue switches and Auto Advance move the channels exactly as they move the picture. Sample rate and start come from the CHOP that dominates the blend (the incoming one past half way).

• Match Channels By: Name pairs channels with the same name, Index pairs them by position.
• Missing Channels (only one CHOP has it): Fade to Zero fades it out or in with the transition, Hold Value keeps it until the switch completes, Drop outputs only the channels both CHOPs share.
• Sample Mismatch: Stretch to Longest resamples the shorter one, Pad to Longest holds its last sample, Trim to Shortest cuts every channel to the shortest length.
• Through Black (Fade Through Black and A/B Fader Through Black): Crossfade (the default) glides the channels from the old scene to the new one across the whole fade, with its timing and easing (or the Fader's travel). Switch at Black jumps when the picture is black. Dip with the Fade also scales them down to zero and back.

Pro callbacks #

Pro adds two callbacks to the Base callbacks:

Callback	When	info keys
onCueEnter(row, scene)	A cue took charge. row is its row as {column: text} plus 'index'; scene is the scene switched to, or None when the scene cell matched nothing.	cue, label, row, index, name, scene
onCueListDone()	The last cue ended. With Loop on the list starts again right after.	cueCount

A cue's cycleendalert warm-up also fires onPrerollStart, and stopping the list during it fires onTransitionCancel.