FFmpeg
internal.h
Go to the documentation of this file.
1 /*
2  * copyright (c) 2001 Fabrice Bellard
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
21 #ifndef AVFORMAT_INTERNAL_H
22 #define AVFORMAT_INTERNAL_H
23 
24 #include <stdint.h>
25 
26 #include "libavcodec/avcodec.h"
27 #include "libavcodec/bsf.h"
29 
30 #include "avformat.h"
31 #include "os_support.h"
32 
33 #define MAX_URL_SIZE 4096
34 
35 /** size of probe buffer, for guessing file type from file contents */
36 #define PROBE_BUF_MIN 2048
37 #define PROBE_BUF_MAX (1 << 20)
38 
39 #ifdef DEBUG
40 # define hex_dump_debug(class, buf, size) av_hex_dump_log(class, AV_LOG_DEBUG, buf, size)
41 #else
42 # define hex_dump_debug(class, buf, size) do { if (0) av_hex_dump_log(class, AV_LOG_DEBUG, buf, size); } while(0)
43 #endif
44 
45 /**
46  * For an AVInputFormat with this flag set read_close() needs to be called
47  * by the caller upon read_header() failure.
48  */
49 #define FF_FMT_INIT_CLEANUP (1 << 0)
50 
51 typedef struct AVCodecTag {
52  enum AVCodecID id;
53  unsigned int tag;
54 } AVCodecTag;
55 
56 typedef struct CodecMime{
57  char str[32];
58  enum AVCodecID id;
59 } CodecMime;
60 
61 /*************************************************/
62 /* fractional numbers for exact pts handling */
63 
64 /**
65  * The exact value of the fractional number is: 'val + num / den'.
66  * num is assumed to be 0 <= num < den.
67  */
68 typedef struct FFFrac {
69  int64_t val, num, den;
70 } FFFrac;
71 
72 
73 typedef struct FFFormatContext {
74  /**
75  * The public context.
76  */
78 
79  /**
80  * Number of streams relevant for interleaving.
81  * Muxing only.
82  */
84 
85  /**
86  * The interleavement function in use. Always set for muxers.
87  */
89  int flush, int has_packet);
90 
91  /**
92  * This buffer is only needed when packets were already buffered but
93  * not decoded, for example to get the codec parameters in MPEG
94  * streams.
95  */
97 
98  /* av_seek_frame() support */
99  int64_t data_offset; /**< offset of the first packet */
100 
101  /**
102  * Raw packets from the demuxer, prior to parsing and decoding.
103  * This buffer is used for buffering packets until the codec can
104  * be identified, as parsing cannot be done without knowing the
105  * codec.
106  */
108  /**
109  * Packets split by the parser get queued here.
110  */
112  /**
113  * The generic code uses this as a temporary packet
114  * to parse packets or for muxing, especially flushing.
115  * For demuxers, it may also be used for other means
116  * for short periods that are guaranteed not to overlap
117  * with calls to av_read_frame() (or ff_read_packet())
118  * or with each other.
119  * It may be used by demuxers as a replacement for
120  * stack packets (unless they call one of the aforementioned
121  * functions with their own AVFormatContext).
122  * Every user has to ensure that this packet is blank
123  * after using it.
124  */
126 
127  /**
128  * Used to hold temporary packets for the generic demuxing code.
129  * When muxing, it may be used by muxers to hold packets (even
130  * permanent ones).
131  */
133  /**
134  * Sum of the size of packets in raw_packet_buffer, in bytes.
135  */
137 
138  /**
139  * Offset to remap timestamps to be non-negative.
140  * Expressed in timebase units.
141  * @see AVStream.mux_ts_offset
142  */
143  int64_t offset;
144 
145  /**
146  * Timebase for the timestamp offset.
147  */
149 
150 #if FF_API_COMPUTE_PKT_FIELDS2
151  int missing_ts_warning;
152 #endif
153 
155 
157 
158  /**
159  * Timestamp of the end of the shortest stream.
160  */
161  int64_t shortest_end;
162 
163  /**
164  * Whether or not avformat_init_output has already been called
165  */
167 
168  /**
169  * Whether or not avformat_init_output fully initialized streams
170  */
172 
173  /**
174  * ID3v2 tag useful for MP3 demuxing
175  */
177 
178  /*
179  * Prefer the codec framerate for avg_frame_rate computation.
180  */
182 
183  /**
184  * Set if chapter ids are strictly monotonic.
185  */
188 
190 {
191  return (FFFormatContext*)s;
192 }
193 
194 typedef struct FFStream {
195  /**
196  * The public context.
197  */
199 
200  /**
201  * Set to 1 if the codec allows reordering, so pts can be different
202  * from dts.
203  */
204  int reorder;
205 
206  /**
207  * bitstream filter to run on stream
208  * - encoding: Set by muxer using ff_stream_add_bitstream_filter
209  * - decoding: unused
210  */
212 
213  /**
214  * Whether or not check_bitstream should still be run on each packet
215  */
217 
218  /**
219  * The codec context used by avformat_find_stream_info, the parser, etc.
220  */
222  /**
223  * 1 if avctx has been initialized with the values from the codec parameters
224  */
226 
227  /* the context for extracting extradata in find_stream_info()
228  * inited=1/bsf=NULL signals that extracting is not possible (codec not
229  * supported) */
230  struct {
232  int inited;
234 
235  /**
236  * Whether the internal avctx needs to be updated from codecpar (after a late change to codecpar)
237  */
239 
241 
243 
244 #define MAX_STD_TIMEBASES (30*12+30+3+6)
245  /**
246  * Stream information used internally by avformat_find_stream_info()
247  */
248  struct {
249  int64_t last_dts;
250  int64_t duration_gcd;
257 
258  /**
259  * 0 -> decoder has not been searched for yet.
260  * >0 -> decoder found
261  * <0 -> decoder with codec_id == -found_decoder has not been found
262  */
264 
265  int64_t last_duration;
266 
267  /**
268  * Those are used for average framerate estimation.
269  */
270  int64_t fps_first_dts;
272  int64_t fps_last_dts;
274 
275  } *info;
276 
277  AVIndexEntry *index_entries; /**< Only used if the format does not
278  support seeking natively. */
281 
284 
285  /**
286  * stream probing state
287  * -1 -> probing finished
288  * 0 -> no probing requested
289  * rest -> perform probing with request_probe being the minimum score to accept.
290  */
292  /**
293  * Indicates that everything up to the next keyframe
294  * should be discarded.
295  */
297 
298  /**
299  * Number of samples to skip at the start of the frame decoded from the next packet.
300  */
302 
303  /**
304  * If not 0, the number of samples that should be skipped from the start of
305  * the stream (the samples are removed from packets with pts==0, which also
306  * assumes negative timestamps do not happen).
307  * Intended for use with formats such as mp3 with ad-hoc gapless audio
308  * support.
309  */
311 
312  /**
313  * If not 0, the first audio sample that should be discarded from the stream.
314  * This is broken by design (needs global sample count), but can't be
315  * avoided for broken by design formats such as mp3 with ad-hoc gapless
316  * audio support.
317  */
319 
320  /**
321  * The sample after last sample that is intended to be discarded after
322  * first_discard_sample. Works on frame boundaries only. Used to prevent
323  * early EOF if the gapless info is broken (considered concatenated mp3s).
324  */
326 
327  /**
328  * Number of internally decoded frames, used internally in libavformat, do not access
329  * its lifetime differs from info which is why it is not in that structure.
330  */
332 
333  /**
334  * Timestamp offset added to timestamps before muxing
335  */
336  int64_t mux_ts_offset;
337 
338  /**
339  * Internal data to check for wrapping of the time stamp
340  */
342 
343  /**
344  * Options for behavior, when a wrap is detected.
345  *
346  * Defined by AV_PTS_WRAP_ values.
347  *
348  * If correction is enabled, there are two possibilities:
349  * If the first time stamp is near the wrap point, the wrap offset
350  * will be subtracted, which will create negative time stamps.
351  * Otherwise the offset will be added.
352  */
354 
355  /**
356  * Internal data to prevent doing update_initial_durations() twice
357  */
359 
360 #define MAX_REORDER_DELAY 16
361 
362  /**
363  * Internal data to generate dts from pts
364  */
367 
369 
370  /**
371  * Internal data to analyze DTS and detect faulty mpeg streams
372  */
374  uint8_t dts_ordered;
375  uint8_t dts_misordered;
376 
377  /**
378  * Internal data to inject global side data
379  */
381 
382  /**
383  * display aspect ratio (0 if unknown)
384  * - encoding: unused
385  * - decoding: Set by libavformat to calculate sample_aspect_ratio internally
386  */
388 
390 
391  /**
392  * last packet in packet_buffer for this stream when muxing.
393  */
395 
396  int64_t last_IP_pts;
398 
399  /**
400  * Number of packets to buffer for codec probing
401  */
403 
404  /* av_read_frame() support */
407 
408  /**
409  * Number of frames that have been demuxed during avformat_find_stream_info()
410  */
412 
413  /**
414  * Stream Identifier
415  * This is the MPEG-TS stream identifier +1
416  * 0 means unknown
417  */
419 
420  // Timestamp generation support:
421  /**
422  * Timestamp corresponding to the last dts sync point.
423  *
424  * Initialized when AVCodecParserContext.dts_sync_point >= 0 and
425  * a DTS is received from the underlying container. Otherwise set to
426  * AV_NOPTS_VALUE by default.
427  */
428  int64_t first_dts;
429  int64_t cur_dts;
430 } FFStream;
431 
433 {
434  return (FFStream*)st;
435 }
436 
437 static av_always_inline const FFStream *cffstream(const AVStream *st)
438 {
439  return (FFStream*)st;
440 }
441 
443 
444 #ifdef __GNUC__
445 #define dynarray_add(tab, nb_ptr, elem)\
446 do {\
447  __typeof__(tab) _tab = (tab);\
448  __typeof__(elem) _elem = (elem);\
449  (void)sizeof(**_tab == _elem); /* check that types are compatible */\
450  av_dynarray_add(_tab, nb_ptr, _elem);\
451 } while(0)
452 #else
453 #define dynarray_add(tab, nb_ptr, elem)\
454 do {\
455  av_dynarray_add((tab), nb_ptr, (elem));\
456 } while(0)
457 #endif
458 
459 #define RELATIVE_TS_BASE (INT64_MAX - (1LL << 48))
460 
461 static av_always_inline int is_relative(int64_t ts)
462 {
463  return ts > (RELATIVE_TS_BASE - (1LL << 48));
464 }
465 
466 /**
467  * Wrap a given time stamp, if there is an indication for an overflow
468  *
469  * @param st stream
470  * @param timestamp the time stamp to wrap
471  * @return resulting time stamp
472  */
473 int64_t ff_wrap_timestamp(const AVStream *st, int64_t timestamp);
474 
476 
477 /**
478  * Automatically create sub-directories
479  *
480  * @param path will create sub-directories by path
481  * @return 0, or < 0 on error
482  */
483 int ff_mkdir_p(const char *path);
484 
485 /**
486  * Write hexadecimal string corresponding to given binary data. The string
487  * is zero-terminated.
488  *
489  * @param buf the output string is written here;
490  * needs to be at least 2 * size + 1 bytes long.
491  * @param src the input data to be transformed.
492  * @param size the size (in byte) of src.
493  * @param lowercase determines whether to use the range [0-9a-f] or [0-9A-F].
494  * @return buf.
495  */
496 char *ff_data_to_hex(char *buf, const uint8_t *src, int size, int lowercase);
497 
498 /**
499  * Parse a string of hexadecimal strings. Any space between the hexadecimal
500  * digits is ignored.
501  *
502  * @param data if non-null, the parsed data is written to this pointer
503  * @param p the string to parse
504  * @return the number of bytes written (or to be written, if data is null)
505  */
506 int ff_hex_to_data(uint8_t *data, const char *p);
507 
508 /**
509  * Add packet to an AVFormatContext's packet_buffer list, determining its
510  * interleaved position using compare() function argument.
511  * @return 0 on success, < 0 on error. pkt will always be blank on return.
512  */
514  int (*compare)(AVFormatContext *, const AVPacket *, const AVPacket *));
515 
517 
518 #define NTP_OFFSET 2208988800ULL
519 #define NTP_OFFSET_US (NTP_OFFSET * 1000000ULL)
520 
521 /** Get the current time since NTP epoch in microseconds. */
522 uint64_t ff_ntp_time(void);
523 
524 /**
525  * Get the NTP time stamp formatted as per the RFC-5905.
526  *
527  * @param ntp_time NTP time in micro seconds (since NTP epoch)
528  * @return the formatted NTP time stamp
529  */
530 uint64_t ff_get_formatted_ntp_time(uint64_t ntp_time_us);
531 
532 /**
533  * Parse the NTP time in micro seconds (since NTP epoch).
534  *
535  * @param ntp_ts NTP time stamp formatted as per the RFC-5905.
536  * @return the time in micro seconds (since NTP epoch)
537  */
538 uint64_t ff_parse_ntp_time(uint64_t ntp_ts);
539 
540 /**
541  * Append the media-specific SDP fragment for the media stream c
542  * to the buffer buff.
543  *
544  * Note, the buffer needs to be initialized, since it is appended to
545  * existing content.
546  *
547  * @param buff the buffer to append the SDP fragment to
548  * @param size the size of the buff buffer
549  * @param st the AVStream of the media to describe
550  * @param idx the global stream index
551  * @param dest_addr the destination address of the media stream, may be NULL
552  * @param dest_type the destination address type, may be NULL
553  * @param port the destination port of the media stream, 0 if unknown
554  * @param ttl the time to live of the stream, 0 if not multicast
555  * @param fmt the AVFormatContext, which might contain options modifying
556  * the generated SDP
557  * @return 0 on success, a negative error code on failure
558  */
559 int ff_sdp_write_media(char *buff, int size, const AVStream *st, int idx,
560  const char *dest_addr, const char *dest_type,
561  int port, int ttl, AVFormatContext *fmt);
562 
563 /**
564  * Write a packet to another muxer than the one the user originally
565  * intended. Useful when chaining muxers, where one muxer internally
566  * writes a received packet to another muxer.
567  *
568  * @param dst the muxer to write the packet to
569  * @param dst_stream the stream index within dst to write the packet to
570  * @param pkt the packet to be written. It will be returned blank when
571  * av_interleaved_write_frame() is used, unchanged otherwise.
572  * @param src the muxer the packet originally was intended for
573  * @param interleave 0->use av_write_frame, 1->av_interleaved_write_frame
574  * @return the value av_write_frame returned
575  */
576 int ff_write_chained(AVFormatContext *dst, int dst_stream, AVPacket *pkt,
578 
579 /**
580  * Read a whole line of text from AVIOContext. Stop reading after reaching
581  * either a \\n, a \\0 or EOF. The returned string is always \\0-terminated,
582  * and may be truncated if the buffer is too small.
583  *
584  * @param s the read-only AVIOContext
585  * @param buf buffer to store the read line
586  * @param maxlen size of the buffer
587  * @return the length of the string written in the buffer, not including the
588  * final \\0
589  */
590 int ff_get_line(AVIOContext *s, char *buf, int maxlen);
591 
592 /**
593  * Same as ff_get_line but strip the white-space characters in the text tail
594  *
595  * @param s the read-only AVIOContext
596  * @param buf buffer to store the read line
597  * @param maxlen size of the buffer
598  * @return the length of the string written in the buffer
599  */
600 int ff_get_chomp_line(AVIOContext *s, char *buf, int maxlen);
601 
602 #define SPACE_CHARS " \t\r\n"
603 
604 /**
605  * Callback function type for ff_parse_key_value.
606  *
607  * @param key a pointer to the key
608  * @param key_len the number of bytes that belong to the key, including the '='
609  * char
610  * @param dest return the destination pointer for the value in *dest, may
611  * be null to ignore the value
612  * @param dest_len the length of the *dest buffer
613  */
614 typedef void (*ff_parse_key_val_cb)(void *context, const char *key,
615  int key_len, char **dest, int *dest_len);
616 /**
617  * Parse a string with comma-separated key=value pairs. The value strings
618  * may be quoted and may contain escaped characters within quoted strings.
619  *
620  * @param str the string to parse
621  * @param callback_get_buf function that returns where to store the
622  * unescaped value string.
623  * @param context the opaque context pointer to pass to callback_get_buf
624  */
625 void ff_parse_key_value(const char *str, ff_parse_key_val_cb callback_get_buf,
626  void *context);
627 
628 /**
629  * Find stream index based on format-specific stream ID
630  * @return stream index, or < 0 on error
631  */
632 int ff_find_stream_index(const AVFormatContext *s, int id);
633 
634 /**
635  * Internal version of av_index_search_timestamp
636  */
637 int ff_index_search_timestamp(const AVIndexEntry *entries, int nb_entries,
638  int64_t wanted_timestamp, int flags);
639 
640 /**
641  * Internal version of av_add_index_entry
642  */
643 int ff_add_index_entry(AVIndexEntry **index_entries,
644  int *nb_index_entries,
645  unsigned int *index_entries_allocated_size,
646  int64_t pos, int64_t timestamp, int size, int distance, int flags);
647 
648 void ff_configure_buffers_for_index(AVFormatContext *s, int64_t time_tolerance);
649 
650 /**
651  * Add a new chapter.
652  *
653  * @param s media file handle
654  * @param id unique ID for this chapter
655  * @param start chapter start time in time_base units
656  * @param end chapter end time in time_base units
657  * @param title chapter title
658  *
659  * @return AVChapter or NULL on error
660  */
661 AVChapter *avpriv_new_chapter(AVFormatContext *s, int64_t id, AVRational time_base,
662  int64_t start, int64_t end, const char *title);
663 
664 /**
665  * Ensure the index uses less memory than the maximum specified in
666  * AVFormatContext.max_index_size by discarding entries if it grows
667  * too large.
668  */
669 void ff_reduce_index(AVFormatContext *s, int stream_index);
670 
671 enum AVCodecID ff_guess_image2_codec(const char *filename);
672 
674  enum AVCodecID codec_id);
675 /**
676  * Perform a binary search using av_index_search_timestamp() and
677  * AVInputFormat.read_timestamp().
678  *
679  * @param target_ts target timestamp in the time base of the given stream
680  * @param stream_index stream number
681  */
682 int ff_seek_frame_binary(AVFormatContext *s, int stream_index,
683  int64_t target_ts, int flags);
684 
685 /**
686  * Update cur_dts of all streams based on the given timestamp and AVStream.
687  *
688  * Stream ref_st unchanged, others set cur_dts in their native time base.
689  * Only needed for timestamp wrapping or if (dts not set and pts!=dts).
690  * @param timestamp new dts expressed in time_base of param ref_st
691  * @param ref_st reference stream giving time_base of param timestamp
692  */
693 void avpriv_update_cur_dts(AVFormatContext *s, AVStream *ref_st, int64_t timestamp);
694 
695 int ff_find_last_ts(AVFormatContext *s, int stream_index, int64_t *ts, int64_t *pos,
696  int64_t (*read_timestamp)(struct AVFormatContext *, int , int64_t *, int64_t ));
697 
698 /**
699  * Perform a binary search using read_timestamp().
700  *
701  * @param target_ts target timestamp in the time base of the given stream
702  * @param stream_index stream number
703  */
704 int64_t ff_gen_search(AVFormatContext *s, int stream_index,
705  int64_t target_ts, int64_t pos_min,
706  int64_t pos_max, int64_t pos_limit,
707  int64_t ts_min, int64_t ts_max,
708  int flags, int64_t *ts_ret,
709  int64_t (*read_timestamp)(struct AVFormatContext *, int , int64_t *, int64_t ));
710 
711 /**
712  * Set the time base and wrapping info for a given stream. This will be used
713  * to interpret the stream's timestamps. If the new time base is invalid
714  * (numerator or denominator are non-positive), it leaves the stream
715  * unchanged.
716  *
717  * @param st stream
718  * @param pts_wrap_bits number of bits effectively used by the pts
719  * (used for wrap control)
720  * @param pts_num time base numerator
721  * @param pts_den time base denominator
722  */
723 void avpriv_set_pts_info(AVStream *st, int pts_wrap_bits,
724  unsigned int pts_num, unsigned int pts_den);
725 
726 /**
727  * Add side data to a packet for changing parameters to the given values.
728  * Parameters set to 0 aren't included in the change.
729  */
731  uint64_t channel_layout, int32_t sample_rate,
733 
734 /**
735  * Set the timebase for each stream from the corresponding codec timebase and
736  * print it.
737  */
739 
740 /**
741  * Read a transport packet from a media file.
742  *
743  * @param s media file handle
744  * @param pkt is filled
745  * @return 0 if OK, AVERROR_xxx on error
746  */
748 
749 /**
750  * Add an attached pic to an AVStream.
751  *
752  * @param st if set, the stream to add the attached pic to;
753  * if unset, a new stream will be added to s.
754  * @param pb AVIOContext to read data from if buf is unset.
755  * @param buf if set, it contains the data and size information to be used
756  * for the attached pic; if unset, data is read from pb.
757  * @param size the size of the data to read if buf is unset.
758  *
759  * @return 0 on success, < 0 on error. On error, this function removes
760  * the stream it has added (if any).
761  */
763  AVBufferRef **buf, int size);
764 
765 /**
766  * Interleave an AVPacket per dts so it can be muxed.
767  * See the documentation of AVOutputFormat.interleave_packet for details.
768  */
770  int flush, int has_packet);
771 
772 /**
773  * Interleave packets directly in the order in which they arrive
774  * without any sort of buffering.
775  */
777  int flush, int has_packet);
778 
780 
781 unsigned int ff_codec_get_tag(const AVCodecTag *tags, enum AVCodecID id);
782 
783 enum AVCodecID ff_codec_get_id(const AVCodecTag *tags, unsigned int tag);
784 
785 int ff_is_intra_only(enum AVCodecID id);
786 
787 /**
788  * Select a PCM codec based on the given parameters.
789  *
790  * @param bps bits-per-sample
791  * @param flt floating-point
792  * @param be big-endian
793  * @param sflags signed flags. each bit corresponds to one byte of bit depth.
794  * e.g. the 1st bit indicates if 8-bit should be signed or
795  * unsigned, the 2nd bit indicates if 16-bit should be signed or
796  * unsigned, etc... This is useful for formats such as WAVE where
797  * only 8-bit is unsigned and all other bit depths are signed.
798  * @return a PCM codec id or AV_CODEC_ID_NONE
799  */
800 enum AVCodecID ff_get_pcm_codec_id(int bps, int flt, int be, int sflags);
801 
802 /**
803  * Chooses a timebase for muxing the specified stream.
804  *
805  * The chosen timebase allows sample accurate timestamps based
806  * on the framerate or sample rate for audio streams. It also is
807  * at least as precise as 1/min_precision would be.
808  */
809 AVRational ff_choose_timebase(AVFormatContext *s, AVStream *st, int min_precision);
810 
811 /**
812  * Chooses a timebase for muxing the specified stream.
813  */
815 
816 /**
817  * Generate standard extradata for AVC-Intra based on width/height and field
818  * order.
819  */
821 
822 /**
823  * Add a bitstream filter to a stream.
824  *
825  * @param st output stream to add a filter to
826  * @param name the name of the filter to add
827  * @param args filter-specific argument string
828  * @return >0 on success;
829  * AVERROR code on failure
830  */
831 int ff_stream_add_bitstream_filter(AVStream *st, const char *name, const char *args);
832 
833 /**
834  * Copy encoding parameters from source to destination stream
835  *
836  * @param dst pointer to destination AVStream
837  * @param src pointer to source AVStream
838  * @return >=0 on success, AVERROR code on error
839  */
841 
842 /**
843  * Copy side data from source to destination stream
844  *
845  * @param dst pointer to destination AVStream
846  * @param src pointer to source AVStream
847  * @return >=0 on success, AVERROR code on error
848  */
850 
851 /**
852  * Wrap ffurl_move() and log if error happens.
853  *
854  * @param url_src source path
855  * @param url_dst destination path
856  * @return 0 or AVERROR on failure
857  */
858 int ff_rename(const char *url_src, const char *url_dst, void *logctx);
859 
860 /**
861  * Allocate extradata with additional AV_INPUT_BUFFER_PADDING_SIZE at end
862  * which is always set to 0.
863  *
864  * Previously allocated extradata in par will be freed.
865  *
866  * @param size size of extradata
867  * @return 0 if OK, AVERROR_xxx on error
868  */
870 
871 /**
872  * Allocate extradata with additional AV_INPUT_BUFFER_PADDING_SIZE at end
873  * which is always set to 0 and fill it from pb.
874  *
875  * @param size size of extradata
876  * @return >= 0 if OK, AVERROR_xxx on error
877  */
879 
880 /**
881  * add frame for rfps calculation.
882  *
883  * @param dts timestamp of the i-th frame
884  * @return 0 if OK, AVERROR_xxx on error
885  */
886 int ff_rfps_add_frame(AVFormatContext *ic, AVStream *st, int64_t dts);
887 
889 
890 /**
891  * Flags for AVFormatContext.write_uncoded_frame()
892  */
894 
895  /**
896  * Query whether the feature is possible on this stream.
897  * The frame argument is ignored.
898  */
900 
901 };
902 
903 /**
904  * Copies the whilelists from one context to the other
905  */
907 
908 /**
909  * Returned by demuxers to indicate that data was consumed but discarded
910  * (ignored streams or junk data). The framework will re-call the demuxer.
911  */
912 #define FFERROR_REDO FFERRTAG('R','E','D','O')
913 
914 /**
915  * Utility function to open IO stream of output format.
916  *
917  * @param s AVFormatContext
918  * @param url URL or file name to open for writing
919  * @options optional options which will be passed to io_open callback
920  * @return >=0 on success, negative AVERROR in case of failure
921  */
923 
924 /*
925  * A wrapper around AVFormatContext.io_close that should be used
926  * instead of calling the pointer directly.
927  *
928  * @param s AVFormatContext
929  * @param *pb the AVIOContext to be closed and freed. Can be NULL.
930  * @return >=0 on success, negative AVERROR in case of failure
931  */
933 
934 /* Default io_close callback, not to be used directly, use ff_format_io_close
935  * instead. */
937 
938 /**
939  * Utility function to check if the file uses http or https protocol
940  *
941  * @param s AVFormatContext
942  * @param filename URL or file name to open for writing
943  */
944 int ff_is_http_proto(const char *filename);
945 
946 /**
947  * Parse creation_time in AVFormatContext metadata if exists and warn if the
948  * parsing fails.
949  *
950  * @param s AVFormatContext
951  * @param timestamp parsed timestamp in microseconds, only set on successful parsing
952  * @param return_seconds set this to get the number of seconds in timestamp instead of microseconds
953  * @return 1 if OK, 0 if the metadata was not present, AVERROR(EINVAL) on parse error
954  */
955 int ff_parse_creation_time_metadata(AVFormatContext *s, int64_t *timestamp, int return_seconds);
956 
957 /**
958  * Standardize creation_time metadata in AVFormatContext to an ISO-8601
959  * timestamp string.
960  *
961  * @param s AVFormatContext
962  * @return <0 on error
963  */
965 
966 #define CONTAINS_PAL 2
967 /**
968  * Reshuffles the lines to use the user specified stride.
969  *
970  * @param ppkt input and output packet
971  * @return negative error code or
972  * 0 if no new packet was allocated
973  * non-zero if a new packet was allocated and ppkt has to be freed
974  * CONTAINS_PAL if in addition to a new packet the old contained a palette
975  */
976 int ff_reshuffle_raw_rgb(AVFormatContext *s, AVPacket **ppkt, AVCodecParameters *par, int expected_stride);
977 
978 /**
979  * Retrieves the palette from a packet, either from side data, or
980  * appended to the video data in the packet itself (raw video only).
981  * It is commonly used after a call to ff_reshuffle_raw_rgb().
982  *
983  * Use 0 for the ret parameter to check for side data only.
984  *
985  * @param pkt pointer to packet before calling ff_reshuffle_raw_rgb()
986  * @param ret return value from ff_reshuffle_raw_rgb(), or 0
987  * @param palette pointer to palette buffer
988  * @return negative error code or
989  * 1 if the packet has a palette, else 0
990  */
991 int ff_get_packet_palette(AVFormatContext *s, AVPacket *pkt, int ret, uint32_t *palette);
992 
993 struct AVBPrint;
994 /**
995  * Finalize buf into extradata and set its size appropriately.
996  */
997 int ff_bprint_to_codecpar_extradata(AVCodecParameters *par, struct AVBPrint *buf);
998 
999 /**
1000  * Find the next packet in the interleaving queue for the given stream.
1001  *
1002  * @return a pointer to a packet if one was found, NULL otherwise.
1003  */
1004 const AVPacket *ff_interleaved_peek(AVFormatContext *s, int stream);
1005 
1006 int ff_get_muxer_ts_offset(AVFormatContext *s, int stream_index, int64_t *offset);
1007 
1008 int ff_lock_avformat(void);
1009 int ff_unlock_avformat(void);
1010 
1011 /**
1012  * Set AVFormatContext url field to the provided pointer. The pointer must
1013  * point to a valid string. The existing url field is freed if necessary. Also
1014  * set the legacy filename field to the same string which was provided in url.
1015  */
1016 void ff_format_set_url(AVFormatContext *s, char *url);
1017 
1018 void avpriv_register_devices(const AVOutputFormat * const o[], const AVInputFormat * const i[]);
1019 
1020 /**
1021  * Make shift_size amount of space at read_start by shifting data in the output
1022  * at read_start until the current IO position. The underlying IO context must
1023  * be seekable.
1024  */
1025 int ff_format_shift_data(AVFormatContext *s, int64_t read_start, int shift_size);
1026 
1027 #endif /* AVFORMAT_INTERNAL_H */
be
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it be(in the first position) for now. Options ------- Then comes the options array. This is what will define the user accessible options. For example
AVCodec
AVCodec.
Definition: codec.h:202
FFStream::skip_samples
int skip_samples
Number of samples to skip at the start of the frame decoded from the next packet.
Definition: internal.h:301
ff_get_pcm_codec_id
enum AVCodecID ff_get_pcm_codec_id(int bps, int flt, int be, int sflags)
Select a PCM codec based on the given parameters.
Definition: utils.c:368
name
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default minimum maximum flags name is the option name
Definition: writing_filters.txt:88
ff_rfps_add_frame
int ff_rfps_add_frame(AVFormatContext *ic, AVStream *st, int64_t dts)
add frame for rfps calculation.
Definition: demux.c:2147
ff_find_decoder
const AVCodec * ff_find_decoder(AVFormatContext *s, const AVStream *st, enum AVCodecID codec_id)
Definition: utils.c:135
FFStream::inject_global_side_data
int inject_global_side_data
Internal data to inject global side data.
Definition: internal.h:380
ff_ntp_time
uint64_t ff_ntp_time(void)
Get the current time since NTP epoch in microseconds.
Definition: utils.c:950
FFFormatContext::interleave_packet
int(* interleave_packet)(struct AVFormatContext *s, AVPacket *pkt, int flush, int has_packet)
The interleavement function in use.
Definition: internal.h:88
FFFormatContext::prefer_codec_framerate
int prefer_codec_framerate
Definition: internal.h:181
ff_get_extradata
int ff_get_extradata(AVFormatContext *s, AVCodecParameters *par, AVIOContext *pb, int size)
Allocate extradata with additional AV_INPUT_BUFFER_PADDING_SIZE at end which is always set to 0 and f...
Definition: utils.c:469
FFStream::first_dts
int64_t first_dts
Timestamp corresponding to the last dts sync point.
Definition: internal.h:428
FFStream::rfps_duration_sum
int64_t rfps_duration_sum
Definition: internal.h:252
FFStream::duration_gcd
int64_t duration_gcd
Definition: internal.h:250
AVCodecParameters
This struct describes the properties of an encoded stream.
Definition: codec_par.h:52
FFStream::last_IP_pts
int64_t last_IP_pts
Definition: internal.h:396
ffformatcontext
static av_always_inline FFFormatContext * ffformatcontext(AVFormatContext *s)
Definition: internal.h:189
ff_find_last_ts
int ff_find_last_ts(AVFormatContext *s, int stream_index, int64_t *ts, int64_t *pos, int64_t(*read_timestamp)(struct AVFormatContext *, int, int64_t *, int64_t))
Definition: seek.c:352
ff_format_output_open
int ff_format_output_open(AVFormatContext *s, const char *url, AVDictionary **options)
Utility function to open IO stream of output format.
Definition: utils.c:1832
FFStream::codec_info_duration_fields
int64_t codec_info_duration_fields
Definition: internal.h:255
AVCodecTag::id
enum AVCodecID id
Definition: internal.h:52
MAX_STD_TIMEBASES
#define MAX_STD_TIMEBASES
Definition: internal.h:244
ff_gen_search
int64_t ff_gen_search(AVFormatContext *s, int stream_index, int64_t target_ts, int64_t pos_min, int64_t pos_max, int64_t pos_limit, int64_t ts_min, int64_t ts_max, int flags, int64_t *ts_ret, int64_t(*read_timestamp)(struct AVFormatContext *, int, int64_t *, int64_t))
Perform a binary search using read_timestamp().
Definition: seek.c:390
FFStream::codec_info_duration
int64_t codec_info_duration
Definition: internal.h:254
ff_get_formatted_ntp_time
uint64_t ff_get_formatted_ntp_time(uint64_t ntp_time_us)
Get the NTP time stamp formatted as per the RFC-5905.
Definition: utils.c:955
ff_free_stream
void ff_free_stream(AVFormatContext *s, AVStream *st)
Definition: utils.c:680
FFStream::first_discard_sample
int64_t first_discard_sample
If not 0, the first audio sample that should be discarded from the stream.
Definition: internal.h:318
FFStream::interleaver_chunk_size
int64_t interleaver_chunk_size
Definition: internal.h:282
ff_add_index_entry
int ff_add_index_entry(AVIndexEntry **index_entries, int *nb_index_entries, unsigned int *index_entries_allocated_size, int64_t pos, int64_t timestamp, int size, int distance, int flags)
Internal version of av_add_index_entry.
Definition: seek.c:59
PacketList
Definition: packet_internal.h:31
data
const char data[16]
Definition: mxf.c:143
FFFormatContext::initialized
int initialized
Whether or not avformat_init_output has already been called.
Definition: internal.h:166
ff_parse_creation_time_metadata
int ff_parse_creation_time_metadata(AVFormatContext *s, int64_t *timestamp, int return_seconds)
Parse creation_time in AVFormatContext metadata if exists and warn if the parsing fails.
Definition: utils.c:1865
ff_parse_ntp_time
uint64_t ff_parse_ntp_time(uint64_t ntp_ts)
Parse the NTP time in micro seconds (since NTP epoch).
Definition: utils.c:977
FFStream::fps_last_dts
int64_t fps_last_dts
Definition: internal.h:272
FFStream::bsfc
AVBSFContext * bsfc
bitstream filter to run on stream
Definition: internal.h:211
FFStream::extract_extradata
struct FFStream::@259 extract_extradata
AVDictionary
Definition: dict.c:30
ff_get_chomp_line
int ff_get_chomp_line(AVIOContext *s, char *buf, int maxlen)
Same as ff_get_line but strip the white-space characters in the text tail.
Definition: aviobuf.c:815
cffstream
static const av_always_inline FFStream * cffstream(const AVStream *st)
Definition: internal.h:437
ff_choose_chroma_location
enum AVChromaLocation ff_choose_chroma_location(AVFormatContext *s, AVStream *st)
Chooses a timebase for muxing the specified stream.
Definition: mux.c:106
FFStream::last_dts_for_order_check
int64_t last_dts_for_order_check
Internal data to analyze DTS and detect faulty mpeg streams.
Definition: internal.h:373
AVWriteUncodedFrameFlags
AVWriteUncodedFrameFlags
Flags for AVFormatContext.write_uncoded_frame()
Definition: internal.h:893
ff_interleave_packet_per_dts
int ff_interleave_packet_per_dts(AVFormatContext *s, AVPacket *pkt, int flush, int has_packet)
Interleave an AVPacket per dts so it can be muxed.
Definition: mux.c:911
os_support.h
sample_rate
sample_rate
Definition: ffmpeg_filter.c:153
AVBSFContext
The bitstream filter state.
Definition: bsf.h:47
AVIndexEntry
Definition: avformat.h:801
FFStream::bsf
AVBSFContext * bsf
Definition: internal.h:231
ff_seek_frame_binary
int ff_seek_frame_binary(AVFormatContext *s, int stream_index, int64_t target_ts, int flags)
Perform a binary search using av_index_search_timestamp() and AVInputFormat.read_timestamp().
Definition: seek.c:282
FFFormatContext::shortest_end
int64_t shortest_end
Timestamp of the end of the shortest stream.
Definition: internal.h:161
ff_bprint_to_codecpar_extradata
int ff_bprint_to_codecpar_extradata(AVCodecParameters *par, struct AVBPrint *buf)
Finalize buf into extradata and set its size appropriately.
Definition: utils.c:1915
ff_unlock_avformat
int ff_unlock_avformat(void)
Definition: utils.c:82
ff_is_intra_only
int ff_is_intra_only(enum AVCodecID id)
Definition: utils.c:287
CodecMime
Definition: internal.h:56
FFStream::is_intra_only
int is_intra_only
Definition: internal.h:240
ff_guess_image2_codec
enum AVCodecID ff_guess_image2_codec(const char *filename)
Definition: img2.c:109
FFStream::dts_ordered
uint8_t dts_ordered
Definition: internal.h:374
FFStream::last_IP_duration
int last_IP_duration
Definition: internal.h:397
RELATIVE_TS_BASE
#define RELATIVE_TS_BASE
Definition: internal.h:459
bsf.h
ffstream
static av_always_inline FFStream * ffstream(AVStream *st)
Definition: internal.h:432
FFStream::inited
int inited
Definition: internal.h:232
AVStreamParseType
AVStreamParseType
Definition: avformat.h:790
FFStream::index_entries_allocated_size
unsigned int index_entries_allocated_size
Definition: internal.h:280
ff_get_line
int ff_get_line(AVIOContext *s, char *buf, int maxlen)
Read a whole line of text from AVIOContext.
Definition: aviobuf.c:798
AVChapter
Definition: avformat.h:1159
ff_read_packet
int ff_read_packet(AVFormatContext *s, AVPacket *pkt)
Read a transport packet from a media file.
Definition: demux.c:524
type
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf type
Definition: writing_filters.txt:86
ff_data_to_hex
char * ff_data_to_hex(char *buf, const uint8_t *src, int size, int lowercase)
Write hexadecimal string corresponding to given binary data.
Definition: utils.c:1146
AVCodecParserContext::dts
int64_t dts
Definition: avcodec.h:2793
FFStream::priv_pts
FFFrac * priv_pts
Definition: internal.h:242
pkt
AVPacket * pkt
Definition: movenc.c:59
ff_stream_side_data_copy
int ff_stream_side_data_copy(AVStream *dst, const AVStream *src)
Copy side data from source to destination stream.
Definition: utils.c:614
AVInputFormat
Definition: avformat.h:650
FFStream::info
struct FFStream::@260 * info
Stream information used internally by avformat_find_stream_info()
AVCodecTag
Definition: internal.h:51
ff_write_chained
int ff_write_chained(AVFormatContext *dst, int dst_stream, AVPacket *pkt, AVFormatContext *src, int interleave)
Write a packet to another muxer than the one the user originally intended.
Definition: mux.c:1300
ff_framehash_write_header
int ff_framehash_write_header(AVFormatContext *s)
Set the timebase for each stream from the corresponding codec timebase and print it.
Definition: framehash.c:24
FFStream::duration_count
int duration_count
Definition: internal.h:251
FFFormatContext::parse_queue
PacketList parse_queue
Packets split by the parser get queued here.
Definition: internal.h:111
width
#define width
FFStream::duration_error
double(* duration_error)[2][MAX_STD_TIMEBASES]
Definition: internal.h:253
s
#define s(width, name)
Definition: cbs_vp9.c:257
FFFormatContext::packet_buffer
PacketList packet_buffer
This buffer is only needed when packets were already buffered but not decoded, for example to get the...
Definition: internal.h:96
FFStream::frame_delay_evidence
int frame_delay_evidence
Definition: internal.h:256
ff_rename
int ff_rename(const char *url_src, const char *url_dst, void *logctx)
Wrap ffurl_move() and log if error happens.
Definition: avio.c:665
avpriv_stream_set_need_parsing
void avpriv_stream_set_need_parsing(AVStream *st, enum AVStreamParseType type)
Definition: utils.c:100
FFStream::nb_decoded_frames
int nb_decoded_frames
Number of internally decoded frames, used internally in libavformat, do not access its lifetime diffe...
Definition: internal.h:331
FFFormatContext::data_offset
int64_t data_offset
offset of the first packet
Definition: internal.h:99
ff_interleave_add_packet
int ff_interleave_add_packet(AVFormatContext *s, AVPacket *pkt, int(*compare)(AVFormatContext *, const AVPacket *, const AVPacket *))
Add packet to an AVFormatContext's packet_buffer list, determining its interleaved position using com...
Definition: mux.c:807
FFStream::codec_info_nb_frames
int codec_info_nb_frames
Number of frames that have been demuxed during avformat_find_stream_info()
Definition: internal.h:411
channels
channels
Definition: aptx.h:33
FFStream::pts_reorder_error_count
uint8_t pts_reorder_error_count[MAX_REORDER_DELAY+1]
Definition: internal.h:366
FFStream::display_aspect_ratio
AVRational display_aspect_ratio
display aspect ratio (0 if unknown)
Definition: internal.h:387
codec_id
enum AVCodecID codec_id
Definition: vaapi_decode.c:369
key
const char * key
Definition: hwcontext_opencl.c:168
FFStream::pts_reorder_error
int64_t pts_reorder_error[MAX_REORDER_DELAY+1]
Internal data to generate dts from pts.
Definition: internal.h:365
ff_hex_to_data
int ff_hex_to_data(uint8_t *data, const char *p)
Parse a string of hexadecimal strings.
Definition: utils.c:1167
FFFormatContext
Definition: internal.h:73
FFStream::need_parsing
enum AVStreamParseType need_parsing
Definition: internal.h:405
context
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default minimum maximum flags name is the option keep it simple and lowercase description are in without and describe what they for example set the foo of the bar offset is the offset of the field in your context
Definition: writing_filters.txt:91
AVFormatContext
Format I/O context.
Definition: avformat.h:1200
FFStream::pub
AVStream pub
The public context.
Definition: internal.h:198
avpriv_update_cur_dts
void avpriv_update_cur_dts(AVFormatContext *s, AVStream *ref_st, int64_t timestamp)
Update cur_dts of all streams based on the given timestamp and AVStream.
Definition: seek.c:32
FFStream::bitstream_checked
int bitstream_checked
Whether or not check_bitstream should still be run on each packet.
Definition: internal.h:216
flush
static void flush(AVCodecContext *avctx)
Definition: aacdec_template.c:593
FFStream::avctx_inited
int avctx_inited
1 if avctx has been initialized with the values from the codec parameters
Definition: internal.h:225
ff_choose_timebase
AVRational ff_choose_timebase(AVFormatContext *s, AVStream *st, int min_precision)
Chooses a timebase for muxing the specified stream.
Definition: mux.c:91
AVRational
Rational number (pair of numerator and denominator).
Definition: rational.h:58
ff_get_muxer_ts_offset
int ff_get_muxer_ts_offset(AVFormatContext *s, int stream_index, int64_t *offset)
Definition: mux.c:1033
ff_stream_add_bitstream_filter
int ff_stream_add_bitstream_filter(AVStream *st, const char *name, const char *args)
Add a bitstream filter to a stream.
Definition: utils.c:1789
FFStream::nb_index_entries
int nb_index_entries
Definition: internal.h:279
AVProbeData
This structure contains the data a format has to probe a file.
Definition: avformat.h:447
FFStream::fps_last_dts_idx
int fps_last_dts_idx
Definition: internal.h:273
ff_reshuffle_raw_rgb
int ff_reshuffle_raw_rgb(AVFormatContext *s, AVPacket **ppkt, AVCodecParameters *par, int expected_stride)
Reshuffles the lines to use the user specified stride.
Definition: rawutils.c:25
FFStream::interleaver_chunk_duration
int64_t interleaver_chunk_duration
Definition: internal.h:283
FFFormatContext::inject_global_side_data
int inject_global_side_data
Definition: internal.h:154
AVCodecID
AVCodecID
Identify the syntax and semantics of the bitstream.
Definition: codec_id.h:47
FFStream::fps_first_dts
int64_t fps_first_dts
Those are used for average framerate estimation.
Definition: internal.h:270
FFFormatContext::id3v2_meta
AVDictionary * id3v2_meta
ID3v2 tag useful for MP3 demuxing.
Definition: internal.h:176
interleave
static void interleave(uint8_t *dst, uint8_t *src, int w, int h, int dst_linesize, int src_linesize, enum FilterMode mode, int swap)
Definition: vf_il.c:108
options
const OptionDef options[]
FFStream::found_decoder
int found_decoder
0 -> decoder has not been searched for yet.
Definition: internal.h:263
AVIOContext
Bytestream IO Context.
Definition: avio.h:161
FFFormatContext::parse_pkt
AVPacket * parse_pkt
The generic code uses this as a temporary packet to parse packets or for muxing, especially flushing.
Definition: internal.h:125
ff_codec_get_id
enum AVCodecID ff_codec_get_id(const AVCodecTag *tags, unsigned int tag)
Definition: utils.c:357
FFFrac::val
int64_t val
Definition: internal.h:69
FFStream
Definition: internal.h:194
FFStream::last_discard_sample
int64_t last_discard_sample
The sample after last sample that is intended to be discarded after first_discard_sample.
Definition: internal.h:325
bps
unsigned bps
Definition: movenc.c:1597
ff_copy_whiteblacklists
int ff_copy_whiteblacklists(AVFormatContext *dst, const AVFormatContext *src)
Copies the whilelists from one context to the other.
Definition: utils.c:115
ff_format_io_close_default
void ff_format_io_close_default(AVFormatContext *s, AVIOContext *pb)
Definition: utils.c:1842
size
int size
Definition: twinvq_data.h:10344
ff_lock_avformat
int ff_lock_avformat(void)
Definition: utils.c:77
FFStream::dts_misordered
uint8_t dts_misordered
Definition: internal.h:375
ff_is_http_proto
int ff_is_http_proto(const char *filename)
Utility function to check if the file uses http or https protocol.
Definition: utils.c:1860
height
#define height
MAX_REORDER_DELAY
#define MAX_REORDER_DELAY
Definition: internal.h:360
offset
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf offset
Definition: writing_filters.txt:86
FFStream::pts_wrap_behavior
int pts_wrap_behavior
Options for behavior, when a wrap is detected.
Definition: internal.h:353
FFFormatContext::raw_packet_buffer_size
int raw_packet_buffer_size
Sum of the size of packets in raw_packet_buffer, in bytes.
Definition: internal.h:136
FFStream::update_initial_durations_done
int update_initial_durations_done
Internal data to prevent doing update_initial_durations() twice.
Definition: internal.h:358
FFStream::start_skip_samples
int64_t start_skip_samples
If not 0, the number of samples that should be skipped from the start of the stream (the samples are ...
Definition: internal.h:310
ff_interleaved_peek
const AVPacket * ff_interleaved_peek(AVFormatContext *s, int stream)
Find the next packet in the interleaving queue for the given stream.
Definition: mux.c:1049
FFStream::probe_packets
int probe_packets
Number of packets to buffer for codec probing.
Definition: internal.h:402
ff_wrap_timestamp
int64_t ff_wrap_timestamp(const AVStream *st, int64_t timestamp)
Wrap a given time stamp, if there is an indication for an overflow.
Definition: demux.c:63
FFStream::probe_data
AVProbeData probe_data
Definition: internal.h:389
AVChromaLocation
AVChromaLocation
Location of chroma samples.
Definition: pixfmt.h:616
FFStream::skip_to_keyframe
int skip_to_keyframe
Indicates that everything up to the next keyframe should be discarded.
Definition: internal.h:296
ff_standardize_creation_time
int ff_standardize_creation_time(AVFormatContext *s)
Standardize creation_time metadata in AVFormatContext to an ISO-8601 timestamp string.
Definition: utils.c:1882
FFFormatContext::raw_packet_buffer
PacketList raw_packet_buffer
Raw packets from the demuxer, prior to parsing and decoding.
Definition: internal.h:107
PacketListEntry
Definition: packet_internal.h:26
FFStream::mux_ts_offset
int64_t mux_ts_offset
Timestamp offset added to timestamps before muxing.
Definition: internal.h:336
AVOutputFormat
Definition: avformat.h:503
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:271
ff_flush_packet_queue
void ff_flush_packet_queue(AVFormatContext *s)
Definition: utils.c:299
FFStream::reorder
int reorder
Set to 1 if the codec allows reordering, so pts can be different from dts.
Definition: internal.h:204
FFStream::fps_first_dts_idx
int fps_first_dts_idx
Definition: internal.h:271
av_always_inline
#define av_always_inline
Definition: attributes.h:49
FFStream::pts_buffer
int64_t pts_buffer[MAX_REORDER_DELAY+1]
Definition: internal.h:368
avpriv_new_chapter
AVChapter * avpriv_new_chapter(AVFormatContext *s, int64_t id, AVRational time_base, int64_t start, int64_t end, const char *title)
Add a new chapter.
Definition: utils.c:883
FFStream::last_in_packet_buffer
PacketListEntry * last_in_packet_buffer
last packet in packet_buffer for this stream when muxing.
Definition: internal.h:394
ff_add_param_change
int ff_add_param_change(AVPacket *pkt, int32_t channels, uint64_t channel_layout, int32_t sample_rate, int32_t width, int32_t height)
Add side data to a packet for changing parameters to the given values.
Definition: utils.c:1322
avcodec.h
ff_sdp_write_media
int ff_sdp_write_media(char *buff, int size, const AVStream *st, int idx, const char *dest_addr, const char *dest_type, int port, int ttl, AVFormatContext *fmt)
Append the media-specific SDP fragment for the media stream c to the buffer buff.
Definition: sdp.c:913
AVCodecParserContext
Definition: avcodec.h:2773
ff_rfps_calculate
void ff_rfps_calculate(AVFormatContext *ic)
Definition: demux.c:2207
tag
uint32_t tag
Definition: movenc.c:1596
ff_find_stream_index
int ff_find_stream_index(const AVFormatContext *s, int id)
Find stream index based on format-specific stream ID.
Definition: utils.c:1275
FFStream::last_duration
int64_t last_duration
Definition: internal.h:265
ret
ret
Definition: filter_design.txt:187
ff_get_packet_palette
int ff_get_packet_palette(AVFormatContext *s, AVPacket *pkt, int ret, uint32_t *palette)
Retrieves the palette from a packet, either from side data, or appended to the video data in the pack...
Definition: utils.c:1891
AVStream
Stream structure.
Definition: avformat.h:935
lowercase
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default minimum maximum flags name is the option keep it simple and lowercase description are in lowercase
Definition: writing_filters.txt:89
pos
unsigned int pos
Definition: spdifenc.c:412
avformat.h
ff_format_set_url
void ff_format_set_url(AVFormatContext *s, char *url)
Set AVFormatContext url field to the provided pointer.
Definition: utils.c:2002
FFFormatContext::chapter_ids_monotonic
int chapter_ids_monotonic
Set if chapter ids are strictly monotonic.
Definition: internal.h:186
FFFormatContext::offset_timebase
AVRational offset_timebase
Timebase for the timestamp offset.
Definition: internal.h:148
AVCodecContext
main external API structure.
Definition: avcodec.h:383
compare
static float compare(const AVFrame *haystack, const AVFrame *obj, int offx, int offy)
Definition: vf_find_rect.c:95
ff_stream_encode_params_copy
int ff_stream_encode_params_copy(AVStream *dst, const AVStream *src)
Copy encoding parameters from source to destination stream.
Definition: utils.c:586
ff_reduce_index
void ff_reduce_index(AVFormatContext *s, int stream_index)
Ensure the index uses less memory than the maximum specified in AVFormatContext.max_index_size by dis...
Definition: seek.c:45
FFStream::avctx
AVCodecContext * avctx
The codec context used by avformat_find_stream_info, the parser, etc.
Definition: internal.h:221
ff_codec_get_tag
unsigned int ff_codec_get_tag(const AVCodecTag *tags, enum AVCodecID id)
Definition: utils.c:347
ff_parse_key_val_cb
void(* ff_parse_key_val_cb)(void *context, const char *key, int key_len, char **dest, int *dest_len)
Callback function type for ff_parse_key_value.
Definition: internal.h:614
ff_interleave_packet_passthrough
int ff_interleave_packet_passthrough(AVFormatContext *s, AVPacket *pkt, int flush, int has_packet)
Interleave packets directly in the order in which they arrive without any sort of buffering.
Definition: mux.c:1027
ff_index_search_timestamp
int ff_index_search_timestamp(const AVIndexEntry *entries, int nb_entries, int64_t wanted_timestamp, int flags)
Internal version of av_index_search_timestamp.
Definition: seek.c:127
FFFormatContext::offset
int64_t offset
Offset to remap timestamps to be non-negative.
Definition: internal.h:143
avpriv_set_pts_info
void avpriv_set_pts_info(AVStream *st, int pts_wrap_bits, unsigned int pts_num, unsigned int pts_den)
Set the time base and wrapping info for a given stream.
Definition: utils.c:1195
CodecMime::str
char str[32]
Definition: internal.h:57
FFStream::index_entries
AVIndexEntry * index_entries
Only used if the format does not support seeking natively.
Definition: internal.h:277
CodecMime::id
enum AVCodecID id
Definition: internal.h:58
FFFormatContext::streams_initialized
int streams_initialized
Whether or not avformat_init_output fully initialized streams.
Definition: internal.h:171
FFFrac::num
int64_t num
Definition: internal.h:69
AVBufferRef
A reference to a data buffer.
Definition: buffer.h:82
packet_internal.h
FFFormatContext::pkt
AVPacket * pkt
Used to hold temporary packets for the generic demuxing code.
Definition: internal.h:132
ff_mkdir_p
int ff_mkdir_p(const char *path)
Automatically create sub-directories.
Definition: utils.c:1112
ff_generate_avci_extradata
int ff_generate_avci_extradata(AVStream *st)
Generate standard extradata for AVC-Intra based on width/height and field order.
Definition: utils.c:1586
FFStream::request_probe
int request_probe
stream probing state -1 -> probing finished 0 -> no probing requested rest -> perform probing with re...
Definition: internal.h:291
AVPacket
This structure stores compressed data.
Definition: packet.h:350
ff_read_frame_flush
void ff_read_frame_flush(AVFormatContext *s)
Flush the frame reader.
Definition: seek.c:714
AV_WRITE_UNCODED_FRAME_QUERY
@ AV_WRITE_UNCODED_FRAME_QUERY
Query whether the feature is possible on this stream.
Definition: internal.h:899
src
INIT_CLIP pixel * src
Definition: h264pred_template.c:418
FFStream::cur_dts
int64_t cur_dts
Definition: internal.h:429
int32_t
int32_t
Definition: audioconvert.c:56
convert_header.str
string str
Definition: convert_header.py:20
FFStream::stream_identifier
int stream_identifier
Stream Identifier This is the MPEG-TS stream identifier +1 0 means unknown.
Definition: internal.h:418
distance
static float distance(float x, float y, int band)
Definition: nellymoserenc.c:233
FFStream::need_context_update
int need_context_update
Whether the internal avctx needs to be updated from codecpar (after a late change to codecpar)
Definition: internal.h:238
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:561
FFStream::last_dts
int64_t last_dts
Definition: internal.h:249
FFStream::parser
struct AVCodecParserContext * parser
Definition: internal.h:406
read_timestamp
static int64_t read_timestamp(AVFormatContext *s, int stream_index, int64_t *ppos, int64_t pos_limit, int64_t(*read_timestamp)(struct AVFormatContext *, int, int64_t *, int64_t))
Definition: seek.c:273
FFFrac
The exact value of the fractional number is: 'val + num / den'.
Definition: internal.h:68
FFFrac::den
int64_t den
Definition: internal.h:69
ff_format_shift_data
int ff_format_shift_data(AVFormatContext *s, int64_t read_start, int shift_size)
Make shift_size amount of space at read_start by shifting data in the output at read_start until the ...
Definition: utils.c:2038
AVCodecTag::tag
unsigned int tag
Definition: internal.h:53
int
int
Definition: ffmpeg_filter.c:153
FFFormatContext::pub
AVFormatContext pub
The public context.
Definition: internal.h:77
avpriv_register_devices
void avpriv_register_devices(const AVOutputFormat *const o[], const AVInputFormat *const i[])
Definition: allformats.c:583
FFStream::pts_wrap_reference
int64_t pts_wrap_reference
Internal data to check for wrapping of the time stamp.
Definition: internal.h:341
ff_format_io_close
int ff_format_io_close(AVFormatContext *s, AVIOContext **pb)
Definition: utils.c:1847
ff_configure_buffers_for_index
void ff_configure_buffers_for_index(AVFormatContext *s, int64_t time_tolerance)
Definition: seek.c:170
FFFormatContext::nb_interleaved_streams
int nb_interleaved_streams
Number of streams relevant for interleaving.
Definition: internal.h:83
ff_add_attached_pic
int ff_add_attached_pic(AVFormatContext *s, AVStream *st, AVIOContext *pb, AVBufferRef **buf, int size)
Add an attached pic to an AVStream.
Definition: utils.c:250
ff_parse_key_value
void ff_parse_key_value(const char *str, ff_parse_key_val_cb callback_get_buf, void *context)
Parse a string with comma-separated key=value pairs.
Definition: utils.c:1221
ff_alloc_extradata
int ff_alloc_extradata(AVCodecParameters *par, int size)
Allocate extradata with additional AV_INPUT_BUFFER_PADDING_SIZE at end which is always set to 0.
Definition: utils.c:451
is_relative
static av_always_inline int is_relative(int64_t ts)
Definition: internal.h:461
FFFormatContext::avoid_negative_ts_use_pts
int avoid_negative_ts_use_pts
Definition: internal.h:156