Palinopsia / OSC Reference

Layer opacity.

Layer time multiplier : 0..1 maps to 0 to 20×.

A/B source crossfade (0 = A, 1 = B).

Feedback trail persistence.

Layer blend mode : an index, 0..1 across the 20 modes, or the name : normal · 50add · add · subtract · multiply · screen · overlay · softlight · hardlight · darken · lighten · difference · exclusion · dodge · burn · wrap · weave · lumakey · consume · lightercolor (index 0 to 19; 50add, the additive crossfade, came in at 1 in v1.3.0, so later indices moved up one).

How B combines with A before the crossfade : the same 20 modes, by index, 0..1 or name.

Silence the layer.

Solo the layer.

Layer samples its own previous frame.

Vary this layer : a variant at its own amount, like its Vary button.

A video slot's transport : play, loop, granular playback. Without {A|B} : the layer's first video slot. An Import audio slot answers to the same addresses (no direction, no grain).

The film's own sound (0 = silent, the default), or an audio slot's volume. Heard on Sonify's output device.

Forward · reverse · pendulum (index, 0..1 across, or the name).

The clip plays at its own speed (× its layer's), whatever the global speed.

Playback speed, log across 1/64× to 128× (a sound file plays 1/16× to 16×).

A one-shot seek within the trim (never echoed back : the playhead moves every frame).

The trim points.

The granular player's grain size, spray, reverse odds and jitter.

Grains on free time or the tempo : free · 1/16 · 1/8 · 1/4 · 1/2.

The Audio Layer's volume, a gain (1 = as it comes).

A to B : 0.5 plays both whole, toward an end the other one fades out.

Mute the Audio Layer.

Both files from their in points together (≥ 0.5), or both paused. Advertised, but never sent back by the feedback, so a destination that echoes its state can't restart the files mid-show (the per-slot play is sent).

A slot's volume (a gain, 0..2), pan (-1 left .. 1 right), mute (≥ 0.5). A file, a live input or an NDI® source.

A file slot's transport; keep the pitch when its speed changes.

A file slot's speed (log, like a video's; a sound plays 1/16× to 16×), a one-shot seek, the trim points.

Swap the source generator : a shaderId (a shader of your own from the Source Editor goes by its user-… id), a built-in's display name, or none. The one already there keeps its settings. none empties the slot; a name it does not know leaves the slot as it is.

A source shader input, scaled to its range.

One part of a color : hue · saturation · brightness · alpha, the rest held. The same /{part} follows every color input address (its effects, the layer's, the master's, the Background's).

An input on the per-source FX unit i.

Marbling : a drop at x y (0..1 of the frame, y up), its size × the drop size (default 1). Live : never in the undo or the session. One number is the plain drop ▸ trigger.

An input on the per-layer FX unit i.

The A/B harmony, B's colors relative to A's (the Mixer's HUE, -1..1 there) : 0 pulls B onto A's colors, 0.5 leaves B as it is, 1 puts B on A's complement.

The master switch for every layer's coupling (the Mixer header's ≈ coupling). On at launch, not saved.

Bond character : off · lean · hocket · cut · gate · drift.

Coupling depth.

Vestigial (0) ↔ obvious (1).

The audio feature that drives it : level · flux · transient · centroid · band · pitch · noisiness. An index (0 to 6) or a name reaches all seven; a float 0..1 spreads over the first six, level to pitch, as it always did, so noisiness takes index 6 or its name. Advertised and mirrored as a whole number 0..6.

Which of the six bands the band feature listens to : a whole number, 0 the lowest to 5 the highest, or a fraction 0..1 across the six. A whole number counts as the band whatever its type tag (a float 1.0 is band 1, the second). Advertised and mirrored as a whole number 0..5, so a fader built from the advertisement reaches every band.

Level-matching (the Mixer's auto chip) : the feature heard against its own recent range, so a quiet track moves the mix as far as a loud one and silence stays still. On by default; below 0.5 the raw feature (a quarter-second crossfade). Advertised in OSCQuery and mirrored in feedback (1 on, 0 off).

A Vibe palette input (colour inputs take 3–4 args).

A finishing color's part (vibe · context · finalizer) : hue · saturation · brightness (no alpha : these stages read RGB). Advertised in OSCQuery and sent back as feedback, like the Background source's color parts.

A Context input : haze, depth, light (point2D), PBR.

A Finalizer input : levels, gain, grain, output shape.

An input on a user-added master FX unit i.

Background opacity (0 = off).

Its own clock, 0 to 4× (0.0625 = the default 0.25×) : its source, effects and a Collage's films.

The shadow the layers cast onto it (0 = flat).

How the layers sit on it : 0 = blend in (Layer 1 blends onto it in its own mode) · 1 = group (the layers composite as if alone, and the Background shows through their dark and transparent parts).

The Background's own dice : a new ground and rack, keeping opacity, speed, shadow and mode.

Swap the ground (a ground's id or name, or none; anything else is ignored).

A background source input, scaled to range.

Marbling on the Background : a drop at x y [size].

An input on background FX unit i.

Sparse ⇄ dense.

Gesture ⇄ Texture.

Dispersal ⇄ Coalescence.

Near ⇄ far : pushes the scene into depth.

Flow ⇄ Interruption.

The temperament dials (0 = off) : tonicity, the shutter, the analog drift, the superimposition flicker (held under the flash-safety limit).

Select the active World : id / name string, or a 1-based index into the bank.

The World amount : how much of the active World's own change is on (1 all of it, the default; 0 the mood it found). Your edits, modulators and macros keep working under it. Remembered on this computer.

Run (≥ 0.5) or stop the macro-form sequencer.

Advance to the next scene now (respects transition + variation).

The Seq page's transport : play every lane marked with transport (the scenes, the Sonify keys, the Body rule timeline; the beat lanes together on bar 1, or on Ableton Link's next bar), or below 0.5 stop them all.

Run (≥ 0.5) or stop the Body rule timeline : while it runs, each rule with blocks is on inside them and off outside them, in bars of the tempo; stopped, the rules stay as they are.

Drive Macro knob k, a smoothed macro that fans out to whatever you've mapped to it. Its old name /opsia/meta/{k} (before v1.3.2, when they were the Meta knobs) still works, in and in the feedback out.

Master tempo, raw, in BPM. With Ableton Link on, a tempo sent here counts as your own edit : it goes to every linked app (Link has no address of its own).

Overall loudness.

Spectral flux (rate of change).

Onset / attack energy.

Spectral brightness.

Estimated pitch.

Noisiness (spectral flatness) : a clear tone at 0, noise at 1.

Energy in one of six frequency bands.

Recall scene n (1-based) : full-instrument state.

Recall the scene whose number (1-based, rounded) is the argument. Not edge-tracked : every message recalls, so send it once (the dataflou mesh's scene destination plays this one).

Re-roll everything within curated ranges, at the Transport's intensity.

Re-roll one scope, at the Transport's intensity : sources · sourceparams · sourcefx · sourcefxonly · layerfxonly · layer · master · finishing · modulators.

Panic flush : drop every self-feeding buffer (feedback · trails · frame rings · accumulators) at once. Same as key 0 / the ⚡ Flush button; advertised over OSCQuery.

Vary : a variant of the whole scene at the Transport's spread, like its Vary button.

The other randomizes, as MIDI Learn fires them : master FX parameters in place, the Sonify patch, the selected Inspector unit, the Resolume pins, the Background's dice, and macro, new Macro knob values with their destinations kept (not the Transport's Macro Knobs scope, which also re-rolls the destinations; that one has no address). meta, its old name, still works.

The output transform : the whole finished frame moved as one picture, 0..1 over each range : x and y -1..1 (frame widths and heights), scale 0..2, rotate -180..180°, spin -360..360° a second, feather 0..0.2. 0.5 = none for x, y, scale, rotate and spin. Skipped while the dome is on (the dome has its own turn, spin and offset).

Flip the output frame.

What shows past the frame : black · repeat · mirror.

Back to the frame as it is.

Space : Sonify in the room, stereo · speakers · objects.

Turn the sound scene (0.5 = none) · how softly a following voice moves (0..2 s).

Swap left and right · hear the room on headphones (binaural).

The Collage pieces as sources of their own : an integer count, or 0..1 of 30.

Where a Sonify voice sits, 0..1 over each range : az -180..180° (0.5 = straight ahead; an offset while the voice follows), el -15..90°, width 0..180°, span 0..1, spin -360..360° a second. Voices : spectra orbit flow events raster sstv filter chord collage signal assemblage.

The voice follows the picture, else it stays at its fixed place.

Metasurface cursor : two 0..1 floats on the scene plane; the output becomes a live blend of the nearest scenes. Sending it turns the surface ON (Pandore's Trill Square plays it).

Enable / disable the Metasurface (≥ 0.5).

Draw sequencer : auto-trace the drawn path across the plane (≥ 0.5).

Draw-path loop time : seconds (or milliseconds if > 120).

Draw-path jump jitter : 0..1 maps to 0–100 %. Random teleports of the playhead to other spots on the path.

Draw-path direction : 0 forward · 1 backward · 2 ping-pong.

Draw-path smooth wobble : 0..1 maps to 0–100 %. A sinusoidal vibrato around the traced position (distinct from jump's teleports).

Close the draw path into a loop (end→start), so forward play flows around instead of teleporting.

Master on/off for the sound engine.

Output gain.

The global quantizer (key root, root octave and scale) : a name (harmonic minor, dimwh, Diminished W-H…) or an index : 0 chromatic · 1 major · 2 minor · 3 minor pentatonic · 4 whole tone · 5 dorian · 6 phrygian · 7 lydian · 8 harmonic minor · 9 ionian · 10 mixolydian · 11 aeolian · 12 locrian · 13 major pentatonic · 14 major blues · 15 minor blues · 16 diminished W-H · 17 diminished H-W.

Run the key sequencer (≥ 0.5) or stop it; next changes the key now (each message at 0.5 or more, not edge-tracked).

How the next key is chosen : list · circle · affinity · pivot · picture.

The glide to a new key (0 to 4 s) and the chance a change falls when the clock allows one.

Free time : every how often a change may fall (0.25 to 300 s); vary draws each wait around it, between Every ÷ 4^vary and Every × 4^vary (0 = always Every).

Picture chooses from pool (0 : the roots and scales ticked) or list (1 : only the keys written for it).

Picture : range 0 reads the color wheel and the light as they are, 1 the piece's own range of them spread over every key and mood; hold the shortest a key stays (0 to 60 s).

Per-voice enable, level and pan.

A voice's probes (scan column, orbit centre/radius, raster rect…), pitch, and timbre / motion params, with the same names as the on-screen strip.

Recall a saved output EQ : its name, or its number in the menu (0 or flat : flat). The bypass switch and the glue stay.

The Filter voice plays a line-in (≥ 0.5) instead of its noise; linefrom says which : input (an audio input) or layer (the Audio Layer, its slots mixed before its own volume and mute).

What each image tap reads : 0 the master output, 1-4 a layer.

Which tap a voice listens to (A or B). Every voice but collage and assemblage (they hear films, not the picture).

A voice's octave range (spectra, flow, events, signal, chord, collage, assemblage, filter, synth) : an integer octave, or a float 0..1 across the voice's span (collage and assemblage reach octave 9); the low end always stays below the high end.

Spectra's sweep locked to the tempo (one sweep a bar; off, the rate you had set comes back); the Orbit's shape (circle, 1:2, 2:3, 3:4, 1:3); the Filter's noise loop (0 free noise, up a frozen stretch replayed : a flutter, then a buzz).

The Collage voice : the films of a Collage source heard all at once, each piece panned by its place and rung at a note of the key. comp is one compressor on all the films (0 = off), so they hold one level.

The films' filters' slope : 12 or 24 dB per octave (an int as it is; a float, 0.5 and up = 24).

The glue : one compressor on everything that leaves (Sonify and the Audio Layer), after the output EQ (both cards are in the audio tab). amount takes the threshold to -12 dB and the ratio to 4:1; voice clean · warm · punch · bite · slow.

Its Ring bank (48 tuned resonant bands) : bank is the wet (0 the plain voice); tone and tilt are bipolar (0.5 = centre).

The bank added on top (send) or crossfaded (mix); choke or sustain; sync modes 0 free · 1 straight · 2 triplet · 3 dotted; voicing 0 Clean · 1 SEM · 2 MS-20 · 3 Steiner · 4 K35.

The Assemblage voice : an Assemblage edit's own sound, cut with the picture, each clip placed by its unit on the Assemble map. It takes every collage/… control above (its ring bank and octave range too), plus accent (a strike of the resonators at every cut) and tape (≥ 0.5 : the speed changes the pitch; below, the pitch is kept).

The Chord's waves : a travelling level across its notes.

The Signal voice : read heads that play the picture as data. wave the grain (0 pip · 1 damped · 2 noise · 3 click · 4 fm · 5 square · 6 tri · 7 pink · 8 ping), heads 1 to 4, path 0 horizontal · 1 vertical · 2 radial · 3 spiral, steps per sweep 0..7 (8 · 12 · 16 · 24 · 32 · 48 · 64 · 96). An integer is the index; a float is 0..1 across the choices.

Its grain length (0.2 ms to 500 ms), the noise grains' tone, the fm depth, the step rate (per second, or per beat when synced), the heads' polymeter spread, how bright a cell must be to fire, marks per head per step, and pitch from free frequency (0) to the scale (1).

Lock Signal's steps to the beat clock both Sonify sequencers share : rate then counts steps per beat, and switching carries the pace over as the page's button does.

The Synth voice : the moving things in the picture play it, each thing a voice (in poly the 8 strongest), its place the note on the key, its looks the sound. Its gain, its balance (0.5 the middle), its tap and its octave range (0 to 8).

Its engine (0 dco · 1 ms · 2 swarm · 3 fm · 4 modal · 5 voice · 6 fold · 7 pluck), voices (0 poly · 1 unison · 2 mono), filter (0 ladder · 1 ms · 2 morph), chorus (0 off · 1 I · 2 II) : a name or an index (a float 0..1 across the choices).

Its sound : the engine's three macros, the filter (fmode the morph filter's low-pass to band-pass to high-pass), the envelope on the cutoff (envamt : 0.5 none), the envelope, glide, drift and its own level.

How the picture is read : mode 0 height · 1 keyboard · 2 radial (the dome : zenith to rim) · 3 score (a playhead on the beat, bars 0 one · 1 two · 2 four); grid 0 free · 1 on the 1/8 · 2 the 1/16 · 3 the 1/8 triplet; slide (≥ 0.5) or steps; sens how much movement counts; picture every patchbay depth scaled (0 : the picture only picks the notes).

The picture patchbay, one row per {dest} : vel · timbre · harmonics · morph · cutoff · reso · drive · env · pan · bend. source a name or an index : 0 none · 1 speed · 2 size · 3 brightness · 4 hue · 5 saturation · 6 texture · 7 x · 8 y · 9 direction · 10 age · 11 motion · 12 light · 13 warmth · 14 busyness · 15 cut (11 and up : the whole picture); depth 0..1 for -1..+1 (0.5 : none).

A factory sound by its name or its number (1-based) : the sound only (the read, the patchbay and the levels stay). Inbound only.

The shared reverb / delay tail : send · delaytime · feedback · size · decay · damp · reverbmode · freeze · reverbmix …

One picture feature : brightness · contrast · motion · edges · entropy · centroidX · centroidY · warmth · saturation · hue · depth · depthSpread · flowX · flowY · divergence · curl · coherence (the last five are the picture's motion field : which way it flows, whether it spreads out or closes in, whether it turns, and whether it moves as one).

One body feature, streamed while the Body camera runs : hands, each hand's shape handLeft… · handRight… + CurlThumb · CurlIndex · CurlMiddle · CurlRing · CurlPinky · PinchIndex · PinchMiddle · PinchRing · PinchPinky · Angle · Facing · Span (curls 1 = curled, pinches 1 = touching, angle 0.5 = upright, facing 1 = palm toward the camera, span 1 = close), pose, face, the nine silhouette zones, presence, the camera's motion field flowEnergy · flowX · flowY · flowDivergence · flowCurl · flowCoherence · flowCenterX · flowCenterY · flowArea, and the movement qualities moveEnergy · moveExpansion · moveFluidity · moveSuddenness · moveDirectness · moveSymmetry.

A gesture rule fired : the custom OSC name, or a truncated default like /body/HandsUpRndMod.

A rule on or off, n its place in the Body page's list (1-based) : active ≥ 0.5 turns it on, below off (float, int or bool; fed back when it changes, camera on or not); toggle turns it on, or off when it is on. An inactive rule's gesture still shows in the monitor and fires nothing.