1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
|
/*
* Copyright (C) 2000-2001 the xine project
*
* This file is part of xine, a unix video player.
*
* xine is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* xine is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* 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.16 2001/09/11 14:17:20 jcdutton Exp $
*/
#ifndef HAVE_AUDIO_OUT_H
#define HAVE_AUDIO_OUT_H
#ifdef __cplusplus
extern "C" {
#endif
#include <inttypes.h>
#if defined(XINE_COMPILE)
#include "metronom.h"
#include "configfile.h"
#endif
#define AUDIO_OUT_IFACE_VERSION 1
/*
* ao_driver_s contains the driver every audio output
* driver plugin has to implement.
*/
typedef struct ao_driver_s ao_driver_t;
struct ao_driver_s {
/*
*
* find out what output modes + capatilities are supported by
* this plugin (constants for the bit vector to return see above)
*
* See AO_CAP_* bellow.
*/
uint32_t (*get_capabilities) (ao_driver_t *this);
/*
* open the driver and make it ready to receive audio data
* buffers may be flushed(!)
*
* return value: 0 : failure, >0 : output sample rate
*/
int (*open)(ao_driver_t *this, uint32_t bits, uint32_t rate, int mode);
/* return the number of audio channels
*/
int (*num_channels)(ao_driver_t *self_gen);
/* return the number of bytes per frame.
* A frame is equivalent to one sample being output on every audio channel.
*/
int (*bytes_per_frame)(ao_driver_t *self_gen);
/* return the delay is frames measured by
* looking at pending samples in the audio output device
*/
int (*delay)(ao_driver_t *self_gen);
/*
* return gap tolerance (in pts) needed for this driver
*/
int (*get_gap_tolerance) (ao_driver_t *self_gen);
/*
* write audio data to output buffer
* audio driver must sync sample playback with metronom
* return value:
* 1 => audio samples were processed ok
* 0 => audio samples were not yet processed,
* call write_audio_data with the _same_ samples again
*/
int (*write)(ao_driver_t *this,
int16_t* audio_data, uint32_t num_samples);
/*
* this is called when the decoder no longer uses the audio
* output driver - the driver should get ready to get opened() again
*/
void (*close)(ao_driver_t *this);
/*
* shut down this audio output driver plugin and
* free all resources allocated
*/
void (*exit) (ao_driver_t *this);
/*
* Get, Set a property of audio driver.
*
* get_property() return 1 in success, 0 on failure.
* set_property() return value on success, ~value on failure.
*
* See AC_PROP_* bellow for available properties.
*/
int (*get_property) (ao_driver_t *this, int property);
int (*set_property) (ao_driver_t *this, int property, int value);
};
/*
* ao_instance_s contains the instance every audio decoder talks to
*/
typedef struct ao_instance_s ao_instance_t;
struct ao_instance_s {
uint32_t (*get_capabilities) (ao_instance_t *this); /* for constants see below */
/* open audio driver for audio output
* return value: 0:failure, >0:output sample rate
*/
int (*open) (ao_instance_t *this,
uint32_t bits, uint32_t rate, int mode);
/*
* write audio data to output buffer
* audio driver must sync sample playback with metronom
* return value:
* 1 => audio samples were processed ok
* 0 => audio samples were not yet processed,
* call write_audio_data with the _same_ samples again
*/
int (*write)(ao_instance_t *this,
int16_t* audio_data, uint32_t num_frames,
uint32_t pts);
/* audio driver is no longer used by decoder => close */
void (*close) (ao_instance_t *self);
/* called on xine exit */
void (*exit) (ao_instance_t *this);
/* private stuff */
ao_driver_t *driver;
metronom_t *metronom;
int audio_loop_running;
pthread_t audio_thread;
int audio_step; /* pts per 32 768 samples (sample = #bytes/2) */
int32_t frames_per_kpts; /* frames per 1024/90000 sec */
int32_t output_frame_rate, input_frame_rate;
double frame_rate_factor;
uint32_t num_channels;
int audio_started;
uint32_t last_audio_vpts;
int resample_conf;
int do_resample;
int mode;
int bits;
int gap_tolerance;
uint16_t *frame_buffer;
int16_t *zero_space;
};
/* This initiates the audio_out sync routines
* found in ./src/xine-engine/audio_out.c
*/
ao_instance_t *ao_new_instance (ao_driver_t *driver, metronom_t *metronom, config_values_t *config) ;
/*
* to build a dynamic audio output plugin,
* you have to implement these driver:
*
*
* ao_driver_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
*
*/
/*
* audio output modes + capabilities
*/
#define AO_CAP_NOCAP 0x00000000 /* driver has no capabilities */
#define AO_CAP_MODE_A52 0x00000001 /* driver supports A/52 output */
#define AO_CAP_MODE_AC5 0x00000002 /* driver supports AC5 output */
/* 1 sample == 2 bytes (C) */
#define AO_CAP_MODE_MONO 0x00000004 /* driver supports mono output */
/* 1 sample == 4 bytes (L,R) */
#define AO_CAP_MODE_STEREO 0x00000008 /* driver supports stereo output */
/* 1 sample == 8 bytes (L,R,LR,RR) */
#define AO_CAP_MODE_4CHANNEL 0x00000010 /* driver supports 4 channels */
/* 1 sample == 10 bytes (L,R,LR,RR,C) */
#define AO_CAP_MODE_5CHANNEL 0x00000020 /* driver supports 5 channels */
/* 1 sample == 12 bytes (L,R,LR,RR,C,LFE) */
#define AO_CAP_MODE_5_1CHANNEL 0x00000040 /* driver supports 5.1 channels */
#define AO_CAP_MIXER_VOL 0x00000080 /* driver supports mixer control */
#define AO_CAP_PCM_VOL 0x00000100 /* driver supports pcm control */
#define AO_CAP_MUTE_VOL 0x00000200 /* driver can mute volume */
/* properties supported by get/set_property() */
#define AO_PROP_MIXER_VOL 0
#define AO_PROP_PCM_VOL 1
#define AO_PROP_MUTE_VOL 2
typedef struct ao_info_s {
int interface_version;
char *id;
char *description;
int priority;
} ao_info_t ;
#ifdef __cplusplus
}
#endif
#endif
|
