Alc/effects/dedicated.c

   1 /**
   2  * OpenAL cross platform audio library
   3  * Copyright (C) 2011 by Chris Robinson.
   4  * This library is free software; you can redistribute it and/or
   5  *  modify it under the terms of the GNU Library General Public
   6  *  License as published by the Free Software Foundation; either
   7  *  version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  *  Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  *  License along with this library; if not, write to the
  16  *  Free Software Foundation, Inc.,
  17  *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18  * Or go to http://www.gnu.org/copyleft/lgpl.html
  19  */
  20
  21 #include "config.h"
  22
  23 #include <stdlib.h>
  24
  25 #include "alMain.h"
  26 #include "alFilter.h"
  27 #include "alAuxEffectSlot.h"
  28 #include "alError.h"
  29 #include "alu.h"
  30
  31
  32 typedef struct ALdedicatedState {
  33     DERIVE_FROM_TYPE(ALeffectState);
  34
  35     ALfloat gains[MAX_OUTPUT_CHANNELS];
  36 } ALdedicatedState;
  37
  38
  39 static ALvoid ALdedicatedState_Destruct(ALdedicatedState *state)
  40 {
  41     ALeffectState_Destruct(STATIC_CAST(ALeffectState,state));
  42 }
  43
  44 static ALboolean ALdedicatedState_deviceUpdate(ALdedicatedState *UNUSED(state), ALCdevice *UNUSED(device))
  45 {
  46     return AL_TRUE;
  47 }
  48
  49 static ALvoid ALdedicatedState_update(ALdedicatedState *state, const ALCdevice *device, const ALeffectslot *Slot, const ALeffectProps *props)
  50 {
  51     ALfloat Gain;
  52     ALuint i;
  53
  54     for(i = 0;i < MAX_OUTPUT_CHANNELS;i++)
  55         state->gains[i] = 0.0f;
  56
  57     Gain = Slot->Params.Gain * props->Dedicated.Gain;
  58     if(Slot->Params.EffectType == AL_EFFECT_DEDICATED_LOW_FREQUENCY_EFFECT)
  59     {
  60         int idx;
  61         if((idx=GetChannelIdxByName(device->RealOut, LFE)) != -1)
  62         {
  63             STATIC_CAST(ALeffectState,state)->OutBuffer = device->RealOut.Buffer;
  64             STATIC_CAST(ALeffectState,state)->OutChannels = device->RealOut.NumChannels;
  65             state->gains[idx] = Gain;
  66         }
  67     }
  68     else if(Slot->Params.EffectType == AL_EFFECT_DEDICATED_DIALOGUE)
  69     {
  70         int idx;
  71         /* Dialog goes to the front-center speaker if it exists, otherwise it
  72          * plays from the front-center location. */
  73         if((idx=GetChannelIdxByName(device->RealOut, FrontCenter)) != -1)
  74         {
  75             STATIC_CAST(ALeffectState,state)->OutBuffer = device->RealOut.Buffer;
  76             STATIC_CAST(ALeffectState,state)->OutChannels = device->RealOut.NumChannels;
  77             state->gains[idx] = Gain;
  78         }
  79         else
  80         {
  81             ALfloat coeffs[MAX_AMBI_COEFFS];
  82             CalcXYZCoeffs(0.0f, 0.0f, -1.0f, 0.0f, coeffs);
  83
  84             STATIC_CAST(ALeffectState,state)->OutBuffer = device->Dry.Buffer;
  85             STATIC_CAST(ALeffectState,state)->OutChannels = device->Dry.NumChannels;
  86             ComputePanningGains(device->Dry, coeffs, Gain, state->gains);
  87         }
  88     }
  89 }
  90
  91 static ALvoid ALdedicatedState_process(ALdedicatedState *state, ALuint SamplesToDo, const ALfloat (*restrict SamplesIn)[BUFFERSIZE], ALfloat (*restrict SamplesOut)[BUFFERSIZE], ALuint NumChannels)
  92 {
  93     const ALfloat *gains = state->gains;
  94     ALuint i, c;
  95
  96     for(c = 0;c < NumChannels;c++)
  97     {
  98         if(!(fabsf(gains[c]) > GAIN_SILENCE_THRESHOLD))
  99             continue;
 100
 101         for(i = 0;i < SamplesToDo;i++)
 102             SamplesOut[c][i] += SamplesIn[0][i] * gains[c];
 103     }
 104 }
 105
 106 DECLARE_DEFAULT_ALLOCATORS(ALdedicatedState)
 107
 108 DEFINE_ALEFFECTSTATE_VTABLE(ALdedicatedState);
 109
 110
 111 typedef struct ALdedicatedStateFactory {
 112     DERIVE_FROM_TYPE(ALeffectStateFactory);
 113 } ALdedicatedStateFactory;
 114
 115 ALeffectState *ALdedicatedStateFactory_create(ALdedicatedStateFactory *UNUSED(factory))
 116 {
 117     ALdedicatedState *state;
 118     ALsizei s;
 119
 120     state = ALdedicatedState_New(sizeof(*state));
 121     if(!state) return NULL;
 122     SET_VTABLE2(ALdedicatedState, ALeffectState, state);
 123
 124     for(s = 0;s < MAX_OUTPUT_CHANNELS;s++)
 125         state->gains[s] = 0.0f;
 126
 127     return STATIC_CAST(ALeffectState, state);
 128 }
 129
 130 DEFINE_ALEFFECTSTATEFACTORY_VTABLE(ALdedicatedStateFactory);
 131
 132
 133 ALeffectStateFactory *ALdedicatedStateFactory_getFactory(void)
 134 {
 135     static ALdedicatedStateFactory DedicatedFactory = { { GET_VTABLE2(ALdedicatedStateFactory, ALeffectStateFactory) } };
 136
 137     return STATIC_CAST(ALeffectStateFactory, &DedicatedFactory);
 138 }
 139
 140
 141 void ALdedicated_setParami(ALeffect *UNUSED(effect), ALCcontext *context, ALenum UNUSED(param), ALint UNUSED(val))
 142 { SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM); }
 143 void ALdedicated_setParamiv(ALeffect *effect, ALCcontext *context, ALenum param, const ALint *vals)
 144 {
 145     ALdedicated_setParami(effect, context, param, vals[0]);
 146 }
 147 void ALdedicated_setParamf(ALeffect *effect, ALCcontext *context, ALenum param, ALfloat val)
 148 {
 149     ALeffectProps *props = &effect->Props;
 150     switch(param)
 151     {
 152         case AL_DEDICATED_GAIN:
 153             if(!(val >= 0.0f && isfinite(val)))
 154                 SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE);
 155             props->Dedicated.Gain = val;
 156             break;
 157
 158         default:
 159             SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM);
 160     }
 161 }
 162 void ALdedicated_setParamfv(ALeffect *effect, ALCcontext *context, ALenum param, const ALfloat *vals)
 163 {
 164     ALdedicated_setParamf(effect, context, param, vals[0]);
 165 }
 166
 167 void ALdedicated_getParami(const ALeffect *UNUSED(effect), ALCcontext *context, ALenum UNUSED(param), ALint *UNUSED(val))
 168 { SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM); }
 169 void ALdedicated_getParamiv(const ALeffect *effect, ALCcontext *context, ALenum param, ALint *vals)
 170 {
 171     ALdedicated_getParami(effect, context, param, vals);
 172 }
 173 void ALdedicated_getParamf(const ALeffect *effect, ALCcontext *context, ALenum param, ALfloat *val)
 174 {
 175     const ALeffectProps *props = &effect->Props;
 176     switch(param)
 177     {
 178         case AL_DEDICATED_GAIN:
 179             *val = props->Dedicated.Gain;
 180             break;
 181
 182         default:
 183             SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM);
 184     }
 185 }
 186 void ALdedicated_getParamfv(const ALeffect *effect, ALCcontext *context, ALenum param, ALfloat *vals)
 187 {
 188     ALdedicated_getParamf(effect, context, param, vals);
 189 }
 190
 191 DEFINE_ALEFFECT_VTABLE(ALdedicated);