Libav 0.7.1
libavformat/options.c
Go to the documentation of this file.
00001 /*
00002  * Copyright (c) 2000, 2001, 2002 Fabrice Bellard
00003  *
00004  * This file is part of Libav.
00005  *
00006  * Libav is free software; you can redistribute it and/or
00007  * modify it under the terms of the GNU Lesser General Public
00008  * License as published by the Free Software Foundation; either
00009  * version 2.1 of the License, or (at your option) any later version.
00010  *
00011  * Libav is distributed in the hope that it will be useful,
00012  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00013  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00014  * Lesser General Public License for more details.
00015  *
00016  * You should have received a copy of the GNU Lesser General Public
00017  * License along with Libav; if not, write to the Free Software
00018  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
00019  */
00020 #include "avformat.h"
00021 #include "libavutil/opt.h"
00022 
00028 static const char* format_to_name(void* ptr)
00029 {
00030     AVFormatContext* fc = (AVFormatContext*) ptr;
00031     if(fc->iformat) return fc->iformat->name;
00032     else if(fc->oformat) return fc->oformat->name;
00033     else return "NULL";
00034 }
00035 
00036 static const AVOption *opt_find(void *obj, const char *name, const char *unit, int opt_flags, int search_flags)
00037 {
00038     AVFormatContext   *s = obj;
00039     AVInputFormat  *ifmt = NULL;
00040     AVOutputFormat *ofmt = NULL;
00041     if (s->priv_data) {
00042         if ((s->iformat && !s->iformat->priv_class) ||
00043             (s->oformat && !s->oformat->priv_class))
00044             return NULL;
00045         return av_opt_find(s->priv_data, name, unit, opt_flags, search_flags);
00046     }
00047 
00048     while ((ifmt = av_iformat_next(ifmt))) {
00049         const AVOption *o;
00050 
00051         if (ifmt->priv_class && (o = av_opt_find(&ifmt->priv_class, name, unit, opt_flags, search_flags)))
00052             return o;
00053     }
00054     while ((ofmt = av_oformat_next(ofmt))) {
00055         const AVOption *o;
00056 
00057         if (ofmt->priv_class && (o = av_opt_find(&ofmt->priv_class, name, unit, opt_flags, search_flags)))
00058             return o;
00059     }
00060     return NULL;
00061 }
00062 
00063 #define OFFSET(x) offsetof(AVFormatContext,x)
00064 #define DEFAULT 0 //should be NAN but it does not work as it is not a constant in glibc as required by ANSI/ISO C
00065 //these names are too long to be readable
00066 #define E AV_OPT_FLAG_ENCODING_PARAM
00067 #define D AV_OPT_FLAG_DECODING_PARAM
00068 
00069 static const AVOption options[]={
00070 {"probesize", "set probing size", OFFSET(probesize), FF_OPT_TYPE_INT, {.dbl = 5000000 }, 32, INT_MAX, D},
00071 {"muxrate", "set mux rate", OFFSET(mux_rate), FF_OPT_TYPE_INT, {.dbl = DEFAULT }, 0, INT_MAX, E},
00072 {"packetsize", "set packet size", OFFSET(packet_size), FF_OPT_TYPE_INT, {.dbl = DEFAULT }, 0, INT_MAX, E},
00073 {"fflags", NULL, OFFSET(flags), FF_OPT_TYPE_FLAGS, {.dbl = DEFAULT }, INT_MIN, INT_MAX, D|E, "fflags"},
00074 {"ignidx", "ignore index", 0, FF_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_IGNIDX }, INT_MIN, INT_MAX, D, "fflags"},
00075 {"genpts", "generate pts", 0, FF_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_GENPTS }, INT_MIN, INT_MAX, D, "fflags"},
00076 {"nofillin", "do not fill in missing values that can be exactly calculated", 0, FF_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_NOFILLIN }, INT_MIN, INT_MAX, D, "fflags"},
00077 {"noparse", "disable AVParsers, this needs nofillin too", 0, FF_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_NOPARSE }, INT_MIN, INT_MAX, D, "fflags"},
00078 {"igndts", "ignore dts", 0, FF_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_IGNDTS }, INT_MIN, INT_MAX, D, "fflags"},
00079 #if FF_API_FLAG_RTP_HINT
00080 {"rtphint", "add rtp hinting (deprecated, use the -movflags rtphint option instead)", 0, FF_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_RTP_HINT }, INT_MIN, INT_MAX, E, "fflags"},
00081 #endif
00082 {"analyzeduration", "how many microseconds are analyzed to estimate duration", OFFSET(max_analyze_duration), FF_OPT_TYPE_INT, {.dbl = 5*AV_TIME_BASE }, 0, INT_MAX, D},
00083 {"cryptokey", "decryption key", OFFSET(key), FF_OPT_TYPE_BINARY, {.dbl = 0}, 0, 0, D},
00084 {"indexmem", "max memory used for timestamp index (per stream)", OFFSET(max_index_size), FF_OPT_TYPE_INT, {.dbl = 1<<20 }, 0, INT_MAX, D},
00085 {"rtbufsize", "max memory used for buffering real-time frames", OFFSET(max_picture_buffer), FF_OPT_TYPE_INT, {.dbl = 3041280 }, 0, INT_MAX, D}, /* defaults to 1s of 15fps 352x288 YUYV422 video */
00086 {"fdebug", "print specific debug info", OFFSET(debug), FF_OPT_TYPE_FLAGS, {.dbl = DEFAULT }, 0, INT_MAX, E|D, "fdebug"},
00087 {"ts", NULL, 0, FF_OPT_TYPE_CONST, {.dbl = FF_FDEBUG_TS }, INT_MIN, INT_MAX, E|D, "fdebug"},
00088 {"max_delay", "maximum muxing or demuxing delay in microseconds", OFFSET(max_delay), FF_OPT_TYPE_INT, {.dbl = DEFAULT }, 0, INT_MAX, E|D},
00089 {"fpsprobesize", "number of frames used to probe fps", OFFSET(fps_probe_size), FF_OPT_TYPE_INT, {.dbl = -1}, -1, INT_MAX-1, D},
00090 {NULL},
00091 };
00092 
00093 #undef E
00094 #undef D
00095 #undef DEFAULT
00096 
00097 static const AVClass av_format_context_class = {
00098     .class_name     = "AVFormatContext",
00099     .item_name      = format_to_name,
00100     .option         = options,
00101     .version        = LIBAVUTIL_VERSION_INT,
00102     .opt_find       = opt_find,
00103 };
00104 
00105 static void avformat_get_context_defaults(AVFormatContext *s)
00106 {
00107     memset(s, 0, sizeof(AVFormatContext));
00108 
00109     s->av_class = &av_format_context_class;
00110 
00111     av_opt_set_defaults(s);
00112 }
00113 
00114 AVFormatContext *avformat_alloc_context(void)
00115 {
00116     AVFormatContext *ic;
00117     ic = av_malloc(sizeof(AVFormatContext));
00118     if (!ic) return ic;
00119     avformat_get_context_defaults(ic);
00120     return ic;
00121 }