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_DEMUXER_H
20 #define MPLAYER_DEMUXER_H
22 #include <sys/types.h>
30 #include "demux_packet.h"
34 #ifdef HAVE_BUILTIN_EXPECT
35 #define likely(x) __builtin_expect((x) != 0, 1)
36 #define unlikely(x) __builtin_expect((x) != 0, 0)
39 #define unlikely(x) (x)
42 #define MAX_PACKS 4096
43 #define MAX_PACK_BYTES 0x8000000 // 128 MiB
46 DEMUXER_TYPE_UNKNOWN
= 0,
51 DEMUXER_TYPE_AVI_NINI
,
64 DEMUXER_TYPE_RAWAUDIO
,
69 DEMUXER_TYPE_RAWVIDEO
,
70 DEMUXER_TYPE_MPEG4_ES
,
74 DEMUXER_TYPE_MATROSKA
,
75 DEMUXER_TYPE_REALAUDIO
,
84 DEMUXER_TYPE_MPEG_PES
,
85 DEMUXER_TYPE_MPEG_GXF
,
87 DEMUXER_TYPE_LAVF_PREFERRED
,
91 /* Values after this are for internal use and can not be selected
92 * as demuxer type by the user (-demuxer option). */
95 DEMUXER_TYPE_DEMUXERS
,
96 DEMUXER_TYPE_PLAYLIST
,
105 // DEMUXER control commands/answers
106 #define DEMUXER_CTRL_NOTIMPL -1
107 #define DEMUXER_CTRL_DONTKNOW 0
108 #define DEMUXER_CTRL_OK 1
109 #define DEMUXER_CTRL_GUESS 2
110 #define DEMUXER_CTRL_GET_TIME_LENGTH 10
111 #define DEMUXER_CTRL_GET_PERCENT_POS 11
112 #define DEMUXER_CTRL_SWITCH_AUDIO 12
113 #define DEMUXER_CTRL_RESYNC 13
114 #define DEMUXER_CTRL_SWITCH_VIDEO 14
115 #define DEMUXER_CTRL_IDENTIFY_PROGRAM 15
116 #define DEMUXER_CTRL_CORRECT_PTS 16
118 #define SEEK_ABSOLUTE (1 << 0)
119 #define SEEK_FACTOR (1 << 1)
120 #define SEEK_FORWARD (1 << 2)
121 #define SEEK_BACKWARD (1 << 3)
123 // demux_lavf can pass lavf buffers using FF_INPUT_BUFFER_PADDING_SIZE instead
124 #define MP_INPUT_BUFFER_PADDING_SIZE 16
126 typedef struct demux_stream
{
127 int buffer_pos
; // current buffer position
128 int buffer_size
; // current buffer size
129 unsigned char *buffer
; // current buffer, never free() it, always use free_demux_packet(buffer_ref);
130 double pts
; // current buffer's pts
131 int pts_bytes
; // number of bytes read after last pts stamp
132 int eof
; // end of demuxed stream? (true if all buffer empty)
133 off_t pos
; // position in the input stream (file)
134 off_t dpos
; // position in the demuxed stream
135 int pack_no
; // serial number of packet
136 bool keyframe
; // keyframe flag of current packet
137 int non_interleaved
; // 1 if this stream is not properly interleaved,
138 // so e.g. subtitle handling must do explicit reads.
140 int packs
; // number of packets in buffer
141 int bytes
; // total bytes of packets in buffer
142 demux_packet_t
*first
; // read to current buffer from here
143 demux_packet_t
*last
; // append new packets from input stream to here
144 demux_packet_t
*current
; // needed for refcounting of the buffer
145 int id
; // stream ID (for multiple audio/video streams)
146 struct demuxer
*demuxer
; // parent demuxer structure (stream handler)
148 struct demux_packet
*asf_packet
; // read asf fragments here
151 unsigned int ss_mul
, ss_div
;
152 // ---- stream header ----
156 typedef struct demuxer_info
{
164 #define MAX_A_STREAMS 256
165 #define MAX_V_STREAMS 256
166 #define MAX_S_STREAMS 256
171 * Demuxer description structure
173 typedef struct demuxer_desc
{
174 const char *info
; // What is it (long name and/or description)
175 const char *name
; // Demuxer name, used with -demuxer switch
176 const char *shortdesc
; // Description printed at demuxer detection
177 const char *author
; // Demuxer author(s)
178 const char *comment
; // Comment, printed with -demuxer help
180 enum demuxer_type type
;
181 // If 1 detection is safe and fast, do it before file extension check
184 // Check if can demux the file, return DEMUXER_TYPE_xxx on success
185 // Mandatory if safe_check == 1, else optional
186 int (*check_file
)(struct demuxer
*demuxer
);
187 /// Get packets from file, return 0 on eof. Mandatory
188 int (*fill_buffer
)(struct demuxer
*demuxer
, struct demux_stream
*ds
);
189 /// Open the demuxer, return demuxer on success, NULL on failure
190 struct demuxer
*(*open
)(struct demuxer
*demuxer
); // Optional
191 /// Close the demuxer
192 void (*close
)(struct demuxer
*demuxer
); // Optional
194 void (*seek
)(struct demuxer
*demuxer
, float rel_seek_secs
,
195 float audio_delay
, int flags
);
196 // Various control functions. Optional
197 int (*control
)(struct demuxer
*demuxer
, int cmd
, void *arg
);
200 typedef struct demux_chapter
206 struct matroska_data
{
207 unsigned char segment_uid
[16];
208 // Ordered chapter information if any
209 struct matroska_chapter
{
212 bool has_segment_uid
;
213 unsigned char segment_uid
[16];
216 int num_ordered_chapters
;
219 typedef struct demux_attachment
224 unsigned int data_size
;
225 } demux_attachment_t
;
227 struct demuxer_params
{
228 unsigned char (*matroska_wanted_uids
)[16];
231 typedef struct demuxer
{
232 const demuxer_desc_t
*desc
; ///< Demuxer description structure
233 const char *filetype
; // format name when not identified by demuxer (libavformat)
234 off_t filepos
; // input stream current pos.
237 struct stream
*stream
;
238 double stream_pts
; // current stream pts, if applicable (e.g. dvd)
239 double reference_clock
;
240 char *filename
; // Needed by avs_check_file
241 int synced
; // stream synced (used by mpeg)
242 enum demuxer_type type
;
243 /* Normally the file_format field is just a copy of the type field above.
244 * There are 2 exceptions I noticed. Internal demux_avi may force
245 * ->type to DEMUXER_TYPE_AVI_[NI|NINI] while leaving ->file_format at
246 * DEMUXER_TYPE_AVI. Internal demux_mov may set ->type to
247 * DEMUXER_TYPE_PLAYLIST and also return that from the check function
248 * or not (looks potentially buggy). */
249 enum demuxer_type file_format
;
250 int seekable
; // flag
251 /* Set if using absolute seeks for small movements is OK (no pts resets
252 * that would make pts ambigious, preferably supports back/forward flags */
254 enum timestamp_type timestamp_type
;
256 struct demux_stream
*audio
; // audio buffer/demuxer
257 struct demux_stream
*video
; // video buffer/demuxer
258 struct demux_stream
*sub
; // dvd subtitle buffer/demuxer
261 struct sh_audio
*a_streams
[MAX_A_STREAMS
];
262 struct sh_video
*v_streams
[MAX_V_STREAMS
];
263 struct sh_sub
*s_streams
[MAX_S_STREAMS
];
265 // teletext decoder private data, if demuxer stream contains teletext
268 struct demux_chapter
*chapters
;
271 struct demux_attachment
*attachments
;
274 struct matroska_data matroska_data
;
275 // for trivial demuxers which just read the whole file for codec to use
276 struct bstr file_contents
;
278 void *priv
; // demuxer-specific internal data
279 char **info
; // metadata
281 struct demuxer_params
*params
;
285 int progid
; //program id
286 int aid
, vid
, sid
; //audio, video and subtitle id
289 struct demux_packet
*new_demux_packet(size_t len
);
290 // data must already have suitable padding
291 struct demux_packet
*new_demux_packet_fromdata(void *data
, size_t len
);
292 void resize_demux_packet(struct demux_packet
*dp
, size_t len
);
293 struct demux_packet
*clone_demux_packet(struct demux_packet
*pack
);
294 void free_demux_packet(struct demux_packet
*dp
);
297 #define SIZE_MAX ((size_t)-1)
300 static inline void *realloc_struct(void *ptr
, size_t nmemb
, size_t size
)
302 if (nmemb
> SIZE_MAX
/ size
) {
306 return realloc(ptr
, nmemb
* size
);
309 struct demuxer
*new_demuxer(struct MPOpts
*opts
, struct stream
*stream
,
310 int type
, int a_id
, int v_id
, int s_id
,
312 void free_demuxer(struct demuxer
*demuxer
);
314 void ds_add_packet(struct demux_stream
*ds
, struct demux_packet
*dp
);
315 void ds_read_packet(struct demux_stream
*ds
, struct stream
*stream
, int len
,
316 double pts
, off_t pos
, bool keyframe
);
318 int demux_fill_buffer(struct demuxer
*demux
, struct demux_stream
*ds
);
319 int ds_fill_buffer(struct demux_stream
*ds
);
321 static inline off_t
ds_tell(struct demux_stream
*ds
)
323 return (ds
->dpos
- ds
->buffer_size
) + ds
->buffer_pos
;
326 static inline int ds_tell_pts(struct demux_stream
*ds
)
328 return (ds
->pts_bytes
- ds
->buffer_size
) + ds
->buffer_pos
;
331 int demux_read_data(struct demux_stream
*ds
, unsigned char *mem
, int len
);
332 int demux_pattern_3(struct demux_stream
*ds
, unsigned char *mem
, int maxlen
,
333 int *read
, uint32_t pattern
);
335 #define demux_peekc(ds) ( \
336 (likely(ds->buffer_pos<ds->buffer_size)) ? ds->buffer[ds->buffer_pos] \
337 : ((unlikely(!ds_fill_buffer(ds))) ? (-1) : ds->buffer[ds->buffer_pos]))
338 #define demux_getc(ds) ( \
339 (likely(ds->buffer_pos<ds->buffer_size)) ? ds->buffer[ds->buffer_pos++] \
340 : ((unlikely(!ds_fill_buffer(ds))) ? (-1) : ds->buffer[ds->buffer_pos++]))
342 void ds_free_packs(struct demux_stream
*ds
);
343 int ds_get_packet(struct demux_stream
*ds
, unsigned char **start
);
344 int ds_get_packet_pts(struct demux_stream
*ds
, unsigned char **start
,
346 int ds_get_packet_sub(struct demux_stream
*ds
, unsigned char **start
);
347 struct demux_packet
*ds_get_packet2(struct demux_stream
*ds
, bool repeat_last
);
348 double ds_get_next_pts(struct demux_stream
*ds
);
349 int ds_parse(struct demux_stream
*sh
, uint8_t **buffer
, int *len
, double pts
,
351 void ds_clear_parser(struct demux_stream
*sh
);
353 static inline int avi_stream_id(unsigned int id
)
359 return 100; // invalid ID
363 struct demuxer
*demux_open(struct MPOpts
*opts
, struct stream
*stream
,
364 int file_format
, int aid
, int vid
, int sid
,
367 struct demuxer
*demux_open_withparams(struct MPOpts
*opts
,
368 struct stream
*stream
, int file_format
, int aid
, int vid
, int sid
,
369 char *filename
, struct demuxer_params
*params
);
371 void demux_flush(struct demuxer
*demuxer
);
372 int demux_seek(struct demuxer
*demuxer
, float rel_seek_secs
, float audio_delay
,
374 struct demuxer
*new_demuxers_demuxer(struct demuxer
*vd
, struct demuxer
*ad
,
377 // AVI demuxer params:
378 extern int index_mode
; // -1=untouched 0=don't use index 1=use (generate) index
379 extern char *index_file_save
, *index_file_load
;
381 extern int pts_from_bps
;
383 int demux_info_add(struct demuxer
*demuxer
, const char *opt
, const char *param
);
384 int demux_info_add_bstr(struct demuxer
*demuxer
, struct bstr opt
,
386 char *demux_info_get(struct demuxer
*demuxer
, const char *opt
);
387 int demux_info_print(struct demuxer
*demuxer
);
388 int demux_control(struct demuxer
*demuxer
, int cmd
, void *arg
);
390 int demuxer_switch_audio(struct demuxer
*demuxer
, int index
);
391 int demuxer_switch_video(struct demuxer
*demuxer
, int index
);
393 int demuxer_type_by_filename(char *filename
);
395 void demuxer_help(void);
397 int demuxer_add_attachment(struct demuxer
*demuxer
, struct bstr name
,
398 struct bstr type
, struct bstr data
);
399 int demuxer_add_chapter(struct demuxer
*demuxer
, struct bstr name
,
400 uint64_t start
, uint64_t end
);
401 int demuxer_seek_chapter(struct demuxer
*demuxer
, int chapter
,
404 /// Get current chapter index if available.
405 int demuxer_get_current_chapter(struct demuxer
*demuxer
, double time_now
);
406 /// Get chapter name by index if available.
407 char *demuxer_chapter_name(struct demuxer
*demuxer
, int chapter
);
408 /// Get chapter start time and end time by index if available.
409 float demuxer_chapter_time(struct demuxer
*demuxer
, int chapter
, float *end
);
410 /// Get total chapter number.
411 int demuxer_chapter_count(struct demuxer
*demuxer
);
412 /// Get current angle index.
413 int demuxer_get_current_angle(struct demuxer
*demuxer
);
415 int demuxer_set_angle(struct demuxer
*demuxer
, int angle
);
416 /// Get number of angles.
417 int demuxer_angles_count(struct demuxer
*demuxer
);
419 /* Get the index of a track.
420 * lang is a string list, NULL is same as empty list
421 * Sort tracks based on the following criteria:
422 * 1) earlier match in lang list, or last no match
423 * 2) track is marked default (default wins)
424 * 3) track number (lower wins)
425 * For audio, select best track according to these criteria; only return -1
426 * if there are no tracks at all.
427 * For subs, select best track according to the same criteria, but return -1
428 * if all tracks are no-lang-match, not-default.
430 int demuxer_audio_track_by_lang_and_default(struct demuxer
*d
, char **langt
);
431 int demuxer_sub_track_by_lang_and_default(struct demuxer
*d
, char **langt
);
433 #endif /* MPLAYER_DEMUXER_H */