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
|
/*
* Copyright (C) 2000-2002 the xine project
*
* Copyright (C) James Courtier-Dutton James@superbug.demon.co.uk - July 2001
*
* This file is part of xine, a free 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: spu_decoder.h,v 1.6 2002/10/23 17:12:34 guenter Exp $
*/
#ifndef HAVE_SPU_OUT_H
#define HAVE_SPU_OUT_H
#ifdef __cplusplus
extern "C" {
#endif
#include <inttypes.h>
#if defined(XINE_COMPILE)
#include "metronom.h"
#include "configfile.h"
#endif
#define SPU_OUT_IFACE_VERSION 1
/*
* spu_functions_s contains the functions every spu output
* driver plugin has to implement.
*/
typedef struct spu_functions_s spu_functions_t;
struct spu_functions_s {
/*
*
* find out what output modes + capatilities are supported by
* this plugin (constants for the bit vector to return see above)
*
* See SPU_CAP_* bellow.
*/
uint32_t (*get_capabilities) (spu_functions_t *this);
/*
* connect this driver to the xine engine
*/
void (*connect) (spu_functions_t *this, metronom_t *metronom);
/*
* open the driver and make it ready to receive spu data
* buffers may be flushed(!)
*
* return value: <=0 : failure, 1 : ok
*/
int (*open)(spu_functions_t *this, uint32_t bits, uint32_t rate, int mode);
/*
* write spu data to output buffer - may block
* spu driver must sync sample playback with metronom
*/
void (*write_spu_data)(spu_functions_t *this,
int16_t* spu_data, uint32_t num_samples,
int64_t pts);
/*
* this is called when the decoder no longer uses the spu
* output driver - the driver should get ready to get opened() again
*/
void (*close)(spu_functions_t *this);
/*
* shut down this spu output driver plugin and
* free all resources allocated
*/
void (*exit) (spu_functions_t *this);
/*
* Get, Set a property of spu 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) (spu_functions_t *this, int property);
int (*set_property) (spu_functions_t *this, int property, int value);
};
/*
* to build a dynamic spu output plugin,
* you have to implement these functions:
*
*
* spu_functions_t *init_spu_out_plugin (config_values_t *config)
*
* init this plugin, check if device is available
*
* spu_info_t *get_spu_out_plugin_info ()
*
* peek at some (static) information about the plugin without initializing it
*
*/
/*
* spu output modes + capabilities
*/
/* none yet */
typedef struct spu_info_s {
int interface_version;
char *id;
char *description;
int priority;
} spu_info_t ;
#ifdef __cplusplus
}
#endif
#endif
|
