Go to the documentation of this file.
75 vfprintf(stdout, fmt, vl);
80 #if HAVE_SETDLLDIRECTORY && defined(_WIN32)
88 double min,
double max,
double *dst)
94 error =
"Expected number for %s but found: %s\n";
95 else if (d < min || d >
max)
96 error =
"The value for %s was %s which is not within %f - %f\n";
98 error =
"Expected int64 for %s but found %s\n";
100 error =
"Expected int for %s but found %s\n";
120 if (((po->
flags & req_flags) != req_flags) ||
121 (po->
flags & rej_flags))
131 av_strlcat(buf,
"[:<stream_spec>]",
sizeof(buf));
173 #if HAVE_COMMANDLINETOARGVW && defined(_WIN32)
174 #include <shellapi.h>
176 static char** win32_argv_utf8 =
NULL;
177 static int win32_argc = 0;
190 int i, buffsize = 0,
offset = 0;
192 if (win32_argv_utf8) {
193 *argc_ptr = win32_argc;
194 *argv_ptr = win32_argv_utf8;
199 argv_w = CommandLineToArgvW(GetCommandLineW(), &win32_argc);
200 if (win32_argc <= 0 || !argv_w)
204 for (
i = 0;
i < win32_argc;
i++)
205 buffsize += WideCharToMultiByte(CP_UTF8, 0, argv_w[
i], -1,
208 win32_argv_utf8 =
av_mallocz(
sizeof(
char *) * (win32_argc + 1) + buffsize);
209 argstr_flat = (
char *)win32_argv_utf8 +
sizeof(
char *) * (win32_argc + 1);
210 if (!win32_argv_utf8) {
215 for (
i = 0;
i < win32_argc;
i++) {
216 win32_argv_utf8[
i] = &argstr_flat[
offset];
217 offset += WideCharToMultiByte(CP_UTF8, 0, argv_w[
i], -1,
221 win32_argv_utf8[
i] =
NULL;
224 *argc_ptr = win32_argc;
225 *argv_ptr = win32_argv_utf8;
250 char *arg_allocated =
NULL;
261 "Requested to load an argument from file for a bool option '%s'\n",
267 if (!arg_allocated) {
269 "Error reading the value for option '%s' from file: %s\n",
278 char *p = strchr(opt,
':');
291 sol->opt[sol->nb_opt - 1].specifier = str;
292 dst = &sol->opt[sol->nb_opt - 1].u;
299 arg_allocated =
NULL;
340 *(
double *)dst = num;
347 "Failed to set value '%s' for option '%s': %s\n",
358 sol->type = po->
type;
372 .
name =
"AVOption passthrough",
382 if (!po->
name && opt[0] ==
'n' && opt[1] ==
'o') {
409 int (*parse_arg_function)(
void *,
const char*))
412 int optindex, handleoptions = 1,
ret;
419 while (optindex < argc) {
420 opt = argv[optindex++];
422 if (handleoptions && opt[0] ==
'-' && opt[1] !=
'\0') {
423 if (opt[1] ==
'-' && opt[2] ==
'\0') {
433 if (parse_arg_function) {
434 ret = parse_arg_function(optctx, opt);
449 g->group_def->name,
g->arg);
451 for (
i = 0;
i <
g->nb_opts;
i++) {
454 if (
g->group_def->flags &&
455 !(
g->group_def->flags & o->
opt->
flags)) {
457 "%s %s -- you are trying to apply an input option to an "
458 "output file or vice versa. Move this option before the "
459 "file it belongs to.\n", o->
key, o->
opt->
help,
460 g->group_def->name,
g->arg);
483 for (
i = 1;
i < argc;
i++) {
484 const char *cur_opt = argv[
i];
486 if (*cur_opt++ !=
'-')
490 if (!po->
name && cur_opt[0] ==
'n' && cur_opt[1] ==
'o')
493 if ((!po->
name && !strcmp(cur_opt, optname)) ||
494 (po->
name && !strcmp(optname, po->
name)))
505 const unsigned char *p;
508 if (!((*p >=
'+' && *p <=
':') || (*p >=
'@' && *p <=
'Z') ||
509 *p ==
'_' || (*p >=
'a' && *p <=
'z')))
516 for (p =
a; *p; p++) {
517 if (*p ==
'\\' || *p ==
'"' || *p ==
'$' || *p ==
'`')
519 else if (*p < ' ' || *p >
'~')
552 if (idx && argv[idx + 1])
562 for (
i = 0;
i < argc;
i++) {
576 int opt_flags,
int search_flags)
584 #define FLAGS ((o->type == AV_OPT_TYPE_FLAGS && (arg[0]=='-' || arg[0]=='+')) ? AV_DICT_APPEND : 0)
589 char opt_stripped[128];
595 #if CONFIG_SWRESAMPLE
599 if (!strcmp(opt,
"debug") || !strcmp(opt,
"fdebug"))
602 if (!(p = strchr(opt,
':')))
603 p = opt + strlen(opt);
604 av_strlcpy(opt_stripped, opt,
FFMIN(
sizeof(opt_stripped), p - opt + 1));
608 ((opt[0] ==
'v' || opt[0] ==
'a' || opt[0] ==
's') &&
623 if (!strcmp(opt,
"srcw") || !strcmp(opt,
"srch") ||
624 !strcmp(opt,
"dstw") || !strcmp(opt,
"dsth") ||
625 !strcmp(opt,
"src_format") || !strcmp(opt,
"dst_format")) {
626 av_log(
NULL,
AV_LOG_ERROR,
"Directly using swscale dimensions/format options is not supported, please use the -s or -pix_fmt options\n");
634 if (!consumed && !strcmp(opt,
"sws_flags")) {
639 #if CONFIG_SWRESAMPLE
662 for (
i = 0;
i < nb_groups;
i++) {
664 if (p->
sep && !strcmp(p->
sep, opt))
712 const char *
key,
const char *
val)
722 g->opts[
g->nb_opts - 1].opt = opt;
723 g->opts[
g->nb_opts - 1].key =
key;
724 g->opts[
g->nb_opts - 1].val =
val;
735 memset(octx, 0,
sizeof(*octx));
793 while (optindex < argc) {
794 const char *opt = argv[optindex++], *
arg;
800 if (opt[0] ==
'-' && opt[1] ==
'-' && !opt[2]) {
805 if (opt[0] !=
'-' || !opt[1] || dashdash+1 == optindex) {
815 #define GET_ARG(arg) \
817 arg = argv[optindex++]; \
819 av_log(NULL, AV_LOG_ERROR, "Missing argument for option '%s'.\n", opt);\
820 return AVERROR(EINVAL); \
826 if (group_idx >= 0) {
842 arg = argv[optindex++];
859 if (argv[optindex]) {
863 "argument '%s'.\n", opt, argv[optindex]);
868 "with argument '%s'.\n", opt, argv[optindex]);
874 if (opt[0] ==
'n' && opt[1] ==
'o' &&
882 "argument 0.\n", po->
name, po->
help);
892 "command: may be ignored.\n");
904 while (
c !=
'\n' &&
c != EOF)
911 const char *preset_name,
int is_path,
912 const char *codec_name)
916 #if HAVE_GETMODULEHANDLE && defined(_WIN32)
917 char *datadir =
NULL;
920 char *env_ffmpeg_datadir =
getenv_utf8(
"FFMPEG_DATADIR");
921 const char *
base[3] = { env_ffmpeg_datadir,
926 av_strlcpy(filename, preset_name, filename_size);
929 #if HAVE_GETMODULEHANDLE && defined(_WIN32)
930 wchar_t *datadir_w = get_module_filename(
NULL);
933 if (wchartoutf8(datadir_w, &datadir))
940 for (ls = datadir; *ls; ls++)
941 if (*ls ==
'\\') *ls =
'/';
943 if (ls = strrchr(datadir,
'/'))
945 ptrdiff_t datadir_len = ls - datadir;
946 size_t desired_size = datadir_len + strlen(
"/ffpresets") + 1;
948 datadir, desired_size,
sizeof *datadir);
950 datadir = new_datadir;
951 datadir[datadir_len] = 0;
952 strncat(datadir,
"/ffpresets", desired_size - 1 - datadir_len);
958 for (
i = 0;
i < 3 && !
f;
i++) {
961 snprintf(filename, filename_size,
"%s%s/%s.ffpreset",
base[
i],
962 i != 1 ?
"" :
"/.ffmpeg", preset_name);
964 if (!
f && codec_name) {
966 "%s%s/%s-%s.ffpreset",
967 base[
i],
i != 1 ?
"" :
"/.ffmpeg", codec_name,
974 #if HAVE_GETMODULEHANDLE && defined(_WIN32)
1022 char *p = strchr(t->
key,
':');
1042 else if (t->
key[0] == prefix &&
1071 for (
int i = 0;
i <
s->nb_streams;
i++) {
1080 for (
int i = 0;
i <
s->nb_streams;
i++)
1088 if (new_size >= INT_MAX / elem_size) {
1092 if (*
size < new_size) {
1096 memset(
tmp + *
size*elem_size, 0, (new_size-*
size) * elem_size);
1120 theta -= 360*
floor(theta/360 + 0.9/360);
1122 if (
fabs(theta - 90*
round(theta/90)) > 2)
1124 "If you want to help, upload a sample "
1125 "of this file to https://streams.videolan.org/upload/ "
1126 "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.
const AVCodec * avcodec_find_encoder(enum AVCodecID id)
Find a registered encoder with a matching codec ID.
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.
const AVCodec * avcodec_find_decoder(enum AVCodecID id)
Find a registered decoder with a matching codec ID.
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.