dvdcss: Fix typo in documentation
[mplayer/glamo.git] / stream / stream.h
blobee78e1c196da809e543754624af69aab55e2da41
1 /*
2 * This file is part of MPlayer.
4 * MPlayer is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
9 * MPlayer is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License along
15 * with MPlayer; if not, write to the Free Software Foundation, Inc.,
16 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
19 #ifndef MPLAYER_STREAM_H
20 #define MPLAYER_STREAM_H
22 #include "config.h"
23 #include "mp_msg.h"
24 #include "url.h"
25 #include <string.h>
26 #include <inttypes.h>
27 #include <sys/types.h>
28 #include <fcntl.h>
30 #ifndef O_BINARY
31 #define O_BINARY 0
32 #endif
34 #define STREAMTYPE_DUMMY -1 // for placeholders, when the actual reading is handled in the demuxer
35 #define STREAMTYPE_FILE 0 // read from seekable file
36 #define STREAMTYPE_VCD 1 // raw mode-2 CDROM reading, 2324 bytes/sector
37 #define STREAMTYPE_STREAM 2 // same as FILE but no seeking (for net/stdin)
38 #define STREAMTYPE_DVD 3 // libdvdread
39 #define STREAMTYPE_MEMORY 4 // read data from memory area
40 #define STREAMTYPE_PLAYLIST 6 // FIXME!!! same as STREAMTYPE_FILE now
41 #define STREAMTYPE_DS 8 // read from a demuxer stream
42 #define STREAMTYPE_DVDNAV 9 // we cannot safely "seek" in this...
43 #define STREAMTYPE_CDDA 10 // raw audio CD reader
44 #define STREAMTYPE_SMB 11 // smb:// url, using libsmbclient (samba)
45 #define STREAMTYPE_VCDBINCUE 12 // vcd directly from bin/cue files
46 #define STREAMTYPE_DVB 13
47 #define STREAMTYPE_VSTREAM 14
48 #define STREAMTYPE_SDP 15
49 #define STREAMTYPE_PVR 16
50 #define STREAMTYPE_TV 17
51 #define STREAMTYPE_MF 18
52 #define STREAMTYPE_RADIO 19
53 #define STREAMTYPE_BLURAY 20
55 #define STREAM_BUFFER_SIZE 2048
57 #define VCD_SECTOR_SIZE 2352
58 #define VCD_SECTOR_OFFS 24
59 #define VCD_SECTOR_DATA 2324
61 /// atm it will always use mode == STREAM_READ
62 /// streams that use the new api should check the mode at open
63 #define STREAM_READ 0
64 #define STREAM_WRITE 1
65 /// Seek flags, if not mannualy set and s->seek isn't NULL
66 /// MP_STREAM_SEEK is automaticly set
67 #define MP_STREAM_SEEK_BW 2
68 #define MP_STREAM_SEEK_FW 4
69 #define MP_STREAM_SEEK (MP_STREAM_SEEK_BW|MP_STREAM_SEEK_FW)
70 /** This is a HACK for live555 that does not respect the
71 separation between stream an demuxer and thus is not
72 actually a stream cache can not be used */
73 #define STREAM_NON_CACHEABLE 8
75 //////////// Open return code
76 #define STREAM_REDIRECTED -2
77 /// This can't open the requested protocol (used by stream wich have a
78 /// * protocol when they don't know the requested protocol)
79 #define STREAM_UNSUPPORTED -1
80 #define STREAM_ERROR 0
81 #define STREAM_OK 1
83 #define MAX_STREAM_PROTOCOLS 10
85 #define STREAM_CTRL_RESET 0
86 #define STREAM_CTRL_GET_TIME_LENGTH 1
87 #define STREAM_CTRL_SEEK_TO_CHAPTER 2
88 #define STREAM_CTRL_GET_CURRENT_CHAPTER 3
89 #define STREAM_CTRL_GET_NUM_CHAPTERS 4
90 #define STREAM_CTRL_GET_CURRENT_TIME 5
91 #define STREAM_CTRL_SEEK_TO_TIME 6
92 #define STREAM_CTRL_GET_SIZE 7
93 #define STREAM_CTRL_GET_ASPECT_RATIO 8
94 #define STREAM_CTRL_GET_NUM_ANGLES 9
95 #define STREAM_CTRL_GET_ANGLE 10
96 #define STREAM_CTRL_SET_ANGLE 11
99 typedef enum {
100 streaming_stopped_e,
101 streaming_playing_e
102 } streaming_status;
104 typedef struct streaming_control {
105 URL_t *url;
106 streaming_status status;
107 int buffering; // boolean
108 unsigned int prebuffer_size;
109 char *buffer;
110 unsigned int buffer_size;
111 unsigned int buffer_pos;
112 unsigned int bandwidth; // The downstream available
113 int (*streaming_read)( int fd, char *buffer, int buffer_size, struct streaming_control *stream_ctrl );
114 int (*streaming_seek)( int fd, off_t pos, struct streaming_control *stream_ctrl );
115 void *data;
116 // hacks for asf
117 int *audio_id_ptr;
118 int *video_id_ptr;
119 } streaming_ctrl_t;
121 struct stream;
122 typedef struct stream_info_st {
123 const char *info;
124 const char *name;
125 const char *author;
126 const char *comment;
127 /// mode isn't used atm (ie always READ) but it shouldn't be ignored
128 /// opts is at least in it's defaults settings and may have been
129 /// altered by url parsing if enabled and the options string parsing.
130 int (*open)(struct stream* st, int mode, void* opts, int* file_format);
131 const char* protocols[MAX_STREAM_PROTOCOLS];
132 const void* opts;
133 int opts_url; /* If this is 1 we will parse the url as an option string
134 * too. Otherwise options are only parsed from the
135 * options string given to open_stream_plugin */
136 } stream_info_t;
138 typedef struct stream {
139 // Read
140 int (*fill_buffer)(struct stream *s, char* buffer, int max_len);
141 // Write
142 int (*write_buffer)(struct stream *s, char* buffer, int len);
143 // Seek
144 int (*seek)(struct stream *s,off_t pos);
145 // Control
146 // Will be later used to let streams like dvd and cdda report
147 // their structure (ie tracks, chapters, etc)
148 int (*control)(struct stream *s,int cmd,void* arg);
149 // Close
150 void (*close)(struct stream *s);
152 int fd; // file descriptor, see man open(2)
153 int type; // see STREAMTYPE_*
154 int flags;
155 int sector_size; // sector size (seek will be aligned on this size if non 0)
156 unsigned int buf_pos,buf_len;
157 off_t pos,start_pos,end_pos;
158 int eof;
159 int mode; //STREAM_READ or STREAM_WRITE
160 unsigned int cache_pid;
161 void* cache_data;
162 void* priv; // used for DVD, TV, RTSP etc
163 char* url; // strdup() of filename/url
164 char *lavf_type; // name of expected demuxer type for lavf
165 struct MPOpts *opts;
166 #ifdef CONFIG_NETWORKING
167 streaming_ctrl_t *streaming_ctrl;
168 #endif
169 unsigned char buffer[STREAM_BUFFER_SIZE>VCD_SECTOR_SIZE?STREAM_BUFFER_SIZE:VCD_SECTOR_SIZE];
170 } stream_t;
172 #ifdef CONFIG_NETWORKING
173 #include "network.h"
174 #endif
176 int stream_fill_buffer(stream_t *s);
177 int stream_seek_long(stream_t *s, off_t pos);
179 #ifdef CONFIG_STREAM_CACHE
180 int stream_enable_cache(stream_t *stream,int size,int min,int prefill);
181 int cache_stream_fill_buffer(stream_t *s);
182 int cache_stream_seek_long(stream_t *s,off_t pos);
183 #else
184 // no cache, define wrappers:
185 #define cache_stream_fill_buffer(x) stream_fill_buffer(x)
186 #define cache_stream_seek_long(x,y) stream_seek_long(x,y)
187 #define stream_enable_cache(x,y,z,w) 1
188 #endif
189 int stream_write_buffer(stream_t *s, unsigned char *buf, int len);
191 inline static int stream_read_char(stream_t *s){
192 return (s->buf_pos<s->buf_len)?s->buffer[s->buf_pos++]:
193 (cache_stream_fill_buffer(s)?s->buffer[s->buf_pos++]:-256);
194 // if(s->buf_pos<s->buf_len) return s->buffer[s->buf_pos++];
195 // stream_fill_buffer(s);
196 // if(s->buf_pos<s->buf_len) return s->buffer[s->buf_pos++];
197 // return 0; // EOF
200 inline static unsigned int stream_read_word(stream_t *s){
201 int x,y;
202 x=stream_read_char(s);
203 y=stream_read_char(s);
204 return (x<<8)|y;
207 inline static unsigned int stream_read_dword(stream_t *s){
208 unsigned int y;
209 y=stream_read_char(s);
210 y=(y<<8)|stream_read_char(s);
211 y=(y<<8)|stream_read_char(s);
212 y=(y<<8)|stream_read_char(s);
213 return y;
216 #define stream_read_fourcc stream_read_dword_le
218 inline static unsigned int stream_read_word_le(stream_t *s){
219 int x,y;
220 x=stream_read_char(s);
221 y=stream_read_char(s);
222 return (y<<8)|x;
225 inline static unsigned int stream_read_dword_le(stream_t *s){
226 unsigned int y;
227 y=stream_read_char(s);
228 y|=stream_read_char(s)<<8;
229 y|=stream_read_char(s)<<16;
230 y|=stream_read_char(s)<<24;
231 return y;
234 inline static uint64_t stream_read_qword(stream_t *s){
235 uint64_t y;
236 y = stream_read_char(s);
237 y=(y<<8)|stream_read_char(s);
238 y=(y<<8)|stream_read_char(s);
239 y=(y<<8)|stream_read_char(s);
240 y=(y<<8)|stream_read_char(s);
241 y=(y<<8)|stream_read_char(s);
242 y=(y<<8)|stream_read_char(s);
243 y=(y<<8)|stream_read_char(s);
244 return y;
247 inline static uint64_t stream_read_qword_le(stream_t *s){
248 uint64_t y;
249 y = stream_read_dword_le(s);
250 y|=(uint64_t)stream_read_dword_le(s)<<32;
251 return y;
254 inline static unsigned int stream_read_int24(stream_t *s){
255 unsigned int y;
256 y = stream_read_char(s);
257 y=(y<<8)|stream_read_char(s);
258 y=(y<<8)|stream_read_char(s);
259 return y;
262 inline static int stream_read(stream_t *s,char* mem,int total){
263 int len=total;
264 while(len>0){
265 int x;
266 x=s->buf_len-s->buf_pos;
267 if(x==0){
268 if(!cache_stream_fill_buffer(s)) return total-len; // EOF
269 x=s->buf_len-s->buf_pos;
271 if(s->buf_pos>s->buf_len) mp_msg(MSGT_DEMUX, MSGL_WARN, "stream_read: WARNING! s->buf_pos>s->buf_len\n");
272 if(x>len) x=len;
273 memcpy(mem,&s->buffer[s->buf_pos],x);
274 s->buf_pos+=x; mem+=x; len-=x;
276 return total;
279 unsigned char* stream_read_line(stream_t *s,unsigned char* mem, int max, int utf16);
281 inline static int stream_eof(stream_t *s){
282 return s->eof;
285 inline static off_t stream_tell(stream_t *s){
286 return s->pos+s->buf_pos-s->buf_len;
289 inline static int stream_seek(stream_t *s,off_t pos){
291 mp_dbg(MSGT_DEMUX, MSGL_DBG3, "seek to 0x%qX\n",(long long)pos);
293 if(pos<s->pos){
294 off_t x=pos-(s->pos-s->buf_len);
295 if(x>=0){
296 s->buf_pos=x;
297 s->eof = 0;
298 // putchar('*');fflush(stdout);
299 return 1;
303 return cache_stream_seek_long(s,pos);
306 inline static int stream_skip(stream_t *s,off_t len){
307 if( len<0 || (len>2*STREAM_BUFFER_SIZE && (s->flags & MP_STREAM_SEEK_FW)) ) {
308 // negative or big skip!
309 return stream_seek(s,stream_tell(s)+len);
311 while(len>0){
312 int x=s->buf_len-s->buf_pos;
313 if(x==0){
314 if(!cache_stream_fill_buffer(s)) return 0; // EOF
315 x=s->buf_len-s->buf_pos;
317 if(x>len) x=len;
318 //memcpy(mem,&s->buf[s->buf_pos],x);
319 s->buf_pos+=x; len-=x;
321 return 1;
324 struct MPOpts;
325 void stream_reset(stream_t *s);
326 int stream_control(stream_t *s, int cmd, void *arg);
327 stream_t* new_stream(int fd,int type);
328 void free_stream(stream_t *s);
329 stream_t* new_memory_stream(unsigned char* data,int len);
330 stream_t *open_stream(const char *filename, struct MPOpts *options,
331 int *file_format);
332 stream_t *open_stream_full(const char *filename,int mode,
333 struct MPOpts *options, int *file_format);
334 stream_t *open_output_stream(const char *filename, struct MPOpts *options);
335 /// Set the callback to be used by libstream to check for user
336 /// interruption during long blocking operations (cache filling, etc).
337 struct input_ctx;
338 void stream_set_interrupt_callback(int (*cb)(struct input_ctx*, int),
339 struct input_ctx *ctx);
340 /// Call the interrupt checking callback if there is one and
341 /// wait for time milliseconds
342 int stream_check_interrupt(int time);
344 extern int bluray_angle;
345 extern int bluray_chapter;
346 extern int dvd_title;
347 extern int dvd_angle;
349 extern char *bluray_device;
350 extern char * audio_stream;
352 typedef struct {
353 int id; // 0 - 31 mpeg; 128 - 159 ac3; 160 - 191 pcm
354 int language;
355 int type;
356 int channels;
357 } stream_language_t;
359 #endif /* MPLAYER_STREAM_H */