al/effects/echo.cpp

   1
   2 #include "config.h"
   3
   4 #include "AL/al.h"
   5 #include "AL/efx.h"
   6
   7 #include "alc/effects/base.h"
   8 #include "effects.h"
   9
  10 #ifdef ALSOFT_EAX
  11 #include "alnumeric.h"
  12 #include "al/eax/effect.h"
  13 #include "al/eax/exception.h"
  14 #include "al/eax/utils.h"
  15 #endif // ALSOFT_EAX
  16
  17
  18 namespace {
  19
  20 static_assert(EchoMaxDelay >= AL_ECHO_MAX_DELAY, "Echo max delay too short");
  21 static_assert(EchoMaxLRDelay >= AL_ECHO_MAX_LRDELAY, "Echo max left-right delay too short");
  22
  23 constexpr EffectProps genDefaultProps() noexcept
  24 {
  25     EchoProps props{};
  26     props.Delay    = AL_ECHO_DEFAULT_DELAY;
  27     props.LRDelay  = AL_ECHO_DEFAULT_LRDELAY;
  28     props.Damping  = AL_ECHO_DEFAULT_DAMPING;
  29     props.Feedback = AL_ECHO_DEFAULT_FEEDBACK;
  30     props.Spread   = AL_ECHO_DEFAULT_SPREAD;
  31     return props;
  32 }
  33
  34 } // namespace
  35
  36 const EffectProps EchoEffectProps{genDefaultProps()};
  37
  38 void EchoEffectHandler::SetParami(EchoProps&, ALenum param, int)
  39 { throw effect_exception{AL_INVALID_ENUM, "Invalid echo integer property 0x%04x", param}; }
  40 void EchoEffectHandler::SetParamiv(EchoProps&, ALenum param, const int*)
  41 { throw effect_exception{AL_INVALID_ENUM, "Invalid echo integer-vector property 0x%04x", param}; }
  42 void EchoEffectHandler::SetParamf(EchoProps &props, ALenum param, float val)
  43 {
  44     switch(param)
  45     {
  46     case AL_ECHO_DELAY:
  47         if(!(val >= AL_ECHO_MIN_DELAY && val <= AL_ECHO_MAX_DELAY))
  48             throw effect_exception{AL_INVALID_VALUE, "Echo delay out of range"};
  49         props.Delay = val;
  50         break;
  51
  52     case AL_ECHO_LRDELAY:
  53         if(!(val >= AL_ECHO_MIN_LRDELAY && val <= AL_ECHO_MAX_LRDELAY))
  54             throw effect_exception{AL_INVALID_VALUE, "Echo LR delay out of range"};
  55         props.LRDelay = val;
  56         break;
  57
  58     case AL_ECHO_DAMPING:
  59         if(!(val >= AL_ECHO_MIN_DAMPING && val <= AL_ECHO_MAX_DAMPING))
  60             throw effect_exception{AL_INVALID_VALUE, "Echo damping out of range"};
  61         props.Damping = val;
  62         break;
  63
  64     case AL_ECHO_FEEDBACK:
  65         if(!(val >= AL_ECHO_MIN_FEEDBACK && val <= AL_ECHO_MAX_FEEDBACK))
  66             throw effect_exception{AL_INVALID_VALUE, "Echo feedback out of range"};
  67         props.Feedback = val;
  68         break;
  69
  70     case AL_ECHO_SPREAD:
  71         if(!(val >= AL_ECHO_MIN_SPREAD && val <= AL_ECHO_MAX_SPREAD))
  72             throw effect_exception{AL_INVALID_VALUE, "Echo spread out of range"};
  73         props.Spread = val;
  74         break;
  75
  76     default:
  77         throw effect_exception{AL_INVALID_ENUM, "Invalid echo float property 0x%04x", param};
  78     }
  79 }
  80 void EchoEffectHandler::SetParamfv(EchoProps &props, ALenum param, const float *vals)
  81 { SetParamf(props, param, *vals); }
  82
  83 void EchoEffectHandler::GetParami(const EchoProps&, ALenum param, int*)
  84 { throw effect_exception{AL_INVALID_ENUM, "Invalid echo integer property 0x%04x", param}; }
  85 void EchoEffectHandler::GetParamiv(const EchoProps&, ALenum param, int*)
  86 { throw effect_exception{AL_INVALID_ENUM, "Invalid echo integer-vector property 0x%04x", param}; }
  87 void EchoEffectHandler::GetParamf(const EchoProps &props, ALenum param, float *val)
  88 {
  89     switch(param)
  90     {
  91     case AL_ECHO_DELAY: *val = props.Delay; break;
  92     case AL_ECHO_LRDELAY: *val = props.LRDelay; break;
  93     case AL_ECHO_DAMPING: *val = props.Damping; break;
  94     case AL_ECHO_FEEDBACK: *val = props.Feedback; break;
  95     case AL_ECHO_SPREAD: *val = props.Spread; break;
  96
  97     default:
  98         throw effect_exception{AL_INVALID_ENUM, "Invalid echo float property 0x%04x", param};
  99     }
 100 }
 101 void EchoEffectHandler::GetParamfv(const EchoProps &props, ALenum param, float *vals)
 102 { GetParamf(props, param, vals); }
 103
 104
 105 #ifdef ALSOFT_EAX
 106 namespace {
 107
 108 using EchoCommitter = EaxCommitter<EaxEchoCommitter>;
 109
 110 struct DelayValidator {
 111     void operator()(float flDelay) const
 112     {
 113         eax_validate_range<EchoCommitter::Exception>(
 114             "Delay",
 115             flDelay,
 116             EAXECHO_MINDELAY,
 117             EAXECHO_MAXDELAY);
 118     }
 119 }; // DelayValidator
 120
 121 struct LrDelayValidator {
 122     void operator()(float flLRDelay) const
 123     {
 124         eax_validate_range<EchoCommitter::Exception>(
 125             "LR Delay",
 126             flLRDelay,
 127             EAXECHO_MINLRDELAY,
 128             EAXECHO_MAXLRDELAY);
 129     }
 130 }; // LrDelayValidator
 131
 132 struct DampingValidator {
 133     void operator()(float flDamping) const
 134     {
 135         eax_validate_range<EchoCommitter::Exception>(
 136             "Damping",
 137             flDamping,
 138             EAXECHO_MINDAMPING,
 139             EAXECHO_MAXDAMPING);
 140     }
 141 }; // DampingValidator
 142
 143 struct FeedbackValidator {
 144     void operator()(float flFeedback) const
 145     {
 146         eax_validate_range<EchoCommitter::Exception>(
 147             "Feedback",
 148             flFeedback,
 149             EAXECHO_MINFEEDBACK,
 150             EAXECHO_MAXFEEDBACK);
 151     }
 152 }; // FeedbackValidator
 153
 154 struct SpreadValidator {
 155     void operator()(float flSpread) const
 156     {
 157         eax_validate_range<EchoCommitter::Exception>(
 158             "Spread",
 159             flSpread,
 160             EAXECHO_MINSPREAD,
 161             EAXECHO_MAXSPREAD);
 162     }
 163 }; // SpreadValidator
 164
 165 struct AllValidator {
 166     void operator()(const EAXECHOPROPERTIES& all) const
 167     {
 168         DelayValidator{}(all.flDelay);
 169         LrDelayValidator{}(all.flLRDelay);
 170         DampingValidator{}(all.flDamping);
 171         FeedbackValidator{}(all.flFeedback);
 172         SpreadValidator{}(all.flSpread);
 173     }
 174 }; // AllValidator
 175
 176 } // namespace
 177
 178 template<>
 179 struct EchoCommitter::Exception : public EaxException {
 180     explicit Exception(const char* message) : EaxException{"EAX_ECHO_EFFECT", message}
 181     { }
 182 };
 183
 184 template<>
 185 [[noreturn]] void EchoCommitter::fail(const char *message)
 186 {
 187     throw Exception{message};
 188 }
 189
 190 bool EaxEchoCommitter::commit(const EAXECHOPROPERTIES &props)
 191 {
 192     if(auto *cur = std::get_if<EAXECHOPROPERTIES>(&mEaxProps); cur && *cur == props)
 193         return false;
 194
 195     mEaxProps = props;
 196     mAlProps = [&]{
 197         EchoProps ret{};
 198         ret.Delay = props.flDelay;
 199         ret.LRDelay = props.flLRDelay;
 200         ret.Damping = props.flDamping;
 201         ret.Feedback = props.flFeedback;
 202         ret.Spread = props.flSpread;
 203         return ret;
 204     }();
 205
 206     return true;
 207 }
 208
 209 void EaxEchoCommitter::SetDefaults(EaxEffectProps &props)
 210 {
 211     static constexpr EAXECHOPROPERTIES defprops{[]
 212     {
 213         EAXECHOPROPERTIES ret{};
 214         ret.flDelay = EAXECHO_DEFAULTDELAY;
 215         ret.flLRDelay = EAXECHO_DEFAULTLRDELAY;
 216         ret.flDamping = EAXECHO_DEFAULTDAMPING;
 217         ret.flFeedback = EAXECHO_DEFAULTFEEDBACK;
 218         ret.flSpread = EAXECHO_DEFAULTSPREAD;
 219         return ret;
 220     }()};
 221     props = defprops;
 222 }
 223
 224 void EaxEchoCommitter::Get(const EaxCall &call, const EAXECHOPROPERTIES &props)
 225 {
 226     switch(call.get_property_id())
 227     {
 228     case EAXECHO_NONE: break;
 229     case EAXECHO_ALLPARAMETERS: call.set_value<Exception>(props); break;
 230     case EAXECHO_DELAY: call.set_value<Exception>(props.flDelay); break;
 231     case EAXECHO_LRDELAY: call.set_value<Exception>(props.flLRDelay); break;
 232     case EAXECHO_DAMPING: call.set_value<Exception>(props.flDamping); break;
 233     case EAXECHO_FEEDBACK: call.set_value<Exception>(props.flFeedback); break;
 234     case EAXECHO_SPREAD: call.set_value<Exception>(props.flSpread); break;
 235     default: fail_unknown_property_id();
 236     }
 237 }
 238
 239 void EaxEchoCommitter::Set(const EaxCall &call, EAXECHOPROPERTIES &props)
 240 {
 241     switch(call.get_property_id())
 242     {
 243     case EAXECHO_NONE: break;
 244     case EAXECHO_ALLPARAMETERS: defer<AllValidator>(call, props); break;
 245     case EAXECHO_DELAY: defer<DelayValidator>(call, props.flDelay); break;
 246     case EAXECHO_LRDELAY: defer<LrDelayValidator>(call, props.flLRDelay); break;
 247     case EAXECHO_DAMPING: defer<DampingValidator>(call, props.flDamping); break;
 248     case EAXECHO_FEEDBACK: defer<FeedbackValidator>(call, props.flFeedback); break;
 249     case EAXECHO_SPREAD: defer<SpreadValidator>(call, props.flSpread); break;
 250     default: fail_unknown_property_id();
 251     }
 252 }
 253
 254 #endif // ALSOFT_EAX