alSource.h

Go to the documentation of this file.

#ifndef _AL_SOURCE_H_
#define _AL_SOURCE_H_

#define MAX_SENDS                 4

#include "alMain.h"
#include "alu.h"
#include "alFilter.h"

#ifdef __cplusplus
extern "C" {
#endif

#define SRC_HISTORY_BITS   (6)
#define SRC_HISTORY_LENGTH (1<<SRC_HISTORY_BITS)
#define SRC_HISTORY_MASK   (SRC_HISTORY_LENGTH-1)

extern enum Resampler DefaultResampler;

extern const ALsizei ResamplerPadding[ResamplerMax];
extern const ALsizei ResamplerPrePadding[ResamplerMax];


typedef struct ALbufferlistitem
{
    struct ALbuffer         *buffer;
    struct ALbufferlistitem *next;
    struct ALbufferlistitem *prev;
} ALbufferlistitem;

typedef struct HrtfState {
    ALboolean Moving;
    ALuint Counter;
    ALIGN(16) ALfloat History[MaxChannels][SRC_HISTORY_LENGTH];
    ALIGN(16) ALfloat Values[MaxChannels][HRIR_LENGTH][2];
    ALuint Offset;
} HrtfState;

typedef struct HrtfParams {
    ALfloat Gain;
    ALfloat Dir[3];
    ALIGN(16) ALfloat Coeffs[MaxChannels][HRIR_LENGTH][2];
    ALIGN(16) ALfloat CoeffStep[HRIR_LENGTH][2];
    ALuint Delay[MaxChannels][2];
    ALint DelayStep[2];
    ALuint IrSize;
} HrtfParams;

typedef struct DirectParams {
    ALfloat (*OutBuffer)[BUFFERSIZE];
    ALfloat *ClickRemoval;
    ALfloat *PendingClicks;

    struct {
        HrtfParams Params;
        HrtfState *State;
    } Hrtf;

    /* A mixing matrix. First subscript is the channel number of the input data
     * (regardless of channel configuration) and the second is the channel
     * target (eg. FrontLeft). Not used with HRTF. */
    ALfloat Gains[MaxChannels][MaxChannels];

    /* A low-pass filter, using 2 chained one-pole filters. */
    FILTER iirFilter;
    ALfloat history[MaxChannels*2];
} DirectParams;

typedef struct SendParams {
    struct ALeffectslot *Slot;

    /* Gain control, which applies to all input channels to a single (mono)
     * output buffer. */
    ALfloat Gain;

    /* A low-pass filter, using 2 chained one-pole filters. */
    FILTER iirFilter;
    ALfloat history[MaxChannels*2];
} SendParams;


typedef struct ALsource
{
    volatile ALfloat   Pitch;
    volatile ALfloat   Gain;
    volatile ALfloat   OuterGain;
    volatile ALfloat   MinGain;
    volatile ALfloat   MaxGain;
    volatile ALfloat   InnerAngle;
    volatile ALfloat   OuterAngle;
    volatile ALfloat   RefDistance;
    volatile ALfloat   MaxDistance;
    volatile ALfloat   RollOffFactor;
    volatile ALfloat   Position[3];
    volatile ALfloat   Velocity[3];
    volatile ALfloat   Orientation[3];
    volatile ALboolean HeadRelative;
    volatile ALboolean Looping;
    volatile enum DistanceModel DistanceModel;
    volatile ALboolean DirectChannels;

    volatile ALboolean DryGainHFAuto;
    volatile ALboolean WetGainAuto;
    volatile ALboolean WetGainHFAuto;
    volatile ALfloat   OuterGainHF;

    volatile ALfloat AirAbsorptionFactor;
    volatile ALfloat RoomRolloffFactor;
    volatile ALfloat DopplerFactor;

    enum Resampler Resampler;

    ALdouble Offset;
    ALenum   OffsetType;

    volatile ALint SourceType;

    volatile ALenum state;
    ALenum new_state;

    ALuint position;
    ALuint position_fraction;

    ALbufferlistitem *queue;
    ALuint BuffersInQueue;
    ALuint BuffersPlayed;

    ALuint NumChannels;
    ALuint SampleSize;

    ALfloat DirectGain;
    ALfloat DirectGainHF;

    struct {
        struct ALeffectslot *Slot;
        ALfloat Gain;
        ALfloat GainHF;
    } Send[MAX_SENDS];

    HrtfState Hrtf;

    struct {
        ResamplerFunc Resample;
        DryMixerFunc DryMix;
        WetMixerFunc WetMix;

        ALint Step;

        DirectParams Direct;

        SendParams Send[MAX_SENDS];
    } Params;
    volatile ALenum NeedsUpdate;

    ALvoid (*Update)(struct ALsource *self, const ALCcontext *context);

    ALuint id;
} ALsource;
#define ALsource_Update(s,a)                 ((s)->Update(s,a))

ALvoid SetSourceState(ALsource *Source, ALCcontext *Context, ALenum state);
ALboolean ApplyOffset(ALsource *Source);

ALvoid ReleaseALSources(ALCcontext *Context);

#ifdef __cplusplus
}
#endif

#endif