1 /*****************************************************************************
2 * stream_output.h : stream output module
3 *****************************************************************************
4 * Copyright (C) 2002 VideoLAN
5 * $Id: stream_output.h,v 1.21 2004/02/22 16:08:47 fenrir Exp $
7 * Authors: Christophe Massiot <massiot@via.ecp.fr>
8 * Laurent Aimar <fenrir@via.ecp.fr>
9 * Eric Petit <titer@videolan.org>
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
24 *****************************************************************************/
26 /*****************************************************************************
27 * sout_instance_t: stream output thread descriptor
28 *****************************************************************************/
33 * i_allocated_size: size of allocated buffer
34 * p_allocated_buffer: where data has been allocated
36 * i_buffer_size: sizeof buffer from p_buffer
37 * p_buffer: where data begins
38 * i_size: size of valid data
41 #define SOUT_BUFFER_FLAGS_HEADER 0x0001
44 * Flags for muxer/access private usage.
46 #define SOUT_BUFFER_FLAGS_PRIVATE_MASK 0xffff0000
47 #define SOUT_BUFFER_FLAGS_PRIVATE_SHIFT 16
51 size_t i_allocated_size;
52 byte_t *p_allocated_buffer;
66 struct sout_buffer_t *p_next;
71 vlc_mutex_t lock; /* fifo data lock */
72 vlc_cond_t wait; /* fifo data conditional variable */
75 sout_buffer_t *p_first;
76 sout_buffer_t **pp_last;
79 typedef struct sout_stream_id_t sout_stream_id_t;
84 sout_instance_t *p_sout;
93 struct sout_packetizer_input_t
96 sout_instance_t *p_sout;
100 sout_stream_id_t *id;
104 #define SOUT_METHOD_NONE 0x00
105 #define SOUT_METHOD_FILE 0x10
106 #define SOUT_METHOD_NETWORK 0x20
108 typedef struct sout_access_out_sys_t sout_access_out_sys_t;
109 struct sout_access_out_t
115 sout_instance_t *p_sout;
121 sout_access_out_sys_t *p_sys;
122 int (* pf_seek )( sout_access_out_t *,
124 int (* pf_read )( sout_access_out_t *,
126 int (* pf_write )( sout_access_out_t *,
131 * i_query parameter of pf_mux_capacity
133 /* SOUT_MUX_CAP_GET_ADD_STREAM_ANY_TIME: p_args=NULL, p_answer=&boolean */
134 #define SOUT_MUX_CAP_GET_ADD_STREAM_ANY_TIME 0x01
135 /* SOUT_MUX_CAP_GET_STREAMABLE: p_args=NULL, p_answer=&boolean */
136 #define SOUT_MUX_CAP_GET_STREAMABLE 0x02
137 /* SOUT_MUX_CAP_GET_ADD_STREAM_WAIT: p_args=NULL, p_answer=&boolean */
138 #define SOUT_MUX_CAP_GET_ADD_STREAM_WAIT 0x03
143 #define SOUT_MUX_CAP_ERR_OK 0x00
144 #define SOUT_MUX_CAP_ERR_UNKNOWN 0x01
145 #define SOUT_MUX_CAP_ERR_UNIMPLEMENTED 0x02
147 typedef struct sout_mux_sys_t sout_mux_sys_t;
153 sout_instance_t *p_sout;
158 sout_access_out_t *p_access;
161 int (* pf_capacity) ( sout_mux_t *,
162 int, void *, void *);
163 int (* pf_addstream )( sout_mux_t *,
165 int (* pf_delstream )( sout_mux_t *,
167 int (* pf_mux ) ( sout_mux_t * );
170 /* here are all inputs accepted by muxer */
172 sout_input_t **pp_inputs;
176 sout_mux_sys_t *p_sys;
179 /* creater private */
183 /* XXX private to stream_output.c */
184 /* if muxer doesn't support adding stream at any time then we first wait
185 * for stream then we refuse all stream and start muxing */
186 vlc_bool_t b_add_stream_any_time;
187 vlc_bool_t b_waiting_stream;
188 /* we wait one second after first stream added */
189 mtime_t i_add_stream_start;
202 typedef struct sout_stream_sys_t sout_stream_sys_t;
208 sout_instance_t *p_sout;
214 /* add, remove a stream */
215 sout_stream_id_t * (*pf_add) ( sout_stream_t *, es_format_t * );
216 int (*pf_del) ( sout_stream_t *, sout_stream_id_t * );
218 /* manage a packet */
219 int (*pf_send)( sout_stream_t *, sout_stream_id_t *, sout_buffer_t* );
222 sout_stream_sys_t *p_sys;
225 typedef struct sout_instance_sys_t sout_instance_sys_t;
226 struct sout_instance_t
234 int i_preheader; /* max over all muxer */
236 int i_padding; /* needed by some decoders */
239 sout_stream_t *p_stream;
242 sout_instance_sys_t *p_sys;
245 static inline sout_cfg_t *sout_cfg_find( sout_cfg_t *p_cfg, char *psz_name )
247 while( p_cfg && strcmp( p_cfg->psz_name, psz_name ) )
249 p_cfg = p_cfg->p_next;
255 static inline char *sout_cfg_find_value( sout_cfg_t *p_cfg, char *psz_name )
257 while( p_cfg && strcmp( p_cfg->psz_name, psz_name ) )
259 p_cfg = p_cfg->p_next;
262 if( p_cfg && p_cfg->psz_value )
264 return( p_cfg->psz_value );
269 /*****************************************************************************
271 *****************************************************************************/
272 #define sout_NewInstance(a,b) __sout_NewInstance(VLC_OBJECT(a),b)
273 VLC_EXPORT( sout_instance_t *, __sout_NewInstance, ( vlc_object_t *, char * ) );
274 VLC_EXPORT( void, sout_DeleteInstance, ( sout_instance_t * ) );
276 VLC_EXPORT( sout_fifo_t *, sout_FifoCreate, ( sout_instance_t * ) );
277 VLC_EXPORT( void, sout_FifoDestroy, ( sout_instance_t *, sout_fifo_t * ) );
278 VLC_EXPORT( void, sout_FifoFree, ( sout_instance_t *,sout_fifo_t * ) );
280 VLC_EXPORT( void, sout_FifoPut, ( sout_fifo_t *, sout_buffer_t* ) );
281 VLC_EXPORT( sout_buffer_t *, sout_FifoGet, ( sout_fifo_t * ) );
282 VLC_EXPORT( sout_buffer_t *, sout_FifoShow, ( sout_fifo_t * ) );
285 VLC_EXPORT( sout_packetizer_input_t *, sout_InputNew,( sout_instance_t *, es_format_t * ) );
286 VLC_EXPORT( int, sout_InputDelete, ( sout_packetizer_input_t * ) );
287 VLC_EXPORT( int, sout_InputSendBuffer, ( sout_packetizer_input_t *, sout_buffer_t* ) );
289 VLC_EXPORT( sout_buffer_t*, sout_BufferNew, ( sout_instance_t *, size_t ) );
290 VLC_EXPORT( int, sout_BufferRealloc,( sout_instance_t *, sout_buffer_t*, size_t ) );
291 VLC_EXPORT( int, sout_BufferReallocFromPreHeader,( sout_instance_t *, sout_buffer_t*, size_t ) );
292 VLC_EXPORT( int, sout_BufferDelete, ( sout_instance_t *, sout_buffer_t* ) );
293 VLC_EXPORT( sout_buffer_t*, sout_BufferDuplicate,(sout_instance_t *, sout_buffer_t * ) );
294 VLC_EXPORT( void, sout_BufferChain, ( sout_buffer_t **, sout_buffer_t * ) );
296 VLC_EXPORT( sout_access_out_t *, sout_AccessOutNew, ( sout_instance_t *, char *psz_access, char *psz_name ) );
297 VLC_EXPORT( void, sout_AccessOutDelete, ( sout_access_out_t * ) );
298 VLC_EXPORT( int, sout_AccessOutSeek, ( sout_access_out_t *, off_t ) );
299 VLC_EXPORT( int, sout_AccessOutRead, ( sout_access_out_t *, sout_buffer_t * ) );
300 VLC_EXPORT( int, sout_AccessOutWrite, ( sout_access_out_t *, sout_buffer_t * ) );
302 VLC_EXPORT( sout_mux_t *, sout_MuxNew, ( sout_instance_t*, char *, sout_access_out_t * ) );
303 VLC_EXPORT( sout_input_t *, sout_MuxAddStream, ( sout_mux_t *, es_format_t * ) );
304 VLC_EXPORT( void, sout_MuxDeleteStream, ( sout_mux_t *, sout_input_t * ) );
305 VLC_EXPORT( void, sout_MuxDelete, ( sout_mux_t * ) );
306 VLC_EXPORT( void, sout_MuxSendBuffer, ( sout_mux_t *, sout_input_t *, sout_buffer_t * ) );
308 VLC_EXPORT( char *, sout_cfg_parser, ( char **, sout_cfg_t **, char * ) );
309 VLC_EXPORT( sout_stream_t *, sout_stream_new, ( sout_instance_t *, char *psz_chain ) );
310 VLC_EXPORT( void, sout_stream_delete, ( sout_stream_t *p_stream ) );