audioeffects.slapbackdelay
SlapbackDelay - one tape repeat after the dry, in mono: the Sun Studio slap.
The player’s text is the class docstring, and every sentence in it that
makes a claim is tied to a test by the CLAIMS table in the class’s test
file.
- audioeffects.slapbackdelay.TIME_MIN_MS = 40.0
40-250 ms, log.
- Type:
The Time span, fixed on every instance (dossier section 6)
- audioeffects.slapbackdelay.LINE_MS = 251.0
Time’s top plus 1 ms. The node clamps a delay at
line_frames - 2(audiodsp_feedback_delay.c:148-150), and the read reaches 250 ms plus the wow’s 22.1 frames at 3.5 cents; 251 ms clears that at every rate (dossier Tier 3, A8.6).- Type:
The line
- audioeffects.slapbackdelay.TONE_MIN_HZ = 2000.0
The Tone span’s corners; the top stop is exactly
damping_hz = 0.
- audioeffects.slapbackdelay.WOW_HZ = 0.7
The wow’s fixed rate and the Wow knob’s ceiling, in cents peak.
- audioeffects.slapbackdelay.REPEATS_MAX = 0.6
The Repeats knob’s top, handed to the node’s
feedback.
- audioeffects.slapbackdelay.SLEW = 0.1875
3/16, exact in float32, so every step of the walk is exact at 48 kHz (dossier section 8.6).
- Type:
The fixed Time walk, delay-seconds per second
- audioeffects.slapbackdelay.ECHO_TOLERANCE = 1e-06
How close, as a 0..1 knob position, a Time write must come to the constructor’s own seeded position to count as a host echoing it back: 1e-6 is 1/7 874 of one MIDI step, and holds a single-precision board’s round trip through the 0-127 scale.
- audioeffects.slapbackdelay.DEFAULTS = (135.0, 0.35, 0.15, 20000.0, 1.0, 0.0)
patch 0’s steps, rounded. An option left out plays the step itself.
- Type:
The constructor defaults, which NaN falls back to
- audioeffects.slapbackdelay.wow_depth_ms(cents)[source]
The Wow knob’s cents -> the node’s
wow_depth_msat 0.7 Hz.A delay swinging D sin(2 pi f t) ms moves pitch by a peak ratio of 1 + 2 pi f D / 1000, so the rising side reaches
centsat D = (2^(cents/1200) - 1) / (2 pi 0.7) x 1000 (dossier A4): 1.0 cent is 0.1314 ms, 3.5 cents 0.4601 ms. Clamped to 0..3.5 cents.
- audioeffects.slapbackdelay.tone_excess(damping_hz, sample_rate)[source]
(frames, relative excess) for a loop low-pass at
damping_hz(already pre-warped): afterframesframes whatever its state held weighs under 2^-17 of it, and its single-precision state can rest up to 2^-24 / a above the line’s peak, a being the coefficient.DigitalDelay’s_tone_excess, as a function of the handed value. (0, 0.0) with Tone out.
- class audioeffects.slapbackdelay.SlapbackDelay(source, *options, **keywords)[source]
Bases:
ComponentOne tape repeat after the dry, in the same place: the Sun Studio slap.
Your dry signal passes untouched, and one copy of it comes back a moment later, a little quieter: the two-machine tape echo on Sam Phillips’ Sun sides. By default the repeat comes 134.4 ms after the dry, once.
The controls. Time is the gap between the dry and the repeat. Level is the console’s return. Saturation is how hard the return drove the record amplifier. Tone is the tape path’s top end. Wow is the transport’s slow wobble. Repeats sends the slap round again. Time runs from 40 to 250 ms, Level from 0 to 2, Saturation from 0 to 1, Tone from 2 kHz to out at its top stop, Wow from 0 to 3.5 cents and Repeats from 0 to 0.6. Level 0 is a wire. Up to Level 1 the dry passes untouched until the repeat arrives, however hard Saturation drives the repeat. A hot input can reach the rail, since the repeat adds to a dry at unity. Keep the input under -6 dBFS and the defaults and patches stay off the rails. At Repeats 0 there is one repeat and no second. Repeats above 0 sends the repeat round for more. Wow swings the repeat’s pitch by the cents the knob reads, at a slow fixed rate. The default Wow takes the repeat’s very top more than 4 dB down at Nyquist, where Wow 0 leaves it within half a dB. At 22.05 kHz the last Tone positions below the top stop clamp below Nyquist and all do the same thing.
Time. Every Time position lands on the nearest whole frame at 48 kHz. At 44.1 and 22.05 kHz the node lands some positions a fraction of a frame off, and a sliver of the repeat falls on the frame beside it. A host that writes back
get_macro(0)keeps the constructor’s exact Time. Turning Time walks the repeat to the new Time, bending its pitch, instead of clicking. A Wow move glides instead of stepping.Mono, latency, tail. A source the same in both channels comes out the same in both channels, and a one-channel source gets the stereo render’s left channel. A click comes out on the frame it went in: there is no latency.
tail_samplesis an upper bound on how many frames the output takes to reach exact zero, counted from when your input stops or from when you read it if that is later, for the settings as they stand when you read it.reset()empties the line and returns to patch 0. The class never reads the host’s tempo. A constructor value outside a knob’s span clamps to the nearer stop, atone_hzof 0 or less is Tone out, and NaN takes the option’s default.Limits shared by the family. Level walks a jump over 20 ms, but any other control that jumps makes the output step: move it in small steps from the host if you need it smooth. When your source ends, the tail rings out as it would on silence.
- NAME = 'SlapbackDelay'
The stable provider name
audioeffects.create()discovers.
- TIER = 'audiodsp'
STOCK or AUDIODSP, with REQUIRES naming the audiodsp-own modules an AUDIODSP class needs.
- Type:
roadmap §3
- CAPABILITIES = ()
The contract’s static reads.
CAPABILITIESnames"tempo_sync"if and only if the class readsself._transport().
- INPUT_CEILING_DBFS = -6
The defaults and every patch play the ceiling kit’s materials clean at this level; at -3 dBFS, patch 2 rails on a 100 Hz square.
- MACRO_LABELS = ('Time', 'Level', 'Saturation', 'Tone', 'Wow', 'Repeats')
Knob names, one per macro index; one mode per label; the private engineering spans behind them; and the patches on the 0-127 grid.
- PATCHES = {0: ('Single Slap', (84, 22, 19, 127, 36, 0)), 1: ('Short Slap', (52, 22, 19, 127, 36, 0)), 2: ('Doubling', (0, 32, 19, 127, 73, 0)), 3: ('Hot Return', (84, 22, 89, 127, 36, 0)), 4: ('Two Repeats', (84, 22, 19, 127, 36, 74)), 5: ('Dark Slap', (84, 22, 19, 51, 36, 0))}
_component.macro_ofof the dossier’s section 6 settings; patch 0 is the constructor’s defaults on the grid.
- reset()[source]
Clear every node this class built, tail first, and restore patch 0. The borrowed source is never named here.
- property tail_samples
What this bound promises is in the class docstring; how it is built is in the dossier.