pspsascore.h

Go to the documentation of this file.

/*
 * PSP Software Development Kit - https://github.com/pspdev
 * -----------------------------------------------------------------------
 * Licensed under the BSD license, see LICENSE in PSPSDK root for details.
 *
 * pspsascore.h - Prototypes for the sceSasCore library.
 *
 * Copyright (c) 2026 IsaacTCB
 *
 */
 
#ifndef __SCELIBSAS_H__
#define __SCELIBSAS_H__
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <psptypes.h>
 
#define PSP_SAS_GET_VOICE_BIT(voice) (1u << (voice % 32))
 
#define PSP_SAS_GET_FLAG_AT(flags, voice) (((flags) & (PSP_SAS_GET_VOICE_BIT(voice))) != 0)
 
#define PSP_SAS_GRAIN_SIZE (256)
 
#define PSP_SAS_GRAIN_SIZE_MIN (64)
 
#define PSP_SAS_GRAIN_SIZE_MAX (2048)
 
#define PSP_SAS_VOICES_MAX (32)
 
#define PSP_SAS_SAMPLE_RATE (44100)
 
#define PSP_SAS_VOLUME_MAX (0x1000)
 
#define PSP_SAS_PITCH_BASE (0x1000)
 
#define PSP_SAS_PITCH_MIN (0x1)
 
#define PSP_SAS_PITCH_MAX (0x4000)
 
#define PSP_SAS_NOISE_FREQ_MAX (0x3F)
 
#define PSP_SAS_ENVELOPE_HEIGHT_MAX (0x40000000)
 
#define PSP_SAS_ENVELOPE_FREQ_MAX (0x7FFFFFFF)
 
typedef enum {
    PSP_SAS_OUTPUTMODE_STEREO = 0,
    PSP_SAS_OUTPUTMODE_MULTICHANNEL = 1,
} PspSasOutputModes;
 
typedef enum {
    PSP_SAS_EFFECT_TYPE_OFF    = -1,
    PSP_SAS_EFFECT_TYPE_ROOM   = 0,
    PSP_SAS_EFFECT_TYPE_SMALL  = 1,
    PSP_SAS_EFFECT_TYPE_MEDIUM = 2,
    PSP_SAS_EFFECT_TYPE_LARGE  = 3,
    PSP_SAS_EFFECT_TYPE_HALL   = 4,
    PSP_SAS_EFFECT_TYPE_SPACE  = 5,
    PSP_SAS_EFFECT_TYPE_ECHO   = 6,
    PSP_SAS_EFFECT_TYPE_DELAY  = 7,
    PSP_SAS_EFFECT_TYPE_PIPE   = 8,
} PspSasEffectTypes;
 
typedef enum {
    PSP_SAS_ADSR_CURVE_MODE_LINEAR_INCREASE = 0,
    PSP_SAS_ADSR_CURVE_MODE_LINEAR_DECREASE = 1,
    PSP_SAS_ADSR_CURVE_MODE_LINEAR_BENT     = 2,
    PSP_SAS_ADSR_CURVE_MODE_EXPONENT_REV    = 3,
    PSP_SAS_ADSR_CURVE_MODE_EXPONENT        = 4,
    PSP_SAS_ADSR_CURVE_MODE_DIRECT          = 5,
} PspSasADSRCurveModes;
 
enum PspSasErrorCodes {
    PSP_SAS_ERROR_ADDRESS        = 0x80420005,
    PSP_SAS_ERROR_VOICE_INDEX    = 0x80420010,
    PSP_SAS_ERROR_NOISE_CLOCK    = 0x80420011,
    PSP_SAS_ERROR_PITCH_VAL      = 0x80420012,
    PSP_SAS_ERROR_ADSR_MODE      = 0x80420013,
    PSP_SAS_ERROR_ADPCM_SIZE     = 0x80420014,
    PSP_SAS_ERROR_LOOP_MODE      = 0x80420015,
    PSP_SAS_ERROR_INVALID_STATE  = 0x80420016,
    PSP_SAS_ERROR_VOLUME_VAL     = 0x80420018,
    PSP_SAS_ERROR_ADSR_VAL       = 0x80420019,
    PSP_SAS_ERROR_FX_TYPE        = 0x80420020,
    PSP_SAS_ERROR_FX_FEEDBACK    = 0x80420021,
    PSP_SAS_ERROR_FX_DELAY       = 0x80420022,
    PSP_SAS_ERROR_FX_VOLUME_VAL  = 0x80420023,
    PSP_SAS_ERROR_BUSY           = 0x80420030,
    PSP_SAS_ERROR_NOTINIT        = 0x80420100,
    PSP_SAS_ERROR_ALRDYINIT      = 0x80420101,
};
 
enum PspSasADSRFlags {
    PSP_SAS_ADSR_ATTACK  = 1,
    PSP_SAS_ADSR_DECAY   = 2,
    PSP_SAS_ADSR_SUSTAIN = 4,
    PSP_SAS_ADSR_RELEASE = 8,
};
 
#define PSP_SAS_ADSR_EVERYTHING (PSP_SAS_ADSR_ATTACK | PSP_SAS_ADSR_DECAY | PSP_SAS_ADSR_SUSTAIN | PSP_SAS_ADSR_RELEASE)
 
typedef struct {
    u8 pad[3616];
} SceSasCore;
 
int __sceSasInit(SceSasCore* core, int grainsize, int maxvoices, PspSasOutputModes outputmode, int samplerate);
 
int __sceSasGetOutputmode(SceSasCore* core);
 
int __sceSasSetOutputmode(SceSasCore* core, PspSasOutputModes outputmode);
 
int __sceSasRevType(SceSasCore* core, PspSasEffectTypes type);
 
int __sceSasRevEVOL(SceSasCore* core, int leftvol, int rightvol);
 
int __sceSasRevVON(SceSasCore* core, int dry, int wet);
 
int __sceSasRevParam(SceSasCore* core, int delay, int feedback);
 
int __sceSasGetGrain(SceSasCore* core);
 
int __sceSasSetGrain(SceSasCore* core, int grainsize);
 
u32 __sceSasGetEndFlag(SceSasCore* core);
 
int __sceSasSetVoice(SceSasCore* core, int voice, void* vag, int size, int loop);
 
int __sceSasSetVoicePCM(SceSasCore* core, int voice, void* pcm, int samplecount, int loopstart);
 
int __sceSasSetKeyOn(SceSasCore* core, int voice);
 
int __sceSasSetKeyOff(SceSasCore* core, int voice);
 
int __sceSasSetPitch(SceSasCore* core, int voice, int pitch);
 
int __sceSasSetADSRmode(SceSasCore* core, int voice, u32 mask, PspSasADSRCurveModes attackcurve, PspSasADSRCurveModes decaycurve, PspSasADSRCurveModes sustaincurve, PspSasADSRCurveModes releasecurve);
 
int __sceSasSetADSR(SceSasCore* core, int voice, u32 mask, int attackrate, int decayrate, int sustainrate, int releaserate);
 
int __sceSasSetSimpleADSR(SceSasCore* core, int voice, u32 envelope1, u32 envelope2);
 
int __sceSasSetSL(SceSasCore* core, int voice, int level);
 
int __sceSasSetVolume(SceSasCore* core, int voice, int leftvol, int rightvol, int sendleftvol, int sendrightvol);
 
int __sceSasCore(SceSasCore* core, void* dst);
 
int __sceSasCoreWithMix(SceSasCore* core, void* dst, int leftvol, int rightvol);
 
int __sceSasGetPauseFlag(SceSasCore* core);
 
int __sceSasGetEnvelopeHeight(SceSasCore* core, int voice);
 
int __sceSasGetAllEnvelopeHeights(SceSasCore* core, int heights[32]);
 
int __sceSasSetPause(SceSasCore* core, u32 voicebit, int pause);
 
int __sceSasSetNoise(SceSasCore* core, int voice, int freq);
 
int __sceSasSetTrianglarWave(SceSasCore* core, int voice, int unk);
 
int __sceSasSetTriangularWave(SceSasCore* core, int voice, int unk);
 
int __sceSasSetSteepWave(SceSasCore* core, int voice, int duty);
 
/* TODO: Expose Atrac3 context struct */
int __sceSasSetVoiceATRAC3(SceSasCore* core, int voice, void* atrac3ctx);
int __sceSasConcatenateATRAC3(SceSasCore* core, int voice, void* data, int size);
int __sceSasUnsetATRAC3(SceSasCore* core, int voice);
 
#ifdef __cplusplus
}
#endif
 
#endif /* __SCELIBSAS_H__ */