include/x3daudio.h

   1 /*
   2  * Copyright (c) 2015 Andrew Eikum for CodeWeavers
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 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  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 #ifndef _X3DAUDIO_H
  20 #define _X3DAUDIO_H
  21
  22 typedef struct X3DAUDIO_VECTOR {
  23     float x, y, z;
  24 } X3DAUDIO_VECTOR;
  25
  26 typedef struct X3DAUDIO_CONE {
  27     float InnerAngle;
  28     float OuterAngle;
  29     float InnerVolume;
  30     float OuterVolume;
  31     float InnerLPF;
  32     float OuterLPF;
  33     float InnerReverb;
  34     float OuterReverb;
  35 } X3DAUDIO_CONE;
  36
  37 typedef struct X3DAUDIO_DISTANCE_CURVE_POINT {
  38     float Distance;
  39     float DSPSetting;
  40 } X3DAUDIO_DISTANCE_CURVE_POINT;
  41
  42 typedef struct X3DAUDIO_DISTANCE_CURVE {
  43     X3DAUDIO_DISTANCE_CURVE_POINT *pPoints;
  44     UINT32 PointCount;
  45 } X3DAUDIO_DISTANCE_CURVE;
  46
  47 typedef struct X3DAUDIO_LISTENER {
  48     X3DAUDIO_VECTOR OrientFront;
  49     X3DAUDIO_VECTOR OrientTop;
  50     X3DAUDIO_VECTOR Position;
  51     X3DAUDIO_VECTOR Velocity;
  52     X3DAUDIO_CONE *pCone;
  53 } X3DAUDIO_LISTENER;
  54
  55 typedef struct X3DAUDIO_EMITTER {
  56     X3DAUDIO_CONE *pCone;
  57     X3DAUDIO_VECTOR OrientFront;
  58     X3DAUDIO_VECTOR OrientTop;
  59     X3DAUDIO_VECTOR Position;
  60     X3DAUDIO_VECTOR Velocity;
  61     float InnerRadius;
  62     float InnerRadiusAngle;
  63     UINT32 ChannelCount;
  64     float ChannelRadius;
  65     float *pChannelAzimuths;
  66     X3DAUDIO_DISTANCE_CURVE *pVolumeCurve;
  67     X3DAUDIO_DISTANCE_CURVE *pLFECurve;
  68     X3DAUDIO_DISTANCE_CURVE *pLPFDirectCurve;
  69     X3DAUDIO_DISTANCE_CURVE *pLPFReverbCurve;
  70     X3DAUDIO_DISTANCE_CURVE *pReverbCurve;
  71     float CurveDistanceScalar;
  72     float DopplerScalar;
  73 } X3DAUDIO_EMITTER;
  74
  75 typedef struct X3DAUDIO_DSP_SETTINGS {
  76     float *pMatrixCoefficients;
  77     float *pDelayTimes;
  78     UINT32 SrcChannelCount;
  79     UINT32 DstChannelCount;
  80     float LPFDirectCoefficient;
  81     float LPFReverbCoefficient;
  82     float ReverbLevel;
  83     float DopplerFactor;
  84     float EmitterToListenerAngle;
  85     float EmitterToListenerDistance;
  86     float EmitterVelocityComponent;
  87     float ListenerVelocityComponent;
  88 } X3DAUDIO_DSP_SETTINGS;
  89
  90 #define X3DAUDIO_CALCULATE_MATRIX           0x00000001
  91 #define X3DAUDIO_CALCULATE_DELAY            0x00000002
  92 #define X3DAUDIO_CALCULATE_LPF_DIRECT       0x00000004
  93 #define X3DAUDIO_CALCULATE_LPF_REVERB       0x00000008
  94 #define X3DAUDIO_CALCULATE_REVERB           0x00000010
  95 #define X3DAUDIO_CALCULATE_DOPPLER          0x00000020
  96 #define X3DAUDIO_CALCULATE_EMITTER_ANGLE    0x00000040
  97 #define X3DAUDIO_CALCULATE_ZEROCENTER       0x00010000
  98 #define X3DAUDIO_CALCULATE_REDIRECT_TO_LFE  0x00020000
  99
 100 #define X3DAUDIO_HANDLE_BYTESIZE 20
 101 typedef BYTE X3DAUDIO_HANDLE[X3DAUDIO_HANDLE_BYTESIZE];
 102
 103 HRESULT CDECL X3DAudioInitialize(UINT32, float, X3DAUDIO_HANDLE);
 104 void CDECL X3DAudioCalculate(const X3DAUDIO_HANDLE, const X3DAUDIO_LISTENER *,
 105         const X3DAUDIO_EMITTER *, UINT32, X3DAUDIO_DSP_SETTINGS *);
 106
 107 #endif