sound.h

Go to the documentation of this file.

/*---------------------------------------------------------------------------------
 
    Sound functions.
 
    Copyright (C) 2012-2023
        Alekmaul
 
    This software is provided 'as-is', without any express or implied
    warranty.  In no event will the authors be held liable for any
    damages arising from the use of this software.
 
    Permission is granted to anyone to use this software for any
    purpose, including commercial applications, and to alter it and
    redistribute it freely, subject to the following restrictions:
 
    1.  The origin of this software must not be misrepresented; you
        must not claim that you wrote the original software. If you use
        this software in a product, an acknowledgment in the product
        documentation would be appreciated but is not required.
    2.  Altered source versions must be plainly marked as such, and
        must not be misrepresented as being the original software.
    3.  This notice may not be removed or altered from any source
        distribution.
 
 
---------------------------------------------------------------------------------*/
 
#ifndef SNES_SOUND_INCLUDE
#define SNES_SOUND_INCLUDE
 
#include <snes/snestypes.h>
#include <snes/interrupt.h>
 
typedef struct
{
    u8 pitch;   
    u8 panning; 
    u8 volume;  
    u8 length1; 
    u8 length2; 
    u8 addr1;   
    u8 addr2;   
    u8 bank;    
} brrsamples;
 
#define REG_APU00 (*(vuint8 *)0x2140)
#define REG_APU01 (*(vuint8 *)0x2141)
#define REG_APU02 (*(vuint8 *)0x2142)
#define REG_APU03 (*(vuint8 *)0x2143)
#define REG_APU0001 (*(vuint16 *)0x2140)
#define REG_APU0203 (*(vuint16 *)0x2142)
 
void spcBoot(void);
 
void spcSetBank(u8 *bank);
 
void spcLoad(u16 musIndex);
 
void spcLoadEffect(u16 sfxIndex);
 
void spcPlay(u8 startPos);
 
void spcStop(void);
 
void spcPauseMusic(void);
 
void spcResumeMusic(void);
 
void spcSetModuleVolume(u8 vol);
 
void spcFadeModuleVolume(u16 vol, u16 fadespeed);
 
void spcFlush(void);
 
void spcProcess(void);
 
void spcEffect(u16 pitch, u16 sfxIndex, u8 volpan);
 
void spcSetSoundTable(u16 sndTableAddr, u8 sndTableBank);
 
void spcSetSoundEntry(u8 vol, u8 panning, u8 pitch, u16 length, u8 *sampleaddr, brrsamples *ptr);
 
void spcSetSoundDataEntry(u8 vol, u8 panning, u8 pitch, u16 length, u8 *sampleaddr, brrsamples *ptr);
 
//---------------------------------------------------------------------------------
void spcSetSoundTableEntry(brrsamples *ptr);
 
void spcAllocateSoundRegion(u8 size);
 
void spcPlaySound(u8 sndIndex);
 
void spcPlaySoundV(u8 sndIndex, u16 volume);
 
#endif // SNES_SOUND_INCLUDE