mirror of https://github.com/FFmpeg/FFmpeg.git
Originally committed as revision 25210 to svn://svn.ffmpeg.org/ffmpeg/trunkoldabi
Michael Niedermayer
14 years ago
parent
cba322d76d
commit
6ed040408b
15 changed files with 702 additions and 601 deletions
@ -0,0 +1,441 @@ |
|||||||
|
/*
|
||||||
|
* AVOptions |
||||||
|
* Copyright (c) 2005 Michael Niedermayer <michaelni@gmx.at> |
||||||
|
* |
||||||
|
* This file is part of FFmpeg. |
||||||
|
* |
||||||
|
* FFmpeg is free software; you can redistribute it and/or |
||||||
|
* modify it under the terms of the GNU Lesser General Public |
||||||
|
* License as published by the Free Software Foundation; either |
||||||
|
* version 2.1 of the License, or (at your option) any later version. |
||||||
|
* |
||||||
|
* FFmpeg is distributed in the hope that it will be useful, |
||||||
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
||||||
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
||||||
|
* Lesser General Public License for more details. |
||||||
|
* |
||||||
|
* You should have received a copy of the GNU Lesser General Public |
||||||
|
* License along with FFmpeg; if not, write to the Free Software |
||||||
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
||||||
|
*/ |
||||||
|
|
||||||
|
/**
|
||||||
|
* @file |
||||||
|
* AVOptions |
||||||
|
* @author Michael Niedermayer <michaelni@gmx.at> |
||||||
|
*/ |
||||||
|
|
||||||
|
#include "avutil.h" |
||||||
|
#include "opt.h" |
||||||
|
#include "libavutil/eval.h" |
||||||
|
|
||||||
|
//FIXME order them and do a bin search
|
||||||
|
const AVOption *av_find_opt(void *v, const char *name, const char *unit, int mask, int flags){ |
||||||
|
AVClass *c= *(AVClass**)v; //FIXME silly way of storing AVClass
|
||||||
|
const AVOption *o= c->option; |
||||||
|
|
||||||
|
for(;o && o->name; o++){ |
||||||
|
if(!strcmp(o->name, name) && (!unit || (o->unit && !strcmp(o->unit, unit))) && (o->flags & mask) == flags ) |
||||||
|
return o; |
||||||
|
} |
||||||
|
return NULL; |
||||||
|
} |
||||||
|
|
||||||
|
const AVOption *av_next_option(void *obj, const AVOption *last){ |
||||||
|
if(last && last[1].name) return ++last; |
||||||
|
else if(last) return NULL; |
||||||
|
else return (*(AVClass**)obj)->option; |
||||||
|
} |
||||||
|
|
||||||
|
static int av_set_number2(void *obj, const char *name, double num, int den, int64_t intnum, const AVOption **o_out){ |
||||||
|
const AVOption *o= av_find_opt(obj, name, NULL, 0, 0); |
||||||
|
void *dst; |
||||||
|
if(o_out) |
||||||
|
*o_out= o; |
||||||
|
if(!o || o->offset<=0) |
||||||
|
return AVERROR(ENOENT); |
||||||
|
|
||||||
|
if(o->max*den < num*intnum || o->min*den > num*intnum) { |
||||||
|
av_log(obj, AV_LOG_ERROR, "Value %lf for parameter '%s' out of range\n", num, name); |
||||||
|
return AVERROR(ERANGE); |
||||||
|
} |
||||||
|
|
||||||
|
dst= ((uint8_t*)obj) + o->offset; |
||||||
|
|
||||||
|
switch(o->type){ |
||||||
|
case FF_OPT_TYPE_FLAGS: |
||||||
|
case FF_OPT_TYPE_INT: *(int *)dst= llrint(num/den)*intnum; break; |
||||||
|
case FF_OPT_TYPE_INT64: *(int64_t *)dst= llrint(num/den)*intnum; break; |
||||||
|
case FF_OPT_TYPE_FLOAT: *(float *)dst= num*intnum/den; break; |
||||||
|
case FF_OPT_TYPE_DOUBLE:*(double *)dst= num*intnum/den; break; |
||||||
|
case FF_OPT_TYPE_RATIONAL: |
||||||
|
if((int)num == num) *(AVRational*)dst= (AVRational){num*intnum, den}; |
||||||
|
else *(AVRational*)dst= av_d2q(num*intnum/den, 1<<24); |
||||||
|
break; |
||||||
|
default: |
||||||
|
return AVERROR(EINVAL); |
||||||
|
} |
||||||
|
return 0; |
||||||
|
} |
||||||
|
|
||||||
|
static const AVOption *av_set_number(void *obj, const char *name, double num, int den, int64_t intnum){ |
||||||
|
const AVOption *o = NULL; |
||||||
|
if (av_set_number2(obj, name, num, den, intnum, &o) < 0) |
||||||
|
return NULL; |
||||||
|
else |
||||||
|
return o; |
||||||
|
} |
||||||
|
|
||||||
|
static const double const_values[]={ |
||||||
|
M_PI, |
||||||
|
M_E, |
||||||
|
FF_QP2LAMBDA, |
||||||
|
0 |
||||||
|
}; |
||||||
|
|
||||||
|
static const char * const const_names[]={ |
||||||
|
"PI", |
||||||
|
"E", |
||||||
|
"QP2LAMBDA", |
||||||
|
0 |
||||||
|
}; |
||||||
|
|
||||||
|
static int hexchar2int(char c) { |
||||||
|
if (c >= '0' && c <= '9') return c - '0'; |
||||||
|
if (c >= 'a' && c <= 'f') return c - 'a' + 10; |
||||||
|
if (c >= 'A' && c <= 'F') return c - 'A' + 10; |
||||||
|
return -1; |
||||||
|
} |
||||||
|
|
||||||
|
int av_set_string3(void *obj, const char *name, const char *val, int alloc, const AVOption **o_out){ |
||||||
|
int ret; |
||||||
|
const AVOption *o= av_find_opt(obj, name, NULL, 0, 0); |
||||||
|
if (o_out) |
||||||
|
*o_out = o; |
||||||
|
if(!o) |
||||||
|
return AVERROR(ENOENT); |
||||||
|
if(!val || o->offset<=0) |
||||||
|
return AVERROR(EINVAL); |
||||||
|
|
||||||
|
if(o->type == FF_OPT_TYPE_BINARY){ |
||||||
|
uint8_t **dst = (uint8_t **)(((uint8_t*)obj) + o->offset); |
||||||
|
int *lendst = (int *)(dst + 1); |
||||||
|
uint8_t *bin, *ptr; |
||||||
|
int len = strlen(val); |
||||||
|
av_freep(dst); |
||||||
|
*lendst = 0; |
||||||
|
if (len & 1) return AVERROR(EINVAL); |
||||||
|
len /= 2; |
||||||
|
ptr = bin = av_malloc(len); |
||||||
|
while (*val) { |
||||||
|
int a = hexchar2int(*val++); |
||||||
|
int b = hexchar2int(*val++); |
||||||
|
if (a < 0 || b < 0) { |
||||||
|
av_free(bin); |
||||||
|
return AVERROR(EINVAL); |
||||||
|
} |
||||||
|
*ptr++ = (a << 4) | b; |
||||||
|
} |
||||||
|
*dst = bin; |
||||||
|
*lendst = len; |
||||||
|
return 0; |
||||||
|
} |
||||||
|
if(o->type != FF_OPT_TYPE_STRING){ |
||||||
|
int notfirst=0; |
||||||
|
for(;;){ |
||||||
|
int i; |
||||||
|
char buf[256]; |
||||||
|
int cmd=0; |
||||||
|
double d; |
||||||
|
|
||||||
|
if(*val == '+' || *val == '-') |
||||||
|
cmd= *(val++); |
||||||
|
|
||||||
|
for(i=0; i<sizeof(buf)-1 && val[i] && val[i]!='+' && val[i]!='-'; i++) |
||||||
|
buf[i]= val[i]; |
||||||
|
buf[i]=0; |
||||||
|
|
||||||
|
{ |
||||||
|
const AVOption *o_named= av_find_opt(obj, buf, o->unit, 0, 0); |
||||||
|
if(o_named && o_named->type == FF_OPT_TYPE_CONST) |
||||||
|
d= o_named->default_val; |
||||||
|
else if(!strcmp(buf, "default")) d= o->default_val; |
||||||
|
else if(!strcmp(buf, "max" )) d= o->max; |
||||||
|
else if(!strcmp(buf, "min" )) d= o->min; |
||||||
|
else if(!strcmp(buf, "none" )) d= 0; |
||||||
|
else if(!strcmp(buf, "all" )) d= ~0; |
||||||
|
else { |
||||||
|
int res = av_parse_and_eval_expr(&d, buf, const_names, const_values, NULL, NULL, NULL, NULL, NULL, 0, obj); |
||||||
|
if (res < 0) { |
||||||
|
av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\"\n", val); |
||||||
|
return res; |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
if(o->type == FF_OPT_TYPE_FLAGS){ |
||||||
|
if (cmd=='+') d= av_get_int(obj, name, NULL) | (int64_t)d; |
||||||
|
else if(cmd=='-') d= av_get_int(obj, name, NULL) &~(int64_t)d; |
||||||
|
}else{ |
||||||
|
if (cmd=='+') d= notfirst*av_get_double(obj, name, NULL) + d; |
||||||
|
else if(cmd=='-') d= notfirst*av_get_double(obj, name, NULL) - d; |
||||||
|
} |
||||||
|
|
||||||
|
if ((ret = av_set_number2(obj, name, d, 1, 1, o_out)) < 0) |
||||||
|
return ret; |
||||||
|
val+= i; |
||||||
|
if(!*val) |
||||||
|
return 0; |
||||||
|
notfirst=1; |
||||||
|
} |
||||||
|
return AVERROR(EINVAL); |
||||||
|
} |
||||||
|
|
||||||
|
if(alloc){ |
||||||
|
av_free(*(void**)(((uint8_t*)obj) + o->offset)); |
||||||
|
val= av_strdup(val); |
||||||
|
} |
||||||
|
|
||||||
|
memcpy(((uint8_t*)obj) + o->offset, &val, sizeof(val)); |
||||||
|
return 0; |
||||||
|
} |
||||||
|
|
||||||
|
const AVOption *av_set_double(void *obj, const char *name, double n){ |
||||||
|
return av_set_number(obj, name, n, 1, 1); |
||||||
|
} |
||||||
|
|
||||||
|
const AVOption *av_set_q(void *obj, const char *name, AVRational n){ |
||||||
|
return av_set_number(obj, name, n.num, n.den, 1); |
||||||
|
} |
||||||
|
|
||||||
|
const AVOption *av_set_int(void *obj, const char *name, int64_t n){ |
||||||
|
return av_set_number(obj, name, 1, 1, n); |
||||||
|
} |
||||||
|
|
||||||
|
/**
|
||||||
|
* |
||||||
|
* @param buf a buffer which is used for returning non string values as strings, can be NULL |
||||||
|
* @param buf_len allocated length in bytes of buf |
||||||
|
*/ |
||||||
|
const char *av_get_string(void *obj, const char *name, const AVOption **o_out, char *buf, int buf_len){ |
||||||
|
const AVOption *o= av_find_opt(obj, name, NULL, 0, 0); |
||||||
|
void *dst; |
||||||
|
uint8_t *bin; |
||||||
|
int len, i; |
||||||
|
if(!o || o->offset<=0) |
||||||
|
return NULL; |
||||||
|
if(o->type != FF_OPT_TYPE_STRING && (!buf || !buf_len)) |
||||||
|
return NULL; |
||||||
|
|
||||||
|
dst= ((uint8_t*)obj) + o->offset; |
||||||
|
if(o_out) *o_out= o; |
||||||
|
|
||||||
|
switch(o->type){ |
||||||
|
case FF_OPT_TYPE_FLAGS: snprintf(buf, buf_len, "0x%08X",*(int *)dst);break; |
||||||
|
case FF_OPT_TYPE_INT: snprintf(buf, buf_len, "%d" , *(int *)dst);break; |
||||||
|
case FF_OPT_TYPE_INT64: snprintf(buf, buf_len, "%"PRId64, *(int64_t*)dst);break; |
||||||
|
case FF_OPT_TYPE_FLOAT: snprintf(buf, buf_len, "%f" , *(float *)dst);break; |
||||||
|
case FF_OPT_TYPE_DOUBLE: snprintf(buf, buf_len, "%f" , *(double *)dst);break; |
||||||
|
case FF_OPT_TYPE_RATIONAL: snprintf(buf, buf_len, "%d/%d", ((AVRational*)dst)->num, ((AVRational*)dst)->den);break; |
||||||
|
case FF_OPT_TYPE_STRING: return *(void**)dst; |
||||||
|
case FF_OPT_TYPE_BINARY: |
||||||
|
len = *(int*)(((uint8_t *)dst) + sizeof(uint8_t *)); |
||||||
|
if(len >= (buf_len + 1)/2) return NULL; |
||||||
|
bin = *(uint8_t**)dst; |
||||||
|
for(i = 0; i < len; i++) snprintf(buf + i*2, 3, "%02X", bin[i]); |
||||||
|
break; |
||||||
|
default: return NULL; |
||||||
|
} |
||||||
|
return buf; |
||||||
|
} |
||||||
|
|
||||||
|
static int av_get_number(void *obj, const char *name, const AVOption **o_out, double *num, int *den, int64_t *intnum){ |
||||||
|
const AVOption *o= av_find_opt(obj, name, NULL, 0, 0); |
||||||
|
void *dst; |
||||||
|
if(!o || o->offset<=0) |
||||||
|
goto error; |
||||||
|
|
||||||
|
dst= ((uint8_t*)obj) + o->offset; |
||||||
|
|
||||||
|
if(o_out) *o_out= o; |
||||||
|
|
||||||
|
switch(o->type){ |
||||||
|
case FF_OPT_TYPE_FLAGS: *intnum= *(unsigned int*)dst;return 0; |
||||||
|
case FF_OPT_TYPE_INT: *intnum= *(int *)dst;return 0; |
||||||
|
case FF_OPT_TYPE_INT64: *intnum= *(int64_t*)dst;return 0; |
||||||
|
case FF_OPT_TYPE_FLOAT: *num= *(float *)dst;return 0; |
||||||
|
case FF_OPT_TYPE_DOUBLE: *num= *(double *)dst;return 0; |
||||||
|
case FF_OPT_TYPE_RATIONAL: *intnum= ((AVRational*)dst)->num; |
||||||
|
*den = ((AVRational*)dst)->den; |
||||||
|
return 0; |
||||||
|
} |
||||||
|
error: |
||||||
|
*den=*intnum=0; |
||||||
|
return -1; |
||||||
|
} |
||||||
|
|
||||||
|
double av_get_double(void *obj, const char *name, const AVOption **o_out){ |
||||||
|
int64_t intnum=1; |
||||||
|
double num=1; |
||||||
|
int den=1; |
||||||
|
|
||||||
|
av_get_number(obj, name, o_out, &num, &den, &intnum); |
||||||
|
return num*intnum/den; |
||||||
|
} |
||||||
|
|
||||||
|
AVRational av_get_q(void *obj, const char *name, const AVOption **o_out){ |
||||||
|
int64_t intnum=1; |
||||||
|
double num=1; |
||||||
|
int den=1; |
||||||
|
|
||||||
|
av_get_number(obj, name, o_out, &num, &den, &intnum); |
||||||
|
if(num == 1.0 && (int)intnum == intnum) |
||||||
|
return (AVRational){intnum, den}; |
||||||
|
else |
||||||
|
return av_d2q(num*intnum/den, 1<<24); |
||||||
|
} |
||||||
|
|
||||||
|
int64_t av_get_int(void *obj, const char *name, const AVOption **o_out){ |
||||||
|
int64_t intnum=1; |
||||||
|
double num=1; |
||||||
|
int den=1; |
||||||
|
|
||||||
|
av_get_number(obj, name, o_out, &num, &den, &intnum); |
||||||
|
return num*intnum/den; |
||||||
|
} |
||||||
|
|
||||||
|
static void opt_list(void *obj, void *av_log_obj, const char *unit, |
||||||
|
int req_flags, int rej_flags) |
||||||
|
{ |
||||||
|
const AVOption *opt=NULL; |
||||||
|
|
||||||
|
while((opt= av_next_option(obj, opt))){ |
||||||
|
if (!(opt->flags & req_flags) || (opt->flags & rej_flags)) |
||||||
|
continue; |
||||||
|
|
||||||
|
/* Don't print CONST's on level one.
|
||||||
|
* Don't print anything but CONST's on level two. |
||||||
|
* Only print items from the requested unit. |
||||||
|
*/ |
||||||
|
if (!unit && opt->type==FF_OPT_TYPE_CONST) |
||||||
|
continue; |
||||||
|
else if (unit && opt->type!=FF_OPT_TYPE_CONST) |
||||||
|
continue; |
||||||
|
else if (unit && opt->type==FF_OPT_TYPE_CONST && strcmp(unit, opt->unit)) |
||||||
|
continue; |
||||||
|
else if (unit && opt->type == FF_OPT_TYPE_CONST) |
||||||
|
av_log(av_log_obj, AV_LOG_INFO, " %-15s ", opt->name); |
||||||
|
else |
||||||
|
av_log(av_log_obj, AV_LOG_INFO, "-%-17s ", opt->name); |
||||||
|
|
||||||
|
switch( opt->type ) |
||||||
|
{ |
||||||
|
case FF_OPT_TYPE_FLAGS: |
||||||
|
av_log( av_log_obj, AV_LOG_INFO, "%-7s ", "<flags>" ); |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_INT: |
||||||
|
av_log( av_log_obj, AV_LOG_INFO, "%-7s ", "<int>" ); |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_INT64: |
||||||
|
av_log( av_log_obj, AV_LOG_INFO, "%-7s ", "<int64>" ); |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_DOUBLE: |
||||||
|
av_log( av_log_obj, AV_LOG_INFO, "%-7s ", "<double>" ); |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_FLOAT: |
||||||
|
av_log( av_log_obj, AV_LOG_INFO, "%-7s ", "<float>" ); |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_STRING: |
||||||
|
av_log( av_log_obj, AV_LOG_INFO, "%-7s ", "<string>" ); |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_RATIONAL: |
||||||
|
av_log( av_log_obj, AV_LOG_INFO, "%-7s ", "<rational>" ); |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_BINARY: |
||||||
|
av_log( av_log_obj, AV_LOG_INFO, "%-7s ", "<binary>" ); |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_CONST: |
||||||
|
default: |
||||||
|
av_log( av_log_obj, AV_LOG_INFO, "%-7s ", "" ); |
||||||
|
break; |
||||||
|
} |
||||||
|
av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_ENCODING_PARAM) ? 'E' : '.'); |
||||||
|
av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_DECODING_PARAM) ? 'D' : '.'); |
||||||
|
av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_VIDEO_PARAM ) ? 'V' : '.'); |
||||||
|
av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_AUDIO_PARAM ) ? 'A' : '.'); |
||||||
|
av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_SUBTITLE_PARAM) ? 'S' : '.'); |
||||||
|
|
||||||
|
if(opt->help) |
||||||
|
av_log(av_log_obj, AV_LOG_INFO, " %s", opt->help); |
||||||
|
av_log(av_log_obj, AV_LOG_INFO, "\n"); |
||||||
|
if (opt->unit && opt->type != FF_OPT_TYPE_CONST) { |
||||||
|
opt_list(obj, av_log_obj, opt->unit, req_flags, rej_flags); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
int av_opt_show2(void *obj, void *av_log_obj, int req_flags, int rej_flags) |
||||||
|
{ |
||||||
|
if(!obj) |
||||||
|
return -1; |
||||||
|
|
||||||
|
av_log(av_log_obj, AV_LOG_INFO, "%s AVOptions:\n", (*(AVClass**)obj)->class_name); |
||||||
|
|
||||||
|
opt_list(obj, av_log_obj, NULL, req_flags, rej_flags); |
||||||
|
|
||||||
|
return 0; |
||||||
|
} |
||||||
|
|
||||||
|
/** Set the values of the AVCodecContext or AVFormatContext structure.
|
||||||
|
* They are set to the defaults specified in the according AVOption options |
||||||
|
* array default_val field. |
||||||
|
* |
||||||
|
* @param s AVCodecContext or AVFormatContext for which the defaults will be set |
||||||
|
*/ |
||||||
|
void av_opt_set_defaults2(void *s, int mask, int flags) |
||||||
|
{ |
||||||
|
const AVOption *opt = NULL; |
||||||
|
while ((opt = av_next_option(s, opt)) != NULL) { |
||||||
|
if((opt->flags & mask) != flags) |
||||||
|
continue; |
||||||
|
switch(opt->type) { |
||||||
|
case FF_OPT_TYPE_CONST: |
||||||
|
/* Nothing to be done here */ |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_FLAGS: |
||||||
|
case FF_OPT_TYPE_INT: { |
||||||
|
int val; |
||||||
|
val = opt->default_val; |
||||||
|
av_set_int(s, opt->name, val); |
||||||
|
} |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_INT64: |
||||||
|
if((double)(opt->default_val+0.6) == opt->default_val) |
||||||
|
av_log(s, AV_LOG_DEBUG, "loss of precision in default of %s\n", opt->name); |
||||||
|
av_set_int(s, opt->name, opt->default_val); |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_FLOAT: { |
||||||
|
double val; |
||||||
|
val = opt->default_val; |
||||||
|
av_set_double(s, opt->name, val); |
||||||
|
} |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_RATIONAL: { |
||||||
|
AVRational val; |
||||||
|
val = av_d2q(opt->default_val, INT_MAX); |
||||||
|
av_set_q(s, opt->name, val); |
||||||
|
} |
||||||
|
break; |
||||||
|
case FF_OPT_TYPE_STRING: |
||||||
|
case FF_OPT_TYPE_BINARY: |
||||||
|
/* Cannot set default for string as default_val is of type * double */ |
||||||
|
break; |
||||||
|
default: |
||||||
|
av_log(s, AV_LOG_DEBUG, "AVOption type %d of option %s not implemented yet\n", opt->type, opt->name); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
void av_opt_set_defaults(void *s){ |
||||||
|
av_opt_set_defaults2(s, 0, 0); |
||||||
|
} |
||||||
|
|
||||||
@ -0,0 +1,207 @@ |
|||||||
|
/*
|
||||||
|
* AVOptions |
||||||
|
* copyright (c) 2005 Michael Niedermayer <michaelni@gmx.at> |
||||||
|
* |
||||||
|
* This file is part of FFmpeg. |
||||||
|
* |
||||||
|
* FFmpeg is free software; you can redistribute it and/or |
||||||
|
* modify it under the terms of the GNU Lesser General Public |
||||||
|
* License as published by the Free Software Foundation; either |
||||||
|
* version 2.1 of the License, or (at your option) any later version. |
||||||
|
* |
||||||
|
* FFmpeg is distributed in the hope that it will be useful, |
||||||
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
||||||
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
||||||
|
* Lesser General Public License for more details. |
||||||
|
* |
||||||
|
* You should have received a copy of the GNU Lesser General Public |
||||||
|
* License along with FFmpeg; if not, write to the Free Software |
||||||
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
||||||
|
*/ |
||||||
|
|
||||||
|
#ifndef AVUTIL_OPT_H |
||||||
|
#define AVUTIL_OPT_H |
||||||
|
|
||||||
|
/**
|
||||||
|
* @file |
||||||
|
* AVOptions |
||||||
|
*/ |
||||||
|
|
||||||
|
#include "rational.h" |
||||||
|
#include "avutil.h" |
||||||
|
|
||||||
|
enum AVOptionType{ |
||||||
|
FF_OPT_TYPE_FLAGS, |
||||||
|
FF_OPT_TYPE_INT, |
||||||
|
FF_OPT_TYPE_INT64, |
||||||
|
FF_OPT_TYPE_DOUBLE, |
||||||
|
FF_OPT_TYPE_FLOAT, |
||||||
|
FF_OPT_TYPE_STRING, |
||||||
|
FF_OPT_TYPE_RATIONAL, |
||||||
|
FF_OPT_TYPE_BINARY, ///< offset must point to a pointer immediately followed by an int for the length
|
||||||
|
FF_OPT_TYPE_CONST=128, |
||||||
|
}; |
||||||
|
|
||||||
|
/**
|
||||||
|
* AVOption |
||||||
|
*/ |
||||||
|
typedef struct AVOption { |
||||||
|
const char *name; |
||||||
|
|
||||||
|
/**
|
||||||
|
* short English help text |
||||||
|
* @todo What about other languages? |
||||||
|
*/ |
||||||
|
const char *help; |
||||||
|
|
||||||
|
/**
|
||||||
|
* The offset relative to the context structure where the option |
||||||
|
* value is stored. It should be 0 for named constants. |
||||||
|
*/ |
||||||
|
int offset; |
||||||
|
enum AVOptionType type; |
||||||
|
|
||||||
|
/**
|
||||||
|
* the default value for scalar options |
||||||
|
*/ |
||||||
|
double default_val; |
||||||
|
double min; ///< minimum valid value for the option
|
||||||
|
double max; ///< maximum valid value for the option
|
||||||
|
|
||||||
|
int flags; |
||||||
|
#define AV_OPT_FLAG_ENCODING_PARAM 1 ///< a generic parameter which can be set by the user for muxing or encoding
|
||||||
|
#define AV_OPT_FLAG_DECODING_PARAM 2 ///< a generic parameter which can be set by the user for demuxing or decoding
|
||||||
|
#define AV_OPT_FLAG_METADATA 4 ///< some data extracted or inserted into the file like title, comment, ...
|
||||||
|
#define AV_OPT_FLAG_AUDIO_PARAM 8 |
||||||
|
#define AV_OPT_FLAG_VIDEO_PARAM 16 |
||||||
|
#define AV_OPT_FLAG_SUBTITLE_PARAM 32 |
||||||
|
//FIXME think about enc-audio, ... style flags
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The logical unit to which the option belongs. Non-constant |
||||||
|
* options and corresponding named constants share the same |
||||||
|
* unit. May be NULL. |
||||||
|
*/ |
||||||
|
const char *unit; |
||||||
|
} AVOption; |
||||||
|
|
||||||
|
/**
|
||||||
|
* AVOption2. |
||||||
|
* THIS IS NOT PART OF THE API/ABI YET! |
||||||
|
* This is identical to AVOption except that default_val was replaced by |
||||||
|
* an union, it should be compatible with AVOption on normal platforms. |
||||||
|
*/ |
||||||
|
typedef struct AVOption2 { |
||||||
|
const char *name; |
||||||
|
|
||||||
|
/**
|
||||||
|
* short English help text |
||||||
|
* @todo What about other languages? |
||||||
|
*/ |
||||||
|
const char *help; |
||||||
|
|
||||||
|
/**
|
||||||
|
* The offset relative to the context structure where the option |
||||||
|
* value is stored. It should be 0 for named constants. |
||||||
|
*/ |
||||||
|
int offset; |
||||||
|
enum AVOptionType type; |
||||||
|
|
||||||
|
/**
|
||||||
|
* the default value for scalar options |
||||||
|
*/ |
||||||
|
union { |
||||||
|
double dbl; |
||||||
|
const char *str; |
||||||
|
} default_val; |
||||||
|
|
||||||
|
double min; ///< minimum valid value for the option
|
||||||
|
double max; ///< maximum valid value for the option
|
||||||
|
|
||||||
|
int flags; |
||||||
|
/*
|
||||||
|
#define AV_OPT_FLAG_ENCODING_PARAM 1 ///< a generic parameter which can be set by the user for muxing or encoding
|
||||||
|
#define AV_OPT_FLAG_DECODING_PARAM 2 ///< a generic parameter which can be set by the user for demuxing or decoding
|
||||||
|
#define AV_OPT_FLAG_METADATA 4 ///< some data extracted or inserted into the file like title, comment, ...
|
||||||
|
#define AV_OPT_FLAG_AUDIO_PARAM 8 |
||||||
|
#define AV_OPT_FLAG_VIDEO_PARAM 16 |
||||||
|
#define AV_OPT_FLAG_SUBTITLE_PARAM 32 |
||||||
|
*/ |
||||||
|
//FIXME think about enc-audio, ... style flags
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The logical unit to which the option belongs. Non-constant |
||||||
|
* options and corresponding named constants share the same |
||||||
|
* unit. May be NULL. |
||||||
|
*/ |
||||||
|
const char *unit; |
||||||
|
} AVOption2; |
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Look for an option in obj. Look only for the options which |
||||||
|
* have the flags set as specified in mask and flags (that is, |
||||||
|
* for which it is the case that opt->flags & mask == flags). |
||||||
|
* |
||||||
|
* @param[in] obj a pointer to a struct whose first element is a |
||||||
|
* pointer to an AVClass |
||||||
|
* @param[in] name the name of the option to look for |
||||||
|
* @param[in] unit the unit of the option to look for, or any if NULL |
||||||
|
* @return a pointer to the option found, or NULL if no option |
||||||
|
* has been found |
||||||
|
*/ |
||||||
|
const AVOption *av_find_opt(void *obj, const char *name, const char *unit, int mask, int flags); |
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the field of obj with the given name to value. |
||||||
|
* |
||||||
|
* @param[in] obj A struct whose first element is a pointer to an |
||||||
|
* AVClass. |
||||||
|
* @param[in] name the name of the field to set |
||||||
|
* @param[in] val The value to set. If the field is not of a string |
||||||
|
* type, then the given string is parsed. |
||||||
|
* SI postfixes and some named scalars are supported. |
||||||
|
* If the field is of a numeric type, it has to be a numeric or named |
||||||
|
* scalar. Behavior with more than one scalar and +- infix operators |
||||||
|
* is undefined. |
||||||
|
* If the field is of a flags type, it has to be a sequence of numeric |
||||||
|
* scalars or named flags separated by '+' or '-'. Prefixing a flag |
||||||
|
* with '+' causes it to be set without affecting the other flags; |
||||||
|
* similarly, '-' unsets a flag. |
||||||
|
* @param[out] o_out if non-NULL put here a pointer to the AVOption |
||||||
|
* found |
||||||
|
* @param alloc when 1 then the old value will be av_freed() and the |
||||||
|
* new av_strduped() |
||||||
|
* when 0 then no av_free() nor av_strdup() will be used |
||||||
|
* @return 0 if the value has been set, or an AVERROR code in case of |
||||||
|
* error: |
||||||
|
* AVERROR(ENOENT) if no matching option exists |
||||||
|
* AVERROR(ERANGE) if the value is out of range |
||||||
|
* AVERROR(EINVAL) if the value is not valid |
||||||
|
*/ |
||||||
|
int av_set_string3(void *obj, const char *name, const char *val, int alloc, const AVOption **o_out); |
||||||
|
|
||||||
|
const AVOption *av_set_double(void *obj, const char *name, double n); |
||||||
|
const AVOption *av_set_q(void *obj, const char *name, AVRational n); |
||||||
|
const AVOption *av_set_int(void *obj, const char *name, int64_t n); |
||||||
|
double av_get_double(void *obj, const char *name, const AVOption **o_out); |
||||||
|
AVRational av_get_q(void *obj, const char *name, const AVOption **o_out); |
||||||
|
int64_t av_get_int(void *obj, const char *name, const AVOption **o_out); |
||||||
|
const char *av_get_string(void *obj, const char *name, const AVOption **o_out, char *buf, int buf_len); |
||||||
|
const AVOption *av_next_option(void *obj, const AVOption *last); |
||||||
|
|
||||||
|
/**
|
||||||
|
* Show the obj options. |
||||||
|
* |
||||||
|
* @param req_flags requested flags for the options to show. Show only the |
||||||
|
* options for which it is opt->flags & req_flags. |
||||||
|
* @param rej_flags rejected flags for the options to show. Show only the |
||||||
|
* options for which it is !(opt->flags & req_flags). |
||||||
|
* @param av_log_obj log context to use for showing the options |
||||||
|
*/ |
||||||
|
int av_opt_show2(void *obj, void *av_log_obj, int req_flags, int rej_flags); |
||||||
|
|
||||||
|
void av_opt_set_defaults(void *s); |
||||||
|
void av_opt_set_defaults2(void *s, int mask, int flags); |
||||||
|
|
||||||
|
#endif /* AVUTIL_OPT_H */ |
||||||
Loading…
Reference in new issue