Skip to content

Latest commit

 

History

History
95 lines (71 loc) · 8.56 KB

README.md

File metadata and controls

95 lines (71 loc) · 8.56 KB

PatternMachine come plug-in per Logic (Audio Unit, JUCE 8)

PatternMachine dentro Logic, su una traccia strumento: si apre la finestra del plug-in e c'è il sito, si preme Play in Logic e i pattern suonano a tempo, dalla battuta giusta, senza clock MIDI da configurare.

Come funziona

Parte Dove Cosa fa
Interfaccia ../site in un WebView (WKWebView) Il plug-in espone la sola Drum Grid, la libreria, il mixer e l'export; Synthesizer, Sequencer e Sampler restano disponibili nel sito ma sono nascosti nell'AU
Ponte bridge/plugin-bridge.js Come desktop/bridge/bridge.js per l'app, ma per il plug-in: sostituisce trigger, play, stop, setStatus, db, downloadsCap e manda ogni modifica del progetto al C++ entro 0,1 s
Motore Source/Engine.cpp Drum sequencer e campionatore in C++, dentro processBlock: gli step si calcolano dal PPQ di Logic, al campione, con 4/4, 6/8, triplette, groove, swing, probabilità, ripetizioni, flam, intonazione/decay/filtro per step, umanizza, nudge, poliritmi, choke, canzone con fill e mute dei blocchi
Stato Source/PluginProcessor.cpp Il progetto si salva dentro il progetto di Logic (e suona anche senza aprire la finestra)

Il sync è automatico perché è Logic a chiamare il plug-in a ogni blocco audio con la posizione esatta:

  • Play/Stop/tempo/cambi di tempo arrivano da Logic, nessuna impostazione da fare: l'AU legge il PPQ e il BPM dell'host a ogni blocco audio. Anche nudge, humanize, flam e ratchet seguono il BPM istantaneo dell'host. Non serve inviare un MIDI Clock alla traccia del plug-in; il trasporto di Logic è il riferimento più preciso. Il MIDI Clock esterno resta disponibile per l'app desktop e per i collegamenti MIDI senza AU.
  • Posizione: lo step 1 cade sulla battuta 1 di Logic. In modalità Canzone la canzone parte dalla battuta 1 (nel pre-roll tace) e ricomincia alla fine; in modalità Pattern il pattern selezionato gira sempre allineato alle battute.
  • Cicli e salti del righello: il motore si riposiziona sullo step che cade lì.
  • Bounce e bounce offline funzionano, perché l'audio esce dal plug-in e non dal WebView.

L'audio della batteria passa dal canale di Logic (effetti, mixer, automazione del volume), 6 dB sotto il volume del sito per lasciare margine (con i volumi del sito il canale di Logic andava oltre 0 dBFS). Con Logic fermo, il Play della pagina fa un'anteprima a tempo di Logic; i pad, l'anteprima dei blocchi e l'ascolto della libreria suonano sempre dal plug-in. Le note MIDI in ingresso sulla traccia suonano le righe: nota 36 (C1) = riga 1, 37 = riga 2... (i pad dell'MPK).

Tempo e lunghezza dei pattern

Il BPM scritto in una proposta della libreria è un riferimento musicale per scegliere lo stile. Quando il pattern viene suonato nel plug-in, la sua durata è calcolata in step e battute: Logic fornisce il BPM e il PPQ, quindi il pattern viene automaticamente adattato al tempo del progetto senza cambiare la griglia. Anche con lunghezze diverse (8, 12, 16, 24, 32 step) la partenza resta sulla battuta corretta; il nuovo filtro Only at… nella libreria permette di mostrare soltanto proposte generate esattamente al BPM indicato.

Registrare e portare la batteria sulla timeline di Logic

  • Il plug-in produce solo audio: non manda MIDI a Logic (NEEDS_MIDI_OUTPUT FALSE, e processBlock svuota il MIDI). Premere Rec sulla sua traccia non scrive i colpi della drum machine, registra soltanto le note che suoni da una tastiera o dai pad.
  • Non c'è niente da sincronizzare: per il plug-in Rec è un Play (guarda solo se il trasporto di Logic gira, la posizione PPQ e il BPM). Il Play della finestra è l'anteprima con Logic fermo e si spegne da solo quando Logic parte.
  • → Logic (accanto al badge, con − / + per le ripetizioni ×1, ×2, ×4, ×8, ×16): renderizza il WAV del pattern aperto, ripetuto N volte, al tempo di Logic (o tutta la canzone in modalità Canzone), lo salva in ~/Music/PatternMachine/Export e lo mostra nel Finder; da lì si trascina sulla timeline, su una battuta. Un plug-in non può inserire regioni nel progetto di Logic, per questo l'ultimo passo è un trascinamento. Le ripetizioni sono le stesse del selettore Repeats del menu Export (WAV e MP3 «pattern»), exportReps in site/index.html.
  • Il MIDI esportato (Export › MIDI) usa le note General MIDI o 36 + slot del kit SP-1200: non coincidono con la mappa del plug-in (36 + numero di riga), quindi serve per altri strumenti, non per il plug-in stesso.

Progetti ed export usano le stesse cartelle dell'app per Mac: ~/Music/PatternMachine/Progetti (Salva / Progetti salvati) e ~/Music/PatternMachine/Export (MIDI, WAV, MP3, pacchetto Logic; il pulsante Export ↗ accanto al Play apre la cartella nel Finder).

Login e sincronizzazione dei progetti

Nel pannello Projects della finestra del plug-in è possibile fare login con l'account PatternMachine e premere Sync. La sincronizzazione è esplicita e locale-first: i JSON in ~/Music/PatternMachine/Progetti restano la copia di lavoro; i progetti nuovi vengono caricati, quelli presenti solo online vengono scaricati e, se esistono entrambe le copie, vince quella con updatedAt più recente. Le credenziali non vengono salvate nel progetto di Logic: il plug-in conserva solo la sessione in un file locale protetto, separato dai file audio e dallo stato AU. Il lavoro offline continua a funzionare senza login. Il logout rimuove la sessione locale.

La sincronizzazione cloud comprende i dati dei pattern/progetti e i sample del Sampler: il plug-in confronta hash e data, carica le copie locali più nuove e scarica quelle più recenti dall'account, rispettando la quota server di 20 MB. Se l'app macOS è installata sullo stesso Mac, legge anche i kit importati dalla cache locale, anche offline; i file audio restano fuori dallo stato di Logic. I kit personali non vengono ancora trasferiti al cloud, perché appartengono alla libreria locale dell'app e richiederanno un pacchetto separato.

Compilarlo

Servono i Command Line Tools di Xcode (Xcode completo non serve) e brew install cmake ninja.

plugin/scripts/build.sh --test   # scarica JUCE 8.0.15 in plugin/.deps, prove del motore, build, installazione, auval

Installa in ~/Library/Audio/Plug-Ins/Components/PatternMachine.component (AU) e .../VST3/PatternMachine.vst3; la versione Standalone (per provare senza Logic) resta in plugin/build/PatternMachine_artefacts/Release/Standalone/. Ogni build copia di nuovo site/ (senza site/download) e bridge/ nei bundle, anche in quelli già installati.

In Logic: nuova traccia Strumento software › slot Strumento › AU Instruments › Tongatron › PatternMachine. Se Logic non lo vede: Logic Pro › Impostazioni › Plug-in Manager › Reimposta e ripeti la scansione.

Più canali in Logic

Logic può usare più istanze stereo del plug-in anche quando il menu AU non offre Multi-Output. Duplica la traccia PatternMachine, apri ogni istanza e usa il selettore Istanza accanto al badge Logic: scegli Tutti per l'istanza completa oppure una singola riga (BD, SD, HH, ecc.). Ogni istanza suona solo quella riga e resta su un canale separato del mixer; l'assegnazione viene salvata nel progetto di Logic.

Se cambia il sito

  • scheduler(), trigger(), stepHits(), stepIdx() o il formato di mods in site/index.html: vanno allineati in Source/Engine.cpp.
  • PMRhythm.timing() in site/engine/rhythm.js e i dati synthPatterns/synthSong vanno allineati nel ponte e in Source/Engine.cpp.
  • Campi nuovi di traccia o pattern che cambiano il suono: aggiungerli a engineState() in bridge/plugin-bridge.js e a Snapshot::fromVar.
  • Il resto del sito (grafica, libreria, export) passa da solo al prossimo build.sh.

Limiti del prototipo

  • Il plug-in non è firmato con un certificato Apple Developer: va bene sul proprio Mac, non per distribuirlo.
  • I kit personali e i sample importati sono disponibili nel plug-in quando la cache locale dell'app per Mac è presente (__kits/ e __samples/); il trasferimento cloud dei file audio non è ancora incluso in Sync.
  • La testina e il contatore nella finestra si aggiornano 30 volte al secondo (l'audio invece è al campione).
  • In Logic il menu AU può esporre soltanto Mono/Stereo: per i canali separati usare la modalità a istanze, duplicando la traccia e assegnando una riga diversa dal selettore Istanza. Il routing AU multi-output diretto resta sperimentale e dipende dall'host.
  • Le modifiche arrivano al motore entro circa 0,1 s: un colpo scritto proprio sullo step che sta per suonare può saltare quel giro.