libcm is a C development framework with an emphasis on audio signal processing applications.
Você não pode selecionar mais de 25 tópicos Os tópicos devem começar com uma letra ou um número, podem incluir traços ('-') e podem ter até 35 caracteres.

cmProc3.h 29KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702
  1. #ifndef cmProc3_h
  2. #define cmProc3_h
  3. #ifdef __cplusplus
  4. extern "C" {
  5. #endif
  6. typedef struct
  7. {
  8. double wi;
  9. double xi;
  10. int yn;
  11. cmSample_t* y;
  12. int yii;
  13. int yoi;
  14. int ynn;
  15. } cmPitchShiftOsc_t;
  16. typedef struct
  17. {
  18. cmObj obj;
  19. unsigned procSmpCnt;
  20. double srate;
  21. int outN; // procSmpCnt
  22. int wn; //
  23. int xn; //
  24. int bn; //
  25. cmSample_t* b; // b[bn]
  26. cmSample_t* x; // x[xn]
  27. cmSample_t* wnd; // wnd[wn]
  28. cmSample_t* outV; // outV[outN];
  29. int xni; //
  30. bool cubeFl; //
  31. cmPitchShiftOsc_t osc[2]; //
  32. } cmPitchShift;
  33. cmPitchShift* cmPitchShiftAlloc( cmCtx* c, cmPitchShift* p, unsigned procSmpCnt, cmReal_t srate );
  34. cmRC_t cmPitchShiftFree( cmPitchShift** pp );
  35. cmRC_t cmPitchShiftInit( cmPitchShift* p, unsigned procSmpCnt, cmReal_t srate );
  36. cmRC_t cmPitchShiftFinal(cmPitchShift* p );
  37. cmRC_t cmPitchShiftExec( cmPitchShift* p, const cmSample_t* x, cmSample_t* y, unsigned n, double shiftRatio, bool bypassFl );
  38. //=======================================================================================================================
  39. typedef struct
  40. {
  41. double xi; // index into xV[]
  42. double wi; // index into wV[]
  43. cmSample_t u; // cross-fade window polarity
  44. } cmLoopRecdOsc;
  45. typedef struct
  46. {
  47. cmLoopRecdOsc osc[2]; //
  48. cmSample_t* xV; // xV[ xN ]
  49. int xN; // maxRecdSmpCnt
  50. int xfN; // cross-fade sample count
  51. int xii; // xV[] recording input index
  52. cmSample_t* wV; // wV[ xN ] window function (actually contains xii values after recording)
  53. } cmLoopRecdBuf;
  54. typedef struct
  55. {
  56. cmObj obj;
  57. cmSample_t* bufMem;
  58. unsigned maxRecdSmpCnt;
  59. cmLoopRecdBuf* bufArray;
  60. unsigned bufArrayCnt;
  61. cmSample_t* outV;
  62. unsigned outN;
  63. unsigned procSmpCnt;
  64. unsigned xfadeSmpCnt;
  65. unsigned recdBufIdx;
  66. unsigned playBufIdx;
  67. bool recdFl;
  68. bool playFl;
  69. } cmLoopRecord;
  70. cmLoopRecord* cmLoopRecordAlloc( cmCtx* c, cmLoopRecord* p, unsigned procSmpCnt, unsigned maxRecdSmpCnt, unsigned xfadeSmpCnt );
  71. cmRC_t cmLoopRecordFree( cmLoopRecord** pp );
  72. cmRC_t cmLoopRecordInit( cmLoopRecord* p, unsigned procSmpCnt, unsigned maxRecdSmpCnt, unsigned xfadeSmpCnt );
  73. cmRC_t cmLoopRecordFinal( cmLoopRecord* p );
  74. // rgain=recorder output gain, pgain=pass through gain
  75. cmRC_t cmLoopRecordExec( cmLoopRecord* p, const cmSample_t* x, cmSample_t* y, unsigned xn, bool bypassFl, bool recdFl, bool playFl, double ratio, double pgain, double rgain );
  76. //=======================================================================================================================
  77. typedef struct
  78. {
  79. cmObj obj;
  80. unsigned rmsN;
  81. cmSample_t* rmsV; // rmsV[rmsN] previous rmsN values. rmsV[rmsN-1] == rms
  82. cmSample_t rms; // RMS of last procSmpCnt samples
  83. unsigned wndN;
  84. cmSample_t* wndV;
  85. cmSample_t mean;
  86. cmSample_t d0;
  87. unsigned durSmpCnt; // duration of the current gate polarity in samples
  88. bool gateFl;
  89. bool deltaFl;
  90. cmReal_t onThreshPct;
  91. cmReal_t onThreshDb;
  92. cmReal_t offThreshDb; //
  93. } cmGateDetect;
  94. cmGateDetect* cmGateDetectAlloc( cmCtx* c, cmGateDetect* p, unsigned procSmpCnt, cmReal_t onThreshPct, cmReal_t onThreshDb, cmReal_t offThreshDb );
  95. cmRC_t cmGateDetectFree( cmGateDetect** p );
  96. cmRC_t cmGateDetectInit( cmGateDetect* p, unsigned procSmpCnt, cmReal_t onThreshPct, cmReal_t onThreshDb, cmReal_t offThreshDb );
  97. cmRC_t cmGateDetectFinal(cmGateDetect* p );
  98. cmRC_t cmGateDetectExec( cmGateDetect* p, const cmSample_t* x, unsigned xn );
  99. //=======================================================================================================================
  100. typedef struct
  101. {
  102. unsigned medCnt; // length of the median filter
  103. unsigned avgCnt; // length of the (rms - med) moving avg. filter
  104. unsigned suprCnt; // length of the supression window
  105. unsigned offCnt; // length of the offset detection window
  106. cmReal_t suprCoeff; // supression signal shape coeff
  107. cmReal_t onThreshDb; // onset threshold
  108. cmReal_t offThreshDb; // offset threshold
  109. } cmGateDetectParams;
  110. typedef struct
  111. {
  112. cmObj obj;
  113. cmGateDetectParams args;
  114. cmSample_t* medV; // medV[medCnt]
  115. unsigned medIdx;
  116. cmSample_t* avgV; // avgV[avgCnt]
  117. unsigned avgIdx;
  118. cmSample_t* fcofV; // fcofV[medCnt]
  119. cmSample_t* fdlyV; // fdlyV[medCnt]
  120. cmSample_t* suprV; // suprV[suprCnt]
  121. unsigned suprIdx;
  122. cmSample_t* pkV; // pkV[3]
  123. cmSample_t* offV; // offV[offCnt]
  124. unsigned offIdx;
  125. unsigned pkFl; //
  126. bool gateFl; // set by onset, cleared by offset
  127. bool onFl; // set if an onset was detected
  128. bool offFl; // set if an offset was detected
  129. cmReal_t onThresh;
  130. cmReal_t offThresh;
  131. cmSample_t rms; // RMS
  132. cmSample_t med; // median RMS over last medCnt exec's
  133. cmSample_t dif; // max(0, RMS - median_RMS)
  134. cmSample_t avg; // avg dif's over last avgCnt exec's
  135. cmSample_t ons; // dif - avg
  136. cmSample_t flt; // filtered(ons)
  137. cmSample_t sup; // flt w/ suppression
  138. } cmGateDetect2;
  139. cmGateDetect2* cmGateDetectAlloc2( cmCtx* c, cmGateDetect2* p, unsigned procSmpCnt, const cmGateDetectParams* args );
  140. cmRC_t cmGateDetectFree2( cmGateDetect2** p );
  141. cmRC_t cmGateDetectInit2( cmGateDetect2* p, unsigned procSmpCnt, const cmGateDetectParams* args );
  142. cmRC_t cmGateDetectFinal2(cmGateDetect2* p );
  143. cmRC_t cmGateDetectExec2( cmGateDetect2* p, const cmSample_t* x, unsigned xn );
  144. void cmGateDetectSetOnThreshDb2( cmGateDetect2* p, cmReal_t db );
  145. void cmGateDetectSetOffThreshDb2( cmGateDetect2* p, cmReal_t db );
  146. //=======================================================================================================================
  147. //
  148. // Calculate a set of automatic gain adjustments for a set of audio channels.
  149. //
  150. // 1) Call cmAutoGainInit() to reset the object.
  151. // 2) Call cmAutoGainStartCh() and provide an id to identify the channel.
  152. // 3) Call cmAutoGainProcCh() with audio from the channel identified in 2)
  153. // 4) Repeat 2) and 3) for for all channels.
  154. // 5) Call cmAutoGainCalcGains() to set the value of cmAutoGainCh.gain.
  155. //
  156. // The gain coefficents are set to balance the overall gain.
  157. // (i.e. Loud channels are decreased and quiet channels are increased.)
  158. typedef struct
  159. {
  160. unsigned id; // channel id
  161. cmReal_t gain; // gain adjustment coefficient
  162. unsigned onCnt; // count of onsets detected
  163. unsigned offCnt; // count of offsets detected
  164. cmReal_t gateMaxAvg; // average of the max values for each detected event
  165. } cmAutoGainCh;
  166. typedef struct
  167. {
  168. cmObj obj;
  169. cmShiftBuf* sbp;
  170. cmGateDetect2* gdp;
  171. cmAutoGainCh* chArray; //
  172. unsigned chCnt;
  173. cmAutoGainCh* chp;
  174. unsigned gateCnt;
  175. cmReal_t gateSum;
  176. cmReal_t gateMax;
  177. cmReal_t minRms;
  178. } cmAutoGain;
  179. cmAutoGain* cmAutoGainAlloc( cmCtx* c, cmAutoGain* p, unsigned procSmpCnt, cmReal_t srate, cmReal_t hopMs, unsigned chCnt, const cmGateDetectParams* gd_args );
  180. cmRC_t cmAutoGainFree( cmAutoGain** p );
  181. cmRC_t cmAutoGainInit( cmAutoGain* p, unsigned procSmpCnt, cmReal_t srate, cmReal_t hopMs, unsigned chCnt, const cmGateDetectParams* gd_args );
  182. cmRC_t cmAutoGainFinal( cmAutoGain* p );
  183. // Notify the object that the following calls to cmAutoGainProcCh()
  184. // should be associed with the channel 'id'.
  185. cmRC_t cmAutoGainStartCh( cmAutoGain* p, unsigned id );
  186. // Examine the signal arriving from the channel specified in the previous
  187. // call to cmAutoGainProcCh() and determine the max RMS value for each
  188. // event contained in the signal.
  189. cmRC_t cmAutoGainProcCh( cmAutoGain* p, const cmSample_t* x, unsigned xn );
  190. // Calculate the cmAutoGainCh.gain coefficient for each channel.
  191. cmRC_t cmAutoGainCalcGains( cmAutoGain* p );
  192. void cmAutoGainPrint( cmAutoGain* p, cmRpt_t* rpt );
  193. //=======================================================================================================================
  194. typedef struct
  195. {
  196. unsigned ch;
  197. unsigned ssi;
  198. const cmChar_t* pitchStr;
  199. unsigned midi;
  200. cmReal_t gain;
  201. bool nsFl; // noise shaper channel
  202. bool cdFl; // chord detector channel
  203. } cmChCfgCh;
  204. typedef struct
  205. {
  206. cmObj obj;
  207. cmChCfgCh* chArray;
  208. unsigned chCnt;
  209. unsigned nsChCnt; // count of noise-shaper channels
  210. const cmChar_t* fn;
  211. cmJsonH_t jsH;
  212. cmJsonNode_t* cap;
  213. } cmChCfg;
  214. cmChCfg* cmChCfgAlloc( cmCtx* c, cmChCfg* p, cmCtx_t* ctx, const cmChar_t* fn );
  215. cmRC_t cmChCfgFree( cmChCfg** pp );
  216. cmRC_t cmChCfgInit( cmChCfg* p, cmCtx_t* ctx, const cmChar_t* fn );
  217. cmRC_t cmChCfgFinal( cmChCfg* p );
  218. cmRC_t cmChCfgWrite( cmChCfg* p );
  219. void cmChCfgPrint( cmChCfg* p, cmRpt_t* rpt );
  220. unsigned cmChCfgChannelCount( cmCtx_t* ctx, const cmChar_t* fn, unsigned* nsChCntPtr );
  221. unsigned cmChCfgChannelIndex( cmCtx_t* ctx, const cmChar_t* fn, unsigned chIdx );
  222. //=======================================================================================================================
  223. typedef struct
  224. {
  225. bool readyFl; // This channel has received an offset since it was last a candidate.
  226. bool candFl; // This channel is a chord candidate
  227. unsigned candSmpTime; // Time that this channel became a candidate
  228. cmReal_t candRMS; // RMS when this channel became a candidate
  229. bool chordFl; // This channel is part of the current chord
  230. bool gateFl; // Previous gate state
  231. } cmChordDetectCh;
  232. typedef struct
  233. {
  234. cmObj obj;
  235. unsigned maxTimeSpanSmpCnt; // maximum time between onsets of first and last note of chord
  236. unsigned minNotesPerChord; // the min. number of notes required to form a chord
  237. unsigned chCnt; // count of channels
  238. cmChordDetectCh* chArray; // channel state array
  239. bool detectFl; // true when a new chord has been detected
  240. unsigned timeSmp; // current time
  241. cmReal_t srate;
  242. } cmChordDetect;
  243. cmChordDetect* cmChordDetectAlloc( cmCtx*c, cmChordDetect* p, cmReal_t srate, unsigned chCnt, cmReal_t maxTimeSpanMs, unsigned minNotesPerChord );
  244. cmRC_t cmChordDetectFree( cmChordDetect** pp );
  245. cmRC_t cmChordDetectInit( cmChordDetect* p, cmReal_t srate, unsigned chCnt, cmReal_t maxTimeSpanMs, unsigned minNotesPerChord );
  246. cmRC_t cmChordDetectFinal( cmChordDetect* p );
  247. cmRC_t cmChordDetectExec( cmChordDetect* p, unsigned procSmpCnt, const bool* gateV, const cmReal_t* rmsV, unsigned chCnt );
  248. cmRC_t cmChordDetectSetSpanMs( cmChordDetect* p, cmReal_t maxTimeSpanMs );
  249. //=======================================================================================================================
  250. // This object is not really a cross-fader. It is really just a multichannel
  251. // fader - which just calculates the fade gain but does not actually apply it
  252. // to the audio signal - unless you use cmXfaderExecAudio()
  253. typedef struct
  254. {
  255. cmReal_t gain;
  256. bool gateFl; // true if channel is on
  257. bool onFl; // true if gateFl transitioned to true on this cycle
  258. bool offFl; // true if gateFl transitioned to false on this cycle
  259. } cmXfaderCh;
  260. typedef struct
  261. {
  262. cmObj obj;
  263. unsigned chCnt;
  264. cmXfaderCh* chArray;
  265. unsigned fadeSmpCnt;
  266. cmReal_t srate;
  267. bool gateFl; // true if any channels are on
  268. bool onFl; // true on cycle where gate transitions to 'on'.
  269. bool offFl; // true on cycle where gate transitions to 'off'.
  270. } cmXfader;
  271. cmXfader* cmXfaderAlloc( cmCtx*c, cmXfader* p, cmReal_t srate, unsigned chCnt, cmReal_t fadeTimeMs );
  272. cmRC_t cmXfaderFree( cmXfader** pp );
  273. cmRC_t cmXfaderInit( cmXfader* p, cmReal_t srate, unsigned chCnt, cmReal_t fadeTimeMs );
  274. cmRC_t cmXfaderFinal( cmXfader* p );
  275. cmRC_t cmXfaderExec( cmXfader* p, unsigned procSmpCnt, const bool* gateV, unsigned chCnt );
  276. cmRC_t cmXfaderExecAudio( cmXfader* p, unsigned procSmpCnt, const bool* gateV, unsigned chCnt, const cmSample_t* x[], cmSample_t* y );
  277. void cmXfaderSetXfadeTime( cmXfader* p, cmReal_t fadeTimeMs );
  278. // Set all gates to false except chIdx.
  279. void cmXfaderSelectOne( cmXfader* p, unsigned chIdx );
  280. void cmXfaderAllOff( cmXfader* p );
  281. //=======================================================================================================================
  282. // This fader object accepts a gate signal. When the gate is high it increments
  283. // the gain until it reaches 1.0. When the gate is low it decrements the gain
  284. // until it reaches 0.0. The fade time is the lenght of time the gain will take
  285. // to transition from 0.0 to 1.0 or 1.0 to 0.0.
  286. typedef struct
  287. {
  288. cmObj obj;
  289. unsigned fadeSmpCnt; // time to fade from 0->1 or 1->0
  290. cmReal_t srate;
  291. cmReal_t gain;
  292. } cmFader;
  293. cmFader* cmFaderAlloc( cmCtx*c, cmFader* p, cmReal_t srate, cmReal_t fadeTimeMs );
  294. cmRC_t cmFaderFree( cmFader** pp );
  295. cmRC_t cmFaderInit( cmFader* p, cmReal_t srate, cmReal_t fadeTimeMs );
  296. cmRC_t cmFaderFinal( cmFader* p );
  297. cmRC_t cmFaderExec( cmFader* p, unsigned procSmpCnt, bool gateFl, bool mixFl, const cmSample_t* x, cmSample_t* y );
  298. void cmFaderSetFadeTime( cmFader* p, cmReal_t fadeTimeMs );
  299. //=======================================================================================================================
  300. struct cmIDelay_str;
  301. typedef struct
  302. {
  303. cmObj obj;
  304. cmReal_t srate; // system sample rate
  305. bool feedbackFl; // set if this is a feedback comb filter
  306. cmReal_t minHz; // lowest comb frequency this comb filter can support
  307. cmReal_t hz; // location of first comb
  308. cmReal_t alpha; // filter coeff.
  309. cmReal_t dN; // max length of the the cf delay line
  310. unsigned dn; // current length of cf delay line
  311. cmReal_t* d; // d[dn] filter delay line
  312. cmReal_t* b; // b[dn] feedforward coeff's
  313. cmReal_t* a; // a[dn] feedback coeff's
  314. cmReal_t b0; // feedforward coeff 0
  315. bool bypassFl; // bypass enable flag
  316. struct cmIDelay_str* idp;
  317. } cmCombFilt;
  318. cmCombFilt* cmCombFiltAlloc( cmCtx* c, cmCombFilt* p, cmReal_t srate, bool feedbackFl, cmReal_t minHz, cmReal_t alpha, cmReal_t hz, bool bypassFl );
  319. cmRC_t cmCombFiltFree( cmCombFilt** pp);
  320. cmRC_t cmCombFiltInit( cmCombFilt* p, cmReal_t srate, bool feedbackFl, cmReal_t minHz, cmReal_t alpha, cmReal_t hz, bool bypassFl );
  321. cmRC_t cmCombFiltFinal( cmCombFilt* p );
  322. cmRC_t cmCombFiltExec( cmCombFilt* p, const cmSample_t* x, cmSample_t* y, unsigned n );
  323. void cmCombFiltSetAlpha( cmCombFilt* p, cmReal_t alpha );
  324. cmRC_t cmCombFiltSetHz( cmCombFilt* p, cmReal_t hz );
  325. //=======================================================================================================================
  326. typedef struct
  327. {
  328. cmObj obj;
  329. cmReal_t d[2]; //
  330. cmReal_t b[1]; //
  331. cmReal_t a[1]; // a[dn] feedback coeff's
  332. cmReal_t b0; // feedforward coeff 0
  333. bool bypassFl;
  334. } cmDcFilt;
  335. cmDcFilt* cmDcFiltAlloc( cmCtx* c, cmDcFilt* p, bool bypassFl );
  336. cmRC_t cmDcFiltFree( cmDcFilt** pp);
  337. cmRC_t cmDcFiltInit( cmDcFilt* p, bool bypassFl );
  338. cmRC_t cmDcFiltFinal( cmDcFilt* p );
  339. cmRC_t cmDcFiltExec( cmDcFilt* p, const cmSample_t* x, cmSample_t* y, unsigned n );
  340. //=======================================================================================================================
  341. // interpolating delay - used by the comb filter
  342. typedef struct cmIDelay_str
  343. {
  344. cmObj obj;
  345. cmSample_t* d; // d[dn] delay line
  346. int dn; // sizeo of delay
  347. cmSample_t* m; // memory buffer
  348. int mn; // size of memory bufer (dn+3)
  349. int ii; // input index
  350. unsigned tn; // count of taps
  351. cmReal_t* ti; // ti[tn] tap locations (fractional delay from t->ii)
  352. cmReal_t* tff; // tg[tn] tap out gain
  353. cmReal_t* tfb;// tfb[tn] tap feedback gain
  354. cmReal_t srate;
  355. } cmIDelay;
  356. cmIDelay* cmIDelayAlloc( cmCtx* c, cmIDelay* p, cmReal_t srate, cmReal_t maxDelayMs, const cmReal_t* tapMs, const cmReal_t* tapFfGain, const cmReal_t* tapFbGain, unsigned tapCnt );
  357. cmRC_t cmIDelayFree( cmIDelay** pp );
  358. cmRC_t cmIDelayInit( cmIDelay* p, cmReal_t srate, cmReal_t maxDelayMs, const cmReal_t* tapMs, const cmReal_t* tapFfGain, const cmReal_t* tapFbGain, unsigned tapCnt );
  359. cmRC_t cmIDelayFinal(cmIDelay* p );
  360. cmRC_t cmIDelayExec( cmIDelay* p, const cmSample_t* x, cmSample_t* y, unsigned n );
  361. cmRC_t cmIDelaySetTapMs( cmIDelay* p, unsigned tapIdx, cmReal_t tapMs );
  362. //=======================================================================================================================
  363. // This object sequentially assigns channels to groups when their gates go high.
  364. // 'chsPerGroup' channels will be assigned to each group. No channel will be
  365. // assigned to any group unless there are at least 'chsPerGroup' available
  366. // (unassigned) channels.
  367. // Channels are released from groups when one of the member channels gates goes low.
  368. //
  369. typedef struct
  370. {
  371. cmReal_t rms; // current rms of this input channel
  372. bool gateFl; // current gate state of this input channel
  373. bool readyFl; // this channel is available to be assigned to a group
  374. bool offsetFl; // the gate went low during this cycle (cleared on exec)
  375. unsigned groupIdx; // group this channel is assigned to or cmInvalidIdx if it is not assigned to any group
  376. } cmGroupSelCh;
  377. typedef struct
  378. {
  379. unsigned* chIdxArray; // chIdxArray[p->chCnt] array of indexes to channels assigned to this group
  380. unsigned chIdxCnt; // count indexes in chIdxArray[] or 0 if the channel is not in use
  381. bool releaseFl; // true during the cycle that this group was released on
  382. bool createFl; // true during the cycle that this group was created on
  383. } cmGroupSelGrp;
  384. typedef struct
  385. {
  386. cmObj obj;
  387. cmGroupSelCh* chArray; // chArray[chCnt]
  388. unsigned chCnt; // count of channels
  389. cmGroupSelGrp* groupArray; // groupArray[groupCnt]
  390. unsigned groupCnt; // count of groups - must be <= chCnt - can be changed at any time
  391. unsigned chsPerGroup; // channels per group
  392. bool updateFl; // set during exec if channels were assigned or released
  393. } cmGroupSel;
  394. cmGroupSel* cmGroupSelAlloc( cmCtx* c, cmGroupSel* p, unsigned chCnt, unsigned groupCnt, unsigned chsPerGroup );
  395. cmRC_t cmGroupSelFree( cmGroupSel** pp );
  396. cmRC_t cmGroupSelInit( cmGroupSel* p, unsigned chCnt, unsigned groupCnt, unsigned chsPerGroup );
  397. cmRC_t cmGroupSelFinal( cmGroupSel* p );
  398. cmRC_t cmGroupSetChannelGate( cmGroupSel* p, unsigned chIdx, bool gateFl );
  399. cmRC_t cmGroupSetChannelRMS( cmGroupSel* p, unsigned chIdx, cmReal_t rms );
  400. // After exec if the p->updateFl is set then iterate through
  401. // p->groupArray[]. Groups that have been created will have their 'createFl' set
  402. // and groups that will be removed on the next cycle have their 'releaseFl' set.
  403. cmRC_t cmGroupSelExec( cmGroupSel* p );
  404. //=======================================================================================================================
  405. // Route N of M input channels to N output channels.
  406. // The N channels are selected from the first N gates to go high.
  407. typedef struct cmAudioNofM_In_str
  408. {
  409. bool gateFl;
  410. bool onsetFl;
  411. bool offsetFl;
  412. unsigned outChIdx;
  413. cmFader* fader;
  414. struct cmAudioNofM_In_str* link;
  415. } cmAudioNofM_In;
  416. typedef struct
  417. {
  418. struct cmAudioNofM_In_str* list;
  419. } cmAudioNofM_Out;
  420. typedef struct
  421. {
  422. cmObj obj;
  423. unsigned iChCnt; // (M) input channel count
  424. cmAudioNofM_In* inArray; // chArray[ M ] - input channel array
  425. unsigned oChCnt; // (N) output channel count
  426. cmAudioNofM_Out* outArray; // outArray[N] - output channel array
  427. unsigned nxtOutChIdx; // ch assoc;d with the next onset gate will be assined to this output channel
  428. } cmAudioNofM;
  429. cmAudioNofM* cmAudioNofMAlloc( cmCtx* c, cmAudioNofM* p, cmReal_t srate, unsigned iChCnt, unsigned oChCnt, cmReal_t fadeTimeMs );
  430. cmRC_t cmAudioNofMFree( cmAudioNofM** pp );
  431. cmRC_t cmAudioNofMInit( cmAudioNofM* p, cmReal_t srate, unsigned iChCnt, unsigned oChCnt, cmReal_t fadeTimeMs );
  432. cmRC_t cmAudioNofMFinal( cmAudioNofM* p );
  433. cmRC_t cmAudioNofMSetChannelGate( cmAudioNofM* p, unsigned inChIdx, bool gateFl );
  434. // Sum the audio contained in x[inChCnt][n] into y[outChCnt][n] according
  435. // to the state of the object.
  436. // Notes
  437. // 1) y[n] should be zeroed by the caller as the output is summed into this buffer.
  438. // 2) inChCnt should equal p->iChCnt and outChCnt should equal p->oChCnt
  439. cmRC_t cmAudioNofMExec( cmAudioNofM* p, const cmSample_t* x[], unsigned inChCnt, cmSample_t* y[], unsigned outChCnt, unsigned n );
  440. cmRC_t cmAudioNofMSetFadeMs( cmAudioNofM* p, cmReal_t fadeTimeMs );
  441. //=======================================================================================================================
  442. enum { kDlyAdsrId, kAtkAdsrId, kDcyAdsrId, kSusAdsrId, kRlsAdsrId, kDoneAdsrId };
  443. typedef struct
  444. {
  445. cmObj obj;
  446. cmReal_t srate;
  447. bool trigModeFl; // gate on triggers start, gate-off ignored
  448. cmReal_t levelMin;
  449. cmReal_t scaleDur; //
  450. int dlySmp;
  451. int atkSmp;
  452. cmReal_t atkLevel;
  453. int dcySmp;
  454. int susSmp; // only used in trigger mode
  455. cmReal_t susLevel;
  456. int rlsSmp;
  457. unsigned state; // current state
  458. int durSmp; // time in current state
  459. cmReal_t level; // current level
  460. bool gateFl; // last gate state
  461. cmReal_t atkBegLevel; // attack starting level
  462. cmReal_t atkDurSmp; // attack duration
  463. cmReal_t rlsLevel; // release starting level
  464. cmReal_t rlsDurSmp; // release duration
  465. cmReal_t actAtkLevel;
  466. cmReal_t actSusLevel;
  467. } cmAdsr;
  468. cmAdsr* cmAdsrAlloc( cmCtx* c, cmAdsr* p, cmReal_t srate, bool trigFl, cmReal_t minL, cmReal_t dlyMs, cmReal_t atkMs, cmReal_t atkL, cmReal_t dcyMs, cmReal_t susMs, cmReal_t susL, cmReal_t rlsMs );
  469. cmRC_t cmAdsrFree( cmAdsr** pp );
  470. cmRC_t cmAdsrInit( cmAdsr* p, cmReal_t srate, bool trigFl, cmReal_t minL, cmReal_t dlyMs, cmReal_t atkMs, cmReal_t atkL, cmReal_t dcyMs, cmReal_t susMs, cmReal_t susL, cmReal_t rlsMs );
  471. cmRC_t cmAdsrFinal( cmAdsr* p );
  472. cmReal_t cmAdsrExec( cmAdsr* p, unsigned procSmpCnt, bool gateFl, cmReal_t tscale, cmReal_t ascale );
  473. void cmAdsrSetTime( cmAdsr* p, cmReal_t ms, unsigned id );
  474. void cmAdsrSetLevel( cmAdsr* p, cmReal_t level, unsigned id );
  475. void cmAdsrReport( cmAdsr* p, cmRpt_t* rpt );
  476. //=======================================================================================================================
  477. enum { kAtkCompId, kRlsCompId };
  478. typedef struct
  479. {
  480. cmObj obj;
  481. cmReal_t srate; // system sample rate
  482. unsigned procSmpCnt; // samples per exec cycle
  483. cmReal_t inGain; // input gain
  484. cmReal_t threshDb; // threshold in dB (max:100 min:0)
  485. cmReal_t ratio_num; // numerator of the ratio
  486. unsigned atkSmp; // time to reduce the signal by 10.0 db
  487. unsigned rlsSmp; // time to increase the signal by 10.0 db
  488. cmReal_t outGain; // makeup gain
  489. bool bypassFl; // bypass enable
  490. cmSample_t* rmsWnd; // rmsWnd[rmsWndAllocCnt]
  491. unsigned rmsWndAllocCnt; //
  492. unsigned rmsWndCnt; // current RMS window size (rmsWndCnt must be <= rmsWndAllocCnt)
  493. unsigned rmsWndIdx; // next RMS window input index
  494. unsigned state; // env. state
  495. cmReal_t rmsDb; // current incoming signal RMS (max:100 min:0)
  496. cmReal_t gain; // current compressor gain
  497. cmReal_t timeConstDb; // the atk/rls will incr/decr by 'timeConstDb' per atkMs/rlsMs.
  498. cmReal_t pkDb; //
  499. cmReal_t accumDb; //
  500. } cmCompressor;
  501. cmCompressor* cmCompressorAlloc( cmCtx* c, cmCompressor* p, cmReal_t srate, unsigned procSmpCnt, cmReal_t inGain, cmReal_t rmsWndMaxMs, cmReal_t rmsWndMs, cmReal_t threshDb, cmReal_t ratio, cmReal_t atkMs, cmReal_t rlsMs, cmReal_t outGain, bool bypassFl );
  502. cmRC_t cmCompressorFree( cmCompressor** pp );
  503. cmRC_t cmCompressorInit( cmCompressor* p, cmReal_t srate, unsigned procSmpCnt, cmReal_t inGain, cmReal_t rmsWndMaxMs, cmReal_t rmsWndMs, cmReal_t threshDb, cmReal_t ratio, cmReal_t atkMs, cmReal_t rlsMs, cmReal_t outGain, bool bypassFl );
  504. cmRC_t cmCompressorFinal( cmCompressor* p );
  505. cmRC_t cmCompressorExec( cmCompressor* p, const cmSample_t* x, cmSample_t* y, unsigned n );
  506. void cmCompressorSetAttackMs( cmCompressor* p, cmReal_t ms );
  507. void cmCompressorSetReleaseMs( cmCompressor* p, cmReal_t ms );
  508. void cmCompressorSetThreshDb( cmCompressor* p, cmReal_t thresh );
  509. void cmCompressorSetRmsWndMs( cmCompressor* p, cmReal_t ms );
  510. //=======================================================================================================================
  511. // BiQuad Audio Eq's based on Robert Bristow-Johnson's recipes.
  512. // http://www.musicdsp.org/files/Audio-EQ-Cookbook.txt
  513. // See filter_rbj.m for equivalent octave code.
  514. enum
  515. {
  516. kLpfBqId,
  517. kHpFBqId,
  518. kBpfBqId,
  519. kNotchBqId,
  520. kAllpassBqId,
  521. kPeakBqId,
  522. kLowShelfBqId,
  523. kHighShelfBqId
  524. };
  525. typedef struct
  526. {
  527. cmObj obj;
  528. cmReal_t srate;
  529. unsigned mode;
  530. cmReal_t f0Hz;
  531. cmReal_t Q;
  532. cmReal_t gainDb;
  533. cmReal_t d[4];
  534. cmReal_t b[3];
  535. cmReal_t a[3];
  536. bool bypassFl;
  537. } cmBiQuadEq;
  538. cmBiQuadEq* cmBiQuadEqAlloc( cmCtx* c, cmBiQuadEq* p, cmReal_t srate, unsigned mode, cmReal_t f0Hz, cmReal_t Q, cmReal_t gainDb, bool bypassFl );
  539. cmRC_t cmBiQuadEqFree( cmBiQuadEq** pp );
  540. cmRC_t cmBiQuadEqInit( cmBiQuadEq* p, cmReal_t srate, unsigned mode, cmReal_t f0Hz, cmReal_t Q, cmReal_t gainDb, bool bypassFl );
  541. cmRC_t cmBiQuadEqFinal( cmBiQuadEq* p );
  542. cmRC_t cmBiQuadEqExec( cmBiQuadEq* p, const cmSample_t* x, cmSample_t* y, unsigned n );
  543. void cmBiQuadEqSet( cmBiQuadEq* p, unsigned mode, cmReal_t f0Hz, cmReal_t Q, cmReal_t gainDb );
  544. //=======================================================================================================================
  545. typedef struct
  546. {
  547. cmObj obj;
  548. cmReal_t srate;
  549. cmReal_t downSrate;
  550. cmReal_t bits;
  551. bool rectFl;
  552. bool fullFl;
  553. cmReal_t clipDb;
  554. cmReal_t inGain;
  555. cmReal_t outGain;
  556. bool bypassFl;
  557. double fracIdx;
  558. cmSample_t lastVal;
  559. cmSample_t lastY;
  560. cmSample_t lastX;
  561. } cmDistDs;
  562. cmDistDs* cmDistDsAlloc( cmCtx* c, cmDistDs* p, cmReal_t srate, cmReal_t inGain, cmReal_t downSrate, cmReal_t bits, bool rectFl, bool fullFl, cmReal_t clipDb, cmReal_t outGain, bool bypassFl );
  563. cmRC_t cmDistDsFree( cmDistDs** p );
  564. cmRC_t cmDistDsInit( cmDistDs* p, cmReal_t srate, cmReal_t inGain, cmReal_t downSrate, cmReal_t bits, bool rectFl, bool fullFl, cmReal_t clipDb, cmReal_t outGain, bool bypassFl );
  565. cmRC_t cmDistDsFinal( cmDistDs* p );
  566. cmRC_t cmDistDsExec( cmDistDs* p, const cmSample_t* x, cmSample_t* y, unsigned n );
  567. //=======================================================================================================================
  568. /*
  569. typedef struct
  570. {
  571. cmObj obj;
  572. } cmUnitDelay;
  573. cmUnitDelay* cmUnitDelayAlloc( cmCtx* c, cmUnitDelay* p, cmReal_t srate, unsigned smpCnt, unsigned inCnt, unsigned outCnt, const cmReal_t delayMsV, unsigned delayCnt );
  574. cmRC_t cmUnitDelayFree( cmUnitDelay* p );
  575. cmRC_t cmUnitDelayInit( cmUnitDelay* p, cmReal_t srate, unsigned smpCnt, braunsigned inCnt, unsigned outCnt, const cmReal_t delayMsV, unsigned delayCnt );
  576. cmRC_t cmUnitDelayFinal( cmUnitDelay* p );
  577. cmRC_t cmUnitDelayExec( cmUnitDelay* p, const cmSample_t** x, unsigned inChCnt, cmSample_t** y, unsigned outChCnt, unsigned smpCnt );
  578. */
  579. #ifdef __cplusplus
  580. }
  581. #endif
  582. #endif