diff options
Diffstat (limited to 'src/xine-engine/audio_out.h')
| -rw-r--r-- | src/xine-engine/audio_out.h | 94 |
1 files changed, 50 insertions, 44 deletions
diff --git a/src/xine-engine/audio_out.h b/src/xine-engine/audio_out.h index 9b332e72d..98bbc4683 100644 --- a/src/xine-engine/audio_out.h +++ b/src/xine-engine/audio_out.h @@ -17,7 +17,7 @@ * along with this program; if not, write to the Free Software * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA * - * $Id: audio_out.h,v 1.2 2001/04/27 10:42:38 f1rmb Exp $ + * $Id: audio_out.h,v 1.3 2001/04/28 19:47:42 guenter Exp $ */ #ifndef HAVE_AUDIO_OUT_H #define HAVE_AUDIO_OUT_H @@ -30,90 +30,96 @@ #endif -#define AUDIO_OUT_PLUGIN_IFACE_VERSION 1 +#define AUDIO_OUT_IFACE_VERSION 1 /* * audio output modes Used as Bitfield in AC3 decoder */ #define AO_MODE_AC3 1 -#define AO_MODE_MONO 2 /* 1 sample == 2 bytes */ -#define AO_MODE_STEREO 4 /* 1 sample == 4 bytes */ -#define AO_MODE_4CHANNEL 8 /* 1 sample == 8 bytes */ -#define AO_MODE_5CHANNEL 16 /* 1 sample == 10 bytes */ +#define AO_MODE_AC5 2 +#define AO_MODE_MONO 4 /* 1 sample == 2 bytes */ +#define AO_MODE_STEREO 8 /* 1 sample == 4 bytes */ +#define AO_MODE_4CHANNEL 16 /* 1 sample == 8 bytes */ +#define AO_MODE_5CHANNEL 32 /* 1 sample == 10 bytes */ -typedef struct ao_functions_s -{ +/* + * ao_functions_s contains the functions every audio output + * driver plugin has to implement. + */ + +typedef struct ao_functions_s ao_functions_t; + +struct ao_functions_s { /* - * plugin interface version, lower versions _may_ be supported + * find out what output modes are supported by this plugin + * (constants for the bit vector to return see above) */ - int interface_version; + uint32_t (*get_supported_modes) (ao_functions_t *this); /* - * find out if desired output mode is supported by - * this driver + * connect this driver to the xine engine */ - - int (*is_mode_supported) (int mode); + void (*connect) (ao_functions_t *this, metronom_t *metronom); /* - * init device - buffer will be flushed(!) + * open the driver and make it ready to receive audio data + * buffers may be flushed(!) + * * return value: <=0 : failure, 1 : ok */ - int (*open)(metronom_t *metronom, uint32_t bits, uint32_t rate, int mode); + int (*open)(ao_functions_t *this, uint32_t bits, uint32_t rate, int mode); /* * write audio data to output buffer - may block * audio driver must sync sample playback with metronom */ - void (*write_audio_data)(metronom_t *metronom, + void (*write_audio_data)(ao_functions_t *this, int16_t* audio_data, uint32_t num_samples, uint32_t pts); /* - * close the audio driver + * this is called when the decoder no longer uses the audio + * output driver - the driver should get ready to get opened() again */ - void (*close)(void); + void (*close)(ao_functions_t *this); /* - * return human readable identifier for this plugin + * shut down this audio output driver plugin and + * free all resources allocated */ - char* (*get_identifier) (void); - -} ao_functions_t; + void (*exit) (ao_functions_t *this); -/* - * available drivers: - */ +} ; -#define AO_DRIVER_UNSET -1 -#define AO_DRIVER_NULL 0 -#define AO_DRIVER_OSS 1 -#if defined(HAVE_ALSA) -# define AO_DRIVER_ALSA 2 -# if defined(HAVE_ESD) -# define AO_DRIVER_ESD 3 -# endif -#else /* no ALSA */ -# if defined(HAVE_ESD) -# define AO_DRIVER_ESD 2 -# endif -#endif /* - * find right device driver, init it + * to build a dynamic audio output plugin, + * you have to implement these functions: + * + * + * ao_functions_t *init_audio_out_plugin (config_values_t *config) + * + * init this plugin, check if device is available + * + * ao_info_t *get_audio_out_plugin_info () + * + * peek at some (static) information about the plugin without initializing it + * */ -//ao_functions_t *ao_init(char *driver_name) ; - -ao_functions_t *init_audio_out_plugin(int iface, config_values_t *cfg); +typedef struct ao_info_s { -char *ao_get_available_drivers (); + int interface_version; + char *id; + char *description; + int priority; +} ao_info_t ; #endif |