fftools_cmdutils.h File Reference

Go to the source code of this file.

## Data Structures

struct | SpecifierOpt
struct | OptionDef
struct | Option
struct | OptionGroupDef
struct | OptionGroup
struct | OptionGroupList
struct | OptionParseContext

## Macros

#define | AV_LOG_STDERR -16
#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_CODEC_NAME(id) const char *name = avcodec_descriptor_get(id)->name;
#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
typedef struct OptionGroupDef | OptionGroupDef
typedef struct OptionGroup | OptionGroup
typedef struct OptionGroupList | OptionGroupList
typedef struct OptionParseContext | OptionParseContext

## Functions

void | register_exit (void(*cb)(int ret))
void | exit_program (int ret) av_noreturn
void | init_dynload (void)
void | init_opts (void)
void | uninit_opts (void)
void | log_callback_help (void *ptr, int level, const char *fmt, va_list vl)
int | opt_cpuflags (void *optctx, const char *opt, const char *arg)
int | opt_default (void *optctx, const char *opt, const char *arg)
int | opt_loglevel (void *optctx, const char *opt, const char *arg)
int | opt_report (void *optctx, const char *opt, const char *arg)
int | opt_max_alloc (void *optctx, const char *opt, const char *arg)
int | opt_codec_debug (void *optctx, const char *opt, const char *arg)
int | opt_timelimit (void *optctx, const char *opt, const char *arg)
double | parse_number_or_die (const char *context, const char *numstr, int type, double min, double max)
int64_t | parse_time_or_die (const char *context, const char *timestr, int is_duration)
void | show_help_options (const OptionDef *options, const char *msg, int req_flags, int rej_flags, int alt_flags)
void | show_help_children (const AVClass *class, int flags)
void | show_help_default_ffmpeg (const char *opt, const char *arg)
void | show_help_default_ffprobe (const char *opt, const char *arg)
int | show_help (void *optctx, const char *opt, const char *arg)
void | parse_options (void *optctx, int argc, char **argv, const OptionDef *options, void(*parse_arg_function)(void *optctx, const char *))
int | parse_option (void *optctx, const char *opt, const char *arg, const OptionDef *options)
int | parse_optgroup (void *optctx, OptionGroup *g)
int | split_commandline (OptionParseContext *octx, int argc, char *argv[], const OptionDef *options, const OptionGroupDef *groups, int nb_groups)
void | uninit_parse_context (OptionParseContext *octx)
void | parse_loglevel (int argc, char **argv, const OptionDef *options)
int | locate_option (int argc, char **argv, const OptionDef *options, const char *optname)
int | check_stream_specifier (AVFormatContext *s, AVStream *st, const char *spec)
AVDictionary * | filter_codec_opts (AVDictionary *opts, enum AVCodecID codec_id, AVFormatContext *s, AVStream *st, AVCodec *codec)
AVDictionary ** | setup_find_stream_info_opts (AVFormatContext *s, AVDictionary *codec_opts)
void | print_error (const char *filename, int err)
void | show_banner (int argc, char **argv, const OptionDef *options)
int | show_version (void *optctx, const char *opt, const char *arg)
int | show_buildconf (void *optctx, const char *opt, const char *arg)
int | show_license (void *optctx, const char *opt, const char *arg)
int | show_formats (void *optctx, const char *opt, const char *arg)
int | show_muxers (void *optctx, const char *opt, const char *arg)
int | show_demuxers (void *optctx, const char *opt, const char *arg)
int | show_devices (void *optctx, const char *opt, const char *arg)
int | show_codecs (void *optctx, const char *opt, const char *arg)
int | show_decoders (void *optctx, const char *opt, const char *arg)
int | show_encoders (void *optctx, const char *opt, const char *arg)
int | show_filters (void *optctx, const char *opt, const char *arg)
int | show_bsfs (void *optctx, const char *opt, const char *arg)
int | show_protocols (void *optctx, const char *opt, const char *arg)
int | show_pix_fmts (void *optctx, const char *opt, const char *arg)
int | show_layouts (void *optctx, const char *opt, const char *arg)
int | show_sample_fmts (void *optctx, const char *opt, const char *arg)
int | show_colors (void *optctx, const char *opt, const char *arg)
int | read_yesno (void)
FILE * | get_preset_file (char *filename, size_t filename_size, const char *preset_name, int is_path, const char *codec_name)
void * | grow_array (void *array, int elem_size, int *size, int new_size)
double | get_rotation (AVStream *st)

## Variables

__thread char * | program_name
__thread int | program_birth_year
__thread AVCodecContext * | avcodec_opts [AVMEDIA_TYPE_NB]
__thread AVFormatContext * | avformat_opts
__thread AVDictionary * | sws_dict
__thread AVDictionary * | swr_opts
__thread AVDictionary * | format_opts
__thread AVDictionary * | codec_opts
__thread AVDictionary * | resample_opts
__thread int | hide_banner
__thread int | find_stream_info

## Macro Definition Documentation

## AV_LOG_STDERR

#define AV_LOG_STDERR -16

Defines logs printed to stderr by ffmpeg. They are not filtered and always redirected.

Definition at line 63 of file fftools_cmdutils.h.

## GET_CH_LAYOUT_DESC

#define GET_CH_LAYOUT_DESC | ( |  | ch_layout | ) |

Value:
char name[128];\
av_get_channel_layout_string(name, sizeof(name), 0, ch_layout);

Definition at line 629 of file fftools_cmdutils.h.

## GET_CH_LAYOUT_NAME

#define GET_CH_LAYOUT_NAME | ( |  | ch_layout | ) |

Value:
char name[16];\
snprintf(name, sizeof(name), "0x%"PRIx64, ch_layout);

Definition at line 625 of file fftools_cmdutils.h.

## GET_CODEC_NAME

#define GET_CODEC_NAME | ( |  | id | ) | const char *name = avcodec_descriptor_get(id)->name;

Definition at line 615 of file fftools_cmdutils.h.

## GET_PIX_FMT_NAME

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

Definition at line 612 of file fftools_cmdutils.h.

## GET_SAMPLE_FMT_NAME

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

Definition at line 618 of file fftools_cmdutils.h.

## GET_SAMPLE_RATE_NAME

#define GET_SAMPLE_RATE_NAME | ( |  | rate | ) |

Value:
char name[16];\
snprintf(name, sizeof(name), "%d", rate);

Definition at line 621 of file fftools_cmdutils.h.

## GROW_ARRAY

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

Definition at line 609 of file fftools_cmdutils.h.

## HAS_ARG

#define HAS_ARG 0x0001

Definition at line 190 of file fftools_cmdutils.h.

## media_type_string

#define media_type_string av_get_media_type_string

Definition at line 607 of file fftools_cmdutils.h.

## OPT_AUDIO

#define OPT_AUDIO 0x0020

Definition at line 195 of file fftools_cmdutils.h.

## OPT_BOOL

#define OPT_BOOL 0x0002

Definition at line 191 of file fftools_cmdutils.h.

## OPT_DATA

#define OPT_DATA 0x1000

Definition at line 201 of file fftools_cmdutils.h.

## OPT_DOUBLE

#define OPT_DOUBLE 0x20000

Definition at line 206 of file fftools_cmdutils.h.

## OPT_EXIT

#define OPT_EXIT 0x0800

Definition at line 200 of file fftools_cmdutils.h.

## OPT_EXPERT

#define OPT_EXPERT 0x0004

Definition at line 192 of file fftools_cmdutils.h.

## OPT_FLOAT

#define OPT_FLOAT 0x0100

Definition at line 197 of file fftools_cmdutils.h.

## OPT_INPUT

#define OPT_INPUT 0x40000

Definition at line 207 of file fftools_cmdutils.h.

## OPT_INT

#define OPT_INT 0x0080

Definition at line 196 of file fftools_cmdutils.h.

## OPT_INT64

#define OPT_INT64 0x0400

Definition at line 199 of file fftools_cmdutils.h.

## OPT_OFFSET

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

Definition at line 203 of file fftools_cmdutils.h.

## OPT_OUTPUT

#define OPT_OUTPUT 0x80000

Definition at line 208 of file fftools_cmdutils.h.

## OPT_PERFILE

#define OPT_PERFILE

Value:
0x2000 /* the option is per-file (currently ffmpeg-only).
implied by OPT_OFFSET or OPT_SPEC */

Definition at line 202 of file fftools_cmdutils.h.

## OPT_SPEC

#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 204 of file fftools_cmdutils.h.

## OPT_STRING

#define OPT_STRING 0x0008

Definition at line 193 of file fftools_cmdutils.h.

## OPT_SUBTITLE

#define OPT_SUBTITLE 0x0200

Definition at line 198 of file fftools_cmdutils.h.

## OPT_TIME

#define OPT_TIME 0x10000

Definition at line 205 of file fftools_cmdutils.h.

## OPT_VIDEO

#define OPT_VIDEO 0x0010

Definition at line 194 of file fftools_cmdutils.h.

## Typedef Documentation

## Option

typedef struct Option Option

An option extracted from the commandline. Cannot use AVDictionary because of options like -map which can be used multiple times.

## OptionDef

typedef struct OptionDef OptionDef

## OptionGroup

typedef struct OptionGroup OptionGroup

## OptionGroupDef

typedef struct OptionGroupDef OptionGroupDef

## OptionGroupList

typedef struct OptionGroupList OptionGroupList

A list of option groups that all have the same group type (e.g. input files or output files)

## OptionParseContext

typedef struct OptionParseContext OptionParseContext

## SpecifierOpt

typedef struct SpecifierOpt SpecifierOpt

## Function Documentation

## check_stream_specifier()

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 2145 of file fftools_cmdutils.c.

## exit_program()

void exit_program | ( | int | ret | ) |

Wraps exit with a program-specific cleanup routine.

Definition at line 166 of file fftools_cmdutils.c.

## filter_codec_opts()

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 2153 of file fftools_cmdutils.c.

## get_preset_file()

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 2095 of file fftools_cmdutils.c.

## get_rotation()

double get_rotation | ( | AVStream * | st | ) |

Definition at line 2249 of file fftools_cmdutils.c.

## grow_array()

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 2230 of file fftools_cmdutils.c.

## init_dynload()

void init_dynload | ( | void |  | ) |

Initialize dynamic library loading

Definition at line 150 of file fftools_cmdutils.c.

## init_opts()

void init_opts | ( | void |  | ) |

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

Definition at line 116 of file fftools_cmdutils.c.

## locate_option()

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 485 of file fftools_cmdutils.c.

## log_callback_help()

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.

## opt_codec_debug()

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

## opt_cpuflags()

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

Override the cpuflags.

Definition at line 902 of file fftools_cmdutils.c.

## opt_default()

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 583 of file fftools_cmdutils.c.

## opt_loglevel()

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

Set the libav* libraries log level.

Definition at line 914 of file fftools_cmdutils.c.

## opt_max_alloc()

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

Definition at line 1104 of file fftools_cmdutils.c.

## opt_report()

int opt_report | ( | void * | optctx,
|  | const char * | opt,
|  | const char * | arg
| ) |  |

Definition at line 1099 of file fftools_cmdutils.c.

## opt_timelimit()

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

Limit the execution time.

Definition at line 1118 of file fftools_cmdutils.c.

## parse_loglevel()

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 544 of file fftools_cmdutils.c.

## parse_number_or_die()

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 177 of file fftools_cmdutils.c.

## parse_optgroup()

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
  g | option group

Definition at line 452 of file fftools_cmdutils.c.

## parse_option()

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 384 of file fftools_cmdutils.c.

## parse_options()

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.

## parse_time_or_die()

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 198 of file fftools_cmdutils.c.

## print_error()

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 1131 of file fftools_cmdutils.c.

## read_yesno()

int read_yesno | ( | void |  | ) |

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

Definition at line 2084 of file fftools_cmdutils.c.

## register_exit()

void register_exit | ( | void(*)(int ret) | cb | ) |

Register a program-specific cleanup routine.

Definition at line 161 of file fftools_cmdutils.c.

## setup_find_stream_info_opts()

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 2210 of file fftools_cmdutils.c.

## show_banner()

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 1228 of file fftools_cmdutils.c.

## show_bsfs()

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 1700 of file fftools_cmdutils.c.

## show_buildconf()

int show_buildconf | ( | void * | optctx,
|  | const char * | opt,
|  | const char * | arg
| ) |  |

Print the build configuration of the program to stdout. The contents depend on the definition of FFMPEG_CONFIGURATION. This option processing function does not utilize the arguments.

Definition at line 1247 of file fftools_cmdutils.c.

## show_codecs()

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 1593 of file fftools_cmdutils.c.

## show_colors()

int show_colors | ( | void * | optctx,
|  | const char * | opt,
|  | const char * | arg
| ) |  |

Print a listing containing all the color names and values recognized by the program.

Definition at line 1774 of file fftools_cmdutils.c.

## show_decoders()

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 1688 of file fftools_cmdutils.c.

## show_demuxers()

int show_demuxers | ( | void * | optctx,
|  | const char * | opt,
|  | const char * | arg
| ) |  |

Print a listing containing all the demuxer supported by the program (including devices). This option processing function does not utilize the arguments.

Definition at line 1408 of file fftools_cmdutils.c.

## show_devices()

int show_devices | ( | void * | optctx,
|  | const char * | opt,
|  | const char * | arg
| ) |  |

Print a listing containing all the devices supported by the program. This option processing function does not utilize the arguments.

Definition at line 1413 of file fftools_cmdutils.c.

## show_encoders()

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 1694 of file fftools_cmdutils.c.

## show_filters()

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 1727 of file fftools_cmdutils.c.

## show_formats()

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

Print a listing containing all the formats supported by the program (including devices). This option processing function does not utilize the arguments.

Definition at line 1398 of file fftools_cmdutils.c.

## show_help()

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

Generic -h handler common to all fftools.

Definition at line 2039 of file fftools_cmdutils.c.

## show_help_children()

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 239 of file fftools_cmdutils.c.

## show_help_default_ffmpeg()

void show_help_default_ffmpeg | ( | const char * | opt,
|  | const char * | arg
| ) |  |

Per-fftool specific help handlers. Implemented in each fftool, called by show_help().

Definition at line 3247 of file fftools_ffmpeg_opt.c.

## show_help_default_ffprobe()

void show_help_default_ffprobe | ( | const char * | opt,
|  | const char * | arg
| ) |  |

Definition at line 3418 of file fftools_ffprobe.c.

## show_help_options()

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 210 of file fftools_cmdutils.c.

## show_layouts()

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 1821 of file fftools_cmdutils.c.

## show_license()

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 1254 of file fftools_cmdutils.c.

## show_muxers()

int show_muxers | ( | void * | optctx,
|  | const char * | opt,
|  | const char * | arg
| ) |  |

Print a listing containing all the muxers supported by the program (including devices). This option processing function does not utilize the arguments.

Definition at line 1403 of file fftools_cmdutils.c.

## show_pix_fmts()

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 1788 of file fftools_cmdutils.c.

## show_protocols()

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 1712 of file fftools_cmdutils.c.

## show_sample_fmts()

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 1850 of file fftools_cmdutils.c.

## show_version()

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 1239 of file fftools_cmdutils.c.

## split_commandline()

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 791 of file fftools_cmdutils.c.

## uninit_opts()

void uninit_opts | ( | void |  | ) |

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

Definition at line 121 of file fftools_cmdutils.c.

## uninit_parse_context()

void uninit_parse_context | ( | OptionParseContext * | octx | ) |

Free all allocated memory in an OptionParseContext.

Definition at line 765 of file fftools_cmdutils.c.

## Variable Documentation

## avcodec_opts

__thread AVCodecContext* avcodec_opts[AVMEDIA_TYPE_NB]

extern

## avformat_opts

__thread AVFormatContext* avformat_opts

extern

## codec_opts

__thread AVDictionary * codec_opts

Definition at line 79 of file fftools_cmdutils.h.

## find_stream_info

__thread int find_stream_info

extern

Definition at line 207 of file fftools_ffmpeg_opt.c.

## format_opts

__thread AVDictionary* format_opts

extern

Definition at line 103 of file fftools_cmdutils.c.

## hide_banner

__thread int hide_banner

extern

Definition at line 107 of file fftools_cmdutils.c.

## program_birth_year

__thread int program_birth_year

extern

program birth year, defined by the program for show_banner()

Definition at line 99 of file fftools_cmdutils.c.

## program_name

__thread char* program_name

extern

program name, defined by the program for show_version().

Definition at line 98 of file fftools_cmdutils.c.

## resample_opts

__thread AVDictionary * resample_opts

Definition at line 79 of file fftools_cmdutils.h.

## swr_opts

__thread AVDictionary* swr_opts

extern

Definition at line 102 of file fftools_cmdutils.c.

## sws_dict

__thread AVDictionary* sws_dict

extern

Definition at line 101 of file fftools_cmdutils.c.