1 /*****************************************************************************
2 * vlc_stream.h: Stream (between access and demux) descriptor and methods
3 *****************************************************************************
4 * Copyright (C) 1999-2004 VLC authors and VideoLAN
7 * Authors: Laurent Aimar <fenrir@via.ecp.fr>
9 * This program is free software; you can redistribute it and/or modify it
10 * under the terms of the GNU Lesser General Public License as published by
11 * the Free Software Foundation; either version 2.1 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public License
20 * along with this program; if not, write to the Free Software Foundation,
21 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22 *****************************************************************************/
25 #define VLC_STREAM_H 1
27 #include <vlc_block.h>
31 * This file defines structures and functions for stream (between access and demux) descriptor in vlc
39 * \defgroup stream Stream
41 * This will allow you to easily handle read/seek in demuxer modules.
45 /* Opaque definition for text reader context */
46 typedef struct stream_text_t stream_text_t
;
57 /* Module properties for stream filter */
61 /* Real or virtual path (it can only be changed during stream_t opening) */
64 /* Stream source for stream filter */
68 int (*pf_read
) ( stream_t
*, void *p_read
, unsigned int i_read
);
69 int (*pf_peek
) ( stream_t
*, const uint8_t **pp_peek
, unsigned int i_peek
);
70 int (*pf_control
)( stream_t
*, int i_query
, va_list );
73 void (*pf_destroy
)( stream_t
*);
75 /* Private data for module */
78 /* Text reader state */
79 stream_text_t
*p_text
;
81 /* Weak link to parent input */
82 input_thread_t
*p_input
;
86 * Possible commands to send to stream_Control() and stream_vaControl()
91 STREAM_CAN_SEEK
, /**< arg1= bool * res=cannot fail*/
92 STREAM_CAN_FASTSEEK
, /**< arg1= bool * res=cannot fail*/
93 STREAM_CAN_PAUSE
, /**< arg1= bool * res=cannot fail*/
94 STREAM_CAN_CONTROL_PACE
, /**< arg1= bool * res=cannot fail*/
97 STREAM_SET_POSITION
, /**< arg1= uint64_t res=can fail */
98 STREAM_GET_POSITION
, /**< arg1= uint64_t * res=cannot fail*/
100 STREAM_GET_SIZE
, /**< arg1= uint64_t * res=cannot fail (0 if no sense)*/
102 /* Special for direct access control from demuxer.
103 * XXX: avoid using it by all means */
104 STREAM_CONTROL_ACCESS
, /* arg1= int i_access_query, args res: can fail
105 if access unreachable or access control answer */
107 /* You should update size of source if any and then update size
108 * FIXME find a way to avoid it */
112 STREAM_GET_TITLE_INFO
= 0x102, /**< arg1=input_title_t*** arg2=int* res=can fail */
113 STREAM_GET_META
, /**< arg1= vlc_meta_t ** res=can fail */
114 STREAM_GET_CONTENT_TYPE
, /**< arg1= char ** res=can fail */
115 STREAM_GET_SIGNAL
, /**< arg1=double *pf_quality, arg2=double *pf_strength res=can fail */
117 STREAM_SET_PAUSE_STATE
= 0x200, /**< arg1= bool res=can fail */
118 STREAM_SET_TITLE
, /**< arg1= int res=can fail */
119 STREAM_SET_SEEKPOINT
, /**< arg1= int res=can fail */
121 /* XXX only data read through stream_Read/Block will be recorded */
122 STREAM_SET_RECORD_STATE
, /**< arg1=bool, arg2=const char *psz_ext (if arg1 is true) res=can fail */
125 VLC_API
int stream_Read( stream_t
*s
, void *p_read
, int i_read
);
126 VLC_API
int stream_Peek( stream_t
*s
, const uint8_t **pp_peek
, int i_peek
);
127 VLC_API
int stream_vaControl( stream_t
*s
, int i_query
, va_list args
);
128 VLC_API
void stream_Delete( stream_t
*s
);
129 VLC_API
int stream_Control( stream_t
*s
, int i_query
, ... );
130 VLC_API block_t
* stream_Block( stream_t
*s
, int i_size
);
131 VLC_API block_t
* stream_BlockRemaining( stream_t
*s
, int i_max_size
);
132 VLC_API
char * stream_ReadLine( stream_t
* );
135 * Get the current position in a stream
137 static inline int64_t stream_Tell( stream_t
*s
)
140 stream_Control( s
, STREAM_GET_POSITION
, &i_pos
);
142 return (int64_t)1 << 62;
147 * Get the size of the stream.
149 static inline int64_t stream_Size( stream_t
*s
)
152 stream_Control( s
, STREAM_GET_SIZE
, &i_pos
);
154 return (int64_t)1 << 62;
158 static inline int stream_Seek( stream_t
*s
, uint64_t i_pos
)
160 return stream_Control( s
, STREAM_SET_POSITION
, i_pos
);
164 * Get the Content-Type of a stream, or NULL if unknown.
165 * Result must be free()'d.
167 static inline char *stream_ContentType( stream_t
*s
)
170 if( stream_Control( s
, STREAM_GET_CONTENT_TYPE
, &res
) )
176 * Create a special stream and a demuxer, this allows chaining demuxers
177 * You must delete it using stream_Delete.
179 VLC_API stream_t
* stream_DemuxNew( demux_t
*p_demux
, const char *psz_demux
, es_out_t
*out
);
182 * Send data to a stream handle created by stream_DemuxNew().
184 VLC_API
void stream_DemuxSend( stream_t
*s
, block_t
*p_block
);
187 * Perform a <b>demux</b> (i.e. DEMUX_...) control request on a stream handle
188 * created by stream_DemuxNew().
190 VLC_API
int stream_DemuxControlVa( stream_t
*s
, int, va_list );
192 static inline int stream_DemuxControl( stream_t
*s
, int query
, ... )
197 va_start( ap
, query
);
198 ret
= stream_DemuxControlVa( s
, query
, ap
);
204 * Create a stream_t reading from memory.
205 * You must delete it using stream_Delete.
207 VLC_API stream_t
* stream_MemoryNew(vlc_object_t
*p_obj
, uint8_t *p_buffer
, uint64_t i_size
, bool b_preserve_memory
);
208 #define stream_MemoryNew( a, b, c, d ) stream_MemoryNew( VLC_OBJECT(a), b, c, d )
211 * Create a stream_t reading from a URL.
212 * You must delete it using stream_Delete.
214 VLC_API stream_t
* stream_UrlNew(vlc_object_t
*p_this
, const char *psz_url
);
215 #define stream_UrlNew( a, b ) stream_UrlNew( VLC_OBJECT(a), b )
219 * Try to add a stream filter to an open stream.
220 * @return New stream to use, or NULL if the filter could not be added.
222 VLC_API stream_t
* stream_FilterNew( stream_t
*p_source
, const char *psz_stream_filter
);