git.sesse.net Git - ffmpeg/blob - libavformat/options.c

   1 /*
   2  * Copyright (c) 2000, 2001, 2002 Fabrice Bellard
   3  *
   4  * This file is part of Libav.
   5  *
   6  * Libav is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * Libav is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with Libav; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  19  */
  20 #include "avformat.h"
  21 #include "avio_internal.h"
  22 #include "libavutil/opt.h"
  23
  24 /**
  25  * @file
  26  * Options definition for AVFormatContext.
  27  */
  28
  29 static const char* format_to_name(void* ptr)
  30 {
  31     AVFormatContext* fc = (AVFormatContext*) ptr;
  32     if(fc->iformat) return fc->iformat->name;
  33     else if(fc->oformat) return fc->oformat->name;
  34     else return "NULL";
  35 }
  36
  37 static void *format_child_next(void *obj, void *prev)
  38 {
  39     AVFormatContext *s = obj;
  40     if (!prev && s->priv_data &&
  41         ((s->iformat && s->iformat->priv_class) ||
  42           s->oformat && s->oformat->priv_class))
  43         return s->priv_data;
  44 #if !FF_API_OLD_AVIO
  45     if (s->pb && s->pb->av_class && prev != s->pb)
  46         return s->pb;
  47 #endif
  48     return NULL;
  49 }
  50
  51 static const AVClass *format_child_class_next(const AVClass *prev)
  52 {
  53     AVInputFormat  *ifmt = NULL;
  54     AVOutputFormat *ofmt = NULL;
  55
  56     if (!prev)
  57 #if !FF_API_OLD_AVIO
  58         return &ffio_url_class;
  59 #else
  60     prev = (void *)&ifmt; // Dummy pointer;
  61 #endif
  62
  63     while ((ifmt = av_iformat_next(ifmt)))
  64         if (ifmt->priv_class == prev)
  65             break;
  66
  67     if (!ifmt)
  68         while ((ofmt = av_oformat_next(ofmt)))
  69             if (ofmt->priv_class == prev)
  70                 break;
  71     if (!ofmt)
  72         while (ifmt = av_iformat_next(ifmt))
  73             if (ifmt->priv_class)
  74                 return ifmt->priv_class;
  75
  76     while (ofmt = av_oformat_next(ofmt))
  77         if (ofmt->priv_class)
  78             return ofmt->priv_class;
  79
  80     return NULL;
  81 }
  82
  83 #define OFFSET(x) offsetof(AVFormatContext,x)
  84 #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
  85 //these names are too long to be readable
  86 #define E AV_OPT_FLAG_ENCODING_PARAM
  87 #define D AV_OPT_FLAG_DECODING_PARAM
  88
  89 static const AVOption options[]={
  90 {"probesize", "set probing size", OFFSET(probesize), AV_OPT_TYPE_INT, {.dbl = 5000000 }, 32, INT_MAX, D},
  91 #if FF_API_MUXRATE
  92 {"muxrate", "set mux rate", OFFSET(mux_rate), AV_OPT_TYPE_INT, {.dbl = DEFAULT }, 0, INT_MAX, E},
  93 #endif
  94 {"packetsize", "set packet size", OFFSET(packet_size), AV_OPT_TYPE_INT, {.dbl = DEFAULT }, 0, INT_MAX, E},
  95 {"fflags", NULL, OFFSET(flags), AV_OPT_TYPE_FLAGS, {.dbl = DEFAULT }, INT_MIN, INT_MAX, D|E, "fflags"},
  96 {"ignidx", "ignore index", 0, AV_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_IGNIDX }, INT_MIN, INT_MAX, D, "fflags"},
  97 {"genpts", "generate pts", 0, AV_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_GENPTS }, INT_MIN, INT_MAX, D, "fflags"},
  98 {"nofillin", "do not fill in missing values that can be exactly calculated", 0, AV_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_NOFILLIN }, INT_MIN, INT_MAX, D, "fflags"},
  99 {"noparse", "disable AVParsers, this needs nofillin too", 0, AV_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_NOPARSE }, INT_MIN, INT_MAX, D, "fflags"},
 100 {"igndts", "ignore dts", 0, AV_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_IGNDTS }, INT_MIN, INT_MAX, D, "fflags"},
 101 #if FF_API_FLAG_RTP_HINT
 102 {"rtphint", "add rtp hinting (deprecated, use the -movflags rtphint option instead)", 0, AV_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_RTP_HINT }, INT_MIN, INT_MAX, E, "fflags"},
 103 #endif
 104 {"discardcorrupt", "discard corrupted frames", 0, AV_OPT_TYPE_CONST, {.dbl = AVFMT_FLAG_DISCARD_CORRUPT }, INT_MIN, INT_MAX, D, "fflags"},
 105 {"analyzeduration", "how many microseconds are analyzed to estimate duration", OFFSET(max_analyze_duration), AV_OPT_TYPE_INT, {.dbl = 5*AV_TIME_BASE }, 0, INT_MAX, D},
 106 {"cryptokey", "decryption key", OFFSET(key), AV_OPT_TYPE_BINARY, {.dbl = 0}, 0, 0, D},
 107 {"indexmem", "max memory used for timestamp index (per stream)", OFFSET(max_index_size), AV_OPT_TYPE_INT, {.dbl = 1<<20 }, 0, INT_MAX, D},
 108 {"rtbufsize", "max memory used for buffering real-time frames", OFFSET(max_picture_buffer), AV_OPT_TYPE_INT, {.dbl = 3041280 }, 0, INT_MAX, D}, /* defaults to 1s of 15fps 352x288 YUYV422 video */
 109 {"fdebug", "print specific debug info", OFFSET(debug), AV_OPT_TYPE_FLAGS, {.dbl = DEFAULT }, 0, INT_MAX, E|D, "fdebug"},
 110 {"ts", NULL, 0, AV_OPT_TYPE_CONST, {.dbl = FF_FDEBUG_TS }, INT_MIN, INT_MAX, E|D, "fdebug"},
 111 {"max_delay", "maximum muxing or demuxing delay in microseconds", OFFSET(max_delay), AV_OPT_TYPE_INT, {.dbl = DEFAULT }, 0, INT_MAX, E|D},
 112 {"fer", "set error detection aggressivity", OFFSET(error_recognition), AV_OPT_TYPE_INT, {.dbl = FF_ER_CAREFUL }, INT_MIN, INT_MAX, D, "fer"},
 113 {"careful", NULL, 0, AV_OPT_TYPE_CONST, {.dbl = FF_ER_CAREFUL }, INT_MIN, INT_MAX, D, "fer"},
 114 {"explode", "abort decoding on error recognition", 0, AV_OPT_TYPE_CONST, {.dbl = FF_ER_EXPLODE }, INT_MIN, INT_MAX, D, "fer"},
 115 {"fpsprobesize", "number of frames used to probe fps", OFFSET(fps_probe_size), AV_OPT_TYPE_INT, {.dbl = -1}, -1, INT_MAX-1, D},
 116 {NULL},
 117 };
 118
 119 #undef E
 120 #undef D
 121 #undef DEFAULT
 122
 123 static const AVClass av_format_context_class = {
 124     .class_name     = "AVFormatContext",
 125     .item_name      = format_to_name,
 126     .option         = options,
 127     .version        = LIBAVUTIL_VERSION_INT,
 128     .child_next     = format_child_next,
 129     .child_class_next = format_child_class_next,
 130 };
 131
 132 static void avformat_get_context_defaults(AVFormatContext *s)
 133 {
 134     memset(s, 0, sizeof(AVFormatContext));
 135
 136     s->av_class = &av_format_context_class;
 137
 138     av_opt_set_defaults(s);
 139 }
 140
 141 AVFormatContext *avformat_alloc_context(void)
 142 {
 143     AVFormatContext *ic;
 144     ic = av_malloc(sizeof(AVFormatContext));
 145     if (!ic) return ic;
 146     avformat_get_context_defaults(ic);
 147     return ic;
 148 }
 149
 150 const AVClass *avformat_get_class(void)
 151 {
 152     return &av_format_context_class;
 153 }