cmdutils.c File Reference

#include <string.h>
#include <stdlib.h>
#include <errno.h>
#include <math.h>
#include "config.h"
#include "libavformat/avformat.h"
#include "libavfilter/avfilter.h"
#include "libavdevice/avdevice.h"
#include "libswscale/swscale.h"
#include "libpostproc/postprocess.h"
#include "libavutil/avstring.h"
#include "libavutil/parseutils.h"
#include "libavutil/pixdesc.h"
#include "libavutil/eval.h"
#include "libavcodec/opt.h"
#include "cmdutils.h"
#include "version.h"

Go to the source code of this file.

Defines

#define INDENT   1
#define SHOW_VERSION   2
#define SHOW_CONFIG   4
#define PRINT_LIB_INFO(outstream, libname, LIBNAME, flags)
#define sws_isSupportedInput(x)   0
#define sws_isSupportedOutput(x)   0

Functions

void init_opts (void)
 Initialize the cmdutils option system, in particular allocate the *_opts contexts.
void uninit_opts (void)
 Uninitialize the cmdutils option system, in particular free the *_opts contexts and their contents.
void log_callback_help (void *ptr, int level, const char *fmt, va_list vl)
 Trivial log callback.
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.
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.
void show_help_options (const OptionDef *options, const char *msg, int mask, int value)
static const OptionDeffind_option (const OptionDef *po, const char *name)
void parse_options (int argc, char **argv, const OptionDef *options, void(*parse_arg_function)(const char *))
 Parse the command line arguments.
int opt_default (const char *opt, const char *arg)
 Fallback for options that are not explicitly handled, these will be parsed through AVOptions.
int opt_loglevel (const char *opt, const char *arg)
 Set the libav* libraries log level.
int opt_timelimit (const char *opt, const char *arg)
 Limit the execution time.
void set_context_opts (void *ctx, void *opts_ctx, int flags, AVCodec *codec)
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.
static void print_all_libs_info (FILE *outstream, int flags)
void show_banner (void)
 Print the program banner to stderr.
void show_version (void)
 Print the version of the program to stdout.
void show_license (void)
 Print the license of the program to stdout.
void list_fmts (void(*get_fmt_string)(char *buf, int buf_size, int fmt), int nb_fmts)
void show_formats (void)
 Print a listing containing all the formats supported by the program.
void show_codecs (void)
 Print a listing containing all the codecs supported by the program.
void show_bsfs (void)
 Print a listing containing all the bit stream filters supported by the program.
void show_protocols (void)
 Print a listing containing all the protocols supported by the program.
void show_filters (void)
 Print a listing containing all the filters supported by the program.
void show_pix_fmts (void)
 Print a listing containing all the pixel formats supported by the program.
int read_yesno (void)
 Return a positive value if a line read from standard input starts with [yY], otherwise return 0.
int 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.
void init_pts_correction (PtsCorrectionContext *ctx)
 Reset the state of the PtsCorrectionContext.
int64_t guess_correct_pts (PtsCorrectionContext *ctx, int64_t reordered_pts, int64_t dts)
 Attempt to guess proper monotonic timestamps for decoded video frames which might have incorrect times.
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.

Variables

const char ** opt_names
const char ** opt_values
static int opt_name_count
AVCodecContextavcodec_opts [AVMEDIA_TYPE_NB]
AVFormatContextavformat_opts
struct SwsContextsws_opts
static const int this_year = 2011
static int warned_cfg = 0


Define Documentation

#define INDENT   1

Definition at line 382 of file cmdutils.c.

Referenced by show_banner().

#define PRINT_LIB_INFO ( outstream,
libname,
LIBNAME,
flags   ) 

Value:

if (CONFIG_##LIBNAME) {                                             \
        const char *indent = flags & INDENT? "  " : "";                 \
        if (flags & SHOW_VERSION) {                                     \
            unsigned int version = libname##_version();                 \
            fprintf(outstream, "%slib%-9s %2d.%3d.%2d / %2d.%3d.%2d\n", \
                    indent, #libname,                                   \
                    LIB##LIBNAME##_VERSION_MAJOR,                       \
                    LIB##LIBNAME##_VERSION_MINOR,                       \
                    LIB##LIBNAME##_VERSION_MICRO,                       \
                    version >> 16, version >> 8 & 0xff, version & 0xff); \
        }                                                               \
        if (flags & SHOW_CONFIG) {                                      \
            const char *cfg = libname##_configuration();                \
            if (strcmp(FFMPEG_CONFIGURATION, cfg)) {                    \
                if (!warned_cfg) {                                      \
                    fprintf(outstream,                                  \
                            "%sWARNING: library configuration mismatch\n", \
                            indent);                                    \
                    warned_cfg = 1;                                     \
                }                                                       \
                fprintf(stderr, "%s%-11s configuration: %s\n",          \
                        indent, #libname, cfg);                         \
            }                                                           \
        }                                                               \
    }                                                                   \

Definition at line 386 of file cmdutils.c.

Referenced by print_all_libs_info().

#define SHOW_CONFIG   4

Definition at line 384 of file cmdutils.c.

Referenced by show_banner().

#define SHOW_VERSION   2

Definition at line 383 of file cmdutils.c.

Referenced by show_banner(), and show_version().

#define sws_isSupportedInput (  )     0

#define sws_isSupportedOutput (  )     0


Function Documentation

static const OptionDef* find_option ( const OptionDef po,
const char *  name 
) [static]

Definition at line 149 of file cmdutils.c.

Referenced by parse_options().

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, in that order. If no such file is found and codec_name is defined, then search for a file named codec_name-preset_name.ffpreset 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 778 of file cmdutils.c.

Referenced by ffserver_opt_preset(), and opt_preset().

int64_t guess_correct_pts ( PtsCorrectionContext ctx,
int64_t  pts,
int64_t  dts 
)

Attempt to guess proper monotonic timestamps for decoded video frames which might have incorrect times.

Input timestamps may wrap around, in which case the output will as well.

Parameters:
pts the pts field of the decoded AVPacket, as passed through AVCodecContext.reordered_opaque
dts the dts field of the decoded AVPacket
Returns:
one of the input values, may be AV_NOPTS_VALUE

Definition at line 757 of file cmdutils.c.

Referenced by get_video_frame(), and output_packet().

void init_opts ( void   ) 

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

Definition at line 60 of file cmdutils.c.

Referenced by main().

void init_pts_correction ( PtsCorrectionContext ctx  ) 

Reset the state of the PtsCorrectionContext.

Definition at line 751 of file cmdutils.c.

Referenced by get_video_frame(), and transcode().

void list_fmts ( void(*)(char *buf, int buf_size, int fmt)  get_fmt_string,
int  nb_fmts 
)

Definition at line 509 of file cmdutils.c.

Referenced by opt_audio_sample_fmt().

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

Trivial log callback.

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

Definition at line 93 of file cmdutils.c.

Referenced by show_help().

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

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

Definition at line 229 of file cmdutils.c.

Referenced by opt_bitrate(), opt_preset(), and opt_target().

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

Set the libav* libraries log level.

Definition at line 290 of file cmdutils.c.

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

Limit the execution time.

Definition at line 325 of file cmdutils.c.

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 commandline 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 98 of file cmdutils.c.

Referenced by opt_audio_channels(), opt_audio_rate(), opt_debug(), opt_height(), opt_me_threshold(), opt_streamid(), opt_thread_count(), opt_timelimit(), opt_verbose(), opt_vismv(), opt_width(), and parse_options().

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

Parse the command line arguments.

Parameters:
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.

Definition at line 158 of file cmdutils.c.

Referenced by main().

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 commandline 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:
parse_date()

Definition at line 115 of file cmdutils.c.

Referenced by opt_duration(), opt_input_ts_offset(), opt_recording_time(), opt_recording_timestamp(), opt_seek(), opt_start_time(), and parse_forced_key_frames().

static void print_all_libs_info ( FILE *  outstream,
int  flags 
) [static]

Definition at line 413 of file cmdutils.c.

Referenced by show_banner(), and show_version().

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 370 of file cmdutils.c.

Referenced by decode_thread(), open_input_file(), opt_input_file(), opt_output_file(), read_ffserver_streams(), and write_frame().

int 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:
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 727 of file cmdutils.c.

Referenced by transcode().

int read_yesno ( void   ) 

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

Definition at line 716 of file cmdutils.c.

Referenced by opt_output_file().

void set_context_opts ( void *  ctx,
void *  opts_ctx,
int  flags,
AVCodec codec 
)

void show_banner ( void   ) 

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 424 of file cmdutils.c.

Referenced by main().

void show_bsfs ( void   ) 

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

Definition at line 644 of file cmdutils.c.

void show_codecs ( void   ) 

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

Definition at line 568 of file cmdutils.c.

void show_filters ( void   ) 

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

Definition at line 672 of file cmdutils.c.

void show_formats ( void   ) 

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

Definition at line 519 of file cmdutils.c.

void show_help_options ( const OptionDef options,
const char *  msg,
int  mask,
int  value 
)

Definition at line 126 of file cmdutils.c.

Referenced by show_help().

void show_license ( void   ) 

Print the license of the program to stdout.

The license depends on the license of the libraries compiled into the program.

Definition at line 440 of file cmdutils.c.

void show_pix_fmts ( void   ) 

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

Definition at line 683 of file cmdutils.c.

Referenced by opt_frame_pix_fmt().

void show_protocols ( void   ) 

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

Definition at line 654 of file cmdutils.c.

void show_version ( void   ) 

Print the version of the program to stdout.

The version message depends on the current versions of the repository and of the libav* libraries.

Definition at line 435 of file cmdutils.c.

void uninit_opts ( void   ) 

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

Definition at line 71 of file cmdutils.c.

Referenced by do_exit(), and ffmpeg_exit().


Variable Documentation

AVCodecContext* avcodec_opts[AVMEDIA_TYPE_NB]

int opt_name_count [static]

Definition at line 53 of file cmdutils.c.

Referenced by opt_default(), set_context_opts(), and uninit_opts().

const char** opt_names

Definition at line 51 of file cmdutils.c.

Referenced by opt_default(), set_context_opts(), and uninit_opts().

const char** opt_values

Definition at line 52 of file cmdutils.c.

Referenced by opt_default(), set_context_opts(), and uninit_opts().

Definition at line 56 of file cmdutils.c.

Referenced by do_video_out(), queue_picture(), show_help(), and transcode().

const int this_year = 2011 [static]

Definition at line 58 of file cmdutils.c.

Referenced by show_banner().

int warned_cfg = 0 [static]

Definition at line 380 of file cmdutils.c.


Generated on Mon May 2 19:50:13 2011 for FFmpeg by  doxygen 1.5.6