Go to the documentation of this file.
72 vfprintf(stdout, fmt, vl);
77 #if HAVE_SETDLLDIRECTORY && defined(_WIN32)
85 double min,
double max,
double *dst)
91 error =
"Expected number for %s but found: %s\n";
92 else if (d < min || d >
max)
93 error =
"The value for %s was %s which is not within %f - %f\n";
95 error =
"Expected int64 for %s but found %s\n";
97 error =
"Expected int for %s but found %s\n";
117 if (((po->
flags & req_flags) != req_flags) ||
118 (po->
flags & rej_flags))
128 av_strlcat(buf,
"[:<stream_spec>]",
sizeof(buf));
170 #if HAVE_COMMANDLINETOARGVW && defined(_WIN32)
171 #include <shellapi.h>
173 static char** win32_argv_utf8 =
NULL;
174 static int win32_argc = 0;
187 int i, buffsize = 0,
offset = 0;
189 if (win32_argv_utf8) {
190 *argc_ptr = win32_argc;
191 *argv_ptr = win32_argv_utf8;
196 argv_w = CommandLineToArgvW(GetCommandLineW(), &win32_argc);
197 if (win32_argc <= 0 || !argv_w)
201 for (
i = 0;
i < win32_argc;
i++)
202 buffsize += WideCharToMultiByte(CP_UTF8, 0, argv_w[
i], -1,
205 win32_argv_utf8 =
av_mallocz(
sizeof(
char *) * (win32_argc + 1) + buffsize);
206 argstr_flat = (
char *)win32_argv_utf8 +
sizeof(
char *) * (win32_argc + 1);
207 if (!win32_argv_utf8) {
212 for (
i = 0;
i < win32_argc;
i++) {
213 win32_argv_utf8[
i] = &argstr_flat[
offset];
214 offset += WideCharToMultiByte(CP_UTF8, 0, argv_w[
i], -1,
218 win32_argv_utf8[
i] =
NULL;
221 *argc_ptr = win32_argc;
222 *argv_ptr = win32_argv_utf8;
247 char *arg_allocated =
NULL;
258 "Requested to load an argument from file for a bool option '%s'\n",
264 if (!arg_allocated) {
266 "Error reading the value for option '%s' from file: %s\n",
275 char *p = strchr(opt,
':');
288 sol->opt[sol->nb_opt - 1].specifier = str;
289 dst = &sol->opt[sol->nb_opt - 1].u;
296 arg_allocated =
NULL;
318 *(int64_t *)dst = num;
337 *(
double *)dst = num;
344 "Failed to set value '%s' for option '%s': %s\n",
355 sol->type = po->
type;
369 .
name =
"AVOption passthrough",
379 if (!po->
name && opt[0] ==
'n' && opt[1] ==
'o') {
406 int (*parse_arg_function)(
void *,
const char*))
409 int optindex, handleoptions = 1,
ret;
416 while (optindex < argc) {
417 opt = argv[optindex++];
419 if (handleoptions && opt[0] ==
'-' && opt[1] !=
'\0') {
420 if (opt[1] ==
'-' && opt[2] ==
'\0') {
430 if (parse_arg_function) {
431 ret = parse_arg_function(optctx, opt);
446 g->group_def->name,
g->arg);
448 for (
i = 0;
i <
g->nb_opts;
i++) {
451 if (
g->group_def->flags &&
452 !(
g->group_def->flags & o->
opt->
flags)) {
454 "%s %s -- you are trying to apply an input option to an "
455 "output file or vice versa. Move this option before the "
456 "file it belongs to.\n", o->
key, o->
opt->
help,
457 g->group_def->name,
g->arg);
480 for (
i = 1;
i < argc;
i++) {
481 const char *cur_opt = argv[
i];
483 if (*cur_opt++ !=
'-')
487 if (!po->
name && cur_opt[0] ==
'n' && cur_opt[1] ==
'o')
490 if ((!po->
name && !strcmp(cur_opt, optname)) ||
491 (po->
name && !strcmp(optname, po->
name)))
502 const unsigned char *p;
505 if (!((*p >=
'+' && *p <=
':') || (*p >=
'@' && *p <=
'Z') ||
506 *p ==
'_' || (*p >=
'a' && *p <=
'z')))
513 for (p =
a; *p; p++) {
514 if (*p ==
'\\' || *p ==
'"' || *p ==
'$' || *p ==
'`')
516 else if (*p < ' ' || *p >
'~')
549 if (idx && argv[idx + 1])
559 for (
i = 0;
i < argc;
i++) {
573 int opt_flags,
int search_flags)
581 #define FLAGS (o->type == AV_OPT_TYPE_FLAGS && (arg[0]=='-' || arg[0]=='+')) ? AV_DICT_APPEND : 0
586 char opt_stripped[128];
592 #if CONFIG_SWRESAMPLE
596 if (!strcmp(opt,
"debug") || !strcmp(opt,
"fdebug"))
599 if (!(p = strchr(opt,
':')))
600 p = opt + strlen(opt);
601 av_strlcpy(opt_stripped, opt,
FFMIN(
sizeof(opt_stripped), p - opt + 1));
605 ((opt[0] ==
'v' || opt[0] ==
'a' || opt[0] ==
's') &&
620 if (!strcmp(opt,
"srcw") || !strcmp(opt,
"srch") ||
621 !strcmp(opt,
"dstw") || !strcmp(opt,
"dsth") ||
622 !strcmp(opt,
"src_format") || !strcmp(opt,
"dst_format")) {
623 av_log(
NULL,
AV_LOG_ERROR,
"Directly using swscale dimensions/format options is not supported, please use the -s or -pix_fmt options\n");
631 if (!consumed && !strcmp(opt,
"sws_flags")) {
636 #if CONFIG_SWRESAMPLE
659 for (
i = 0;
i < nb_groups;
i++) {
661 if (p->
sep && !strcmp(p->
sep, opt))
709 const char *
key,
const char *
val)
719 g->opts[
g->nb_opts - 1].opt = opt;
720 g->opts[
g->nb_opts - 1].key =
key;
721 g->opts[
g->nb_opts - 1].val =
val;
732 memset(octx, 0,
sizeof(*octx));
790 while (optindex < argc) {
791 const char *opt = argv[optindex++], *
arg;
797 if (opt[0] ==
'-' && opt[1] ==
'-' && !opt[2]) {
802 if (opt[0] !=
'-' || !opt[1] || dashdash+1 == optindex) {
812 #define GET_ARG(arg) \
814 arg = argv[optindex++]; \
816 av_log(NULL, AV_LOG_ERROR, "Missing argument for option '%s'.\n", opt);\
817 return AVERROR(EINVAL); \
823 if (group_idx >= 0) {
839 arg = argv[optindex++];
856 if (argv[optindex]) {
860 "argument '%s'.\n", opt, argv[optindex]);
865 "with argument '%s'.\n", opt, argv[optindex]);
871 if (opt[0] ==
'n' && opt[1] ==
'o' &&
879 "argument 0.\n", po->
name, po->
help);
889 "command: may be ignored.\n");
901 while (
c !=
'\n' &&
c != EOF)
908 const char *preset_name,
int is_path,
909 const char *codec_name)
913 #if HAVE_GETMODULEHANDLE && defined(_WIN32)
914 char *datadir =
NULL;
917 char *env_ffmpeg_datadir =
getenv_utf8(
"FFMPEG_DATADIR");
918 const char *
base[3] = { env_ffmpeg_datadir,
923 av_strlcpy(filename, preset_name, filename_size);
926 #if HAVE_GETMODULEHANDLE && defined(_WIN32)
927 wchar_t *datadir_w = get_module_filename(
NULL);
930 if (wchartoutf8(datadir_w, &datadir))
937 for (ls = datadir; *ls; ls++)
938 if (*ls ==
'\\') *ls =
'/';
940 if (ls = strrchr(datadir,
'/'))
942 ptrdiff_t datadir_len = ls - datadir;
943 size_t desired_size = datadir_len + strlen(
"/ffpresets") + 1;
945 datadir, desired_size,
sizeof *datadir);
947 datadir = new_datadir;
948 datadir[datadir_len] = 0;
949 strncat(datadir,
"/ffpresets", desired_size - 1 - datadir_len);
955 for (
i = 0;
i < 3 && !
f;
i++) {
958 snprintf(filename, filename_size,
"%s%s/%s.ffpreset",
base[
i],
959 i != 1 ?
"" :
"/.ffmpeg", preset_name);
961 if (!
f && codec_name) {
963 "%s%s/%s-%s.ffpreset",
964 base[
i],
i != 1 ?
"" :
"/.ffmpeg", codec_name,
971 #if HAVE_GETMODULEHANDLE && defined(_WIN32)
1015 char *p = strchr(t->
key,
':');
1035 else if (t->
key[0] == prefix &&
1064 for (
int i = 0;
i <
s->nb_streams;
i++) {
1073 for (
int i = 0;
i <
s->nb_streams;
i++)
1081 if (new_size >= INT_MAX / elem_size) {
1085 if (*
size < new_size) {
1089 memset(
tmp + *
size*elem_size, 0, (new_size-*
size) * elem_size);
1113 theta -= 360*
floor(theta/360 + 0.9/360);
1115 if (
fabs(theta - 90*
round(theta/90)) > 2)
1117 "If you want to help, upload a sample "
1118 "of this file to https://streams.videolan.org/upload/ "
1119 "and contact the ffmpeg-devel mailing list. (ffmpeg-devel@ffmpeg.org)");
static void error(const char *err)
#define AV_OPT_SEARCH_CHILDREN
Search in possible children of the given object first.
static FILE * fopen_utf8(const char *path, const char *mode)
void show_help_options(const OptionDef *options, const char *msg, int req_flags, int rej_flags)
Print help for all options matching specified flags.
const OptionGroupDef * group_def
#define AV_LOG_WARNING
Something somehow does not look correct.
#define AV_BPRINT_SIZE_UNLIMITED
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default minimum maximum flags name is the option name
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
double get_rotation(const int32_t *displaymatrix)
enum AVMediaType codec_type
General type of the encoded data.
const AVClass * av_opt_child_class_iterate(const AVClass *parent, void **iter)
Iterate over potential AVOptions-enabled children of parent.
void av_bprint_init(AVBPrint *buf, unsigned size_init, unsigned size_max)
const AVClass * priv_class
AVClass for the private context.
const AVClass * avformat_get_class(void)
Get the AVClass for AVFormatContext.
int init_report(const char *env, FILE **file)
int parse_number(const char *context, const char *numstr, enum OptionType type, double min, double max, double *dst)
Parse a string and return its corresponding value as a double.
int avio_open(AVIOContext **s, const char *filename, int flags)
Create and initialize a AVIOContext for accessing the resource indicated by url.
AVDictionary * format_opts
int grow_array(void **array, int elem_size, int *size, int new_size)
Realloc array to hold new_size elements of elem_size.
#define AV_LOG_VERBOSE
Detailed information.
static void freeenv_utf8(char *var)
#define fc(width, name, range_min, range_max)
void show_help_children(const AVClass *class, int flags)
Show help for all options with given flags in class and all its children.
int flags
A combination of AV_OPT_FLAG_*.
static int finish_group(OptionParseContext *octx, int group_idx, const char *arg)
size_t av_strlcatf(char *dst, size_t size, const char *fmt,...)
static int opt_has_arg(const OptionDef *o)
A list of option groups that all have the same group type (e.g.
static int init_parse_context(OptionParseContext *octx, const OptionGroupDef *groups, int nb_groups)
#define AVERROR_OPTION_NOT_FOUND
Option not found.
An option extracted from the commandline.
static double val(void *priv, double ch)
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf type
const AVClass * sws_get_class(void)
Get the AVClass for swsContext.
const OptionGroupDef * group_def
#define AV_OPT_FLAG_AUDIO_PARAM
int check_stream_specifier(AVFormatContext *s, AVStream *st, const char *spec)
Check if the given stream matches a stream specifier.
trying all byte sequences megabyte in length and selecting the best looking sequence will yield cases to try But first
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
AVDictionary * codec_opts
static void check_options(const OptionDef *po)
static FILE * report_file
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.
int avio_read_to_bprint(AVIOContext *h, struct AVBPrint *pb, size_t max_size)
Read contents of h into print buffer, up to max_size bytes, or up to EOF.
void * av_realloc_array(void *ptr, size_t nmemb, size_t size)
static __device__ float floor(float a)
#define av_assert0(cond)
assert() equivalent, that is always enabled.
int setup_find_stream_info_opts(AVFormatContext *s, AVDictionary *codec_opts, AVDictionary ***dst)
Setup AVCodecContext options for avformat_find_stream_info().
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
int filter_codec_opts(const AVDictionary *opts, enum AVCodecID codec_id, AVFormatContext *s, AVStream *st, const AVCodec *codec, AVDictionary **dst)
Filter out options for given codec.
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default minimum maximum flags name is the option keep it simple and lowercase description are in without and describe what they for example set the foo of the bar offset is the offset of the field in your context
void init_dynload(void)
Initialize dynamic library loading.
AVDictionary * format_opts
AVCodecParameters * codecpar
Codec parameters associated with this stream.
Describe the class of an AVClass context structure.
const AVClass * avcodec_get_class(void)
Get the AVClass for AVCodecContext.
static __device__ float fabs(float a)
static int add_opt(OptionParseContext *octx, const OptionDef *opt, const char *key, const char *val)
static void prepare_app_arguments(int *argc_ptr, char ***argv_ptr)
const AVClass * swr_get_class(void)
Get the AVClass for SwrContext.
int opt_loglevel(void *optctx, const char *opt, const char *arg)
Set the libav* libraries log level.
static char * getenv_utf8(const char *varname)
#define AV_OPT_SEARCH_FAKE_OBJ
The obj passed to av_opt_find() is fake – only a double pointer to AVClass instead of a required poin...
int av_parse_time(int64_t *timeval, const char *timestr, int duration)
Parse timestr and return in *time a corresponding number of microseconds.
#define AV_OPT_FLAG_ENCODING_PARAM
A generic parameter which can be set by the user for muxing or encoding.
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
AVCodecID
Identify the syntax and semantics of the bitstream.
char * file_read(const char *filename)
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.
AVDictionary * codec_opts
const OptionDef options[]
const AVOption * av_opt_find(void *obj, const char *name, const char *unit, int opt_flags, int search_flags)
Look for an option in an object.
int avformat_match_stream_specifier(AVFormatContext *s, AVStream *st, const char *spec)
Check if the stream st contained in s is matched by the stream specifier spec.
int av_bprint_finalize(AVBPrint *buf, char **ret_str)
Finalize a print buffer.
#define av_err2str(errnum)
Convenience macro, the return value should be used only directly in function arguments but never stan...
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.
void uninit_opts(void)
Uninitialize the cmdutils option system, in particular free the *_opts contexts and their contents.
printf("static const uint8_t my_array[100] = {\n")
void * allocate_array_elem(void *ptr, size_t elem_size, int *nb_elems)
Atomically add a new element to an array of pointers, i.e.
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
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf offset
void av_dict_free(AVDictionary **pm)
Free all the memory allocated for an AVDictionary struct and all keys and values.
int av_strstart(const char *str, const char *pfx, const char **ptr)
Return non-zero if pfx is a prefix of str.
int av_opt_show2(void *obj, void *av_log_obj, int req_flags, int rej_flags)
Show the obj options.
void av_log_set_level(int level)
Set the log level.
#define i(width, name, range_min, range_max)
static av_always_inline av_const double round(double x)
#define AV_OPT_FLAG_SUBTITLE_PARAM
int parse_options(void *optctx, int argc, char **argv, const OptionDef *options, int(*parse_arg_function)(void *, const char *))
static av_const int av_toupper(int c)
Locale-independent conversion of ASCII characters to uppercase.
#define AV_OPT_FLAG_VIDEO_PARAM
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
void * av_calloc(size_t nmemb, size_t size)
void parse_loglevel(int argc, char **argv, const OptionDef *options)
Find the '-loglevel' option in the command line args and apply it.
static int array[MAX_W *MAX_W]
#define AV_LOG_FATAL
Something went wrong and recovery is not possible.
int read_yesno(void)
Return a positive value if a line read from standard input starts with [yY], otherwise return 0.
double av_strtod(const char *numstr, char **tail)
Parse the string in numstr and return its value as a double.
size_t av_strlcat(char *dst, const char *src, size_t size)
Append the string src to the string dst, but to a total length of no more than size - 1 bytes,...
void uninit_parse_context(OptionParseContext *octx)
Free all allocated memory in an OptionParseContext.
void log_callback_help(void *ptr, int level, const char *fmt, va_list vl)
Trivial log callback.
int av_dynarray_add_nofree(void *tab_ptr, int *nb_ptr, void *elem)
Add an element to a dynamic array.
#define OPT_FLAG_PERSTREAM
int parse_option(void *optctx, const char *opt, const char *arg, const OptionDef *options)
Parse one given option.
static int write_option(void *optctx, const OptionDef *po, const char *opt, const char *arg, const OptionDef *defs)
#define GROW_ARRAY(array, nb_elems)
int parse_optgroup(void *optctx, OptionGroup *g, const OptionDef *defs)
Parse an options group and write results into optctx.
#define AVIO_FLAG_READ
read-only
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.
char * av_strdup(const char *s)
Duplicate a string.
#define AV_OPT_FLAG_DECODING_PARAM
A generic parameter which can be set by the user for demuxing or decoding.
const char * sep
Option to be used as group separator.
int avio_closep(AVIOContext **s)
Close the resource accessed by the AVIOContext *s, free it and set the pointer pointing to it to NULL...
int av_dict_set(AVDictionary **pm, const char *key, const char *value, int flags)
Set the given entry in *pm, overwriting an existing entry.
#define flags(name, subs,...)
size_t av_strlcpy(char *dst, const char *src, size_t size)
Copy the string src to dst, but no more than size - 1 bytes, and null-terminate dst.
static const OptionDef * find_option(const OptionDef *po, const char *name)
#define AVERROR_EXIT
Immediate exit was requested; the called function should not be restarted.
const AVDictionaryEntry * av_dict_iterate(const AVDictionary *m, const AVDictionaryEntry *prev)
Iterate over a dictionary.
static void dump_argument(FILE *report_file, const char *a)
static int match_group_separator(const OptionGroupDef *groups, int nb_groups, const char *opt)
int(* func_arg)(void *, const char *, const char *)
static const AVOption * opt_find(void *obj, const char *name, const char *unit, int opt_flags, int search_flags)
double av_display_rotation_get(const int32_t matrix[9])
Extract the rotation component of the transformation matrix.