2 * This file is part of FFmpeg.
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.
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.
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
34 #include "libavformat/avformat.h"
35 #include "libavformat/avio.h"
37 #include "libavcodec/avcodec.h"
39 #include "libavfilter/avfilter.h"
41 #include "libavutil/avutil.h"
42 #include "libavutil/dict.h"
43 #include "libavutil/eval.h"
44 #include "libavutil/fifo.h"
45 #include "libavutil/pixfmt.h"
46 #include "libavutil/rational.h"
47 #include "libavutil/threadmessage.h"
49 #include "libswresample/swresample.h"
52 #define VSYNC_PASSTHROUGH 0
55 #define VSYNC_VSCFR 0xfe
56 #define VSYNC_DROP 0xff
58 #define MAX_STREAMS 1024 /* arbitrary sanity check value */
68 typedef struct HWAccel
{
70 int (*init
)(AVCodecContext
*s
);
72 enum AVPixelFormat pix_fmt
;
75 /* select an input stream for an output stream */
76 typedef struct StreamMap
{
77 int disabled
; /* 1 is this mapping is disabled by a negative map */
81 int sync_stream_index
;
82 char *linklabel
; /* name of an output link, for mapping lavfi outputs */
86 int file_idx
, stream_idx
, channel_idx
; // input
87 int ofile_idx
, ostream_idx
; // output
90 typedef struct OptionsContext
{
93 /* input/output options */
97 SpecifierOpt
*codec_names
;
99 SpecifierOpt
*audio_channels
;
100 int nb_audio_channels
;
101 SpecifierOpt
*audio_sample_rate
;
102 int nb_audio_sample_rate
;
103 SpecifierOpt
*frame_rates
;
105 SpecifierOpt
*frame_sizes
;
107 SpecifierOpt
*frame_pix_fmts
;
108 int nb_frame_pix_fmts
;
111 int64_t input_ts_offset
;
115 SpecifierOpt
*ts_scale
;
117 SpecifierOpt
*dump_attachment
;
118 int nb_dump_attachment
;
119 SpecifierOpt
*hwaccels
;
121 SpecifierOpt
*hwaccel_devices
;
122 int nb_hwaccel_devices
;
125 StreamMap
*stream_maps
;
127 AudioChannelMap
*audio_channel_maps
; /* one info entry per -map_channel */
128 int nb_audio_channel_maps
; /* number of (valid) -map_channel settings */
129 int metadata_global_manual
;
130 int metadata_streams_manual
;
131 int metadata_chapters_manual
;
132 const char **attachments
;
135 int chapters_input_file
;
137 int64_t recording_time
;
139 uint64_t limit_filesize
;
146 int subtitle_disable
;
149 /* indexed by output file stream index */
153 SpecifierOpt
*metadata
;
155 SpecifierOpt
*max_frames
;
157 SpecifierOpt
*bitstream_filters
;
158 int nb_bitstream_filters
;
159 SpecifierOpt
*codec_tags
;
161 SpecifierOpt
*sample_fmts
;
163 SpecifierOpt
*qscale
;
165 SpecifierOpt
*forced_key_frames
;
166 int nb_forced_key_frames
;
167 SpecifierOpt
*force_fps
;
169 SpecifierOpt
*frame_aspect_ratios
;
170 int nb_frame_aspect_ratios
;
171 SpecifierOpt
*rc_overrides
;
173 SpecifierOpt
*intra_matrices
;
174 int nb_intra_matrices
;
175 SpecifierOpt
*inter_matrices
;
176 int nb_inter_matrices
;
177 SpecifierOpt
*chroma_intra_matrices
;
178 int nb_chroma_intra_matrices
;
179 SpecifierOpt
*top_field_first
;
180 int nb_top_field_first
;
181 SpecifierOpt
*metadata_map
;
183 SpecifierOpt
*presets
;
185 SpecifierOpt
*copy_initial_nonkeyframes
;
186 int nb_copy_initial_nonkeyframes
;
187 SpecifierOpt
*copy_prior_start
;
188 int nb_copy_prior_start
;
189 SpecifierOpt
*filters
;
191 SpecifierOpt
*filter_scripts
;
192 int nb_filter_scripts
;
193 SpecifierOpt
*reinit_filters
;
194 int nb_reinit_filters
;
195 SpecifierOpt
*fix_sub_duration
;
196 int nb_fix_sub_duration
;
197 SpecifierOpt
*canvas_sizes
;
201 SpecifierOpt
*passlogfiles
;
203 SpecifierOpt
*guess_layout_max
;
204 int nb_guess_layout_max
;
207 SpecifierOpt
*discard
;
211 typedef struct InputFilter
{
212 AVFilterContext
*filter
;
213 struct InputStream
*ist
;
214 struct FilterGraph
*graph
;
218 typedef struct OutputFilter
{
219 AVFilterContext
*filter
;
220 struct OutputStream
*ost
;
221 struct FilterGraph
*graph
;
224 /* temporary storage until stream maps are processed */
225 AVFilterInOut
*out_tmp
;
228 typedef struct FilterGraph
{
230 const char *graph_desc
;
232 AVFilterGraph
*graph
;
235 InputFilter
**inputs
;
237 OutputFilter
**outputs
;
241 typedef struct InputStream
{
244 int discard
; /* true if stream data should be discarded */
245 int user_set_discard
;
246 int decoding_needed
; /* non zero if the packets must be decoded in 'raw_fifo', see DECODING_FOR_* */
247 #define DECODING_FOR_OST 1
248 #define DECODING_FOR_FILTER 2
250 AVCodecContext
*dec_ctx
;
252 AVFrame
*decoded_frame
;
253 AVFrame
*filter_frame
; /* a ref of decoded_frame, to be sent to filters */
255 int64_t start
; /* time when read started */
256 /* predicted dts of the next packet read for this stream or (when there are
257 * several frames in a packet) of the next frame in current packet (in AV_TIME_BASE units) */
259 int64_t dts
; ///< dts of the last packet read for this stream (in AV_TIME_BASE units)
261 int64_t next_pts
; ///< synthetic pts for the next decode frame (in AV_TIME_BASE units)
262 int64_t pts
; ///< current pts of the decoded frame (in AV_TIME_BASE units)
263 int wrap_correction_done
;
265 int64_t filter_in_rescale_delta_last
;
269 int showed_multi_packet_warning
;
270 AVDictionary
*decoder_opts
;
271 AVRational framerate
; /* framerate forced with -r */
273 int guess_layout_max
;
277 int resample_pix_fmt
;
279 int resample_sample_fmt
;
280 int resample_sample_rate
;
281 int resample_channels
;
282 uint64_t resample_channel_layout
;
284 int fix_sub_duration
;
285 struct { /* previous decoded subtitle and related variables */
300 /* decoded data from this stream goes into all those filters
301 * currently video and audio only */
302 InputFilter
**filters
;
307 /* hwaccel options */
308 enum HWAccelID hwaccel_id
;
309 char *hwaccel_device
;
311 /* hwaccel context */
312 enum HWAccelID active_hwaccel_id
;
314 void (*hwaccel_uninit
)(AVCodecContext
*s
);
315 int (*hwaccel_get_buffer
)(AVCodecContext
*s
, AVFrame
*frame
, int flags
);
316 int (*hwaccel_retrieve_data
)(AVCodecContext
*s
, AVFrame
*frame
);
317 enum AVPixelFormat hwaccel_pix_fmt
;
318 enum AVPixelFormat hwaccel_retrieved_pix_fmt
;
321 // combined size of all the packets read
323 /* number of packets successfully read for this stream */
325 // number of frames/samples retrieved from the decoder
326 uint64_t frames_decoded
;
327 uint64_t samples_decoded
;
330 typedef struct InputFile
{
331 AVFormatContext
*ctx
;
332 int eof_reached
; /* true if eof reached */
333 int eagain
; /* true if last read attempt returned EAGAIN */
334 int ist_index
; /* index of first stream in input_streams */
335 int64_t input_ts_offset
;
338 int64_t start_time
; /* user-specified start time in AV_TIME_BASE or AV_NOPTS_VALUE */
339 int64_t recording_time
;
340 int nb_streams
; /* number of stream that ffmpeg is aware of; may be different
341 from ctx.nb_streams if new streams appear during av_read_frame() */
342 int nb_streams_warn
; /* number of streams that the user was warned of */
347 AVThreadMessageQueue
*in_thread_queue
;
348 pthread_t thread
; /* thread reading from this file */
349 int non_blocking
; /* reading packets from the thread should not block */
350 int joined
; /* the thread has been joined */
354 enum forced_keyframes_const
{
363 extern const char *const forced_keyframes_const_names
[];
366 ENCODER_FINISHED
= 1,
370 typedef struct OutputStream
{
371 int file_index
; /* file index */
372 int index
; /* stream index in the output file */
373 int source_index
; /* InputStream index */
374 AVStream
*st
; /* stream in the output file */
375 int encoding_needed
; /* true if encoding needed for this stream */
377 /* input pts and corresponding output pts
379 struct InputStream
*sync_ist
; /* input stream to sync against */
380 int64_t sync_opts
; /* output frame counter, could be changed to some true timestamp */ // FIXME look at frame_number
381 /* pts of the first frame encoded for this stream, used for limiting
384 /* dts of the last packet sent to the muxer */
385 int64_t last_mux_dts
;
386 AVBitStreamFilterContext
*bitstream_filters
;
387 AVCodecContext
*enc_ctx
;
390 AVFrame
*filtered_frame
;
395 AVRational frame_rate
;
399 AVRational frame_aspect_ratio
;
401 /* forced key frames */
402 int64_t *forced_kf_pts
;
405 char *forced_keyframes
;
406 AVExpr
*forced_keyframes_pexpr
;
407 double forced_keyframes_expr_const_values
[FKF_NB
];
410 int *audio_channels_map
; /* list of the channels id to pick from the source stream */
411 int audio_channels_mapped
; /* number of channels in audio_channels_map */
413 char *logfile_prefix
;
416 OutputFilter
*filter
;
418 char *filters
; ///< filtergraph associated to the -filter option
419 char *filters_script
; ///< filtergraph script associated to the -filter_script option
422 AVDictionary
*encoder_opts
;
423 AVDictionary
*swr_opts
;
424 AVDictionary
*resample_opts
;
425 AVDictionary
*bsf_args
;
427 OSTFinished finished
; /* no more packets should be written for this stream */
428 int unavailable
; /* true if the steram is unavailable (possibly temporarily) */
430 const char *attachment_filename
;
431 int copy_initial_nonkeyframes
;
432 int copy_prior_start
;
436 AVCodecParserContext
*parser
;
439 // combined size of all the packets written
441 // number of packets send to the muxer
442 uint64_t packets_written
;
443 // number of frames/samples sent to the encoder
444 uint64_t frames_encoded
;
445 uint64_t samples_encoded
;
448 typedef struct OutputFile
{
449 AVFormatContext
*ctx
;
451 int ost_index
; /* index of the first stream in output_streams */
452 int64_t recording_time
; ///< desired length of the resulting file in microseconds == AV_TIME_BASE units
453 int64_t start_time
; ///< start time in microseconds == AV_TIME_BASE units
454 uint64_t limit_filesize
; /* filesize limit expressed in bytes */
459 extern InputStream
**input_streams
;
460 extern int nb_input_streams
;
461 extern InputFile
**input_files
;
462 extern int nb_input_files
;
464 extern OutputStream
**output_streams
;
465 extern int nb_output_streams
;
466 extern OutputFile
**output_files
;
467 extern int nb_output_files
;
469 extern FilterGraph
**filtergraphs
;
470 extern int nb_filtergraphs
;
472 extern char *vstats_filename
;
474 extern float audio_drift_threshold
;
475 extern float dts_delta_threshold
;
476 extern float dts_error_threshold
;
478 extern int audio_volume
;
479 extern int audio_sync_method
;
480 extern int video_sync_method
;
481 extern int do_benchmark
;
482 extern int do_benchmark_all
;
483 extern int do_deinterlace
;
484 extern int do_hex_dump
;
485 extern int do_pkt_dump
;
487 extern int start_at_zero
;
490 extern int exit_on_error
;
491 extern int print_stats
;
493 extern int stdin_interaction
;
494 extern int frame_bits_per_raw_sample
;
495 extern AVIOContext
*progress_avio
;
496 extern float max_error_rate
;
497 extern int vdpau_api_ver
;
499 extern const AVIOInterruptCB int_cb
;
501 extern const OptionDef options
[];
502 extern const HWAccel hwaccels
[];
505 void term_init(void);
506 void term_exit(void);
508 void reset_options(OptionsContext
*o
, int is_input
);
509 void show_usage(void);
511 void opt_output_file(void *optctx
, const char *filename
);
513 void remove_avoptions(AVDictionary
**a
, AVDictionary
*b
);
514 void assert_avoptions(AVDictionary
*m
);
516 int guess_input_channel_layout(InputStream
*ist
);
518 enum AVPixelFormat
choose_pixel_fmt(AVStream
*st
, AVCodecContext
*avctx
, AVCodec
*codec
, enum AVPixelFormat target
);
519 void choose_sample_fmt(AVStream
*st
, AVCodec
*codec
);
521 int configure_filtergraph(FilterGraph
*fg
);
522 int configure_output_filter(FilterGraph
*fg
, OutputFilter
*ofilter
, AVFilterInOut
*out
);
523 int ist_in_filtergraph(FilterGraph
*fg
, InputStream
*ist
);
524 FilterGraph
*init_simple_filtergraph(InputStream
*ist
, OutputStream
*ost
);
526 int ffmpeg_parse_options(int argc
, char **argv
);
528 int vdpau_init(AVCodecContext
*s
);
529 int dxva2_init(AVCodecContext
*s
);
530 int vda_init(AVCodecContext
*s
);
532 #endif /* FFMPEG_H */