Go to the documentation of this file.
74 vfprintf(stdout, fmt, vl);
79 #if HAVE_SETDLLDIRECTORY && defined(_WIN32)
87 double min,
double max,
double *dst)
93 error =
"Expected number for %s but found: %s\n";
94 else if (d < min || d >
max)
95 error =
"The value for %s was %s which is not within %f - %f\n";
97 error =
"Expected int64 for %s but found %s\n";
99 error =
"Expected int for %s but found %s\n";
110 int rej_flags,
int alt_flags)
119 if (((po->
flags & req_flags) != req_flags) ||
120 (alt_flags && !(po->
flags & alt_flags)) ||
121 (po->
flags & rej_flags))
165 #if HAVE_COMMANDLINETOARGVW && defined(_WIN32)
166 #include <shellapi.h>
168 static char** win32_argv_utf8 =
NULL;
169 static int win32_argc = 0;
182 int i, buffsize = 0,
offset = 0;
184 if (win32_argv_utf8) {
185 *argc_ptr = win32_argc;
186 *argv_ptr = win32_argv_utf8;
191 argv_w = CommandLineToArgvW(GetCommandLineW(), &win32_argc);
192 if (win32_argc <= 0 || !argv_w)
196 for (
i = 0;
i < win32_argc;
i++)
197 buffsize += WideCharToMultiByte(CP_UTF8, 0, argv_w[
i], -1,
200 win32_argv_utf8 =
av_mallocz(
sizeof(
char *) * (win32_argc + 1) + buffsize);
201 argstr_flat = (
char *)win32_argv_utf8 +
sizeof(
char *) * (win32_argc + 1);
202 if (!win32_argv_utf8) {
207 for (
i = 0;
i < win32_argc;
i++) {
208 win32_argv_utf8[
i] = &argstr_flat[
offset];
209 offset += WideCharToMultiByte(CP_UTF8, 0, argv_w[
i], -1,
213 win32_argv_utf8[
i] =
NULL;
216 *argc_ptr = win32_argc;
217 *argv_ptr = win32_argv_utf8;
239 char *p = strchr(opt,
':');
242 dstcount = (
int *)(so + 1);
243 ret =
grow_array((
void**)so,
sizeof(**so), dstcount, *dstcount + 1);
250 (*so)[*dstcount - 1].specifier = str;
251 dst = &(*so)[*dstcount - 1].u;
272 *(int64_t *)dst = num;
291 *(
double *)dst = num;
296 "Failed to set value '%s' for option '%s': %s\n",
311 .
name =
"AVOption passthrough",
320 if (!po->
name && opt[0] ==
'n' && opt[1] ==
'o') {
347 int (*parse_arg_function)(
void *,
const char*))
350 int optindex, handleoptions = 1,
ret;
357 while (optindex < argc) {
358 opt = argv[optindex++];
360 if (handleoptions && opt[0] ==
'-' && opt[1] !=
'\0') {
361 if (opt[1] ==
'-' && opt[2] ==
'\0') {
371 if (parse_arg_function) {
372 ret = parse_arg_function(optctx, opt);
387 g->group_def->name,
g->arg);
389 for (
i = 0;
i <
g->nb_opts;
i++) {
392 if (
g->group_def->flags &&
393 !(
g->group_def->flags & o->
opt->
flags)) {
395 "%s %s -- you are trying to apply an input option to an "
396 "output file or vice versa. Move this option before the "
397 "file it belongs to.\n", o->
key, o->
opt->
help,
398 g->group_def->name,
g->arg);
421 for (
i = 1;
i < argc;
i++) {
422 const char *cur_opt = argv[
i];
424 if (*cur_opt++ !=
'-')
428 if (!po->
name && cur_opt[0] ==
'n' && cur_opt[1] ==
'o')
431 if ((!po->
name && !strcmp(cur_opt, optname)) ||
432 (po->
name && !strcmp(optname, po->
name)))
443 const unsigned char *p;
446 if (!((*p >=
'+' && *p <=
':') || (*p >=
'@' && *p <=
'Z') ||
447 *p ==
'_' || (*p >=
'a' && *p <=
'z')))
454 for (p =
a; *p; p++) {
455 if (*p ==
'\\' || *p ==
'"' || *p ==
'$' || *p ==
'`')
457 else if (*p < ' ' || *p >
'~')
483 if (idx && argv[idx + 1])
493 for (
i = 0;
i < argc;
i++) {
507 int opt_flags,
int search_flags)
515 #define FLAGS (o->type == AV_OPT_TYPE_FLAGS && (arg[0]=='-' || arg[0]=='+')) ? AV_DICT_APPEND : 0
520 char opt_stripped[128];
526 #if CONFIG_SWRESAMPLE
530 if (!strcmp(opt,
"debug") || !strcmp(opt,
"fdebug"))
533 if (!(p = strchr(opt,
':')))
534 p = opt + strlen(opt);
535 av_strlcpy(opt_stripped, opt,
FFMIN(
sizeof(opt_stripped), p - opt + 1));
539 ((opt[0] ==
'v' || opt[0] ==
'a' || opt[0] ==
's') &&
554 if (!strcmp(opt,
"srcw") || !strcmp(opt,
"srch") ||
555 !strcmp(opt,
"dstw") || !strcmp(opt,
"dsth") ||
556 !strcmp(opt,
"src_format") || !strcmp(opt,
"dst_format")) {
557 av_log(
NULL,
AV_LOG_ERROR,
"Directly using swscale dimensions/format options is not supported, please use the -s or -pix_fmt options\n");
565 if (!consumed && !strcmp(opt,
"sws_flags")) {
570 #if CONFIG_SWRESAMPLE
593 for (
i = 0;
i < nb_groups;
i++) {
595 if (p->
sep && !strcmp(p->
sep, opt))
643 const char *
key,
const char *
val)
653 g->opts[
g->nb_opts - 1].opt = opt;
654 g->opts[
g->nb_opts - 1].key =
key;
655 g->opts[
g->nb_opts - 1].val =
val;
666 memset(octx, 0,
sizeof(*octx));
724 while (optindex < argc) {
725 const char *opt = argv[optindex++], *
arg;
731 if (opt[0] ==
'-' && opt[1] ==
'-' && !opt[2]) {
736 if (opt[0] !=
'-' || !opt[1] || dashdash+1 == optindex) {
746 #define GET_ARG(arg) \
748 arg = argv[optindex++]; \
750 av_log(NULL, AV_LOG_ERROR, "Missing argument for option '%s'.\n", opt);\
751 return AVERROR(EINVAL); \
772 arg = argv[optindex++];
789 if (argv[optindex]) {
793 "argument '%s'.\n", opt, argv[optindex]);
798 "with argument '%s'.\n", opt, argv[optindex]);
804 if (opt[0] ==
'n' && opt[1] ==
'o' &&
812 "argument 0.\n", po->
name, po->
help);
822 "command: may be ignored.\n");
839 while (
c !=
'\n' &&
c != EOF)
846 const char *preset_name,
int is_path,
847 const char *codec_name)
851 #if HAVE_GETMODULEHANDLE && defined(_WIN32)
852 char *datadir =
NULL;
855 char *env_ffmpeg_datadir =
getenv_utf8(
"FFMPEG_DATADIR");
856 const char *
base[3] = { env_ffmpeg_datadir,
861 av_strlcpy(filename, preset_name, filename_size);
864 #if HAVE_GETMODULEHANDLE && defined(_WIN32)
865 wchar_t *datadir_w = get_module_filename(
NULL);
868 if (wchartoutf8(datadir_w, &datadir))
875 for (ls = datadir; *ls; ls++)
876 if (*ls ==
'\\') *ls =
'/';
878 if (ls = strrchr(datadir,
'/'))
880 ptrdiff_t datadir_len = ls - datadir;
881 size_t desired_size = datadir_len + strlen(
"/ffpresets") + 1;
883 datadir, desired_size,
sizeof *datadir);
885 datadir = new_datadir;
886 datadir[datadir_len] = 0;
887 strncat(datadir,
"/ffpresets", desired_size - 1 - datadir_len);
893 for (
i = 0;
i < 3 && !
f;
i++) {
896 snprintf(filename, filename_size,
"%s%s/%s.ffpreset",
base[
i],
897 i != 1 ?
"" :
"/.ffmpeg", preset_name);
899 if (!
f && codec_name) {
901 "%s%s/%s-%s.ffpreset",
902 base[
i],
i != 1 ?
"" :
"/.ffmpeg", codec_name,
909 #if HAVE_GETMODULEHANDLE && defined(_WIN32)
957 char *p = strchr(t->
key,
':');
977 else if (t->
key[0] == prefix &&
1006 for (
int i = 0;
i <
s->nb_streams;
i++) {
1015 for (
int i = 0;
i <
s->nb_streams;
i++)
1023 if (new_size >= INT_MAX / elem_size) {
1027 if (*
size < new_size) {
1031 memset(
tmp + *
size*elem_size, 0, (new_size-*
size) * elem_size);
1055 theta -= 360*
floor(theta/360 + 0.9/360);
1057 if (
fabs(theta - 90*
round(theta/90)) > 2)
1059 "If you want to help, upload a sample "
1060 "of this file to https://streams.videolan.org/upload/ "
1061 "and contact the ffmpeg-devel mailing list. (ffmpeg-devel@ffmpeg.org)");
static void error(const char *err)
static FILE * fopen_utf8(const char *path, const char *mode)
const OptionGroupDef * group_def
#define AV_LOG_WARNING
Something somehow does not look correct.
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
#define AV_OPT_FLAG_VIDEO_PARAM
double get_rotation(const int32_t *displaymatrix)
enum AVMediaType codec_type
General type of the encoded data.
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)
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.
static int finish_group(OptionParseContext *octx, int group_idx, const char *arg)
void print_error(const char *filename, int err)
Print an error message to stderr, indicating filename and a human readable description of the error c...
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
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.
#define AV_OPT_FLAG_ENCODING_PARAM
a generic parameter which can be set by the user for muxing or encoding
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.
#define AV_OPT_FLAG_AUDIO_PARAM
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.
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)
int av_parse_time(int64_t *timeval, const char *timestr, int duration)
Parse timestr and return in *time a corresponding number of microseconds.
static int write_option(void *optctx, const OptionDef *po, const char *opt, const char *arg)
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
#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...
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.
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[]
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.
#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.
#define AV_OPT_SEARCH_CHILDREN
Search in possible children of the given object first.
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.
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)
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_DECODING_PARAM
a generic parameter which can be set by the user for demuxing or decoding
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)
int parse_optgroup(void *optctx, OptionGroup *g)
Parse an options group and write results into optctx.
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.
int parse_option(void *optctx, const char *opt, const char *arg, const OptionDef *options)
Parse one given option.
const AVClass * av_opt_child_class_iterate(const AVClass *parent, void **iter)
Iterate over potential AVOptions-enabled children of parent.
#define GROW_ARRAY(array, nb_elems)
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_SUBTITLE_PARAM
const char * sep
Option to be used as group separator.
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.
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.
int av_opt_show2(void *obj, void *av_log_obj, int req_flags, int rej_flags)
Show the obj options.
const AVDictionaryEntry * av_dict_iterate(const AVDictionary *m, const AVDictionaryEntry *prev)
Iterate over a dictionary.
int parse_number(const char *context, const char *numstr, int type, double min, double max, double *dst)
Parse a string and return its corresponding value as a double.
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.