#include <stdint.h>
#include "libavcodec/avcodec.h"
#include "libavfilter/avfilter.h"
#include "libavformat/avformat.h"
#include "libswscale/swscale.h"

Include dependency graph for cmdutils.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	SpecifierOpt

struct	OptionDef

struct	Option
	An option extracted from the commandline. More...

struct	OptionGroupDef

struct	OptionGroup

struct	OptionGroupList
	A list of option groups that all have the same group type (e.g. More...

struct	OptionParseContext

Macros
#define	HAS_ARG 0x0001

#define	OPT_BOOL 0x0002

#define	OPT_EXPERT 0x0004

#define	OPT_STRING 0x0008

#define	OPT_VIDEO 0x0010

#define	OPT_AUDIO 0x0020

#define	OPT_INT 0x0080

#define	OPT_FLOAT 0x0100

#define	OPT_SUBTITLE 0x0200

#define	OPT_INT64 0x0400

#define	OPT_EXIT 0x0800

#define	OPT_DATA 0x1000

#define	OPT_PERFILE

#define	OPT_OFFSET 0x4000 /* option is specified as an offset in a passed optctx */

#define	OPT_SPEC

#define	OPT_TIME 0x10000

#define	OPT_DOUBLE 0x20000

#define	OPT_INPUT 0x40000

#define	OPT_OUTPUT 0x80000

#define	media_type_string av_get_media_type_string

#define	GROW_ARRAY(array, nb_elems) array = grow_array(array, sizeof(*array), &nb_elems, nb_elems + 1)

#define	GET_PIX_FMT_NAME(pix_fmt) const char *name = av_get_pix_fmt_name(pix_fmt);

#define	GET_SAMPLE_FMT_NAME(sample_fmt) const char *name = av_get_sample_fmt_name(sample_fmt)

#define	GET_SAMPLE_RATE_NAME(rate)

#define	GET_CH_LAYOUT_NAME(ch_layout)

#define	GET_CH_LAYOUT_DESC(ch_layout)

Typedefs
typedef struct SpecifierOpt	SpecifierOpt

typedef struct OptionDef	OptionDef

typedef struct Option	Option
	An option extracted from the commandline. More...

typedef struct OptionGroupDef	OptionGroupDef

typedef struct OptionGroup	OptionGroup

typedef struct OptionGroupList	OptionGroupList
	A list of option groups that all have the same group type (e.g. More...

typedef struct OptionParseContext	OptionParseContext

Functions
void	init_opts (void)
	Initialize the cmdutils option system, in particular allocate the *_opts contexts. More...

void	uninit_opts (void)
	Uninitialize the cmdutils option system, in particular free the *_opts contexts and their contents. More...

void	log_callback_help (void ptr, int level, const char fmt, va_list vl)
	Trivial log callback. More...

int	opt_default (void optctx, const char opt, const char *arg)
	Fallback for options that are not explicitly handled, these will be parsed through AVOptions. More...

int	opt_loglevel (void optctx, const char opt, const char *arg)
	Set the libav* libraries log level. More...

int	opt_report (const char *opt)

int	opt_max_alloc (void optctx, const char opt, const char *arg)

int	opt_cpuflags (void optctx, const char opt, const char *arg)

int	opt_codec_debug (void optctx, const char opt, const char *arg)

int	opt_opencl (void optctx, const char opt, const char *arg)

int	opt_timelimit (void optctx, const char opt, const char *arg)
	Limit the execution time. More...

double	parse_number_or_die (const char context, const char numstr, int type, double min, double max)
	Parse a string and return its corresponding value as a double. More...

int64_t	parse_time_or_die (const char context, const char timestr, int is_duration)
	Parse a string specifying a time and return its corresponding value as a number of microseconds. More...

void	show_help_options (const OptionDef options, const char msg, int req_flags, int rej_flags, int alt_flags)
	Print help for all options matching specified flags. More...

void	show_help_children (const AVClass *class, int flags)
	Show help for all options with given flags in class and all its children. More...

void	show_help_default (const char opt, const char arg)
	Per-fftool specific help handler. More...

int	show_help (void optctx, const char opt, const char *arg)
	Generic -h handler common to all fftools. More...

void	parse_options (void optctx, int argc, char argv, const OptionDef options, void(parse_arg_function)(void optctx, const char *))
	Parse the command line arguments. More...

int	parse_option (void optctx, const char opt, const char arg, const OptionDef options)
	Parse one given option. More...

int	parse_optgroup (void optctx, OptionGroup g)
	Parse an options group and write results into optctx. More...

int	split_commandline (OptionParseContext octx, int argc, char argv[], const OptionDef options, const OptionGroupDef groups, int nb_groups)
	Split the commandline into an intermediate form convenient for further processing. More...

void	uninit_parse_context (OptionParseContext *octx)
	Free all allocated memory in an OptionParseContext. More...

void	parse_loglevel (int argc, char *argv, const OptionDef options)
	Find the '-loglevel' option in the command line args and apply it. More...

int	locate_option (int argc, char *argv, const OptionDef options, const char *optname)
	Return index of option opt in argv or 0 if not found. More...

int	check_stream_specifier (AVFormatContext s, AVStream st, const char *spec)
	Check if the given stream matches a stream specifier. More...

AVDictionary *	filter_codec_opts (AVDictionary opts, enum AVCodecID codec_id, AVFormatContext s, AVStream st, AVCodec codec)
	Filter out options for given codec. More...

AVDictionary **	setup_find_stream_info_opts (AVFormatContext s, AVDictionary codec_opts)
	Setup AVCodecContext options for avformat_find_stream_info(). More...

void	print_error (const char *filename, int err)
	Print an error message to stderr, indicating filename and a human readable description of the error code err. More...

void	show_banner (int argc, char *argv, const OptionDef options)
	Print the program banner to stderr. More...

int	show_version (void optctx, const char opt, const char *arg)
	Print the version of the program to stdout. More...

int	show_license (void optctx, const char opt, const char *arg)
	Print the license of the program to stdout. More...

int	show_formats (void optctx, const char opt, const char *arg)
	Print a listing containing all the formats supported by the program. More...

int	show_codecs (void optctx, const char opt, const char *arg)
	Print a listing containing all the codecs supported by the program. More...

int	show_decoders (void optctx, const char opt, const char *arg)
	Print a listing containing all the decoders supported by the program. More...

int	show_encoders (void optctx, const char opt, const char *arg)
	Print a listing containing all the encoders supported by the program. More...

int	show_filters (void optctx, const char opt, const char *arg)
	Print a listing containing all the filters supported by the program. More...

int	show_bsfs (void optctx, const char opt, const char *arg)
	Print a listing containing all the bit stream filters supported by the program. More...

int	show_protocols (void optctx, const char opt, const char *arg)
	Print a listing containing all the protocols supported by the program. More...

int	show_pix_fmts (void optctx, const char opt, const char *arg)
	Print a listing containing all the pixel formats supported by the program. More...

int	show_layouts (void optctx, const char opt, const char *arg)
	Print a listing containing all the standard channel layouts supported by the program. More...

int	show_sample_fmts (void optctx, const char opt, const char *arg)
	Print a listing containing all the sample formats supported by the program. More...

int	read_yesno (void)
	Return a positive value if a line read from standard input starts with [yY], otherwise return 0. More...

int	cmdutils_read_file (const char filename, char bufptr, size_t size)
	Read the file with name filename, and put its content in a newly allocated 0-terminated buffer. More...

FILE *	get_preset_file (char filename, size_t filename_size, const char preset_name, int is_path, const char *codec_name)
	Get a file corresponding to a preset file. More...

void *	grow_array (void array, int elem_size, int size, int new_size)
	Realloc array to hold new_size elements of elem_size. More...

Variables
const char	program_name []
	program name, defined by the program for show_version(). More...

const int	program_birth_year
	program birth year, defined by the program for show_banner() More...

const int	this_year
	this year, defined by the program for show_banner() More...

AVCodecContext *	avcodec_opts [AVMEDIA_TYPE_NB]

AVFormatContext *	avformat_opts

struct SwsContext *	sws_opts

AVDictionary *	swr_opts

AVDictionary *	format_opts

AVDictionary *	codec_opts

AVDictionary *	resample_opts

Macro Definition Documentation

#define GET_CH_LAYOUT_DESC ( ch_layout )

Value:

char name[128];\

av_get_channel_layout_string(name, sizeof(name), 0, ch_layout);

name

const char * name

Definition: avisynth_c.h:675

av_get_channel_layout_string

void av_get_channel_layout_string(char *buf, int buf_size, int nb_channels, uint64_t channel_layout)

Return a description of a channel layout.

Definition: channel_layout.c:182

Definition at line 548 of file cmdutils.h.

Referenced by print_codec().

#define GET_CH_LAYOUT_NAME ( ch_layout )

Value:

char name[16];\

snprintf(name, sizeof(name), "0x%"PRIx64, ch_layout);

name

const char * name

Definition: avisynth_c.h:675

snprintf

#define snprintf

Definition: snprintf.h:34

Definition at line 544 of file cmdutils.h.

#define GET_PIX_FMT_NAME ( pix_fmt ) const char *name = av_get_pix_fmt_name(pix_fmt);

Definition at line 534 of file cmdutils.h.

Referenced by print_codec().

#define GET_SAMPLE_FMT_NAME ( sample_fmt ) const char *name = av_get_sample_fmt_name(sample_fmt)

Definition at line 537 of file cmdutils.h.

Referenced by print_codec().

#define GET_SAMPLE_RATE_NAME ( rate )

Value:

char name[16];\

snprintf(name, sizeof(name), "%d", rate);

name

const char * name

Definition: avisynth_c.h:675

snprintf

#define snprintf

Definition: snprintf.h:34

Definition at line 540 of file cmdutils.h.

Referenced by print_codec().

#define GROW_ARRAY	(	array,
		nb_elems
	)	array = grow_array(array, sizeof(*array), &nb_elems, nb_elems + 1)

Definition at line 531 of file cmdutils.h.

Referenced by add_input_streams(), add_opt(), configure_filtergraph(), DEF_CHOOSE_FORMAT(), finish_group(), init_input_filter(), new_output_stream(), open_input_file(), open_output_file(), opt_attach(), opt_filter_complex(), opt_filter_complex_script(), opt_map(), and opt_map_channel().

#define HAS_ARG 0x0001

Definition at line 147 of file cmdutils.h.

Referenced by locate_option(), parse_option(), and split_commandline().

#define media_type_string av_get_media_type_string

Definition at line 529 of file cmdutils.h.

Referenced by show_help_filter().

#define OPT_AUDIO 0x0020

Definition at line 152 of file cmdutils.h.

Referenced by show_help_default().

#define OPT_BOOL 0x0002

Definition at line 148 of file cmdutils.h.

Referenced by parse_option(), split_commandline(), and write_option().

#define OPT_DATA 0x1000

Definition at line 158 of file cmdutils.h.

#define OPT_DOUBLE 0x20000

Definition at line 166 of file cmdutils.h.

Referenced by write_option().

#define OPT_EXIT 0x0800

Definition at line 157 of file cmdutils.h.

Referenced by show_help_default(), split_commandline(), and write_option().

#define OPT_EXPERT 0x0004

Definition at line 149 of file cmdutils.h.

Referenced by show_help_default().

#define OPT_FLOAT 0x0100

Definition at line 154 of file cmdutils.h.

Referenced by write_option().

#define OPT_INPUT 0x40000

Definition at line 167 of file cmdutils.h.

#define OPT_INT 0x0080

Definition at line 153 of file cmdutils.h.

Referenced by opt_show_mode(), opt_streamid(), opt_vsync(), parse_number_or_die(), and write_option().

#define OPT_INT64 0x0400

Definition at line 156 of file cmdutils.h.

Referenced by opt_height(), opt_timelimit(), opt_width(), parse_number_or_die(), and write_option().

#define OPT_OFFSET 0x4000 /* option is specified as an offset in a passed optctx */

Definition at line 161 of file cmdutils.h.

Referenced by add_opt(), show_help_default(), uninit_options(), and write_option().

#define OPT_OUTPUT 0x80000

Definition at line 168 of file cmdutils.h.

#define OPT_PERFILE

Value:

0x2000 /* the option is per-file (currently ffmpeg-only).

implied by OPT_OFFSET or OPT_SPEC */

Definition at line 159 of file cmdutils.h.

Referenced by add_opt(), and show_help_default().

#define OPT_SPEC

Value:

0x8000       /* option is to be stored in an array of SpecifierOpt.
                                   Implies OPT_OFFSET. Next element after the offset is
                                   an int containing element count in the array. */

Definition at line 162 of file cmdutils.h.

Referenced by add_opt(), show_help_default(), uninit_options(), and write_option().

#define OPT_STRING 0x0008

Definition at line 150 of file cmdutils.h.

Referenced by uninit_options(), and write_option().

#define OPT_SUBTITLE 0x0200

Definition at line 155 of file cmdutils.h.

Referenced by show_help_default().

#define OPT_TIME 0x10000

Definition at line 165 of file cmdutils.h.

Referenced by write_option().

#define OPT_VIDEO 0x0010

Definition at line 151 of file cmdutils.h.

Referenced by show_help_default().

Typedef Documentation

typedef struct Option Option

An option extracted from the commandline.

Cannot use AVDictionary because of options like -map which can be used multiple times.

typedef struct OptionDef OptionDef

typedef struct OptionGroup OptionGroup

typedef struct OptionGroupDef OptionGroupDef

typedef struct OptionGroupList OptionGroupList

A list of option groups that all have the same group type (e.g.

input files or output files)

typedef struct OptionParseContext OptionParseContext

typedef struct SpecifierOpt SpecifierOpt

Function Documentation

int check_stream_specifier	(	AVFormatContext *	s,
		AVStream *	st,
		const char *	spec
	)

Check if the given stream matches a stream specifier.

Parameters

s	Corresponding format context.
st	Stream from s to be checked.
spec	A stream specifier of the [v\|a\|s\|d]:[<stream index>] form.

Returns: 1 if the stream matches, 0 if it doesn't, <0 on error

Definition at line 1828 of file cmdutils.c.

Referenced by copy_metadata(), filter_codec_opts(), init_input_filter(), open_input_file(), open_output_file(), and opt_map().

int cmdutils_read_file	(	const char *	filename,
		char **	bufptr,
		size_t *	size
	)

Read the file with name filename, and put its content in a newly allocated 0-terminated buffer.

Parameters

filename	file to read from
bufptr	location where pointer to buffer is returned
size	location where size of buffer is returned

Returns: 0 in case of success, a negative value corresponding to an AVERROR error code in case of failure.

Definition at line 1736 of file cmdutils.c.

Referenced by transcode_init().

AVDictionary* filter_codec_opts	(	AVDictionary *	opts,
		enum AVCodecID	codec_id,
		AVFormatContext *	s,
		AVStream *	st,
		AVCodec *	codec
	)

Filter out options for given codec.

Create a new options dictionary containing only the options from opts which apply to the codec with ID codec_id.

Parameters

opts	dictionary to place options in
codec_id	ID of the codec that should be filtered for
s	Corresponding format context.
st	A stream from s for which the options should be filtered.
codec	The particular codec for which the options should be filtered. If null, the default one is looked up according to the codec id.

Returns: a pointer to the created dictionary

Definition at line 1836 of file cmdutils.c.

Referenced by add_input_streams(), new_output_stream(), open_input_file(), setup_find_stream_info_opts(), and stream_component_open().

FILE* get_preset_file	(	char *	filename,
		size_t	filename_size,
		const char *	preset_name,
		int	is_path,
		const char *	codec_name
	)

Get a file corresponding to a preset file.

If is_path is non-zero, look for the file in the path preset_name. Otherwise search for a file named arg.ffpreset in the directories $FFMPEG_DATADIR (if set), $HOME/.ffmpeg, and in the datadir defined at configuration time or in a "ffpresets" folder along the executable on win32, in that order. If no such file is found and codec_name is defined, then search for a file named codec_name-preset_name.avpreset in the above-mentioned directories.

Parameters

filename	buffer where the name of the found filename is written
filename_size	size in bytes of the filename buffer
preset_name	name of the preset to search
is_path	tell if preset_name is a filename path
codec_name	name of the codec for which to look for the preset, may be NULL

Definition at line 1778 of file cmdutils.c.

Referenced by ffserver_opt_preset(), and opt_preset().

void* grow_array	(	void *	array,
		int	elem_size,
		int *	size,
		int	new_size
	)

Realloc array to hold new_size elements of elem_size.

Calls exit() on failure.

Parameters

array	array to reallocate
elem_size	size in bytes of each element
size	new element count will be written here
new_size	number of elements to place in reallocated array

Returns: reallocated array

Definition at line 1912 of file cmdutils.c.

Referenced by opt_streamid(), and write_option().

void init_opts ( void )

Initialize the cmdutils option system, in particular allocate the *_opts contexts.

Definition at line 74 of file cmdutils.c.

Referenced by finish_group(), init_parse_context(), and main().

int locate_option	(	int	argc,
		char **	argv,
		const OptionDef *	options,
		const char *	optname
	)

Return index of option opt in argv or 0 if not found.

Definition at line 409 of file cmdutils.c.

Referenced by parse_loglevel(), and show_banner().

void log_callback_help	(	void *	ptr,
		int	level,
		const char *	fmt,
		va_list	vl
	)

Trivial log callback.

Only suitable for opt_help and similar since it lacks prefix handling.

Definition at line 95 of file cmdutils.c.

Referenced by show_help(), show_help_default(), and show_version().

int opt_codec_debug	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

int opt_cpuflags	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Definition at line 937 of file cmdutils.c.

int opt_default	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Fallback for options that are not explicitly handled, these will be parsed through AVOptions.

Definition at line 483 of file cmdutils.c.

Referenced by opt_default_new(), opt_frame_pix_fmt(), opt_frame_size(), opt_video_channel(), opt_video_standard(), and split_commandline().

int opt_loglevel	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Set the libav* libraries log level.

Definition at line 784 of file cmdutils.c.

Referenced by parse_loglevel().

int opt_max_alloc	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Definition at line 923 of file cmdutils.c.

int opt_opencl	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Referenced by opt_timelimit().

int opt_report ( const char * opt )

Definition at line 918 of file cmdutils.c.

int opt_timelimit	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Limit the execution time.

Definition at line 949 of file cmdutils.c.

void parse_loglevel	(	int	argc,
		char **	argv,
		const OptionDef *	options
	)

Find the '-loglevel' option in the command line args and apply it.

Definition at line 459 of file cmdutils.c.

Referenced by main().

double parse_number_or_die	(	const char *	context,
		const char *	numstr,
		int	type,
		double	min,
		double	max
	)

Parse a string and return its corresponding value as a double.

Exit from the application if the string cannot be correctly parsed or the corresponding value is invalid.

Parameters

context	the context of the value to be set (e.g. the corresponding command line option name)
numstr	the string to be parsed
type	the type (OPT_INT64 or OPT_FLOAT) as which the string should be parsed
min	the minimum valid accepted value
max	the maximum valid accepted value

Definition at line 114 of file cmdutils.c.

Referenced by opt_height(), opt_show_mode(), opt_streamid(), opt_timelimit(), opt_vsync(), opt_width(), and write_option().

int parse_optgroup	(	void *	optctx,
		OptionGroup *	g
	)

Parse an options group and write results into optctx.

Parameters

optctx an app-specific options context. NULL for global options group

Definition at line 376 of file cmdutils.c.

Referenced by ffmpeg_parse_options(), and open_files().

int parse_option	(	void *	optctx,
		const char *	opt,
		const char *	arg,
		const OptionDef *	options
	)

Parse one given option.

Returns: on success 1 if arg was consumed, 0 otherwise; negative number on error

Definition at line 312 of file cmdutils.c.

Referenced by opt_audio_codec(), opt_audio_filters(), opt_audio_frames(), opt_audio_qscale(), opt_channel_layout(), opt_data_codec(), opt_data_frames(), opt_old2new(), opt_qscale(), opt_recording_timestamp(), opt_subtitle_codec(), opt_target(), opt_timecode(), opt_video_codec(), opt_video_filters(), opt_video_frames(), parse_options(), and read_ffserver_streams().

void parse_options	(	void *	optctx,
		int	argc,
		char **	argv,
		const OptionDef *	options,
		void()(void optctx, const char *)	parse_arg_function
	)

Parse the command line arguments.

Parameters

optctx	an opaque options context
argc	number of command line arguments
argv	values of command line arguments
options	Array with the definitions required to interpret every option of the form: -option_name [argument]
parse_arg_function	Name of the function called to process every argument without a leading option name flag. NULL if such arguments do not have to be processed.

int64_t parse_time_or_die	(	const char *	context,
		const char *	timestr,
		int	is_duration
	)

Parse a string specifying a time and return its corresponding value as a number of microseconds.

Exit from the application if the string cannot be correctly parsed.

Parameters

context	the context of the value to be set (e.g. the corresponding command line option name)
timestr	the string to be parsed
is_duration	a flag which tells how to interpret timestr, if not zero timestr is interpreted as a duration, otherwise as a date

See also: av_parse_time()

Definition at line 135 of file cmdutils.c.

Referenced by opt_duration(), opt_recording_timestamp(), opt_seek(), parse_forced_key_frames(), and write_option().

void print_error	(	const char *	filename,
		int	err
	)

Print an error message to stderr, indicating filename and a human readable description of the error code err.

If strerror_r() is not available the use of this function in a multithreaded application may be unsafe.

See also: av_strerror()

Definition at line 982 of file cmdutils.c.

Referenced by open_input_file(), open_output_file(), process_input(), read_thread(), and write_frame().

int read_yesno ( void )

Return a positive value if a line read from standard input starts with [yY], otherwise return 0.

Definition at line 1725 of file cmdutils.c.

Referenced by assert_file_overwrite().

AVDictionary** setup_find_stream_info_opts	(	AVFormatContext *	s,
		AVDictionary *	codec_opts
	)

Setup AVCodecContext options for avformat_find_stream_info().

Create an array of dictionaries, one dictionary for each stream contained in s. Each dictionary will contain the options from codec_opts which can be applied to the corresponding stream codec context.

Returns: pointer to the created array of dictionaries, NULL if it cannot be created

Definition at line 1892 of file cmdutils.c.

Referenced by open_input_file(), and read_thread().

void show_banner	(	int	argc,
		char **	argv,
		const OptionDef *	options
	)

Print the program banner to stderr.

The banner contents depend on the current version of the repository and of the libav* libraries used by the program.

Definition at line 1055 of file cmdutils.c.

Referenced by main().

int show_bsfs	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print a listing containing all the bit stream filters supported by the program.

This option processing function does not utilize the arguments.

Definition at line 1423 of file cmdutils.c.

int show_codecs	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print a listing containing all the codecs supported by the program.

This option processing function does not utilize the arguments.

Definition at line 1321 of file cmdutils.c.

int show_decoders	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print a listing containing all the decoders supported by the program.

Definition at line 1411 of file cmdutils.c.

int show_encoders	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print a listing containing all the encoders supported by the program.

Definition at line 1417 of file cmdutils.c.

int show_filters	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print a listing containing all the filters supported by the program.

This option processing function does not utilize the arguments.

Definition at line 1449 of file cmdutils.c.

int show_formats	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print a listing containing all the formats supported by the program.

This option processing function does not utilize the arguments.

Definition at line 1149 of file cmdutils.c.

int show_help	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Generic -h handler common to all fftools.

Definition at line 1693 of file cmdutils.c.

void show_help_children	(	const AVClass *	class,
		int	flags
	)

Show help for all options with given flags in class and all its children.

Definition at line 176 of file cmdutils.c.

Referenced by print_codec(), show_help_children(), show_help_default(), show_help_demuxer(), show_help_filter(), and show_help_muxer().

void show_help_default	(	const char *	opt,
		const char *	arg
	)

Per-fftool specific help handler.

Implemented in each fftool, called by show_help().

Definition at line 2374 of file ffmpeg_opt.c.

Referenced by show_help().

void show_help_options	(	const OptionDef *	options,
		const char *	msg,
		int	req_flags,
		int	rej_flags,
		int	alt_flags
	)

Print help for all options matching specified flags.

Parameters

options	a list of options
msg	title of this group. Only printed if at least one option matches.
req_flags	print only options which have all those flags set.
rej_flags	don't print options which have any of those flags set.
alt_flags	print only options that have at least one of those flags set

Definition at line 147 of file cmdutils.c.

Referenced by show_help_default().

int show_layouts	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print a listing containing all the standard channel layouts supported by the program.

This option processing function does not utilize the arguments.

Definition at line 1519 of file cmdutils.c.

int show_license	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print the license of the program to stdout.

The license depends on the license of the libraries compiled into the program. This option processing function does not utilize the arguments.

Definition at line 1075 of file cmdutils.c.

int show_pix_fmts	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print a listing containing all the pixel formats supported by the program.

This option processing function does not utilize the arguments.

Definition at line 1486 of file cmdutils.c.

int show_protocols	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print a listing containing all the protocols supported by the program.

This option processing function does not utilize the arguments.

Definition at line 1434 of file cmdutils.c.

int show_sample_fmts	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print a listing containing all the sample formats supported by the program.

Definition at line 1548 of file cmdutils.c.

int show_version	(	void *	optctx,
		const char *	opt,
		const char *	arg
	)

Print the version of the program to stdout.

The version message depends on the current versions of the repository and of the libav* libraries. This option processing function does not utilize the arguments.

Definition at line 1066 of file cmdutils.c.

int split_commandline	(	OptionParseContext *	octx,
		int	argc,
		char *	argv[],
		const OptionDef *	options,
		const OptionGroupDef *	groups,
		int	nb_groups
	)

Split the commandline into an intermediate form convenient for further processing.

The commandline is assumed to be composed of options which either belong to a group (those with OPT_SPEC, OPT_OFFSET or OPT_PERFILE) or are global (everything else).

A group (defined by an OptionGroupDef struct) is a sequence of options terminated by either a group separator option (e.g. -i) or a parameter that is not an option (doesn't start with -). A group without a separator option must always be first in the supplied groups list.

All options within the same group are stored in one OptionGroup struct in an OptionGroupList, all groups with the same group definition are stored in one OptionGroupList in OptionParseContext.groups. The order of group lists is the same as the order of group definitions.

Definition at line 678 of file cmdutils.c.

Referenced by ffmpeg_parse_options().

void uninit_opts ( void )

Uninitialize the cmdutils option system, in particular free the *_opts contexts and their contents.

Definition at line 82 of file cmdutils.c.

Referenced by do_exit(), exit_program(), main(), and uninit_parse_context().

void uninit_parse_context ( OptionParseContext * octx )

Free all allocated memory in an OptionParseContext.

Definition at line 651 of file cmdutils.c.

Referenced by ffmpeg_parse_options().