1 /* SPDX-License-Identifier: BSD-3-Clause 2 * 3 * Copyright(c) 2021 Waves Audio Ltd. All rights reserved. 4 */ 5 /******************************************************************************* 6 * @page CoreConcepts_MaxxEffect MaxxEffect 7 * 8 * @ref MaxxEffect_t or simply **effect** - is a Waves algorithms handler, that 9 * contains: 10 * @ref MaxxEffect_InternalData_Parameters, 11 * @ref MaxxEffect_InternalData_Coefficients, 12 * @ref MaxxEffect_InternalData_States, 13 * @ref MaxxEffect_InternalData_Meters, etc. required during 14 * effect life-cycle. It is caller responsibility to allocate enough memory 15 * for storing effect handler, and to properly initialize it. Refer to the 16 * @ref Initialization page for handler allocation and initialization. 17 * 18 * @section MaxxEffect_InternalData Data structures 19 * @subsection MaxxEffect_InternalData_Parameters Parameters 20 * Data segment with algorithms parameters representing some 21 * configuration available for tuning, e.g. Master Bypass, Mute, Parametric 22 * EQ band frequency, gain etc. *Parameters preset* is an array of parameter 23 * ID and float-point value (id, value) pairs. Might not be included in 24 * MaxxEffect handler. **Updated in the control path.** 25 * 26 * @subsection MaxxEffect_InternalData_Coefficients Coefficients 27 * Data segment with algorithms coefficients such as filters 28 * difference equations. Computed from parameters and used for processing. 29 * Single coefficient is represented by its ID and the corresponding buffer. 30 * *Coefficients preset* is an array of such pairs. 31 * **Updated in the control path.** 32 * 33 * @subsection MaxxEffect_InternalData_States States 34 * Data segment with algorithms states. 35 * **Updated in the data path.** 36 * 37 * @subsection MaxxEffect_InternalData_Meters Meters 38 * Data segment with algorithms meters representing measure of some value 39 * over a period of time, e.g. level, gain reduction, peak, etc. 40 * **Updated in the data path.** 41 ******************************************************************************/ 42 #ifndef MAXX_EFFECT_H 43 #define MAXX_EFFECT_H 44 45 /** 46 * Waves effect handler. 47 * 48 * @see @ref CoreConcepts_MaxxEffect 49 */ 50 typedef void MaxxEffect_t; 51 52 53 #endif 54