ref: 51a1a378632b453d050c9be3afcf75fd2baa198c
dir: /include/cst_audio.h/
/*************************************************************************/ /* */ /* Language Technologies Institute */ /* Carnegie Mellon University */ /* Copyright (c) 2000 */ /* All Rights Reserved. */ /* */ /* Permission is hereby granted, free of charge, to use and distribute */ /* this software and its documentation without restriction, including */ /* without limitation the rights to use, copy, modify, merge, publish, */ /* distribute, sublicense, and/or sell copies of this work, and to */ /* permit persons to whom this work is furnished to do so, subject to */ /* the following conditions: */ /* 1. The code must retain the above copyright notice, this list of */ /* conditions and the following disclaimer. */ /* 2. Any modifications must be clearly marked as such. */ /* 3. Original authors' names are not deleted. */ /* 4. The authors' names are not used to endorse or promote products */ /* derived from this software without specific prior written */ /* permission. */ /* */ /* CARNEGIE MELLON UNIVERSITY AND THE CONTRIBUTORS TO THIS WORK */ /* DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING */ /* ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT */ /* SHALL CARNEGIE MELLON UNIVERSITY NOR THE CONTRIBUTORS BE LIABLE */ /* FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES */ /* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN */ /* AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, */ /* ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF */ /* THIS SOFTWARE. */ /* */ /*************************************************************************/ /* Author: Alan W Black (awb@cs.cmu.edu) */ /* Date: August 2000 */ /*************************************************************************/ /* */ /* Audio */ /* */ /*************************************************************************/ #ifndef _CST_AUDIO_H__ #define _CST_AUDIO_H__ #include "cst_wave.h" #include "cst_hrg.h" #ifdef CST_AUDIO_WIN32 #define CST_AUDIOBUFFSIZE 8092 #else #define CST_AUDIOBUFFSIZE 128 #endif #define CST_AUDIO_DEFAULT_PORT 1746 #define CST_AUDIO_DEFAULT_SERVER "localhost" #define CST_AUDIO_DEFAULT_ENCODING "short" typedef enum { CST_AUDIO_LINEAR16 = 0, CST_AUDIO_LINEAR8, CST_AUDIO_MULAW } cst_audiofmt; /* Returns the number of bytes per sample for a given audio format */ int audio_bps(cst_audiofmt fmt); typedef struct cst_audiodev_struct { int sps, real_sps; int channels, real_channels; cst_audiofmt fmt, real_fmt; int byteswap; cst_rateconv *rateconv; void *platform_data; } cst_audiodev; /* Generic audio functions */ cst_audiodev *audio_open(int sps, int channels, cst_audiofmt fmt); int audio_close(cst_audiodev *ad); int audio_write(cst_audiodev *ad, void *buff, int num_bytes); int audio_flush(cst_audiodev *ad); /* wait for buffers to empty */ int audio_drain(cst_audiodev *ad); /* empty buffers now */ /* Generic high level audio functions */ int play_wave(cst_wave *w); int play_wave_sync(cst_wave *w, cst_relation *rel, int (*call_back)(cst_item *)); int play_wave_client(cst_wave *w, const char *servername, int port, const char *encoding); int auserver(int port); /* Play wave to specified device */ int play_wave_device(cst_wave *w, cst_audiodev *ad); /* Output to a file as if its an audio device */ cst_audiodev *audio_open_file(int sps, int channels, cst_audiofmt fmt, const char *filename); int audio_close_file(cst_audiodev *ad); int audio_write_file(cst_audiodev *ad, void *buff, int num_bytes); int audio_drain_file(cst_audiodev *ad); int audio_flush_file(cst_audiodev *ad); /* For audio streaming */ #define CST_AUDIO_STREAM_STOP -1 #define CST_AUDIO_STREAM_CONT 0 typedef struct cst_audio_streaming_info_struct { int min_buffsize; int (*asc)(const cst_wave *w,int start,int size, int last, struct cst_audio_streaming_info_struct *asi); const cst_utterance *utt; /* in case you need more information */ const cst_item *item; /* because you'll probably want this */ /* But this is *not* updated automatically */ void *userdata; } cst_audio_streaming_info; cst_audio_streaming_info *new_audio_streaming_info(); void delete_audio_streaming_info(cst_audio_streaming_info *asi); CST_VAL_USER_TYPE_DCLS(audio_streaming_info,cst_audio_streaming_info) typedef int (*cst_audio_stream_callback)(const cst_wave *w,int start,int size, int last, cst_audio_streaming_info *asi); /* An example audio streaming callback function src/audio/au_streaming.c */ int audio_stream_chunk(const cst_wave *w, int start, int size, int last, cst_audio_streaming_info *asi); #endif