1
0
mirror of https://github.com/zeldaret/oot.git synced 2024-09-21 12:54:51 +00:00
oot/include/z64audio.h
zelda2774 d68f9893fd
audio_playback, audio_effects OK (#313)
* audio_playback.c

* format.sh

* rename functions

* Audio_SequenceChannelProcessSound

* Audio_SequencePlayerProcessSound

* Audio_GetPortamentoFreqScale

* Audio_GetVibratoPitchChange

* Audio_GetVibratoFreqScale

* Audio_NoteVibratoInit, Audio_NoteVibratoUpdate

* Audio_NotePortamentoInit

* Audio_AdsrInit

* Audio_AdsrUpdate

* Common bitfield formatting

* format.sh

* review

Co-authored-by: zelda2774 <zelda2774@invalid>
2020-08-15 14:06:26 -04:00

517 lines
16 KiB
C

#ifndef _Z64_AUDIO_H_
#define _Z64_AUDIO_H_
/**
* Structs in this repository have primarily been imported from the SM64 Decompilation.
* Many things likely still need shifted around and structs need adjusted.
* Take sizes and locations of structs as very volatile.
* The symbol '!' next to an offset means the member is confirmed.
*/
struct Note;
struct NotePool;
struct SequenceChannel;
struct SequenceChannelLayer;
typedef struct AudioListItem {
// A node in a circularly linked list. Each node is either a head or an item:
// - Items can be either detached (prev = NULL), or attached to a list.
// 'value' points to something of interest.
// - List heads are always attached; if a list is empty, its head points
// to itself. 'count' contains the size of the list.
// If the list holds notes, 'pool' points back to the pool where it lives.
// Otherwise, that member is NULL.
/*!0x00 */ struct AudioListItem* prev;
/*!0x04 */ struct AudioListItem* next;
/*!0x08 */ union {
void* value; // either Note* or SequenceChannelLayer*
s32 count;
} u;
/*!0x0C */ struct NotePool* pool;
} AudioListItem; // size = 0x10
typedef struct NotePool {
/*!0x00 */ AudioListItem disabled;
/*!0x10 */ AudioListItem decaying;
/*!0x20 */ AudioListItem releasing;
/*!0x30 */ AudioListItem active;
} NotePool;
// Pitch sliding by up to one octave in the positive direction. Negative
// direction is "supported" by setting extent to be negative. The code
// exterpolates exponentially in the wrong direction in that case, but that
// doesn't prevent seqplayer from doing it, AFAICT.
typedef struct {
/*!0x00 */ u8 mode; // bit 0x80 denotes something; the rest are an index 0-5
/*!0x02 */ u16 cur;
/*!0x04 */ u16 speed;
/*!0x08 */ f32 extent;
} Portamento; // size = 0xC
typedef struct {
s16 delay;
s16 arg;
} AdsrEnvelope; // size = 0x4
typedef struct {
u32 start;
u32 end;
u32 count;
char unk_0C[0x4];
s16 state[16]; // only exists if count != 0. 8-byte aligned
} AdpcmLoop;
typedef struct {
s32 order;
s32 npredictors;
s16 book[1]; // size 8 * order * npredictors. 8-byte aligned
} AdpcmBook;
typedef struct {
u8 unused;
u8 loaded;
u8* sampleAddr;
AdpcmLoop* loop;
AdpcmBook* book;
u32 sampleSize; // never read. either 0 or 1 mod 9, depending on padding
} AudioBankSample;
typedef struct {
AudioBankSample* sample;
f32 tuning; // frequency scale factor
} AudioBankSound; // size = 0x8
// UNCHANGED
typedef struct {
/* 0x00 */ u8 loaded;
/* 0x01 */ u8 normalRangeLo;
/* 0x02 */ u8 normalRangeHi;
/* 0x03 */ u8 releaseRate;
/* 0x04 */ AdsrEnvelope* envelope;
/* 0x08 */ AudioBankSound lowNotesSound;
/* 0x10 */ AudioBankSound normalNotesSound;
/* 0x18 */ AudioBankSound highNotesSound;
} Instrument; // size >= 0x20
typedef struct {
u8 releaseRate;
u8 pan;
u8 loaded;
AudioBankSound sound;
AdsrEnvelope *envelope;
} Drum; // TODO figure out what is still used.
typedef struct {
u32 unk_0;
u32 unk_4;
} UnkInstrument; // size = 0x8, new struct to OOT
typedef struct {
/* 0x00 */ u8 numInstruments;
/* 0x01 */ u8 numDrums;
/* 0x02 */ char unk_02[0x02];
/* 0x04 */ u16 numUnkInstruments;
/* 0x08 */ Instrument** instruments;
/* 0x0C */ Drum** drums;
/* 0x10 */ UnkInstrument* unkInstruments;
} CtlEntry; // size = 0x14
typedef struct {
u8* pc;
u8* stack[4];
u8 remLoopIters[4];
u8 depth;
} M64ScriptState; // size = 0x1C
typedef struct {
/* 0x000 */ u8 enabled : 1;
/* 0x000 */ u8 finished : 1; // never read
/*!0x000 */ u8 muted : 1;
/* 0x000 */ u8 seqDmaInProgress : 1;
/* 0x000 */ u8 bankDmaInProgress : 1;
/* 0x000 */ u8 recalculateVolume : 1;
/* 0x000 */ u8 pad_0b2 : 1;
/* 0x000 */ u8 unk_0b1 : 1;
/* 0x001 */ u8 state;
/* 0x002 */ u8 noteAllocPolicy;
/* 0x003 */ u8 muteBehavior;
/* 0x004 */ u8 seqId;
/* 0x005 */ u8 defaultBank[1]; // must be an array to get a comparison
// to match; other u8's might also be part of that array
/* 0x006 */ u8 loadingBankId;
/* 0x007 */ s8 seqVariationEu[1];
/* 0x008 */ u16 tempo; // beats per minute in JP, tatums per minute in US/EU
/* 0x00A */ u16 tempoAcc;
/* 0x00C */ s16 transposition;
/* 0x00E */ u16 delay;
/* 0x010 */ char pad_010[0x2];
/* 0x012 */ u16 fadeTimer;
/* 0x014 */ u16 fadeTimerUnkEu;
/* 0x016 */ char pad_016[0x2];
/* 0x018 */ u8* seqData;
/*!0x01C */ f32 fadeVolume;
/*!0x020 */ f32 fadeVelocity;
/* 0x024 */ f32 volume;
/*!0x028 */ f32 muteVolumeScale;
/*!0x02C */ f32 fadeVolumeScale;
/*!0x030 */ f32 appliedFadeVolume;
/* 0x034 */ f32 unk_34;
/*!0x038 */ struct SequenceChannel* channels[16];
/* 0x078 */ M64ScriptState scriptState;
/* 0x094 */ u8* shortNoteVelocityTable;
/* 0x098 */ u8* shortNoteDurationTable;
/*!0x09C */ NotePool notePool;
/* 0x0DC */ OSMesgQueue seqDmaMesgQueue;
/* 0x0F4 */ OSMesg seqDmaMesg;
/* 0x0F8 */ OSIoMesg seqDmaIoMesg;
/* 0x110 */ OSMesgQueue bankDmaMesgQueue;
/* 0x128 */ OSMesg bankDmaMesg;
/* 0x12C */ OSIoMesg bankDmaIoMesg;
/* 0x144 */ u8* bankDmaCurrMemAddr;
/* 0x148 */ u32 bankDmaCurrDevAddr;
/* 0x14C */ s32 bankDmaRemaining;
} SequencePlayer;
typedef struct {
u8 releaseRate;
u8 sustain;
AdsrEnvelope* envelope;
} AdsrSettings; // size = 0x8
typedef struct {
/*!0x00 */ union {
struct A {
/* 0x00 */ u8 unk_0b80 : 1;
/*!0x00 */ u8 hang : 1;
/*!0x00 */ u8 decay : 1;
/*!0x00 */ u8 release : 1;
/*!0x00 */ u8 state : 4;
} s;
/*!0x00 */ u8 asByte;
} action;
/*!0x01 */ u8 envIndex;
/*!0x02 */ s16 delay;
/*!0x04 */ f32 sustain;
/*!0x08 */ f32 velocity;
/*!0x0C */ f32 fadeOutVel;
/*!0x10 */ f32 current;
/*!0x14 */ f32 target;
/* */ char pad18[4];
/*!0x1C */ AdsrEnvelope *envelope;
} AdsrState;
typedef struct {
u8 bit0 : 1;
u8 bit1 : 1;
u8 bit2 : 2;
u8 strongRight : 1;
u8 strongLeft : 1;
u8 stereoHeadsetEffects : 1;
u8 usesHeadsetPanEffects : 1;
} ReverbBitsData;
typedef union {
/* 0x00 */ ReverbBitsData s;
/* 0x00 */ u8 asByte;
} ReverbBits;
typedef struct {
/*!0x00 */ u8 reverb;
/*!0x01 */ u8 unk_1;
/*!0x02 */ u8 pan;
/*!0x03 */ ReverbBits reverbBits;
/*!0x04 */ u8 unk_4;
/*!0x06 */ u16 unk_6;
/*!0x08 */ f32 freqScale;
/*!0x0C */ f32 velocity;
/*!0x10 */ s16* unk_10;
/*!0x14 */ s16 unk_14[8];
} NoteAttributes; // size = 0x24
typedef struct SequenceChannel {
/* 0x00 */ u8 enabled : 1;
/* 0x00 */ u8 finished : 1;
/* 0x00 */ u8 stopScript : 1;
/* 0x00 */ u8 stopSomething2 : 1; // sets SequenceChannelLayer.stopSomething
/* 0x00 */ u8 hasInstrument : 1;
/*!0x00 */ u8 stereoHeadsetEffects : 1;
/* 0x00 */ u8 largeNotes : 1; // notes specify duration and velocity
/* 0x00 */ u8 unused : 1; // never read, set to 0
union {
struct {
/*!0x01 */ u8 freqScale : 1;
/*!0x01 */ u8 volume : 1;
/*!0x01 */ u8 pan : 1;
} s;
/*!0x01 */ u8 asByte;
} changes;
/*!0x02 */ u8 noteAllocPolicy;
/*!0x03 */ u8 muteBehavior;
/*!0x04 */ u8 reverb; // or dry/wet mix
/*!0x05 */ u8 notePriority; // 0-3
/* 0x06 */ u8 someOtherPriority;
/*!0x07 */ u8 bankId;
/*!0x08 */ u8 reverbIndex;
/*!0x09 */ u8 bookOffset;
/*!0x0A */ u8 newPan;
/*!0x0B */ u8 panChannelWeight; // proportion of pan that comes from the channel (0..128)
/* 0x0C */ u8 unk_0C;
/* 0x0D */ u8 padD[2];
/* 0x0F */ u8 unk_0F;
/*!0x10 */ u16 vibratoRateStart;
/*!0x12 */ u16 vibratoExtentStart;
/*!0x14 */ u16 vibratoRateTarget;
/*!0x16 */ u16 vibratoExtentTarget;
/*!0x18 */ u16 vibratoRateChangeDelay;
/*!0x1A */ u16 vibratoExtentChangeDelay;
/*!0x1C */ u16 vibratoDelay;
/* 0x1E */ u16 delay;
/* 0x20 */ u16 unk_20;
/* 0x22 */ u16 pad22;
/*!0x24 */ s16 instOrWave; // either 0 (none), instrument index + 1, or
// 0x80..0x83 for sawtooth/triangle/sine/square waves.
/* 0x26 */ s16 transposition;
/*!0x28 */ f32 volumeScale;
/*!0x2C */ f32 volume;
/*!0x30 */ s32 pan;
/*!0x34 */ f32 appliedVolume;
/* 0x38 */ f32 freqScale;
/* 0x3C */ u8 (*dynTable)[][2];
/* 0x40 */ struct Note* noteUnused; // never read
/* 0x44 */ struct SequenceChannelLayer* layerUnused; // never read
/* 0x48 */ Instrument* instrument;
/*!0x4C */ SequencePlayer* seqPlayer;
/*!0x54 */ struct SequenceChannelLayer* layers[4];
/* 0x64 */ M64ScriptState scriptState;
/* */ AdsrSettings adsr;
/*!0x84 */ NotePool notePool;
/* 0xC4 */ s8 soundScriptIO[8]; // bridge between sound script and audio lib
/* 0xCC */ s16* unk_CC;
/* 0xD0 */ ReverbBits reverbBits;
/* 0xD1 */ char unk_D1[0x3];
} SequenceChannel;
// Maybe SequenceTrack?
typedef struct SequenceChannelLayer {
/* 0x00 */ u8 enabled : 1;
/* 0x00 */ u8 finished : 1;
/* 0x00 */ u8 stopSomething : 1; // ?
/* 0x00 */ u8 continuousNotes : 1; // keep the same note for consecutive notes with the same sound
/* 0x00 */ u8 unusedEu0b8 : 1;
/* 0x00 */ u8 bit2 : 1;
/* 0x00 */ u8 ignoreDrumPan : 1; // (wrong)
/* 0x00 */ u8 notePropertiesNeedInit : 1;
/*!0x01 */ ReverbBits reverbBits;
/* 0x02 */ u8 instOrWave;
/* 0x03 */ u8 status;
/* 0x04 */ u8 noteDuration; // set to 0x80
/* 0x05 */ u8 portamentoTargetNote;
/*!0x06 */ u8 pan; // 0..128
/*!0x07 */ u8 notePan;
/* 0x08 */ u16 portamentoTime;
/* 0x0A */ s16 transposition; // #semitones added to play commands
// (m64 instruction encoding only allows referring to the limited range
// 0..0x3f; this makes 0x40..0x7f accessible as well)
/* 0x0C */ f32 unk0C;
/* 0x10 */ s16 delay; // (wrong)
/* 0x12 */ s16 duration; // (wrong)
/* 0x14 */ f32 unk14;
/* 0x18 */ AdsrSettings adsr;
/*!0x20 */ Portamento portamento;
/*!0x2C */ struct Note* note;
/*!0x30 */ f32 freqScale;
/* 0x34 */ s16 shortNoteDefaultPlayPercentage;
/* 0x36 */ s16 playPercentage; // it's not really a percentage...
/*!0x38 */ f32 velocitySquare;
/* 0x3C */ s16 delayUnused; // set to 'delay', never read
/*!0x40 */ f32 noteVelocity;
/*!0x44 */ f32 noteFreqScale;
/* 0x48 */ Instrument* instrument;
/*!0x4C */ AudioBankSound* sound;
/*!0x50 */ SequenceChannel* seqChannel;
/* 0x54 */ M64ScriptState scriptState;
/* 0x70 */ AudioListItem listItem;
/* 0x80 */ char unk_80[0x10];
} SequenceChannelLayer;
typedef struct {
s16 adpcmdecState[0x10];
s16 finalResampleState[0x10];
s16 mixEnvelopeState[0x28];
s16 panResampleState[0x10];
s16 panSamplesBuffer[0x20];
s16 dummyResampleState[0x10];
} NoteSynthesisBuffers;
typedef struct {
/* 0x00 */ u8 restart;
/* 0x01 */ u8 sampleDmaIndex;
/* 0x02 */ u8 prevHeadsetPanRight;
/* 0x03 */ u8 prevHeadsetPanLeft;
/* 0x04 */ u16 samplePosFrac;
/* 0x08 */ s32 samplePosInt;
/* 0x0C */ NoteSynthesisBuffers* synthesisBuffers;
/* 0x10 */ s16 curVolLeft;
/* 0x12 */ s16 curVolRight;
} NoteSynthesisState;
typedef struct {
/*!0x00 */ struct SequenceChannel* seqChannel; // unless this changed to a layer...?
/*!0x04 */ u32 time;
/*!0x08 */ s16* curve;
/*!0x0C */ f32 extent;
/*!0x10 */ f32 rate;
/*!0x14 */ u8 active;
/*!0x16 */ u16 rateChangeTimer;
/*!0x18 */ u16 extentChangeTimer;
/*!0x1A */ u16 delay;
} VibratoState; // size = 0x1C
typedef struct {
/*!0x00 */ u8 priority;
/*!0x01 */ u8 waveId;
/*!0x02 */ u8 sampleCountIndex;
/* 0x03 */ u8 bankId;
/* 0x04 */ u8 unk_04;
/* 0x05 */ u8 stereoHeadsetEffects;
/* 0x06 */ s16 adsrVolScale;
/*!0x08 */ f32 portamentoFreqScale;
/*!0x0C */ f32 vibratoFreqScale;
/* 0x10 */ SequenceChannelLayer* prevParentLayer;
/*!0x14 */ SequenceChannelLayer* parentLayer;
/*!0x18 */ SequenceChannelLayer* wantedParentLayer;
/*!0x1C */ NoteAttributes attributes;
/*!0x40 */ AdsrState adsr;
// may contain portamento, vibratoState, if those are not part of Note itself
} NotePlaybackState;
typedef struct {
// (This might be a ReverbBits, and asByte might not exist)
union {
struct {
/* 0x00 */ volatile u8 enabled : 1;
/* 0x00 */ u8 needsInit : 1;
/* 0x00 */ u8 finished : 1;
/* 0x00 */ u8 envMixerNeedsInit : 1;
/*!0x00 */ u8 stereoStrongRight : 1;
/*!0x00 */ u8 stereoStrongLeft : 1;
/* 0x00 */ u8 stereoHeadsetEffects : 1;
/* 0x00 */ u8 usesHeadsetPanEffects : 1;
} s;
/* 0x00 */ u8 asByte;
} bitField0;
union {
struct {
/* 0x01 */ u8 reverbIndex : 3;
/*!0x01 */ u8 bookOffset : 2;
/* 0x01 */ u8 bit2 : 1;
/* 0x01 */ u8 isSyntheticWave : 1;
/* 0x01 */ u8 hasTwoAdpcmParts : 1;
} s;
/* 0x01 */ u8 asByte;
} bitField1;
/* 0x02 */ u8 unk_2;
/* 0x03 */ u8 headsetPanRight;
/* 0x04 */ u8 headsetPanLeft;
/* 0x05 */ u8 reverbVol;
/* 0x06 */ u8 unk_06; // sound shifted by 4.
/* 0x07 */ u8 unk_07; // sound shifted by 4.
/*!0x08 */ u16 targetVolLeft;
/*!0x0A */ u16 targetVolRight;
/* 0x0C */ u16 resamplingRateFixedPoint; // stored as signed but loaded as u16
/* 0x0E */ s16 unk_10;
/*!0x10 */ union {
s16* samples;
AudioBankSound* audioBankSound;
} sound;
/* 0x14 */ s16* unk_14;
/* 0x18 */ char pad_18[0x8];
} NoteSubEu; // size = 0x20
typedef struct Note {
/*!0x00 */ AudioListItem listItem;
/* 0x10 */ NoteSynthesisState synthesisState;
/* 0x24 */ char pad_24[0xC];
/*!0x30 */ NotePlaybackState playbackState;
/*!0x90 */ Portamento portamento;
/*!0x9C */ VibratoState vibratoState; // size 0x1C
/* 0xB8 */ char pad_B8[0x4];
/* 0xBC */ u32 unk_BC;
/*!0xC0 */ NoteSubEu noteSubEu;
} Note; // size = 0xE0
typedef struct {
/* 0x00 */ s16 presetUnk4; // audio frames per vsync?
/* 0x02 */ u16 frequency;
/* 0x04 */ u16 aiFrequency; // ?16
/* 0x06 */ s16 samplesPerFrameTarget;
/* 0x08 */ s16 maxAiBufferLength;
/* 0x0A */ s16 minAiBufferLength;
/* 0x0C */ s16 updatesPerFrame;
/* 0x0E */ s16 samplesPerUpdate;
/* 0x10 */ s16 samplesPerUpdateMax;
/* 0x12 */ s16 samplesPerUpdateMin;
/* 0x14 */ f32 resampleRate; // contains 32000.0f / frequency
/* 0x18 */ f32 updatesPerFrameInv; // 1.0f / updatesPerFrame
/* 0x1C */ f32 unkUpdatesPerFrameScaled; // 3.0f / (1280.0f * updatesPerFrame)
} AudioBufferParametersEU;
typedef struct {
u8* start;
u8* cur;
u32 size;
s32 unused; // set to 0, never read
} SoundAllocPool;
typedef struct {
/* 0x0000 */ char unk_0000[0x14];
/* 0x0014 */ NoteSubEu* gNoteSubsEu;
/* 0x0018 */ char unk_0014[0x282C];
/* 0x2844 */ CtlEntry* gCtlEntries;
/* 0x2848 */ char unk_2848[0x4];
/* 0x284C */ AudioBufferParametersEU gAudioBufferParameters;
/* 0x286C */ char unk_286C[0x28];
/* 0x2894 */ s32 gMaxSimultaneousNotes;
/* 0x2898 */ char unk_2898[0xE8];
/* 0x2980 */ s32 gAudioErrorFlags;
/* 0x2984 */ char unk_2984[0x3C];
/* 0x29C0 */ SoundAllocPool gNotesAndBuffersPool;
/* 0x29D0 */ char unk_29D0[0x0B5C];
/* 0x352C */ Note* gNotes;
/* 0x3530 */ char unk_3530[0x2654];
/* 0x5B84 */ s32 gNoteSubEuOffset;
} AudioContext;
typedef struct {
/*!0x00 */ u8 reverb; // volume
/* 0x01 */ u8 unk_1;
/*!0x02 */ u8 pan;
/*!0x03 */ ReverbBits reverbBits;
/*!0x04 */ f32 frequency;
/*!0x08 */ f32 velocity;
/* 0x0C */ char unk_0C[0x4];
/* 0x10 */ s16* unk_10;
/* 0x14 */ u8 unk_14;
/* 0x16 */ u16 unk_16;
} Reverb; // size = 0x1C (May be longer)
#define NO_LAYER ((SequenceChannelLayer*)(-1))
#define NO_CHANNEL ((SequenceChannel*)(-1))
#define ADSR_STATE_DISABLED 0
#define ADSR_STATE_INITIAL 1
#define ADSR_STATE_START_LOOP 2
#define ADSR_STATE_LOOP 3
#define ADSR_STATE_FADE 4
#define ADSR_STATE_HANG 5
#define ADSR_STATE_DECAY 6
#define ADSR_STATE_RELEASE 7
#define ADSR_STATE_SUSTAIN 8
#define ADSR_DISABLE 0
#define ADSR_HANG -1
#define ADSR_GOTO -2
#define ADSR_RESTART -3
#endif