FFmpeg
ffmpeg.h
Go to the documentation of this file.
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18 
19 #ifndef FFTOOLS_FFMPEG_H
20 #define FFTOOLS_FFMPEG_H
21 
22 #include "config.h"
23 
24 #include <stdint.h>
25 #include <stdio.h>
26 #include <signal.h>
27 
28 #include "cmdutils.h"
29 
30 #include "libavformat/avformat.h"
31 #include "libavformat/avio.h"
32 
33 #include "libavcodec/avcodec.h"
34 
35 #include "libavfilter/avfilter.h"
36 
37 #include "libavutil/avutil.h"
38 #include "libavutil/dict.h"
39 #include "libavutil/eval.h"
40 #include "libavutil/fifo.h"
41 #include "libavutil/hwcontext.h"
42 #include "libavutil/pixfmt.h"
43 #include "libavutil/rational.h"
44 #include "libavutil/thread.h"
46 
48 
49 #define VSYNC_AUTO -1
50 #define VSYNC_PASSTHROUGH 0
51 #define VSYNC_CFR 1
52 #define VSYNC_VFR 2
53 #define VSYNC_VSCFR 0xfe
54 #define VSYNC_DROP 0xff
55 
56 #define MAX_STREAMS 1024 /* arbitrary sanity check value */
57 
58 enum HWAccelID {
64 };
65 
66 typedef struct HWAccel {
67  const char *name;
69  enum HWAccelID id;
71 } HWAccel;
72 
73 typedef struct HWDevice {
74  const char *name;
77 } HWDevice;
78 
79 /* select an input stream for an output stream */
80 typedef struct StreamMap {
81  int disabled; /* 1 is this mapping is disabled by a negative map */
86  char *linklabel; /* name of an output link, for mapping lavfi outputs */
87 } StreamMap;
88 
89 typedef struct {
90  int file_idx, stream_idx, channel_idx; // input
91  int ofile_idx, ostream_idx; // output
93 
94 typedef struct OptionsContext {
96 
97  /* input/output options */
98  int64_t start_time;
99  int64_t start_time_eof;
101  const char *format;
102 
115 
116  /* input options */
118  int loop;
119  int rate_emu;
122 
135 
136  /* output options */
139  AudioChannelMap *audio_channel_maps; /* one info entry per -map_channel */
140  int nb_audio_channel_maps; /* number of (valid) -map_channel settings */
144  const char **attachments;
146 
148 
149  int64_t recording_time;
150  int64_t stop_time;
151  uint64_t limit_filesize;
152  float mux_preload;
154  int shortest;
155  int bitexact;
156 
161 
162  /* indexed by output file stream index */
165 
213  int nb_pass;
221  int nb_apad;
233 
234 typedef struct InputFilter {
236  struct InputStream *ist;
239  enum AVMediaType type; // AVMEDIA_TYPE_SUBTITLE for sub2video
240 
242 
243  // parameters configured for this input
244  int format;
245 
246  int width, height;
248 
250  int channels;
251  uint64_t channel_layout;
252 
254 
255  int eof;
256 } InputFilter;
257 
258 typedef struct OutputFilter {
260  struct OutputStream *ost;
263 
264  /* temporary storage until stream maps are processed */
267 
268  /* desired output stream properties */
269  int width, height;
271  int format;
273  uint64_t channel_layout;
274 
275  // those are only set if no format is specified and the encoder gives us multiple options
276  int *formats;
277  uint64_t *channel_layouts;
279 } OutputFilter;
280 
281 typedef struct FilterGraph {
282  int index;
283  const char *graph_desc;
284 
287 
292 } FilterGraph;
293 
294 typedef struct InputStream {
297  int discard; /* true if stream data should be discarded */
299  int decoding_needed; /* non zero if the packets must be decoded in 'raw_fifo', see DECODING_FOR_* */
300 #define DECODING_FOR_OST 1
301 #define DECODING_FOR_FILTER 2
302 
306  AVFrame *filter_frame; /* a ref of decoded_frame, to be sent to filters */
307 
308  int64_t start; /* time when read started */
309  /* predicted dts of the next packet read for this stream or (when there are
310  * several frames in a packet) of the next frame in current packet (in AV_TIME_BASE units) */
311  int64_t next_dts;
312  int64_t dts; ///< dts of the last packet read for this stream (in AV_TIME_BASE units)
313 
314  int64_t next_pts; ///< synthetic pts for the next decode frame (in AV_TIME_BASE units)
315  int64_t pts; ///< current pts of the decoded frame (in AV_TIME_BASE units)
317 
319 
320  int64_t min_pts; /* pts with the smallest value in a current stream */
321  int64_t max_pts; /* pts with the higher value in a current stream */
322 
323  // when forcing constant input framerate through -r,
324  // this contains the pts that will be given to the next decoded frame
325  int64_t cfr_next_pts;
326 
327  int64_t nb_samples; /* number of samples in the last decoded audio frame before looping */
328 
329  double ts_scale;
332  AVRational framerate; /* framerate forced with -r */
335 
337 
339  struct { /* previous decoded subtitle and related variables */
341  int ret;
343  } prev_sub;
344 
345  struct sub2video {
346  int64_t last_pts;
347  int64_t end_pts;
348  AVFifoBuffer *sub_queue; ///< queue of AVSubtitle* before filter init
350  int w, h;
351  unsigned int initialize; ///< marks if sub2video_update should force an initialization
352  } sub2video;
353 
354  int dr1;
355 
356  /* decoded data from this stream goes into all those filters
357  * currently video and audio only */
360 
362 
363  /* hwaccel options */
364  enum HWAccelID hwaccel_id;
365  enum AVHWDeviceType hwaccel_device_type;
367  enum AVPixelFormat hwaccel_output_format;
368 
369  /* hwaccel context */
370  void *hwaccel_ctx;
372  int (*hwaccel_get_buffer)(AVCodecContext *s, AVFrame *frame, int flags);
374  enum AVPixelFormat hwaccel_pix_fmt;
375  enum AVPixelFormat hwaccel_retrieved_pix_fmt;
377 
378  /* stats */
379  // combined size of all the packets read
380  uint64_t data_size;
381  /* number of packets successfully read for this stream */
382  uint64_t nb_packets;
383  // number of frames/samples retrieved from the decoder
384  uint64_t frames_decoded;
385  uint64_t samples_decoded;
386 
387  int64_t *dts_buffer;
389 
390  int got_output;
391 } InputStream;
392 
393 typedef struct InputFile {
395  int eof_reached; /* true if eof reached */
396  int eagain; /* true if last read attempt returned EAGAIN */
397  int ist_index; /* index of first stream in input_streams */
398  int loop; /* set number of times input stream should be looped */
399  int64_t duration; /* actual duration of the longest stream in a file
400  at the moment when looping happens */
401  AVRational time_base; /* time base of the duration */
403 
404  int64_t ts_offset;
405  int64_t last_ts;
406  int64_t start_time; /* user-specified start time in AV_TIME_BASE or AV_NOPTS_VALUE */
408  int64_t recording_time;
409  int nb_streams; /* number of stream that ffmpeg is aware of; may be different
410  from ctx.nb_streams if new streams appear during av_read_frame() */
411  int nb_streams_warn; /* number of streams that the user was warned of */
412  int rate_emu;
414 
415 #if HAVE_THREADS
416  AVThreadMessageQueue *in_thread_queue;
417  pthread_t thread; /* thread reading from this file */
418  int non_blocking; /* reading packets from the thread should not block */
419  int joined; /* the thread has been joined */
420  int thread_queue_size; /* maximum number of queued packets */
421 #endif
422 } InputFile;
423 
431 };
432 
433 #define ABORT_ON_FLAG_EMPTY_OUTPUT (1 << 0)
434 
435 extern const char *const forced_keyframes_const_names[];
436 
437 typedef enum {
440 } OSTFinished ;
441 
442 typedef struct OutputStream {
443  int file_index; /* file index */
444  int index; /* stream index in the output file */
445  int source_index; /* InputStream index */
446  AVStream *st; /* stream in the output file */
447  int encoding_needed; /* true if encoding needed for this stream */
449  /* input pts and corresponding output pts
450  for A/V sync */
451  struct InputStream *sync_ist; /* input stream to sync against */
452  int64_t sync_opts; /* output frame counter, could be changed to some true timestamp */ // FIXME look at frame_number
453  /* pts of the first frame encoded for this stream, used for limiting
454  * recording time */
455  int64_t first_pts;
456  /* dts of the last packet sent to the muxer */
457  int64_t last_mux_dts;
458  // the timebase of the packets sent to the muxer
461 
464 
466  AVCodecParameters *ref_par; /* associated input codec parameters with encoders options applied */
468  int64_t max_frames;
472  int last_nb0_frames[3];
473 
474  void *hwaccel_ctx;
475 
476  /* video only */
478  int is_cfr;
483 
485 
486  /* forced key frames */
488  int64_t *forced_kf_pts;
493  double forced_keyframes_expr_const_values[FKF_NB];
494 
495  /* audio only */
496  int *audio_channels_map; /* list of the channels id to pick from the source stream */
497  int audio_channels_mapped; /* number of channels in audio_channels_map */
498 
500  FILE *logfile;
501 
503  char *avfilter;
504  char *filters; ///< filtergraph associated to the -filter option
505  char *filters_script; ///< filtergraph script associated to the -filter_script option
506 
511  char *apad;
512  OSTFinished finished; /* no more packets should be written for this stream */
513  int unavailable; /* true if the steram is unavailable (possibly temporarily) */
515 
516  // init_output_stream() has been called for this stream
517  // The encoder and the bitstream filters have been initialized and the stream
518  // parameters are set in the AVStream.
520 
522 
523  const char *attachment_filename;
526  char *disposition;
527 
529 
530  /* stats */
531  // combined size of all the packets written
532  uint64_t data_size;
533  // number of packets send to the muxer
534  uint64_t packets_written;
535  // number of frames/samples sent to the encoder
536  uint64_t frames_encoded;
537  uint64_t samples_encoded;
538 
539  /* packet quality factor */
540  int quality;
541 
543 
544  /* the packets are buffered here until the muxer is ready to be initialized */
546 
547  /* packet picture type */
549 
550  /* frame encode sum of squared error values */
551  int64_t error[4];
552 } OutputStream;
553 
554 typedef struct OutputFile {
557  int ost_index; /* index of the first stream in output_streams */
558  int64_t recording_time; ///< desired length of the resulting file in microseconds == AV_TIME_BASE units
559  int64_t start_time; ///< start time in microseconds == AV_TIME_BASE units
560  uint64_t limit_filesize; /* filesize limit expressed in bytes */
561 
562  int shortest;
563 
565 } OutputFile;
566 
567 extern InputStream **input_streams;
568 extern int nb_input_streams;
569 extern InputFile **input_files;
570 extern int nb_input_files;
571 
573 extern int nb_output_streams;
574 extern OutputFile **output_files;
575 extern int nb_output_files;
576 
577 extern FilterGraph **filtergraphs;
578 extern int nb_filtergraphs;
579 
580 extern char *vstats_filename;
581 extern char *sdp_filename;
582 
583 extern float audio_drift_threshold;
584 extern float dts_delta_threshold;
585 extern float dts_error_threshold;
586 
587 extern int audio_volume;
588 extern int audio_sync_method;
589 extern int video_sync_method;
590 extern float frame_drop_threshold;
591 extern int do_benchmark;
592 extern int do_benchmark_all;
593 extern int do_deinterlace;
594 extern int do_hex_dump;
595 extern int do_pkt_dump;
596 extern int copy_ts;
597 extern int start_at_zero;
598 extern int copy_tb;
599 extern int debug_ts;
600 extern int exit_on_error;
601 extern int abort_on_flags;
602 extern int print_stats;
603 extern int qp_hist;
604 extern int stdin_interaction;
605 extern int frame_bits_per_raw_sample;
606 extern AVIOContext *progress_avio;
607 extern float max_error_rate;
608 extern char *videotoolbox_pixfmt;
609 
610 extern int filter_nbthreads;
611 extern int filter_complex_nbthreads;
612 extern int vstats_version;
613 
614 extern const AVIOInterruptCB int_cb;
615 
616 extern const OptionDef options[];
617 extern const HWAccel hwaccels[];
618 extern AVBufferRef *hw_device_ctx;
619 #if CONFIG_QSV
620 extern char *qsv_device;
621 #endif
622 extern HWDevice *filter_hw_device;
623 
624 
625 void term_init(void);
626 void term_exit(void);
627 
628 void reset_options(OptionsContext *o, int is_input);
629 void show_usage(void);
630 
631 void opt_output_file(void *optctx, const char *filename);
632 
635 
637 
638 enum AVPixelFormat choose_pixel_fmt(AVStream *st, AVCodecContext *avctx, AVCodec *codec, enum AVPixelFormat target);
639 void choose_sample_fmt(AVStream *st, AVCodec *codec);
640 
643 void check_filter_outputs(void);
648 
649 void sub2video_update(InputStream *ist, int64_t heartbeat_pts, AVSubtitle *sub);
650 
652 
653 int ffmpeg_parse_options(int argc, char **argv);
654 
657 
658 HWDevice *hw_device_get_by_name(const char *name);
659 int hw_device_init_from_string(const char *arg, HWDevice **dev);
660 void hw_device_free_all(void);
661 
664 
666 
667 #endif /* FFTOOLS_FFMPEG_H */
int64_t pts
current pts of the decoded frame (in AV_TIME_BASE units)
Definition: ffmpeg.h:315
int nb_bitstream_filters
Definition: ffmpeg.h:462
SpecifierOpt * passlogfiles
Definition: ffmpeg.h:214
AVRational enc_timebase
Definition: ffmpeg.h:460
int nb_dump_attachment
Definition: ffmpeg.h:126
int got_output
Definition: ffmpeg.h:340
int nb_metadata
Definition: ffmpeg.h:167
int nb_streamid_map
Definition: ffmpeg.h:164
int frame_number
Definition: ffmpeg.h:448
int width
Definition: ffmpeg.h:269
Definition: ffmpeg.h:425
int keep_pix_fmt
Definition: ffmpeg.h:528
Bytestream IO Context.
Definition: avio.h:161
float mux_preload
Definition: ffmpeg.h:152
int64_t recording_time
desired length of the resulting file in microseconds == AV_TIME_BASE units
Definition: ffmpeg.h:558
HWAccelID
Definition: ffmpeg.h:58
Buffered I/O operations.
uint8_t * name
Definition: ffmpeg.h:262
int nb_outputs
Definition: ffmpeg.h:291
char * qsv_device
Definition: ffmpeg_qsv.c:31
AVDictionary * swr_opts
Definition: ffmpeg.h:509
enum AVPixelFormat choose_pixel_fmt(AVStream *st, AVCodecContext *avctx, AVCodec *codec, enum AVPixelFormat target)
Definition: ffmpeg_filter.c:63
This structure describes decoded (raw) audio or video data.
Definition: frame.h:295
int stream_copy
Definition: ffmpeg.h:514
AVRational frame_rate
Definition: ffmpeg.h:477
int64_t * forced_kf_pts
Definition: ffmpeg.h:488
int64_t start_time_eof
Definition: ffmpeg.h:99
AVBufferRef * hw_frames_ctx
Definition: ffmpeg.h:376
char * filters
filtergraph associated to the -filter option
Definition: ffmpeg.h:504
SpecifierOpt * hwaccel_output_formats
Definition: ffmpeg.h:131
HWDevice * filter_hw_device
Definition: ffmpeg_opt.c:143
int data_disable
Definition: ffmpeg.h:160
float mux_max_delay
Definition: ffmpeg.h:153
int exit_on_error
Definition: ffmpeg_opt.c:165
int64_t cfr_next_pts
Definition: ffmpeg.h:325
int accurate_seek
Definition: ffmpeg.h:413
OutputFile ** output_files
Definition: ffmpeg.c:154
int64_t forced_kf_ref_pts
Definition: ffmpeg.h:487
int nb_forced_key_frames
Definition: ffmpeg.h:179
int * streamid_map
Definition: ffmpeg.h:163
Main libavfilter public API header.
int nb_stream_maps
Definition: ffmpeg.h:138
SpecifierOpt * copy_initial_nonkeyframes
Definition: ffmpeg.h:198
int ostream_idx
Definition: ffmpeg.h:91
int nb_chroma_intra_matrices
Definition: ffmpeg.h:191
AVRational framerate
Definition: ffmpeg.h:332
void choose_sample_fmt(AVStream *st, AVCodec *codec)
Definition: ffmpeg_filter.c:93
SpecifierOpt * reinit_filters
Definition: ffmpeg.h:206
SpecifierOpt * ts_scale
Definition: ffmpeg.h:123
int64_t max_pts
Definition: ffmpeg.h:321
AVFilterInOut * out_tmp
Definition: ffmpeg.h:265
int bitexact
Definition: ffmpeg.h:155
int decoding_needed
Definition: ffmpeg.h:299
int nb_canvas_sizes
Definition: ffmpeg.h:211
The bitstream filter state.
Definition: avcodec.h:5843
int rotate_overridden
Definition: ffmpeg.h:481
int max_muxing_queue_size
Definition: ffmpeg.h:542
SpecifierOpt * discard
Definition: ffmpeg.h:222
int nb_frame_pix_fmts
Definition: ffmpeg.h:114
void * hwaccel_ctx
Definition: ffmpeg.h:474
SpecifierOpt * sample_fmts
Definition: ffmpeg.h:174
SpecifierOpt * guess_layout_max
Definition: ffmpeg.h:218
void hw_device_free_all(void)
Definition: ffmpeg_hw.c:272
int eagain
Definition: ffmpeg.h:396
The reader does not expect b to be semantically here and if the code is changed by maybe adding a a division or other the signedness will almost certainly be mistaken To avoid this confusion a new type was SUINT is the C unsigned type but it holds a signed int to use the same example SUINT a
Definition: undefined.txt:36
Convenience header that includes libavutil&#39;s core.
forced_keyframes_const
Definition: ffmpeg.h:424
GLint GLenum type
Definition: opengl_enc.c:104
int quality
Definition: ffmpeg.h:540
AVFrame * filter_frame
Definition: ffmpeg.h:306
int do_benchmark_all
Definition: ffmpeg_opt.c:158
int nb_program
Definition: ffmpeg.h:227
int last_dropped
Definition: ffmpeg.h:471
FilterGraph ** filtergraphs
Definition: ffmpeg.c:157
int64_t input_ts_offset
Definition: ffmpeg.h:402
int do_hex_dump
Definition: ffmpeg_opt.c:159
int nb_filter_scripts
Definition: ffmpeg.h:205
static void error(const char *err)
const char * name
Definition: ffmpeg.h:67
uint64_t packets_written
Definition: ffmpeg.h:534
AVCodec.
Definition: avcodec.h:3555
int nb_dts_buffer
Definition: ffmpeg.h:388
SpecifierOpt * filters
Definition: ffmpeg.h:202
This struct describes the properties of an encoded stream.
Definition: avcodec.h:4028
int print_stats
Definition: ffmpeg_opt.c:167
float dts_error_threshold
Definition: ffmpeg_opt.c:150
int64_t start_time
start time in microseconds == AV_TIME_BASE units
Definition: ffmpeg.h:559
int index
Definition: ffmpeg.h:282
uint64_t data_size
Definition: ffmpeg.h:532
SpecifierOpt * qscale
Definition: ffmpeg.h:176
AVBSFContext ** bsf_ctx
Definition: ffmpeg.h:463
SpecifierOpt * frame_pix_fmts
Definition: ffmpeg.h:113
SpecifierOpt * chroma_intra_matrices
Definition: ffmpeg.h:190
struct FilterGraph * graph
Definition: ffmpeg.h:237
SpecifierOpt * intra_matrices
Definition: ffmpeg.h:186
int encoding_needed
Definition: ffmpeg.h:447
Format I/O context.
Definition: avformat.h:1353
void remove_avoptions(AVDictionary **a, AVDictionary *b)
Definition: ffmpeg.c:645
uint64_t samples_decoded
Definition: ffmpeg.h:385
struct InputStream * ist
Definition: ffmpeg.h:236
enum HWAccelID id
Definition: ffmpeg.h:69
uint64_t frames_decoded
Definition: ffmpeg.h:384
int header_written
Definition: ffmpeg.h:564
AVFilterGraph * graph
Definition: ffmpeg.h:285
Public dictionary API.
char * logfile_prefix
Definition: ffmpeg.h:499
int user_set_discard
Definition: ffmpeg.h:298
int copy_initial_nonkeyframes
Definition: ffmpeg.h:524
int64_t * dts_buffer
Definition: ffmpeg.h:387
uint8_t
AVDictionary * sws_dict
Definition: ffmpeg.h:508
int nb_time_bases
Definition: ffmpeg.h:229
int stdin_interaction
Definition: ffmpeg_opt.c:169
FILE * logfile
Definition: ffmpeg.h:500
AVDictionary * opts
Definition: ffmpeg.h:556
Definition: eval.c:157
int do_benchmark
Definition: ffmpeg_opt.c:157
int audio_sync_method
Definition: ffmpeg_opt.c:153
int nb_max_frames
Definition: ffmpeg.h:169
int shortest
Definition: ffmpeg.h:562
int nb_output_streams
Definition: ffmpeg.c:153
#define height
void sub2video_update(InputStream *ist, int64_t heartbeat_pts, AVSubtitle *sub)
Definition: ffmpeg.c:240
int nb_streams
Definition: ffmpeg.h:409
int sync_file_index
Definition: ffmpeg.h:84
AVDictionary * resample_opts
Definition: ffmpeg.h:510
int seek_timestamp
Definition: ffmpeg.h:100
void reset_options(OptionsContext *o, int is_input)
AVFilterContext * filter
Definition: ffmpeg.h:259
int * formats
Definition: ffmpeg.h:276
SpecifierOpt * bitstream_filters
Definition: ffmpeg.h:170
int init_complex_filtergraph(FilterGraph *fg)
AVCodec * dec
Definition: ffmpeg.h:304
int top_field_first
Definition: ffmpeg.h:333
int file_index
Definition: ffmpeg.h:295
int64_t filter_in_rescale_delta_last
Definition: ffmpeg.h:318
int wrap_correction_done
Definition: ffmpeg.h:316
int ist_in_filtergraph(FilterGraph *fg, InputStream *ist)
int filter_complex_nbthreads
Definition: ffmpeg_opt.c:173
SpecifierOpt * disposition
Definition: ffmpeg.h:224
int64_t next_dts
Definition: ffmpeg.h:311
unsigned int initialize
marks if sub2video_update should force an initialization
Definition: ffmpeg.h:351
SpecifierOpt * enc_time_bases
Definition: ffmpeg.h:230
uint64_t channel_layout
Definition: ffmpeg.h:273
AVFifoBuffer * sub_queue
queue of AVSubtitle* before filter init
Definition: ffmpeg.h:348
Callback for checking whether to abort blocking functions.
Definition: avio.h:58
libswresample public header
int nb_top_field_first
Definition: ffmpeg.h:193
AVRational sample_aspect_ratio
Definition: ffmpeg.h:247
int rate_emu
Definition: ffmpeg.h:412
int nb_discard
Definition: ffmpeg.h:223
int sample_rate
Definition: ffmpeg.h:249
void check_filter_outputs(void)
int ffmpeg_parse_options(int argc, char **argv)
Definition: ffmpeg_opt.c:3363
AVFilterContext * filter
Definition: ffmpeg.h:235
int nb_filters
Definition: ffmpeg.h:203
int64_t start_time
Definition: ffmpeg.h:98
int64_t start
Definition: ffmpeg.h:308
int loop
Definition: ffmpeg.h:398
uint64_t nb_packets
Definition: ffmpeg.h:382
int seek_timestamp
Definition: ffmpeg.h:407
int64_t last_mux_dts
Definition: ffmpeg.h:457
int video_sync_method
Definition: ffmpeg_opt.c:154
int format
Definition: ffmpeg.h:244
char * sdp_filename
Definition: ffmpeg_opt.c:146
SpecifierOpt * apad
Definition: ffmpeg.h:220
int dr1
Definition: ffmpeg.h:354
int nb_hwaccel_devices
Definition: ffmpeg.h:130
AudioChannelMap * audio_channel_maps
Definition: ffmpeg.h:139
int nb_disposition
Definition: ffmpeg.h:225
const char * arg
Definition: jacosubdec.c:66
SpecifierOpt * codec_tags
Definition: ffmpeg.h:172
SpecifierOpt * rc_overrides
Definition: ffmpeg.h:184
int video_disable
Definition: ffmpeg.h:157
int eof
Definition: ffmpeg.h:255
int nb_input_files
Definition: ffmpeg.c:150
int force_fps
Definition: ffmpeg.h:479
int hw_device_setup_for_encode(OutputStream *ost)
Definition: ffmpeg_hw.c:417
int nb_codec_names
Definition: ffmpeg.h:104
int qp_hist
Definition: ffmpeg_opt.c:168
StreamMap * stream_maps
Definition: ffmpeg.h:137
float frame_drop_threshold
Definition: ffmpeg_opt.c:155
uint64_t limit_filesize
Definition: ffmpeg.h:151
const char * format
Definition: ffmpeg.h:101
int nb_passlogfiles
Definition: ffmpeg.h:215
int filter_nbthreads
Definition: ffmpeg_opt.c:172
int nb_force_fps
Definition: ffmpeg.h:181
OutputFilter * filter
Definition: ffmpeg.h:502
const char * name
Definition: ffmpeg.h:74
AVRational frame_aspect_ratio
Definition: ffmpeg.h:484
int nb_sample_fmts
Definition: ffmpeg.h:175
int file_index
Definition: ffmpeg.h:82
int nb_audio_channel_maps
Definition: ffmpeg.h:140
AVRational mux_timebase
Definition: ffmpeg.h:459
SpecifierOpt * filter_scripts
Definition: ffmpeg.h:204
int nb_attachments
Definition: ffmpeg.h:145
char * linklabel
Definition: ffmpeg.h:86
#define b
Definition: input.c:41
int nb_hwaccel_output_formats
Definition: ffmpeg.h:132
int nb_ts_scale
Definition: ffmpeg.h:124
int is_cfr
Definition: ffmpeg.h:478
SpecifierOpt * audio_channels
Definition: ffmpeg.h:105
uint64_t * channel_layouts
Definition: ffmpeg.h:277
int saw_first_ts
Definition: ffmpeg.h:330
int nb_audio_sample_rate
Definition: ffmpeg.h:108
int abort_on_flags
Definition: ffmpeg_opt.c:166
SpecifierOpt * time_bases
Definition: ffmpeg.h:228
int metadata_chapters_manual
Definition: ffmpeg.h:143
struct OutputStream * ost
Definition: ffmpeg.h:260
int accurate_seek
Definition: ffmpeg.h:120
char * apad
Definition: ffmpeg.h:511
typedef void(APIENTRY *FF_PFNGLACTIVETEXTUREPROC)(GLenum texture)
SpecifierOpt * pass
Definition: ffmpeg.h:212
int64_t nb_samples
Definition: ffmpeg.h:327
SpecifierOpt * audio_sample_rate
Definition: ffmpeg.h:107
int hw_device_setup_for_decode(InputStream *ist)
Definition: ffmpeg_hw.c:301
int64_t duration
Definition: ffmpeg.h:399
void opt_output_file(void *optctx, const char *filename)
int width
Definition: ffmpeg.h:246
int ifilter_parameters_from_frame(InputFilter *ifilter, const AVFrame *frame)
SpecifierOpt * dump_attachment
Definition: ffmpeg.h:125
void assert_avoptions(AVDictionary *m)
Definition: ffmpeg.c:654
SpecifierOpt * canvas_sizes
Definition: ffmpeg.h:210
int nb_codec_tags
Definition: ffmpeg.h:173
int qsv_init(AVCodecContext *s)
Definition: ffmpeg_qsv.c:71
int64_t last_ts
Definition: ffmpeg.h:405
SpecifierOpt * metadata_map
Definition: ffmpeg.h:194
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
#define s(width, name)
Definition: cbs_vp9.c:257
int do_pkt_dump
Definition: ffmpeg_opt.c:160
int64_t max_frames
Definition: ffmpeg.h:468
int audio_channels_mapped
Definition: ffmpeg.h:497
SpecifierOpt * copy_prior_start
Definition: ffmpeg.h:200
SpecifierOpt * frame_aspect_ratios
Definition: ffmpeg.h:182
SpecifierOpt * frame_sizes
Definition: ffmpeg.h:111
int stream_idx
Definition: ffmpeg.h:90
int sample_rate
Definition: ffmpeg.h:272
int nb_hwaccels
Definition: ffmpeg.h:128
int inputs_done
Definition: ffmpeg.h:521
int vstats_version
Definition: ffmpeg_opt.c:174
HWDevice * hw_device_get_by_name(const char *name)
Definition: ffmpeg_hw.c:42
int start_at_zero
Definition: ffmpeg_opt.c:162
int ret
Definition: ffmpeg.h:341
int audio_volume
Definition: ffmpeg_opt.c:152
Stream structure.
Definition: avformat.h:876
A linked-list of the inputs/outputs of the filter chain.
Definition: avfilter.h:1003
InputFilter ** filters
Definition: ffmpeg.h:358
int fix_sub_duration
Definition: ffmpeg.h:338
int64_t recording_time
Definition: ffmpeg.h:408
SpecifierOpt * hwaccels
Definition: ffmpeg.h:127
Definition: ffmpeg.h:66
int(* init)(AVCodecContext *s)
Definition: ffmpeg.h:68
SpecifierOpt * frame_rates
Definition: ffmpeg.h:109
AVStream * st
Definition: ffmpeg.h:296
int nb_presets
Definition: ffmpeg.h:197
int ost_index
Definition: ffmpeg.h:557
struct InputStream * sync_ist
Definition: ffmpeg.h:451
Libavcodec external API header.
double ts_scale
Definition: ffmpeg.h:329
int64_t recording_time
Definition: ffmpeg.h:149
int unavailable
Definition: ffmpeg.h:513
void term_exit(void)
Definition: ffmpeg.c:336
int chapters_input_file
Definition: ffmpeg.h:147
int64_t stop_time
Definition: ffmpeg.h:150
float max_error_rate
Definition: ffmpeg_opt.c:171
uint64_t frames_encoded
Definition: ffmpeg.h:536
int nb_copy_prior_start
Definition: ffmpeg.h:201
AVFifoBuffer * muxing_queue
Definition: ffmpeg.h:545
OutputStream ** output_streams
Definition: ffmpeg.c:152
int ist_index
Definition: ffmpeg.h:397
const char * graph_desc
Definition: ffmpeg.h:283
int guess_layout_max
Definition: ffmpeg.h:334
int64_t start_time
Definition: ffmpeg.h:406
main external API structure.
Definition: avcodec.h:1621
InputFile ** input_files
Definition: ffmpeg.c:149
int rate_emu
Definition: ffmpeg.h:119
int * sample_rates
Definition: ffmpeg.h:278
int metadata_streams_manual
Definition: ffmpeg.h:142
const char * attachment_filename
Definition: ffmpeg.h:523
int configure_output_filter(FilterGraph *fg, OutputFilter *ofilter, AVFilterInOut *out)
a very simple circular buffer FIFO implementation
AVRational time_base
Definition: ffmpeg.h:401
AVCodecContext * enc_ctx
Definition: ffmpeg.h:465
int audio_disable
Definition: ffmpeg.h:158
int64_t input_ts_offset
Definition: ffmpeg.h:117
int nb_filtergraphs
Definition: ffmpeg.c:158
AVFrame * decoded_frame
Definition: ffmpeg.h:305
AVBufferRef * hw_frames_ctx
Definition: ffmpeg.h:253
int nb_bitstream_filters
Definition: ffmpeg.h:171
SpecifierOpt * top_field_first
Definition: ffmpeg.h:192
int channels
Definition: ffmpeg.h:250
int * audio_channels_map
Definition: ffmpeg.h:496
int configure_filtergraph(FilterGraph *fg)
Rational number (pair of numerator and denominator).
Definition: rational.h:58
int file_index
Definition: ffmpeg.h:443
int metadata_global_manual
Definition: ffmpeg.h:141
double rotate_override_value
Definition: ffmpeg.h:482
int64_t sync_opts
Definition: ffmpeg.h:452
char * vstats_filename
Definition: ffmpeg_opt.c:145
AVCodecContext * dec_ctx
Definition: ffmpeg.h:303
SpecifierOpt * force_fps
Definition: ffmpeg.h:180
char * disposition
Definition: ffmpeg.h:526
int filtergraph_is_simple(FilterGraph *fg)
AVMediaType
Definition: avutil.h:199
int nb_fix_sub_duration
Definition: ffmpeg.h:209
int nb_inter_matrices
Definition: ffmpeg.h:189
int nb_streams_warn
Definition: ffmpeg.h:411
AVDictionary * decoder_opts
Definition: ffmpeg.h:331
int shortest
Definition: ffmpeg.h:154
int autorotate
Definition: ffmpeg.h:336
int frame_bits_per_raw_sample
Definition: ffmpeg_opt.c:170
int64_t ts_offset
Definition: ffmpeg.h:404
int nb_qscale
Definition: ffmpeg.h:177
char * filters_script
filtergraph script associated to the -filter_script option
Definition: ffmpeg.h:505
int nb_enc_time_bases
Definition: ffmpeg.h:231
SpecifierOpt * hwaccel_devices
Definition: ffmpeg.h:129
int nb_input_streams
Definition: ffmpeg.c:148
float audio_drift_threshold
Definition: ffmpeg_opt.c:148
AVFrame * filtered_frame
Definition: ffmpeg.h:469
int nb_autorotate
Definition: ffmpeg.h:134
int nb_audio_channels
Definition: ffmpeg.h:106
int source_index
Definition: ffmpeg.h:445
InputStream ** input_streams
Definition: ffmpeg.c:147
int copy_prior_start
Definition: ffmpeg.h:525
SpecifierOpt * metadata
Definition: ffmpeg.h:166
AVIOContext * progress_avio
Definition: ffmpeg.c:143
#define flags(name, subs,...)
Definition: cbs_av1.c:564
int nb_filters
Definition: ffmpeg.h:359
AVExpr * forced_keyframes_pexpr
Definition: ffmpeg.h:492
static int hwaccel_retrieve_data(AVCodecContext *avctx, AVFrame *input)
Definition: ffmpeg_hw.c:433
int64_t dts
dts of the last packet read for this stream (in AV_TIME_BASE units)
Definition: ffmpeg.h:312
int forced_kf_count
Definition: ffmpeg.h:489
int nb_intra_matrices
Definition: ffmpeg.h:187
OSTFinished finished
Definition: ffmpeg.h:512
char * forced_keyframes
Definition: ffmpeg.h:491
int nb_frame_rates
Definition: ffmpeg.h:110
uint64_t data_size
Definition: ffmpeg.h:380
const AVIOInterruptCB int_cb
Definition: ffmpeg.c:489
A reference to a data buffer.
Definition: buffer.h:81
int64_t next_pts
synthetic pts for the next decode frame (in AV_TIME_BASE units)
Definition: ffmpeg.h:314
static AVStream * ost
Main libavformat public API header.
int
SpecifierOpt * max_muxing_queue_size
Definition: ffmpeg.h:216
int reconfiguration
Definition: ffmpeg.h:286
struct FilterGraph * graph
Definition: ffmpeg.h:261
uint64_t limit_filesize
Definition: ffmpeg.h:560
const OptionDef options[]
Definition: ffmpeg_opt.c:3439
SpecifierOpt * presets
Definition: ffmpeg.h:196
SpecifierOpt * program
Definition: ffmpeg.h:226
int reinit_filters
Definition: ffmpeg.h:361
int nb_frame_sizes
Definition: ffmpeg.h:112
AVCodecParameters * ref_par
Definition: ffmpeg.h:466
Utilties for rational number calculation.
OptionGroup * g
Definition: ffmpeg.h:95
SpecifierOpt * inter_matrices
Definition: ffmpeg.h:188
const char *const forced_keyframes_const_names[]
Definition: ffmpeg.c:114
AVBufferRef * device_ref
Definition: ffmpeg.h:76
SpecifierOpt * forced_key_frames
Definition: ffmpeg.h:178
uint64_t samples_encoded
Definition: ffmpeg.h:537
const char ** attachments
Definition: ffmpeg.h:144
int nb_max_muxing_queue_size
Definition: ffmpeg.h:217
AVFrame * last_frame
Definition: ffmpeg.h:470
uint64_t channel_layout
Definition: ffmpeg.h:251
int copy_ts
Definition: ffmpeg_opt.c:161
AVFormatContext * ctx
Definition: ffmpeg.h:394
int pict_type
Definition: ffmpeg.h:548
AVBufferRef * hw_device_ctx
Definition: ffmpeg_opt.c:142
int stream_index
Definition: ffmpeg.h:83
AVCodec * enc
Definition: ffmpeg.h:467
AVSubtitle subtitle
Definition: ffmpeg.h:342
enum AVPixelFormat pix_fmt
Definition: ffmpeg.h:70
int eof_reached
Definition: ffmpeg.h:395
int nb_metadata_map
Definition: ffmpeg.h:195
int forced_kf_index
Definition: ffmpeg.h:490
int nb_rc_overrides
Definition: ffmpeg.h:185
int do_deinterlace
Definition: ffmpeg_opt.c:156
SpecifierOpt * fix_sub_duration
Definition: ffmpeg.h:208
Definition: ffmpeg.h:430
pixel format definitions
AVHWDeviceType
Definition: hwcontext.h:27
char * avfilter
Definition: ffmpeg.h:503
SpecifierOpt * autorotate
Definition: ffmpeg.h:133
int hwaccel_decode_init(AVCodecContext *avctx)
Definition: ffmpeg_hw.c:475
uint8_t * name
Definition: ffmpeg.h:238
float dts_delta_threshold
Definition: ffmpeg_opt.c:149
void * hwaccel_ctx
Definition: ffmpeg.h:370
int guess_input_channel_layout(InputStream *ist)
Definition: ffmpeg.c:2081
int top_field_first
Definition: ffmpeg.h:480
OutputFilter ** outputs
Definition: ffmpeg.h:290
SpecifierOpt * max_frames
Definition: ffmpeg.h:168
int nb_copy_initial_nonkeyframes
Definition: ffmpeg.h:199
int disabled
Definition: ffmpeg.h:81
AVRational frame_rate
Definition: ffmpeg.h:270
AVFormatContext * ctx
Definition: ffmpeg.h:555
int nb_output_files
Definition: ffmpeg.c:155
int hw_device_init_from_string(const char *arg, HWDevice **dev)
Definition: ffmpeg_hw.c:92
SpecifierOpt * codec_names
Definition: ffmpeg.h:103
void show_usage(void)
Definition: ffmpeg_opt.c:3312
int thread_queue_size
Definition: ffmpeg.h:121
An instance of a filter.
Definition: avfilter.h:338
char * hwaccel_device
Definition: ffmpeg.h:366
AVDictionary * encoder_opts
Definition: ffmpeg.h:507
FILE * out
Definition: movenc.c:54
InputFilter ** inputs
Definition: ffmpeg.h:288
char * videotoolbox_pixfmt
int sync_stream_index
Definition: ffmpeg.h:85
int format
Definition: ffmpeg.h:271
int copy_tb
Definition: ffmpeg_opt.c:163
int64_t min_pts
Definition: ffmpeg.h:320
int initialized
Definition: ffmpeg.h:519
int init_simple_filtergraph(InputStream *ist, OutputStream *ost)
int discard
Definition: ffmpeg.h:297
int64_t first_pts
Definition: ffmpeg.h:455
int nb_inputs
Definition: ffmpeg.h:289
int index
Definition: ffmpeg.h:444
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
OSTFinished
Definition: ffmpeg.h:437
int nb_reinit_filters
Definition: ffmpeg.h:207
AVFifoBuffer * frame_queue
Definition: ffmpeg.h:241
int debug_ts
Definition: ffmpeg_opt.c:164
static void hwaccel_uninit(AVCodecContext *avctx)
Definition: decode.c:1358
int nb_guess_layout_max
Definition: ffmpeg.h:219
void term_init(void)
Definition: ffmpeg.c:395
int nb_frame_aspect_ratios
Definition: ffmpeg.h:183
const HWAccel hwaccels[]
Definition: ffmpeg_opt.c:133
int videotoolbox_init(AVCodecContext *s)
Definition: ffmpeg.h:429
simple arithmetic expression evaluator
const char * name
Definition: opengl_enc.c:102
int subtitle_disable
Definition: ffmpeg.h:159