* Bjornmossa DSP algorythms library
This repo contains SC code for synthesis, processing and analysys algorythms.
* Usage
#+BEGIN_SRC sclang
(
var sin_dict = BmDspAlgs.getDict("synths/distorted_sin.scd");
sin_dict[\postAmp] = true;
sin_dict.makeSourceSynthDef.add();

~synth = ();
~synth[\name] = \synth;

Ndef(~synth[\name]).clear;
Ndef(~synth[\name]).ar(2);
Ndef(~synth[\name]).prime(sin_dict[\name]);

Ndef(~synth[\name]).play;
)
#+END_SRC

* Словари-обработки (Fx-словари) через makeBufferProcessingNdef
#+BEGIN_SRC sclang
(
// Загрузка словаря как buffer-processing Fx.
~dict = BmDspAlgs.getDict("spectral/fft_freeze.scd");

// Вход через Bus — стандартный паттерн: makeBufferProcessingNdef
// передаёт \buf как OSC-параметр (control-rate число = номер bus),
// func получает его первым аргументом.
~inBus = Bus.audio(s, 2);
{ Out.ar(~inBus, SoundIn.ar([0, 1])) }.play;

// Создаём Ndef: name = имя нового Ndef, buf = audio-сигнал.
~dict.makeBufferProcessingNdef(\freezeOnly, ~inBus);

// Параметры func (fftBufnum, freezeGate, phaseJitter) теперь —
// control-параметры SynthDef, доступные через .set / .map.
Ndef(\freezeOnly).set(\fftBufnum, someBuffer);
Ndef(\freezeOnly).set(\freezeGate, 1);
Ndef(\freezeOnly).play;
)
#+END_SRC

** Контракт func для Fx-словарей

Func в Fx-словаре объявляется с одним обязательным первым аргументом — *buf*:

#+BEGIN_SRC sclang
func: {
  | buf |
  // buf — это audio-сигнал, пришедший через OSC-параметр \buf.
  // В скетче он = номер Bus.audio, из которого читает Ndef.
  // Остальные параметры объявляются через \name.kr(...) /
  // \name.tr(...) и становятся control-параметрами SynthDef.
  var sig = ...;
  sig;
}
#+END_SRC

Имя первого аргумента (=buf) — это convention, не контракт. Важно,
что func принимает ровно один positional аргумент первым; обёртка
=makeBufferProcessingNdef= делает =SynthDef.wrap(func, prependArgs: [buf])=.

** Цепочки Fx-словарей

Чтобы пропустить выход одного Ndef через другой Fx-словарь,
используется промежуточный Bus:

#+BEGIN_SRC sclang
~midBus = Bus.audio(s, 2);
Ndef(\first)[0] = { Out.ar(~midBus, Ndef(\first).bus.asMap) };

~dict2.makeBufferProcessingNdef(\second, ~midBus);
Ndef(\second).play;
#+END_SRC

Это даёт последовательную обработку: =first → midBus → second=.

** Отличия от нотных словарей

Нотные словари (=makeSourceSynthDef= / =makeSourceNdef=) оборачивают func
с prependArgs =[freq, gate]= и добавляют ADSR-огибающую, panning, amp.
Func должна быть вида =| freq, gate |=.

Fx-словари (=makeBufferProcessingSynthDef= / =makeBufferProcessingNdef=)
оборачивают func с prependArgs =[buf]= и добавляют Pan2 + amp.
Func должна быть вида =| buf |=. Дополнительные обёртки (DetectSilence,
limitDuration через Line) включаются ключами =detectSilence: true= и
=limitDuration: true= в словаре.