Firmament — Bedienungsanleitung

Öffne den Himmel — ein Stereo-Widener und Imager für üppige orchestrale Layer.

Was Firmament ist

Firmament ist ein Mid/Side-Stereo-Widener und -Imager. Es ist eines von zwölf Plugins in der Heavy-Music-Suite von Basilica Audio, und seine Aufgabe in dieser Suite (und in jedem Mix) ist es, Inhalte, die bereits Stereoinformation besitzen — Streicher, Chöre, Synth-Pads, gedoppelte/geschichtete Gitarren, Ambience-Returns —, zu nehmen und zu steuern, wie breit sie sich anfühlen, ohne je zu beeinträchtigen, wie der Mix auf Mono zusammenfällt (Club-PA, Handylautsprecher, ein Broadcast-Mono-Check, ein Bassist, der seinen Part in Mono prüft).

Firmament erzeugt keine Stereobreite aus einem echt monofonen Signal von sich aus (Width und Low Width können nur skalieren, welche Stereo-Differenz im Input bereits vorhanden ist) — die Ausnahmen sind Haas Mode und Decorrelate, die aus nahezu monofonem Material tatsächlich ein Breitegefühl erzeugen können. Haas Mode und Classic Decorrelate tun das auf Kosten eines Teils der exakten Mono-Summen-Garantie, die der Rest des Plugins bietet (Haas kostet am meisten, Classic Decorrelate deutlich weniger — siehe unten). Die Velvet-Dense-/Sparse-Decorrelate-Modi aus v0.3.0 schließen diese Lücke vollständig: Sie synthetisieren Breite aus veröffentlichten Velvet-Noise-Dekorrelator-Designs und lassen dabei den Mono-Fold-down Bit für Bit identisch mit dem des Inputs — Verbreiterung aus Mono mit null Mono-Kompatibilitätskosten.

v0.2.0 hat außerdem überarbeitet, wie Auto Mono Safety reagiert (ruhigere Ballistik, eine Totzone um die Nullkorrelation, ein nutzerseitig einstellbarer Floor und ein optionaler Per-Band-Modus) und den Bereich von Bass Mono Freq erweitert — die vollständige Recherche hinter diesen Änderungen findest du in der Parameterreferenz sowie in docs/design-brief.md/docs/research-notes.md. Jeder neue Parameter startet mit einem Standardwert, der das Verhalten von v0.1.1 exakt reproduziert, sodass sich nichts ändert, sofern du nicht ausdrücklich eingreifst.

v0.3.0 rüstet Decorrelate mit zwei Velvet-Noise-Modi auf (veröffentlichte Dekorrelator-Designs von der DAFx-Konferenz), die — anders als Classic Decorrelate und anders als jeder Haas-Trick — konstruktionsbedingt vollständig mono-summensicher sind: Falte den Output auf Mono und du bekommst Bit für Bit die Mono-Summe des Inputs, bei jedem Velvet-Anteil. Hinzu kommen ein Bass Mono Mode-Wahlschalter (Phase Matched für einen nahtlosen Übergang; Linear Phase für mastering-taugliche Phasendrehungsfreiheit, auf Kosten von Latenz), ein drittes Width-Band (High Split / High Width), eine schnellere Dynamic-Safety-Reaktion mit kompressorartiger Ballistik, optional zuschaltbare Width Compensation (gleichbleibende Lautheit über den Width-Bereich) und ein Mono Audition-Monitorschalter. Wie immer entspricht jeder neue Parameter per Default exakt dem Verhalten von v0.2.0.

Wo es in einer Heavy-Music-Produktionskette sitzt

Firmament ist ein Width-/Imaging-Werkzeug, was es eher ans hintere Ende einer Kanal- oder Bus-Kette rückt, nachdem Tone-Shaping und Dynamik bereits entschieden sind:

1. Korrektives/tonales EQ, Kompression, Saturation (z. B. overture, tenebrae, andere Suite-Mitglieder) — zuerst den Klang formen.
2. Firmament — entscheiden, wie breit es sich anfühlen soll, sobald der Ton steht.
3. Reverb-/Delay-Sends, finale Bus-Bearbeitung — Width-Entscheidungen vor dem Reverb beeinflussen, wie der Reverb-Tail selbst wahrgenommen wird; manche Engineers verbreitern lieber erst nach dem Reverb-Return, was je nach Quelle eine valide Alternative ist.

Typische Platzierungen in einer Heavy-Music-Produktion:

• Streicher-/Chor-/Pad-Busse — der primäre Anwendungsfall. Fahre Width hoch, um die orchestralen/chorischen Layer zu öffnen, ohne die Gitarren/den Bass/die Kick zu verschmieren, die sich den Mix teilen.
• Gedoppelter Rhythmusgitarren-Bus — eine sanftere Hand (Width 110–140 %) kann zwei bereits gepannte Doubles zu einer einzelnen, breiter wirkenden Wand verkleben, ohne die extremen „gehypten" Artefakte mancher Stereo-Widener, weil Firmament nie etwas hinzufügt, das nicht schon im Stereobild war (wieder abgesehen von Haas Mode).
• Master-Bus (sparsam eingesetzt) — Bass Mono ist hier besonders wertvoll: die Kick-/Bass-/Low-Gitarren-Energie zentriert halten (mono-kompatibel, und physisch straffer auf einer PA), während die Becken/Streicher/Reverb-Tails oberhalb der Crossover so breit bleiben, wie der Mix sie bereits hat.
• Mono-Quellinstrumente, die durch einen Stereo-Bus geroutet werden — Firmament akzeptiert einen Mono-Input-Bus problemlos (siehe „Mono-Input" unten); in diesem Fall hat Width überhaupt keine Wirkung, es sei denn, Haas Mode/Decorrelate ist aktiviert, da es keine Zwischen-Kanal-Differenz zu skalieren gibt.

Signalfluss (Klartextversion)

Die vollständige technische Aufschlüsselung (Mermaid-Diagramm, exakte Mathematik, das reale Magnitude-/Phasenverhalten der Linkwitz-Riley-Crossover, Real-Time-Safety-Details) findest du in docs/architecture.md. Kurz gesagt:

1. Der Input wird in Mid (Mono-Inhalt, (L+R)/2) und Side (Stereo-Differenz-Inhalt, (L-R)/2) aufgeteilt.
2. Ist Bass Mono aus, skaliert Width das gesamte Side-Signal um einen einzigen Betrag.
3. Ist Bass Mono aktiviert, wird Side in ein tiefes Band (unterhalb der Bass-Mono-Frequenz) und den Rest aufgeteilt; Low Width skaliert das tiefe Band. Ist zusätzlich High Split (v0.3.0) aktiviert, wird der Rest erneut in ein Mittenband (Width) und ein hohes Band (High Width) geteilt — ein 3-Band-Imager. Bass Mono Mode (v0.3.0) entscheidet, wie der Mid-Pfad zur Aufteilung steht: unangetastet (Classic), phasenangepasst über einen begleitenden Allpass (Phase Matched) oder zeitlich ausgerichtet über eine linearphasige FIR-Aufteilung (Linear Phase, mit gemeldeter Latenz).
4. Ist Auto Mono Safety aktiviert, wird Side zusätzlich automatisch abgeschwächt, sobald der Input so stark phasenversetzt ist, dass die Korrelation die kleine Totzone um die Nullkorrelation verlässt (ein Sicherheitsnetz gegen Mono-Auslöschung) — zusätzlich zu dem, was die Width-Regler bereits getan haben —, entweder als eine globale Messung, oder (wenn Auto Mono Safety Multiband ebenfalls aktiviert und Bass Mono eingeschaltet ist) unabhängig pro Band, und entweder mit ruhiger Meter-Ballistik (Smooth) oder mit schneller, kompressorartiger Ballistik (Dynamic, v0.3.0).
5. Mid und das prozessierte Side werden wieder zu Left/Right zusammengeführt. Im Classic-Bass-Mono-Modus wird Mid von alldem nie angetastet — und die Modi Phase Matched/Linear Phase ändern immer nur Mids Phase/Timing, nie seinen Inhalt — das garantiert die weiter unten beschriebene Mono-Fold-down-Sicherheit.
6. Ist Width Comp (v0.3.0) aktiviert, gleicht ein Equal-Power-Makeup-Gain die von Width eingebrachte Pegeländerung aus.
7. Ist Decorrelate aktiviert: Im Modus Classic wird der rechte Kanal durch ein Allpass-Netzwerk verarbeitet und per Decorrelate Amount eingemischt; in den Velvet-Modi (v0.3.0) erhalten stattdessen beide Kanäle velvet-noise-diffundierten Stereo-Differenz-Inhalt — vollständig mono-summensicher. Andernfalls wird, falls Haas Mode aktiviert ist, der rechte Kanal leicht relativ zu Left verzögert (Decorrelate und Haas schließen sich gegenseitig aus) — zuletzt angewendet, vor dem finalen Trim.
8. Output trimmt den Gesamtpegel; Mono Audition (v0.3.0) ersetzt, wenn aktiviert, beide Kanäle durch den exakten Mono-Fold-down zur Kontrolle.

Gemeldete Latenz

Firmament ist latenzasymmetrisch nach Modus, und nur bei einem Modus. getLatencySamples() meldet exakt das:

Überall sonst in der Kette lautet die Zahl gleichermaßen null: Die Crossover sind Linkwitz-Riley-IIR-Strukturen, die Classic-Decorrelate-Allpass-Kaskade ist eine Direct-Form-Biquad-Kette, die Velvet-Dense/Sparse-Dekorrelatoren sind latenzfreie sparse FIRs, und die Delay von Haas Mode ist ein bewusster relativer Kanal-Offset statt eines Verarbeitungsartefakts, das ein Host kompensieren müsste — keines davon fügt gemeldete Latenz hinzu, bei keinem Setting, bei keiner Samplerate. Nur Linear Phase Bass Mono weicht ab: Sein FIR-Komplementär-Crossover meldet N/2 Samples, wobei N = 4096 * fs / 48000 auf gerade gerundet wird, die Zahl skaliert also mit der Samplerate (2048 bei 48 kHz; entsprechend mehr oder weniger bei anderen Raten), und sie wird dynamisch gemeldet, außerhalb des Audio-Threads, über einen 50-ms-Message-Thread-Servicing-Timer statt über den Audio-Callback. Ein Wechsel zu oder von Linear Phase während der Wiedergabe wendet ein kurzes (~5 ms) Mute an und kann deinen Host dazu bringen, die Plugin-Delay-Kompensation neu auszuhandeln — manche Hosts klicken dabei, weshalb die Tipps unten empfehlen, den Modus vor einem Render-Durchgang zu wählen statt ihn zu automatisieren. Ein klickfreier Übergang über eine Latenzänderung hinweg ist prinzipiell nicht erreichbar.

Parameterreferenz

Tipps

• Beginne mit Width, nicht mit Bass Mono. Die meisten Materialien brauchen nur den einzelnen globalen Width-Regler; greife gezielt zu Bass Mono Freq/Low Width, wenn du hörst, dass der Low-End an Fokus verliert oder sich in Mono schlecht überträgt, während du Width hochfährst.
• Immer im Mono A/B-vergleichen. Solo den Bus, schalte das Mono-/Downmix-Monitoring deiner DAW ein und bestätige, dass sich nichts seltsam auslöscht — Firmaments eigener Width-/Low-Width-/Auto-Mono-Safety-Pfad (breitbandig oder multiband) ist konstruktionsbedingt nachweislich mono-sicher (siehe docs/architecture.md), Haas Mode und Decorrelate aber bewusst nicht, und selbst eine mono-sichere Width-Einstellung kann noch Probleme freilegen, die im eigenen Stereobild des Quellmaterials bereits latent vorhanden waren.
• 200 % Width ist eine Spezialeffekt-Einstellung, kein Standard. Auf einem ganzen Mix oder einem lauten Bus liest sich das schnell künstlich/phasig; viel nützlicher ist es, kurz danach zu greifen (automatisiert für einen Chorus-Lift, einen Breakdown, einen einzelnen Pad-Layer), als es durchgehend aktiviert zu lassen.
• Auto Mono Safety ist ein Sicherheitsnetz, kein Ersatz fürs Hinhören. Es reagiert auf die Korrelation des Inputs des Plugins, mit meter-artiger (300 ms) Ballistik und einer kleinen Totzone um die Nullkorrelation — schnell genug, um ein anhaltendes Phasenproblem zu erfassen, nicht schnell genug (noch dafür gedacht), schnelle Transienten sample-genau zu überwachen, und nicht so überempfindlich, dass eine gelegentliche kleine negative Messung es bereits auslöst.
• Bevorzuge Decorrelate gegenüber Haas Mode, wenn Mono-Übertragbarkeit überhaupt eine Rolle spielt — und bevorzuge die Velvet-Modi gegenüber Classic, wenn sie absolut zählt. Die dokumentierten Kosten von Classic Decorrelate sind milde spektrale Welligkeit beim Mono-Fold-down; die Velvet-Dense-/Sparse-Modi aus v0.3.0 haben konstruktionsbedingt null Mono-Fold-down-Kosten (die Mono-Summe ist Bit für Bit die des Inputs). Die Kosten von Haas Mode sind tiefe, hörbare Kammfilter-Einbrüche. Greife gezielt zu Haas Mode, wenn du seinen stärkeren, dramatischeren Precedence-Effekt-Charakter willst und Mono-Übertragbarkeit zweitrangig ist (ein Übergangseffekt, ein Layer, der nie auf Mono heruntergefaltet wird).
• Linear Phase Bass Mono ist eine Mastering-/Render-Entscheidung, kein Live-Schalter. Es meldet echte Latenz (2048 Samples bei 48 kHz), die dein Host automatisch kompensiert, aber ein Moduswechsel mitten in der Wiedergabe schaltet kurz stumm und kann in manchen Hosts klicken, während sie die Verzögerung neu aushandeln. Wähle es, wenn Phasenreinheit durch die Weiche zählt (Mastering, Bus-Bearbeitung, die weitere M/S-Werkzeuge speist); bleibe fürs Tracking/Live bei Classic oder Phase Matched, die latenzfrei sind.
• Nutze Mono Audition, statt den Downmix-Button deiner DAW zu suchen. Es ist exakt der Fold-down, um den es bei den Mono-Kompatibilitätsgarantien geht, angewendet nach allem anderen.
• Haas Mode/Decorrelate und Bass Mono/Low Width lassen sich problemlos kombinieren, aber überlege, was jedes davon tut: Bass Mono/Low Width/Auto Mono Safety formen Breite innerhalb des Mid/Side-Modells (nachweislich mono-sicher), Haas Mode/Decorrelate sind ein separater, späterer, nicht Mid/Side-basierter Effekt. Falls du garantierte Mono-Kompatibilität brauchst (Broadcast-Auslieferung, ein Club-System mit unvorhersehbarem Mono-/Summen-Sub), lass beide aus und verlasse dich allein auf Width/Low Width/Auto Mono Safety.
• Auf einer Mono-Input-Spur/einem Mono-Input-Bus haben Width/Low Width/Auto Mono Safety nichts, worauf sie wirken könnten (es gibt kein Side-Signal) — das Plugin lässt die Quelle sauber durch. Haas Mode/Decorrelate sind die Regler, die in dieser Situation noch etwas bewirken, da sie arbeiten, nachdem das (jetzt identische) L/R-Paar bereits decodiert wurde — genau dafür, um nahezu monofones Material zu verbreitern, sind sie gebaut.

Presets

Firmament bringt dreizehn Werkspresets für die gängigsten Anwendungsfälle mit (orchestrale/chorische Breite, Doubled-Rhythmus-Verklebung, Bass-Mono auf dem Master-Bus, Sicherheitsnetze für automatisiertes Width, je ein Showcase-Preset für Decorrelate und Haas Mode und — neu in v0.3.0 — Velvet Width, Mastering: Linear Phase Bass Mono und Three-Band Imager) — die vollständige Liste und die Absicht hinter jedem einzelnen findest du in docs/presets.md. Die am oberen Rand des Plugin-Fensters angedockte Preset-Leiste lässt dich Werks-/User-Presets durchstöbern, eigene speichern, User-Presets umbenennen/löschen, einzelne Presets oder eine ganze Bank (ein Zip deiner User-Presets) importieren/exportieren und ein Preset als Standard festlegen, der bei einer frischen Instanz automatisch lädt. Presets sind eine zusätzliche Schicht über dem eigenen Plugin-State-Speichermechanismus deines Hosts, kein Ersatz dafür — deine DAW-Session speichert so oder so weiterhin, welcher Zustand gerade geladen ist.

Unter der Haube

Die Begründung und die vollständigen technischen Details stehen in docs/architecture.md; die Zahlen unten sind das, was die automatisierte Testsuite bei jedem Push tatsächlich erzwingt.

Mono-Kompatibilität ist strukturell, nicht getunt. Firmament kodiert nach Mid/Side (mid = (L+R)/2, side = (L-R)/2) und dekodiert als left = mid + side, right = mid - side. Jeder Width-Regler — Width, Low Width, High Width, Auto Mono Safety — skaliert ausschließlich Side; im Classic-Bass-Mono-Modus wird Mid von keinem davon je angetastet. Weil die Dekodierung immer left + right == 2*mid ist, unabhängig davon, was Side gerade ist, entspricht der Mono-Downmix des Outputs bei jedem Width-Setting dem Mono-Downmix des Inputs, einschließlich 0 % und 200 %. Das wird direkt auf Codec-Ebene geprüft, an der Engine über ein Spektrum an Settings, und unabhängig für jede Stufe, die es plausibel brechen könnte — Multiband-Width, Auto Mono Safety und das dritte Width-Band.

Velvet-Noise-Dekorrelation musste einen echten Widerspruch auflösen, nicht nur ein veröffentlichtes Design implementieren. Die veröffentlichten, optimierten Velvet-Noise-Dekorrelator-Paare (Koeffizienten als Daten aus den Tabellen des Open-Access-Papers übernommen, kein Drittanbieter-Code) dekorrelieren einzeln gut, aber ihre Summe trägt bei 48 kHz eine echte Notch von etwa 17 dB um 320 Hz — weil die Optimierung, die sie hervorgebracht hat, die eigene Flachheit jedes Filters und die Kohärenz des Paars einschränkt, aber nie die Summe des Paars. Als roher Wet-Mix pro Kanal angewendet würde diese Notch direkt im Mono-Fold-down auftauchen. Firmament hält stattdessen die verbreiternde Hälfte der Topologie intakt, pinnt aber den Mono-Anteil trocken: S' = (1-d)S + d*(A(L) - B(R))/2, M' = M. Das Ergebnis ist ein Dekorrelator, dessen Mono-Kompatibilität strukturell statt getunt ist — gemessene Fold-down-Abweichung ~0,0000003 dB bei Velvet Dense, Width 150 %, Amount 100 %, gegen 16,2 dB bei einer Haas-artigen Kontrolle auf demselben Programmmaterial —, und beide Kanäle werden tatsächlich verarbeitet statt nur einer, anders als im Classic-Modus.

Phase Matched beweist seine eigene Behauptung mit einer Negativkontrolle. Statt einen Allpass 2. Ordnung von Hand zu bauen, um der Phase der Weiche zu folgen, wrappt Phase Matched dieselbe Linkwitz-Riley-Filterklasse in ihrem eigenen dokumentierten Allpass-Modus, sodass der begleitende Mid-Pfad exakt dieselben internen Zustandsgleichungen und Koeffizienten wie die Weiche selbst teilt — die Phasen-Tracking-Garantie gilt konstruktionsbedingt, nicht durch sorgfältige Duplikation. Der Test, der das beweist, führt dieselbe Phasen-Tracking-Prüfung erneut aus, mit dem begleitenden Allpass durch Eins ersetzt, und verlangt, dass dieser Durchlauf scheitert — er misst dort 179,8 Grad Phasenfehler, gegen 5e-6 Grad, wenn der echte Allpass eingesetzt ist, was als Absicherung dient, dass der Test nicht still aufhört, etwas zu messen.

Linear Phase ist ein echtes Perfect-Reconstruction-FIR-Paar, keine Näherung: ein Kaiser-gefensterter Sinc-Tiefpass auf dem Mono-Side-Strom, mit dem High-Band und dem Mid-Pfad, die beide passend verzögert werden. Gemessenes Residuum gegen eine reine N/2-Sample-Delay: ~7e-9. Group Delay weicht über 20 Hz – 20 kHz um 0,0002 Samples von flach ab. Der Kernel wird auf dem Message-Thread neu berechnet und über einen einzigen Convolution::loadImpulseResponse-Aufruf installiert, der sein eigenes Hintergrund-Laden und die Output-Überblendung übernimmt, statt eines handgebauten Doppelpuffers — bewusst, weil JUCEs schlichte FIR-Filter-Klasse ihre Koeffizienten nicht vom Message-Thread aus neu zuweisen kann, während der Audio-Thread sie ohne Data Race liest.

Drei-Band-Width summiert flach, weil das Low-Band vor der Summe phasenkorrigiert wird. Standard-3-Wege-Linkwitz-Riley-Praxis, und das Detail, das naive 3-Band-Splits normalerweise falsch machen: Das Low-Band durchläuft vor der Bandsumme einen Allpass, der zum High-Split passt, sodass alle drei Bänder dort identische Phase tragen. Gemessene Bandsummen-Abweichung: innerhalb von ±0,1 dB, sowohl im 3-Band-Fall als auch im Fall mit nur dem High-Split (2-Band).

Das Energie-Gate des Korrelations-Guards existiert wegen einer echten Falle. Ein leckendes Pearson-Korrelationsverhältnis ist unter Stille invariant — Zähler und Nenner klingen mit derselben Rate ab, das Verhältnis bewegt sich also nie. Jeder Korrelationsschätzer im Plugin — die Anzeige-Meter ebenso wie der Dynamic-Safety-Detektor — klingt seine Schätzung deshalb unterhalb eines Energie-Gates gegen null ab; ohne dieses Gate würden Meter bei Stille ±1 anzeigen, und der Dynamic-Guard könnte nach einem gegenphasigen Burst bei maximaler Abschwächung einrasten und nie mehr loslassen. Die eigene Ballistik von Dynamic ist als Zeit bis 90 % Einschwingen spezifiziert und gemessen (5 ms Attack, 250 ms Release), nicht als rohe Zeitkonstante, weil sich eine Lesart der ursprünglichen Spezifikation als rohe Zeitkonstante als nicht erfüllbar herausstellte — eine 250-ms-Zeitkonstante erreicht 90 % Recovery erst nach rund 575 ms, nicht nach 250.

Engineering-Hygiene: keine Heap-Allokationen auf dem Audio-Thread, bewiesen unter einem ersetzten Allocator über jede Decorrelate-/Bass-Mono-/Safety-Modus-Kombination, einschließlich Modus-Wechseln innerhalb der abgesicherten Region und dem reset() beim Linear-Phase-Pfad-Tausch. Jede bedingte DSP-Stufe läuft bei jedem Sample, unabhängig davon, ob sie gerade aktiviert ist — nur die Output-Auswahl wird gegatet — weil das Gaten des Verarbeitungsaufrufs selbst einmal den Filterzustand einfrieren statt abklingen ließ, was den einen Fall, in dem es so ausgeliefert wurde, einen hörbaren Transienten erzeugte (behoben in v0.1.1). Jedes Input-Sample wird auf NaN/Inf geprüft und auf null gesetzt, bevor es die M/S-Kodierung erreicht, weil der IIR-Zustand der Weiche und die leckenden Integratoren des Korrelationsschätzers sonst ein einzelnes vergiftetes Sample unbegrenzt weitertragen würden. Sessions aus v0.1.x und v0.2.0 laden mit jedem gespeicherten Wert intakt, verifiziert sowohl als Same-Binary-Toleranz-0-Null als auch gegen einen eingefrorenen, committeten v0.2.0-Referenz-Render.

Bekannte Einschränkungen

• Haas Mode und Classic Decorrelate sind bewusste, dokumentierte Ausnahmen von der Mono-Summen-Garantie — die Velvet-Decorrelate-Modi sind es nicht. Haas Mode kostet messbar 16,2 dB Terzoktav-Mono-Fold-down-Abweichung bei repräsentativem Programmmaterial (tiefe Kammfilter-Notches durch Summieren zweier zeitversetzter Kanäle); die Kosten von Classic Decorrelate sind kleiner und begrenzt (unter 9 dB bei 50 % Amount — begrenztes spektrales Ripple statt tiefer Nullstellen), aber weiterhin real. Velvet Dense/Sparse kosten ~0,0000003 dB bei derselben Klasse Programmmaterial — nicht nur niedrig, sondern strukturell unfähig, mehr zu kosten, weil ausschließlich das Stereo-Differenz-Signal je synthetisiert wird.
• Width Compensation wird ausschließlich aus dem Breitband-Width-Parameter berechnet. Bei aktivierten Multiband-Splits gehen Low Width und High Width nicht in die Makeup-Gain-Formel ein. Deshalb steht der Regler standardmäßig aus.
• Es gibt nirgends im Signalpfad einen Limiter oder eine Ceiling. Firmament ist ein rein linearer Prozessor — Width über 100 % und Output über 0 dB fügen beide tatsächlich Gain hinzu, was genau das ist, was der Regler dokumentiert tut, kein Versagen eines Sicherheitsmechanismus.
• Width, Low Width und High Width können aus einem wirklich mono Signal allein keine Stereobreite erzeugen — sie können nur bereits vorhandene Stereo-Differenz skalieren. Bei einem Mono-Input-Bus ist Side exakt 0, und das Plugin lässt die Quelle sauber durch; Haas Mode und Decorrelate sind die einzigen Regler, die in dieser Situation etwas bewirken.
• Das Voicing ist recherchebasiert, nicht gegen den Output irgendeines kommerziellen Plugins gemessen — die vollständige Quellenlage und ihre eigenen Vertrauens-Vorbehalte, einschließlich des konkreten Hinweises, dass die 500–600-Hz-Bereichserweiterung von Bass Mono Freq der am wenigsten belegte, am stärksten begründete Wert im Plugin ist, stehen unter Recherchebasiertes Voicing unten.
• Bewusst außerhalb des Umfangs dieses Releases: Gerzon-Shuffler-Shelfs auf dem Side-Signal, eine ERB-gewarpte Allpass-Kaskaden-„Diffuse"-Dekorrelator-Stufe, Ambience Recovery / externer Sidechain / ein Dry/Wet-Mixer für das gesamte Plugin, ein Goniometer- oder Vectorscope-Widget, Width-Guard-Lookahead, sowie Rotation/Asymmetrie/Pan des Stereofelds.
• Die GUI und ein sichtbares Korrelations-Meter sind noch nicht gebaut — siehe Roadmap unten; jeder Parameter ist in der Zwischenzeit vollständig über generische Host-Editoren und Automation steuerbar.
• Pre-1.0. Release-Binaries für macOS und Windows sind derzeit unsigniert. Lizenziert unter AGPLv3. Breaking Changes bleiben bis v1.0.0 möglich.

Recherchebasiertes Voicing (Ehrlichkeitshinweis)

Firmaments Standardwerte und Wertebereiche (der „typische" 80–200-Hz-Bereich von Bass Mono Freq, die Ordnung der Linkwitz-Riley-Crossover, das Haas-Time-Fenster, die Ballistik/Totzone von Auto Mono Safety, der Ansatz von Decorrelate) sind recherchebasiert — abgeleitet aus öffentlichen Handbüchern, Entwickler-/Produktdokumentation, dem Konsens aus Mastering-Foren und Fachpresse sowie akustischer/psychoakustischer Fachliteratur (die vollständige Quellenangabe findest du in docs/research-notes.md) — nicht gemessen am tatsächlichen Audio-Output irgendeines kommerziellen Stereo-Wideners, und kein proprietärer DSP-Algorithmus eines anderen Herstellers wurde untersucht, dekompiliert oder nachgebildet. docs/design-brief.md dokumentiert genau, welche Zahlen direkt belegt sind, welche belegt, aber mit geringerer Zuverlässigkeit sind, und welche begründete Entscheidungen sind, bei denen eine Quelle ein Prinzip, aber keinen exakten Zahlenwert festlegt.

Roadmap / was noch fehlt

Firmaments GUI ist noch der schlichte, funktionale Slider-/Toggle-Editor im v0.1/v0.2-Stil plus eine einfache Preset-Leiste — jeder Parameter oben ist vollständig aus dem eigenen Fenster des Plugins steuerbar (und aus den generischen Editor-/Automationsspuren jedes Hosts), aber es gibt noch keine eigens gezeichnete Oberfläche, und die Korrelations-/Phasenschätzung, die Auto Mono Safety antreibt, wird noch nicht als sichtbares Meter angezeigt (der DSP-Wert ist vollständig berechnet und getestet — siehe docs/architecture.md — nur das visuelle Widget steht noch aus). Beide sind für einen späteren Meilenstein vorgemerkt (eigene GUI + Metering).