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