libaf/control.h

   1 #ifndef AF_CONTROL_H
   2 #define AF_CONTROL_H
   3
   4 /*********************************************
   5 // Control info struct.
   6 //
   7 // This struct is the argument in a info call to a filter.
   8 */
   9
  10 // Argument types
  11 #define AF_CONTROL_TYPE_BOOL    (0x0<<0)
  12 #define AF_CONTROL_TYPE_CHAR    (0x1<<0)
  13 #define AF_CONTROL_TYPE_INT     (0x2<<0)
  14 #define AF_CONTROL_TYPE_FLOAT   (0x3<<0)
  15 #define AF_CONTROL_TYPE_STRUCT  (0x4<<0)
  16 #define AF_CONTROL_TYPE_SPECIAL (0x5<<0) // a pointer to a function for example
  17 #define AF_CONTROL_TYPE_MASK    (0x7<<0)
  18 // Argument geometry
  19 #define AF_CONTROL_GEOM_SCALAR  (0x0<<3)
  20 #define AF_CONTROL_GEOM_ARRAY   (0x1<<3)
  21 #define AF_CONTROL_GEOM_MATRIX  (0x2<<3)
  22 #define AF_CONTROL_GEOM_MASK    (0x3<<3)
  23 // Argument properties
  24 #define AF_CONTROL_PROP_READ    (0x0<<5) // The argument can be read
  25 #define AF_CONTROL_PROP_WRITE   (0x1<<5) // The argument can be written
  26 #define AF_CONTROL_PROP_SAVE    (0x2<<5) // Can be saved
  27 #define AF_CONTROL_PROP_RUNTIME (0x4<<5) // Acessable during execution
  28 #define AF_CONTROL_PROP_CHANNEL (0x8<<5) // Argument is set per channel
  29 #define AF_CONTROL_PROP_MASK    (0xF<<5)
  30
  31 typedef struct af_control_info_s{
  32   int    def;   // Control enumrification
  33   char*  name;  // Name of argument
  34   char*  info;  // Description of what it does
  35   int    flags; // Flags as defined above
  36   float  max;   // Max and min value
  37   float  min;   // (only aplicable on float and int)
  38   int    xdim;  // 1st dimension
  39   int    ydim;  // 2nd dimension (=0 for everything except matrix)
  40   size_t sz;    // Size of argument in bytes
  41   int    ch;    // Channel number (for future use)
  42   void*  arg;   // Data (for future use)
  43 }af_control_info_t;
  44
  45
  46 /*********************************************
  47 // Extended control used with arguments that operates on only one
  48 // channel at the time
  49 */
  50 typedef struct af_control_ext_s{
  51   void* arg;    // Argument
  52   int   ch;     // Chanel number
  53 }af_control_ext_t;
  54
  55 /*********************************************
  56 // Control parameters
  57 */
  58
  59 /* The control system is divided into 3 levels
  60    mandatory calls       - all filters must answer to all of these
  61    optional calls        - are optional
  62    filter specific calls - applies only to some filters
  63 */
  64
  65 #define AF_CONTROL_MANDATORY            0x10000000
  66 #define AF_CONTROL_OPTIONAL             0x20000000
  67 #define AF_CONTROL_FILTER_SPECIFIC      0x40000000
  68
  69 // MANDATORY CALLS
  70
  71 /* Reinitialize filter. The optional argument contains the new
  72    configuration in form of a af_data_t struct. If the filter does not
  73    support the new format the struct should be changed and AF_FALSE
  74    should be returned. If the incoming and outgoing data streams are
  75    identical the filter can return AF_DETACH. This will remove the
  76    filter. */
  77 #define AF_CONTROL_REINIT               0x00000100 | AF_CONTROL_MANDATORY
  78
  79 // OPTIONAL CALLS
  80
  81 /* Called just after creation with the af_cfg for the stream in which
  82    the filter resides as input parameter this call can be used by the
  83    filter to initialize itself */
  84 #define AF_CONTROL_POST_CREATE          0x00000100 | AF_CONTROL_OPTIONAL
  85
  86 // Called just before destruction of a filter
  87 #define AF_CONTROL_PRE_DESTROY          0x00000200 | AF_CONTROL_OPTIONAL
  88
  89 /* Commandline parameters. If there were any commandline parameters
  90    for this specific filter, they will be given as a char* in the
  91    argument */
  92 #define AF_CONTROL_COMMAND_LINE         0x00000300 | AF_CONTROL_OPTIONAL
  93
  94
  95 // FILTER SPECIFIC CALLS
  96
  97 // Basic operations: These can be ored with any of the below calls
  98 // Set argument
  99 #define AF_CONTROL_SET                  0x00000000
 100 // Get argument
 101 #define AF_CONTROL_GET                  0x00000001
 102 // Get info about the control, i.e fill in everything except argument
 103 #define AF_CONTROL_INFO                 0x00000002
 104
 105 // Resample
 106
 107 // Set output rate in resample
 108 #define AF_CONTROL_RESAMPLE_RATE        0x00000100 | AF_CONTROL_FILTER_SPECIFIC
 109
 110 // Enable sloppy resampling
 111 #define AF_CONTROL_RESAMPLE_SLOPPY      0x00000200 | AF_CONTROL_FILTER_SPECIFIC
 112
 113 // Set resampling accuracy
 114 #define AF_CONTROL_RESAMPLE_ACCURACY    0x00000300 | AF_CONTROL_FILTER_SPECIFIC
 115
 116 // Format
 117
 118 #define AF_CONTROL_FORMAT_FMT           0x00000400 | AF_CONTROL_FILTER_SPECIFIC
 119
 120 // Channels
 121
 122 // Set number of output channels in channels
 123 #define AF_CONTROL_CHANNELS             0x00000600 | AF_CONTROL_FILTER_SPECIFIC
 124
 125 // Set number of channel routes
 126 #define AF_CONTROL_CHANNELS_ROUTES      0x00000700 | AF_CONTROL_FILTER_SPECIFIC
 127
 128 // Set channel routing pair, arg is int[2] and ch is used
 129 #define AF_CONTROL_CHANNELS_ROUTING     0x00000800 | AF_CONTROL_FILTER_SPECIFIC
 130
 131 // Set nuber of channel routing pairs, arg is int*
 132 #define AF_CONTROL_CHANNELS_NR          0x00000900 | AF_CONTROL_FILTER_SPECIFIC
 133
 134 // Set make af_channels into a router
 135 #define AF_CONTROL_CHANNELS_ROUTER      0x00000A00 | AF_CONTROL_FILTER_SPECIFIC
 136
 137 // Volume
 138
 139 // Turn volume control on and off, arg is int*
 140 #define AF_CONTROL_VOLUME_ON_OFF        0x00000B00 | AF_CONTROL_FILTER_SPECIFIC
 141
 142 // Turn soft clipping of the volume on and off, arg is binary
 143 #define AF_CONTROL_VOLUME_SOFTCLIP      0x00000C00 | AF_CONTROL_FILTER_SPECIFIC
 144
 145 // Set volume level, arg is a float* with the volume for all the channels
 146 #define AF_CONTROL_VOLUME_LEVEL         0x00000D00 | AF_CONTROL_FILTER_SPECIFIC
 147
 148 // Probed power level for all channels, arg is a float*
 149 #define AF_CONTROL_VOLUME_PROBE         0x00000E00 | AF_CONTROL_FILTER_SPECIFIC
 150
 151 // Maximum probed power level for all channels, arg is a float*
 152 #define AF_CONTROL_VOLUME_PROBE_MAX     0x00000F00 | AF_CONTROL_FILTER_SPECIFIC
 153
 154 // Compressor/expander
 155
 156 // Turn compressor/expander on and off
 157 #define AF_CONTROL_COMP_ON_OFF          0x00001000 | AF_CONTROL_FILTER_SPECIFIC
 158
 159 // Compression/expansion threshold [dB]
 160 #define AF_CONTROL_COMP_THRESH          0x00001100 | AF_CONTROL_FILTER_SPECIFIC
 161
 162 // Compression/expansion attack time [ms]
 163 #define AF_CONTROL_COMP_ATTACK          0x00001200 | AF_CONTROL_FILTER_SPECIFIC
 164
 165 // Compression/expansion release time [ms]
 166 #define AF_CONTROL_COMP_RELEASE         0x00001300 | AF_CONTROL_FILTER_SPECIFIC
 167
 168 // Compression/expansion gain level [dB]
 169 #define AF_CONTROL_COMP_RATIO           0x00001400 | AF_CONTROL_FILTER_SPECIFIC
 170
 171 // Noise gate
 172
 173 // Turn noise gate on an off
 174 #define AF_CONTROL_GATE_ON_OFF          0x00001500 | AF_CONTROL_FILTER_SPECIFIC
 175
 176 // Noise gate threshold [dB]
 177 #define AF_CONTROL_GATE_THRESH          0x00001600 | AF_CONTROL_FILTER_SPECIFIC
 178
 179 // Noise gate attack time [ms]
 180 #define AF_CONTROL_GATE_ATTACK          0x00001700 | AF_CONTROL_FILTER_SPECIFIC
 181
 182 // Noise gate release time [ms]
 183 #define AF_CONTROL_GATE_RELEASE         0x00001800 | AF_CONTROL_FILTER_SPECIFIC
 184
 185 // Noise gate release range level [dB]
 186 #define AF_CONTROL_GATE_RANGE           0x00001900 | AF_CONTROL_FILTER_SPECIFIC
 187
 188 // Pan
 189
 190 // Pan levels, arg is a control_ext with a float*
 191 #define AF_CONTROL_PAN_LEVEL            0x00001A00 | AF_CONTROL_FILTER_SPECIFIC
 192
 193 // Number of outputs from pan, arg is int*
 194 #define AF_CONTROL_PAN_NOUT             0x00001B00 | AF_CONTROL_FILTER_SPECIFIC
 195
 196 // Balance, arg is float*; range -1 (left) to 1 (right), 0 center
 197 #define AF_CONTROL_PAN_BALANCE          0x00002500 | AF_CONTROL_FILTER_SPECIFIC
 198
 199 // Set equalizer gain, arg is a control_ext with a float*
 200 #define AF_CONTROL_EQUALIZER_GAIN       0x00001C00 | AF_CONTROL_FILTER_SPECIFIC
 201
 202
 203 // Delay length in ms, arg is a control_ext with a float*
 204 #define AF_CONTROL_DELAY_LEN            0x00001D00 | AF_CONTROL_FILTER_SPECIFIC
 205
 206
 207 // Subwoofer
 208
 209 // Channel number which to insert the filtered data, arg in int*
 210 #define AF_CONTROL_SUB_CH               0x00001E00 | AF_CONTROL_FILTER_SPECIFIC
 211
 212 // Cutoff frequency [Hz] for lowpass filter, arg is float*
 213 #define AF_CONTROL_SUB_FC               0x00001F00 | AF_CONTROL_FILTER_SPECIFIC
 214
 215
 216 // Export
 217 #define AF_CONTROL_EXPORT_SZ            0x00002000 | AF_CONTROL_FILTER_SPECIFIC
 218
 219
 220 // ExtraStereo Multiplier
 221 #define AF_CONTROL_ES_MUL               0x00002100 | AF_CONTROL_FILTER_SPECIFIC
 222
 223
 224 // Center
 225
 226 // Channel number which to inster the filtered data, arg in int*
 227 #define AF_CONTROL_CENTER_CH            0x00002200 | AF_CONTROL_FILTER_SPECIFIC
 228
 229
 230 // SineSuppress
 231 #define AF_CONTROL_SS_FREQ              0x00002300 | AF_CONTROL_FILTER_SPECIFIC
 232 #define AF_CONTROL_SS_DECAY             0x00002400 | AF_CONTROL_FILTER_SPECIFIC
 233
 234 #define AF_CONTROL_PLAYBACK_SPEED       0x00002500 | AF_CONTROL_FILTER_SPECIFIC
 235 #define AF_CONTROL_SCALETEMPO_AMOUNT    0x00002600 | AF_CONTROL_FILTER_SPECIFIC
 236
 237 #endif /* AF_CONTROL_H */