AhoLib: Fichero Fuente xsnd.h

00001 #ifndef __XSND_H
00002 #define __XSND_H
00003 
00004 /**********************************************************/
00005 /*/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\*/
00006 /*
00007 Copyright: 1995 - Grupo de Voz (DAET) ETSII/IT-Bilbao
00008 
00009 Nombre fuente................ XSND.H
00010 Nombre paquete............... -
00011 Lenguaje fuente.............. C (Borland C/C++ 3.1)
00012 Estado....................... Completado
00013 Dependencia Hard/OS.......... SoundBlaster 16, DMA, IRQs...
00014 Codigo condicional........... -
00015 
00016 Codificacion................. Borja Etxebarria
00017 
00018 Version  dd/mm/aa  Autor     Proposito de la edicion
00019 -------  --------  --------  -----------------------
00020 1.0.1    10/11/96  Borja     missing prototipes.
00021 1.0.0    02/03/95  Borja     Codificacion inicial.
00022 
00023 ======================== Contenido ========================
00024 Cabecera de modulos para la conversion AD/DA de 8/16 bits
00025 con Sound Blaster 16.
00026 Ver XSNDSB16.C para mas informacion.
00027 Se definen dos familias de funciones:
00028 
00029    xsnd16_???() (xsnd16_open(), xsnd16_close()...)
00030    xsnd8_???() (xsnd8_open(), xsnd8_close()...)
00031 
00032 las primeras para trabajar con muestras de 16 bits, las
00033 segundas para 8 bits.
00034 
00035 Se define otra familia:
00036 
00037     xsnd_???() (xsnd_open(), xsnd_close()...)
00038 
00039 que son alias para una de las familias anteriores (por
00040 defecto xsnd16_???() ).
00041 Creo que deberia unir xsnd16_??? y xsnd8_??? y pasar el numero
00042 de bits como parametro... usar xsnd_??? en prevision a esto.
00043 ....................
00044 Header for 8/16 bit AD/DA using SB16.
00045 Refer to XSNDSB16.C for more information.
00046 There are two families of functions:
00047 
00048    xsnd16_???() (xsnd16_open(), xsnd16_close()...)
00049    xsnd8_???() (xsnd8_open(), xsnd8_close()...)
00050 
00051 the first one for 16 bits samples, the second one for 8
00052 bit samples.
00053 
00054 There is also another family:
00055 
00056     xsnd_???() (xsnd_open(), xsnd_close()...)
00057 
00058 these are alias to one of the previous families (default
00059 alias to xsnd16_???() ).
00060 I think I should unify xsnd16_??? and xsnd8_???, and send the
00061 sample length as a parameter... use xsnd_??? as a prevision
00062 for this change.
00063 ===========================================================
00064 */
00065 /*/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\*/
00066 /**********************************************************/
00067 
00068 #include "tdef.h"
00069 
00070 /**********************************************************/
00071 
00072 #ifdef __cplusplus
00073 extern "C" {
00074 #endif
00075 
00076 /**********************************************************/
00077 
00078 #define XSND_RECORD TRUE
00079 #define XSND_PLAY FALSE
00080 #define XSND_MONO FALSE
00081 #define XSND_STEREO TRUE
00082 
00083 /**********************************************************/
00084 
00085 #define xsnd_open  xsnd16_open
00086 #define xsnd_close  xsnd16_close
00087 #define xsnd_getblk  xsnd16_getblk
00088 #define xsnd_addblk  xsnd16_addblk
00089 #define xsnd_addlastblk  xsnd16_addlastblk
00090 #define xsnd_stopped  xsnd16_stopped
00091 #define xsnd_blocked  xsnd16_blocked
00092 #define xsnd_reset  xsnd16_reset
00093 #define xsnd_start  xsnd16_start
00094 #define xsnd_stop  xsnd16_stop
00095 #define xsnd_getoverrun  xsnd16_getoverrun
00096 #define xsnd_getblknum  xsnd16_getblknum
00097 #define xsnd_getnblk  xsnd16_getnblk
00098 #define xsnd_initialize  xsnd16_initialize
00099 #define xsnd_srate  xsnd16_srate
00100 #define xsnd_getsrate  xsnd16_getsrate
00101 #define xsnd_getqblk xsnd16_getqblk
00102 
00103 /**********************************************************/
00104 
00105 UINT16 xsnd16_open( BOOL record, UINT16 srate, BOOL stereo,
00106                 UINT32 blklen, UINT16 numblk, VOID (PTRF usrproc) ( BOOL last) );
00107 UINT16 xsnd16_close( VOID );
00108 pfINT16 xsnd16_getblk( VOID );
00109 UINT16 xsnd16_addblk( VOID );
00110 UINT16 xsnd16_addlastblk( UINT32 len );
00111 BOOL xsnd16_stopped( VOID );
00112 BOOL xsnd16_blocked( VOID );
00113 
00114 UINT16 xsnd16_reset( VOID );
00115 UINT16 xsnd16_start( VOID );
00116 UINT16 xsnd16_stop( VOID );
00117 UINT16 xsnd16_getoverrun( VOID );
00118 
00119 pfINT16 xsnd16_getblknum( UINT16 nblk );
00120 UINT16 xsnd16_getnblk( VOID );
00121 
00122 UINT16 xsnd16_srate( UINT16 srate );
00123 DOUBLE xsnd16_getsrate( VOID );
00124 
00125 UINT16 xsnd16_getqblk( VOID );
00126 
00127 UINT16 xsnd16_initialize( VOID );
00128 
00129 /**********************************************************/
00130 
00131 UINT16 xsnd8_open( BOOL record, UINT16 srate, BOOL stereo,
00132                 UINT32 blklen, UINT16 numblk, VOID (PTRF usrproc) ( BOOL last) );
00133 UINT16 xsnd8_close( VOID );
00134 pfUINT8 xsnd8_getblk( VOID );
00135 UINT16 xsnd8_addblk( VOID );
00136 UINT16 xsnd8_addlastblk( UINT32 len );
00137 BOOL xsnd8_stopped( VOID );
00138 BOOL xsnd8_blocked( VOID );
00139 
00140 UINT16 xsnd8_reset( VOID );
00141 UINT16 xsnd8_start( VOID );
00142 UINT16 xsnd8_stop( VOID );
00143 UINT16 xsnd8_getoverrun( VOID );
00144 
00145 pfUINT8 xsnd8_getblknum( UINT16 nblk );
00146 UINT16 xsnd8_getnblk( VOID );
00147 
00148 UINT16 xsnd8_srate( UINT16 srate );
00149 DOUBLE xsnd8_getsrate( VOID );
00150 
00151 UINT16 xsnd8_getqblk( VOID );
00152 
00153 UINT16 xsnd8_initialize( VOID );
00154 
00155 /**********************************************************/
00156 
00157 #ifdef __cplusplus
00158 }  /* extern "C" */
00159 #endif
00160 
00161 /**********************************************************/
00162 
00163 #endif