feat(braze): add Braze tempo-locked beating
Check and Windows preview / check (anvil) (push) Successful in 2m15s
Check and Windows preview / check (braze) (push) Successful in 2m26s
Check and Windows preview / check (crucible) (push) Successful in 1m52s
Check and Windows preview / check (knurl) (push) Successful in 1m42s
Check and Windows preview / check (lathe) (push) Successful in 1m44s
Check and Windows preview / check (patina) (push) Successful in 2m38s
Check and Windows preview / check (planish) (push) Successful in 1m29s
Check and Windows preview / check (rivet) (push) Successful in 1m39s
Check and Windows preview / check (temper) (push) Successful in 1m37s
Check and Windows preview / check (weld) (push) Canceled after 2s
Check and Windows preview / previews (push) Canceled after 0s
Check and Windows preview / windows (push) Canceled after 0s
Check and Windows preview / check (anvil) (push) Successful in 2m15s
Check and Windows preview / check (braze) (push) Successful in 2m26s
Check and Windows preview / check (crucible) (push) Successful in 1m52s
Check and Windows preview / check (knurl) (push) Successful in 1m42s
Check and Windows preview / check (lathe) (push) Successful in 1m44s
Check and Windows preview / check (patina) (push) Successful in 2m38s
Check and Windows preview / check (planish) (push) Successful in 1m29s
Check and Windows preview / check (rivet) (push) Successful in 1m39s
Check and Windows preview / check (temper) (push) Successful in 1m37s
Check and Windows preview / check (weld) (push) Canceled after 2s
Check and Windows preview / previews (push) Canceled after 0s
Check and Windows preview / windows (push) Canceled after 0s
Adds a detuned copy of the bass whose beating stays on the tempo grid on every note. The chosen harmonic k beats once per Rate note value, and harmonic n beats n/k times as fast, so every harmonic is on the grid. - The copy is read from a delay line whose delay falls one period of the tracked note per beat cycle (r = 1 + B/(k f0)) and jumps back exactly one period, crossfaded over 6 ms. On a periodic note the jump has no seam: the output matches the ideal sum within 0.003 on harmonics 1-4. - The delay follows the host's beat position, shifted by the lookahead, so beat peaks land on the grid; free-running when stopped. - Low cut: LR4 high-pass on the copy, the bass split by the same crossover, so the sub does not beat and keeps its level. - Depth, Width, Phase, Gate, Output, Snap, Bypass. Pitch from audio (about 67 ms lookahead) or MIDI. - Editor: one bar of the beat per harmonic with the grid and a playhead. - Catalog, workflows, editor-check, docs, signal chain and site copy.
This commit is contained in:
1 parent
e7f3346077
commit
330ec54150
28 files changed
+4565
-18
No files matched your search
@@ -0,0 +1,18 @@
|
||||
# Braze changelog
|
||||
|
||||
## Unreleased (0.1.0)
|
||||
|
||||
- Introduce Braze, a detuned copy of the bass whose beating stays on the tempo
|
||||
grid on every note.
|
||||
- The chosen harmonic (1–8) beats once per Rate note value (1/1 to 1/32, and
|
||||
triplets); harmonic n beats n/harmonic times as fast, so every harmonic beats
|
||||
on the grid. The beat peaks land on the host's beat position.
|
||||
- The detune follows the tracked note. The copy jumps by exactly one period of
|
||||
the note, so the jumps are seamless on a steady note.
|
||||
- Low cut keeps the copy out of the sub, so the sub neither beats nor changes
|
||||
level.
|
||||
- Depth, Width (right channel's beat against the left), Phase, Gate, Output,
|
||||
Snap to semitone, Bypass.
|
||||
- Detect pitch and note starts from the audio with about 67 ms of latency, or
|
||||
follow MIDI notes sent to the effect.
|
||||
- Editor: one bar of the beat per harmonic with the grid and a playhead.
|
||||
@@ -0,0 +1,77 @@
|
||||
# Braze
|
||||
|
||||
Braze makes a reese's movement play in time. Current version **0.1.0**
|
||||
(unreleased).
|
||||
|
||||
Two layers detuned against each other beat: harmonic k of a note at f0 swells
|
||||
and fades k·f0·(r − 1) times per second, where r is the detune ratio. With a
|
||||
fixed detune that rate changes with every note, so the movement of a reese
|
||||
never lines up with the track. Braze adds a detuned copy of the bass and sets
|
||||
its detune on every note so that the beating follows the tempo.
|
||||
|
||||

|
||||
|
||||
## Install on Windows
|
||||
|
||||
Copy `Braze.clap` into `C:\Program Files\Common Files\CLAP\`. In FL Studio 2024.1
|
||||
or newer, open Options → Manage plugins, enable Verify plugins, and Find installed
|
||||
plugins. Load Braze in the mixer slot of the bass. Keep the font license with
|
||||
redistributed packages.
|
||||
|
||||
## Work with it
|
||||
|
||||
1. Put Braze on a single bass layer: a plain saw, or a reese whose own detune
|
||||
you have turned down.
|
||||
2. Pick **Rate**: the note value one beat lasts. 1/8 at 140 BPM is 4.67 beats
|
||||
per second.
|
||||
3. Pick the **harmonic** that should beat at Rate. Harmonic n beats
|
||||
n/harmonic times as fast, so all of them beat on the grid: with harmonic 4 at
|
||||
1/8, harmonic 2 beats in quarters, harmonic 8 in sixteenths, harmonic 3 in
|
||||
quarter triplets.
|
||||
4. Set **Depth**. At 100 % the beating goes down to full nulls; 50–70 % keeps
|
||||
the note present.
|
||||
5. Use **Phase** to move where the beat peaks. At 0° all harmonics peak
|
||||
together on every beat of the chosen harmonic's cycle.
|
||||
|
||||
The display shows one bar: a row per harmonic with the level it gets from the
|
||||
beating, the grid at Rate, and the playhead.
|
||||
|
||||
Other controls:
|
||||
|
||||
- **Low cut** removes the copy below a frequency, so the sub does not beat.
|
||||
The sub keeps its level. Harmonics under the cut show *cut* in the display.
|
||||
Under 20 Hz the cut is off. If the chosen harmonic is under the cut on a
|
||||
note, it does not beat: the note panel says so; pick a higher harmonic.
|
||||
- **Width** moves the right channel's beat against the left, up to half a
|
||||
cycle. At 100 % one side peaks while the other nulls. Check the mono sum.
|
||||
- **Gate** is the input level that counts as a note.
|
||||
- **Snap to semitone** rounds the detected pitch. Leave it off on detuned or
|
||||
bent notes: the copy jumps by one period of the pitch in use.
|
||||
|
||||
### How the detune is made
|
||||
|
||||
The copy is the bass read from a delay line. Its delay falls by one period of
|
||||
the note per beat cycle of the chosen harmonic, which tunes the copy up by
|
||||
exactly r = 1 + B/(k·f0) (B: beats per second, k: the chosen harmonic). When it
|
||||
has fallen a whole period, it jumps back by one period: on a steady note both
|
||||
read positions hold the same waveform, so the jump is crossfaded over 6 ms
|
||||
without a seam. At a beat peak the copy lines up with the bass sample for
|
||||
sample.
|
||||
|
||||
The low detune that low notes need is large: harmonic 1 at 1/8 and 140 BPM on
|
||||
F1 (43.7 Hz) is r = 1.107, about 1.8 semitones. Higher harmonics need less:
|
||||
harmonic 4 asks for about 45 cents on F1.
|
||||
|
||||
## Timing and limits
|
||||
|
||||
Detection uses about 67 ms of lookahead, reported to the host for delay
|
||||
compensation. Pitch range is 30–500 Hz, one voice. The beat position comes from
|
||||
the host while it plays, shifted by the lookahead so the beat stays on the
|
||||
timeline. When the host is stopped, the beat runs on freely at the last tempo.
|
||||
|
||||
Noise, chords and the attack of a note are not periodic, so the copy's jumps
|
||||
are heard there as a short blur. Before the first note, the copy assumes 55 Hz.
|
||||
|
||||
Braze changes the waveform in time, so pitch detection after it can be less
|
||||
sure: put tracked plugins before Braze, or use MIDI. See
|
||||
[Signal chain](../chain.md).
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 301 KiB |
+10
-4
@@ -1,13 +1,13 @@
|
||||
# Signal chain
|
||||
|
||||
The order of the Bass Foundry plugins in a chain matters. Anvil, Lathe, Temper,
|
||||
Knurl and Planish each detect the pitch from the audio they receive. If a plugin earlier
|
||||
Knurl, Planish and Braze each detect the pitch from the audio they receive. If a plugin earlier
|
||||
in the chain changes the audio, the pitch detection after it can go wrong.
|
||||
|
||||
## Recommended order
|
||||
|
||||
```text
|
||||
bass track: synth → Lathe → Temper → Planish → Knurl → Patina → Weld
|
||||
bass track: synth → Lathe → Temper → Planish → Braze → Knurl → Patina → Weld
|
||||
bass bus: Anvil → (bus compression, clipping) → Crucible
|
||||
```
|
||||
|
||||
@@ -16,6 +16,12 @@ bass bus: Anvil → (bus compression, clipping) → Crucible
|
||||
- **Planish after the distortion, before Knurl.** OTT usually comes after
|
||||
distortion. Planish's band edges follow the tracked note, so it also needs a
|
||||
clear pitch: after Knurl, use MIDI.
|
||||
- **Braze after Planish.** Its copy beats against the bass, so a pitch
|
||||
detector after it is less sure: Knurl after Braze works best in MIDI mode.
|
||||
Weld after Braze sees the beating as a looser match between the layers; if
|
||||
it reads Loose, move Braze to the bus after Anvil, with Low cut at or above
|
||||
Anvil's Split. There it reads the pitch from Anvil's clean sub, and the sub
|
||||
stays out of the beating.
|
||||
- **Knurl last among the tracked plugins.** See below.
|
||||
- **Patina after the tracked plugins.** It does not detect pitch, so the order
|
||||
does not change its result.
|
||||
@@ -45,8 +51,8 @@ and route the bass's MIDI notes to it.
|
||||
|
||||
## Latency
|
||||
|
||||
Each tracked plugin adds its own lookahead: Anvil 80 ms, Lathe, Temper and
|
||||
Planish about 67 ms, Knurl about 71 ms, Patina about 45 ms. A full chain is
|
||||
Each tracked plugin adds its own lookahead: Anvil 80 ms, Lathe, Temper,
|
||||
Planish and Braze about 67 ms, Knurl about 71 ms, Patina about 45 ms. A full chain is
|
||||
about 400 ms. FL
|
||||
Studio compensates this for playback and rendering, but playing a MIDI keyboard
|
||||
through the full chain is not practical. Write with a shorter chain and add the
|
||||
|
||||
+3
-2
@@ -25,7 +25,7 @@ Patina has `render` for offline WAV evaluation. The shared crates are:
|
||||
|
||||
- `common-ui`: palette, embedded fonts, header, panels, knobs, meters.
|
||||
- `common-dsp`: filters, YIN pitch tracking, the note tracker used by Anvil,
|
||||
Lathe, Temper, Knurl and Planish, 4× oversampling, meters and WAV files.
|
||||
Lathe, Temper, Knurl, Planish and Braze, 4× oversampling, meters and WAV files.
|
||||
|
||||
The wrappers stay separate workspaces, each with its own lockfile, so the
|
||||
NIH-plug Git dependency stays out of the root workspace. Host identities and
|
||||
@@ -45,7 +45,7 @@ python3 -m unittest discover -s scripts/tests -v
|
||||
```
|
||||
|
||||
Products: `rivet`, `patina`, `anvil`, `crucible`, `lathe`, `temper`, `weld`,
|
||||
`knurl`, `planish`.
|
||||
`knurl`, `planish`, `braze`.
|
||||
|
||||
`check-plugin.py` runs formatting, tests and clippy for one product's packages
|
||||
and its wrapper, without compiling the other products. Run it for every product
|
||||
@@ -145,6 +145,7 @@ identify plugins by CLAP ID, so the vendor name does not affect saved projects.
|
||||
| Weld | (new) | `io.narl.bass-foundry.weld` |
|
||||
| Knurl | (new) | `io.narl.bass-foundry.knurl` |
|
||||
| Planish | (new) | `io.narl.bass-foundry.planish` |
|
||||
| Braze | (new) | `io.narl.bass-foundry.braze` |
|
||||
|
||||
CLAP IDs use the form `io.narl.bass-foundry.<product>`. Builds tagged before
|
||||
this scheme used `io.storyboard.*` IDs; hosts treat the new IDs as different
|
||||
|
||||
+14
-1
@@ -263,7 +263,8 @@ one period of the note, so heavy settings do not ripple at f0. See [Planish](pla
|
||||
- In parallel, from the research findings, in this order: Weld delay
|
||||
spread (done, unreleased); the fatness lane, as the first Assay piece
|
||||
(prototype `scripts/fatness.py`); Anvil Ghost harmonics and Phone listen
|
||||
(done, unreleased); Braze; Anvil Kick lock with offset audition.
|
||||
(done, unreleased); Braze (done, unreleased); Anvil Kick lock with offset
|
||||
audition.
|
||||
4. Forge, when enough modules exist.
|
||||
5. Assay, one plugin for the display-only ideas.
|
||||
6. Texture plugins (Anneal, Swarf, Etch, Bellows) and the note-keyed sequencer.
|
||||
@@ -296,6 +297,18 @@ beats at the same rate. Controls: rate (synced), target harmonic, depth,
|
||||
spread across harmonics, mode. It reuses the tracker, and Weld should not
|
||||
"fix" this beating: put Weld before Braze.
|
||||
|
||||
Built (unreleased 0.1.0, see [Braze](braze/README.md)). The detune is a delay
|
||||
line whose delay falls one period per beat cycle and jumps back one period,
|
||||
which is seamless on a periodic note, and the delay follows the host's beat
|
||||
position, so the peaks land on the grid. Harmonic n then beats at n/k · B: every
|
||||
harmonic is on the grid, so the planned spread control was not needed. A Low
|
||||
cut (LR4 on the copy, the bass split by the same crossover) keeps the sub out.
|
||||
Open: the frequency-shift mode. Mixed with the dry bass, a plain single-sideband
|
||||
shift gives every harmonic the same envelope at the same moment, which is
|
||||
tremolo; it needs a dispersive allpass on the copy to stagger the harmonics
|
||||
before it sounds like movement. Also open: a listening check on a real reese,
|
||||
and how Weld reads a layer after Braze.
|
||||
|
||||
### Arc — self-FM growl (research spike)
|
||||
|
||||
An arc welds with a sustained spark. Arc runs loopback FM (Smyth, DAFx 2026)
|
||||
|
||||
Reference in new issue
Block a user