spAudio.h

[詳解]

 
#ifndef __SPAUDIO_H
#define __SPAUDIO_H
 
#if defined(_MSC_VER)
#pragma comment ( lib, "winmm" )
#endif
 
#include <sp/spDefs.h>
#include <sp/spOption.h>
#include <sp/spAudioDefs.h>
 
#if defined(SGI) || defined(linux) || defined(OSS) || defined(_WIN32) || defined(sun) || defined(MACOS) || defined(ANDROID)
#define SP_SUPPORT_AUDIO
#endif
 
/*
#if defined(MACOSX64)
#undef SP_SUPPORT_AUDIO
#endif
*/
 
#ifdef __cplusplus
extern "C" {
#endif
 
  /*----@addtogroup spAudioGroup----*/
 
typedef struct _spAudio *spAudio;  
#define SP_AUDIO_BLOCKING 0     
#define SP_AUDIO_NONBLOCKING 1  
#define SP_AUDIO_CAPS_OPTION_DIALOG (1<<5)    
    
typedef unsigned long spAudioCallbackType;  
#define SP_AUDIO_NO_CALLBACK 0  
#define SP_AUDIO_OUTPUT_POSITION_CALLBACK (1<<0)  
#define SP_AUDIO_OUTPUT_BUFFER_CALLBACK (1<<2)  
#if 0
/* reserved */
#define SP_AUDIO_OUTPUT_FINISHED_CALLBACK (1<<3)  /* data1: void *buffer, data2: long *buffer_length */
#define SP_AUDIO_OUTPUT_BUFFER_REQUEST_CALLBACK (1<<4)  /* data1: void *buffer, data2: long *buffer_length */
#define SP_AUDIO_INPUT_POSITION_CALLBACK (1<<5)  /* data1: void *buffer, data2: long *buffer_length */
#define SP_AUDIO_INPUT_BUFFER_CALLBACK (1<<6)  /* data1: void *buffer, data2: long *buffer_length */
#define SP_AUDIO_INPUT_FINISHED_CALLBACK (1<<7)  /* data1: void *buffer, data2: long *buffer_length */
#define SP_AUDIO_INPUT_BUFFER_REQUEST_CALLBACK (1<<8)  /* data1: void *buffer, data2: long *buffer_length */
#endif
    
typedef spBool (*spAudioCallbackFunc)(spAudio audio, spAudioCallbackType call_type, void *data1, void *data2, void *user_data);
    
  /*----@addtogroup spAudioGroup----*/
 
#if defined(MACOS)
#pragma import on
#endif
 
  /*----@addtogroup spAudioGroup----*/
 
extern int spGetNumAudioDriver(void);
 
extern char *xspGetAudioDriverName(int index);
    
extern int spGetNumAudioDriverDevice(const char *driver_name);
 
extern char *xspGetAudioDriverDeviceName(const char *driver_name, int index);
  /*----@addtogroup spAudioGroup----*/
    
extern spAudio spInitAudioDriver(const char *driver_name);
extern spAudio spInitAudio(void);
extern void _spFreeAudioDriver(spAudio audio);
extern spBool spAddAudioExitCallback(spAudio audio, spExitCallbackFunc callback);
extern spBool spGetNumAudioDevice(spAudio audio, int *num_device);
extern char *xspGetAudioDeviceName(spAudio audio, int device_index);
extern spBool spSelectAudioDevice(spAudio audio, int device_index);
extern spBool spIsAudioOptionDialogExist(spAudio audio);
extern spBool spDisplayAudioOptionDialog(spAudio audio);
 
extern spBool spSetAudioSampleRate(spAudio audio, double samp_rate);
extern spBool spGetAudioSampleRate(spAudio audio, double *samp_rate);
extern spBool spSetAudioChannel(spAudio audio, int num_channel);
extern spBool spGetAudioChannel(spAudio audio, int *num_channel);
extern spBool spSetAudioBufferSize(spAudio audio, int buffer_size);
extern spBool spGetAudioBufferSize(spAudio audio, int *buffer_size);
extern spBool spSetAudioNumBuffer(spAudio audio, int num_buffer);
extern spBool spGetAudioNumBuffer(spAudio audio, int *num_buffer);
extern spBool spSetAudioBlockingMode(spAudio audio, int block_mode);
extern spBool spGetAudioBlockingMode(spAudio audio, int *block_mode);
extern spBool spSetAudioSampleBit(spAudio audio, int samp_bit);
extern spBool spGetAudioSampleBit(spAudio audio, int *samp_bit);
extern spBool spGetAudioSpecifiedSampleBit(spAudio audio, int *specified_samp_bit);
extern spAudioCallbackType spSetAudioCallbackFunc(spAudio audio, spAudioCallbackType call_type,
                                                  spAudioCallbackFunc call_func, void *call_data);
extern spBool spOpenAudioDevice(spAudio audio, const char *mode);
extern spBool spCloseAudioDevice(spAudio audio);
extern long spReadAudio(spAudio audio, void *data, long length);
extern long spReadAudioBuffer(spAudio audio, char *buffer, long size);
extern long spWriteAudio(spAudio audio, void *data, long length);
extern long spWriteAudioBuffer(spAudio audio, char *buffer, long size);
extern long spReadAudioDoubleWeighted(spAudio audio, double *data, long length, double weight);
extern long spReadAudioDouble(spAudio audio, double *data, long length);
extern long spWriteAudioDoubleWeighted(spAudio audio, double *data, long length, double weight);
extern long spWriteAudioDouble(spAudio audio, double *data, long length);
extern spBool spGetAudioOutputPosition(spAudio audio, spLong *position);
extern spBool spStopAudio(spAudio audio);
extern spBool spSyncAudio(spAudio audio);
#if defined(MACOS)
#pragma import off
#endif
 
#define spFreeAudioDriver(audio) {_spFreeAudioDriver(audio); (audio) = NULL;}
#define spFreeAudio(audio) spFreeAudioDriver(audio)
#ifdef __cplusplus
}  /* Close scope of 'extern "C"' declaration */
#endif
 
#endif /* __SPAUDIO_H */