shapedramps
shapedramps · sources · schema v1SHAPEDRAMPS is a sync-locked parametric ramp generator for video coordinate synthesis — it draws gradients across the raster rather than processing an incoming picture. It emits four mono-video ramps: h_lin/v_lin are stable identity ramps (red channel = screen u or v, untouched by any knob or CV) for clean raster passthrough into geometry modules like RUTTETRA; h_out/v_out are shaped ramps that morph through four canonical shapes via H Shape / V Shape (0..1): linear (t), triangle (abs(2t-1)), soft-fold (0.5 - 0.5*cos(2pi*t)), and radial (H = distance from center scaled so corners read 1, V = angle around center), blending linearly between adjacent shapes. H/V Phase shift the ramp before shaping; H/V Freq scale the axis variable and fract-wrap it, so freq=2 repeats the shape twice across the canvas (a triangle becomes a two-peak zigzag). It also packs two general-purpose 2-channel video crossfade mixers (out = (1-amount)*A + amount*B) so you can blend ramp shapes without an external V-MIXER, though they accept any mono-video signal. Typical use: feed h_lin/v_lin into a coordinate consumer for an identity raster, then crossfade toward h_out/v_out to warp the geometry; all four ramps and both mixers render every frame so downstream consumers always read fresh textures.
the faceplate
inputs
| id | cable | what it does |
|---|---|---|
h_shape | cv | CV (linear) — modulates H Shape, morphing the h_out ramp through linear / triangle / soft-fold / radial as it sweeps 0..1. control voltage (CV); modulates h_shape (additive offset — ±1 CV sweeps the full range, centered on the knob) |
v_shape | cv | CV (linear) — modulates V Shape, morphing the v_out ramp through linear / triangle / soft-fold / radial as it sweeps 0..1. control voltage (CV); modulates v_shape (additive offset — ±1 CV sweeps the full range, centered on the knob) |
h_phase | cv | CV (linear) — modulates H Phase, shifting the h_out ramp along the horizontal axis before shaping (0..1). control voltage (CV); modulates h_phase (additive offset — ±1 CV sweeps the full range, centered on the knob) |
v_phase | cv | CV (linear) — modulates V Phase, shifting the v_out ramp along the vertical axis before shaping (0..1). control voltage (CV); modulates v_phase (additive offset — ±1 CV sweeps the full range, centered on the knob) |
h_freq | cv | CV (linear) — modulates H Freq, scaling the horizontal ramp's repeat count (0.5..8); higher values tile the shape more times across the canvas. control voltage (CV); modulates h_freq (additive offset — ±1 CV sweeps the full range, centered on the knob) |
v_freq | cv | CV (linear) — modulates V Freq, scaling the vertical ramp's repeat count (0.5..8); higher values tile the shape more times across the canvas. control voltage (CV); modulates v_freq (additive offset — ±1 CV sweeps the full range, centered on the knob) |
mix1_a | mono-video | Mono-video — the A input of onboard mixer 1; crossfaded toward mix1_b by Mix 1. If unpatched, mixer 1 outputs B alone (black if both A and B are unpatched). mono video stream |
mix1_b | mono-video | Mono-video — the B input of onboard mixer 1; mix1_a is crossfaded toward it by Mix 1. If unpatched, mixer 1 outputs A alone. mono video stream |
mix2_a | mono-video | Mono-video — the A input of onboard mixer 2; crossfaded toward mix2_b by Mix 2. If unpatched, mixer 2 outputs B alone (black if both A and B are unpatched). mono video stream |
mix2_b | mono-video | Mono-video — the B input of onboard mixer 2; mix2_a is crossfaded toward it by Mix 2. If unpatched, mixer 2 outputs A alone. mono video stream |
mix1_cv | cv | CV (linear) — modulates the Mix 1 crossfade amount (0 = all A, 1 = all B). control voltage (CV); modulates mix1 (additive offset — ±1 CV sweeps the full range, centered on the knob) |
mix2_cv | cv | CV (linear) — modulates the Mix 2 crossfade amount (0 = all A, 1 = all B). control voltage (CV); modulates mix2 (additive offset — ±1 CV sweeps the full range, centered on the knob) |
outputs
| id | cable | what it does |
|---|---|---|
h_lin | mono-video | Mono-video — stable horizontal identity ramp (red channel = screen u, left=0 to right=1). Ignores every knob and CV; ideal as a clean raster passthrough. mono video stream |
v_lin | mono-video | Mono-video — stable vertical identity ramp (red channel = screen v, top=0 to bottom=1). Ignores every knob and CV; ideal as a clean raster passthrough. mono video stream |
h_out | mono-video | Mono-video — shaped horizontal ramp, morphed by H Shape and offset/scaled by H Phase and H Freq. mono video stream |
v_out | mono-video | Mono-video — shaped vertical ramp, morphed by V Shape and offset/scaled by V Phase and V Freq. mono video stream |
mix1_out | mono-video | Mono-video — onboard mixer 1 output: (1-amount)*mix1_a + amount*mix1_b, amount set by Mix 1 / mix1_cv. mono video stream |
mix2_out | mono-video | Mono-video — onboard mixer 2 output: (1-amount)*mix2_a + amount*mix2_b, amount set by Mix 2 / mix2_cv. mono video stream |
params
| id | label | range | default | curve |
|---|---|---|---|---|
h_shape | H Shape | 0..1 | — | linear |
v_shape | V Shape | 0..1 | — | linear |
h_phase | H Phase | 0..1 | — | linear |
v_phase | V Phase | 0..1 | — | linear |
h_freq | H Freq | 0.5..8 | — | linear |
v_freq | V Freq | 0.5..8 | — | linear |
mix1 | Mix 1 | 0..1 | — | linear |
mix2 | Mix 2 | 0..1 | — | linear |
controls
| control | what it does |
|---|---|
| H Freq | H Freq (fader HF, 0.5..8, default 1) — scales the horizontal ramp's repeat count so the chosen shape tiles periodically across the canvas. |
| H Phase | H Phase (fader HP, 0..1) — shifts the h_out ramp along the horizontal axis before shaping. |
| H Shape | H Shape (fader HS, 0..1) — morphs the h_out ramp through linear, triangle, soft-fold, then radial; adjacent shapes blend linearly. |
| Mix 1 | Mix 1 (fader M1, 0..1, default 0.5) — crossfade amount for onboard mixer 1 (0 = all mix1_a, 1 = all mix1_b). |
| Mix 2 | Mix 2 (fader M2, 0..1, default 0.5) — crossfade amount for onboard mixer 2 (0 = all mix2_a, 1 = all mix2_b). |
| V Freq | V Freq (fader VF, 0.5..8, default 1) — scales the vertical ramp's repeat count so the chosen shape tiles periodically across the canvas. |
| V Phase | V Phase (fader VP, 0..1) — shifts the v_out ramp along the vertical axis before shaping. |
| V Shape | V Shape (fader VS, 0..1) — morphs the v_out ramp through linear, triangle, soft-fold, then radial; adjacent shapes blend linearly. |
source
shapedramps.ts on GitHub.