FFmpeg
options.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2001 Fabrice Bellard
3  * Copyright (c) 2002-2004 Michael Niedermayer <michaelni@gmx.at>
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * FFmpeg is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 /**
23  * @file
24  * Options definition for AVCodecContext.
25  */
26 
27 #include "avcodec.h"
28 #include "internal.h"
29 #include "libavutil/avassert.h"
30 #include "libavutil/internal.h"
31 #include "libavutil/mem.h"
32 #include "libavutil/opt.h"
33 #include <string.h>
34 
36 #include "options_table.h"
38 
39 static const char* context_to_name(void* ptr) {
40  AVCodecContext *avc= ptr;
41 
42  if (avc && avc->codec)
43  return avc->codec->name;
44  else
45  return "NULL";
46 }
47 
48 static void *codec_child_next(void *obj, void *prev)
49 {
50  AVCodecContext *s = obj;
51  if (!prev && s->codec && s->codec->priv_class && s->priv_data)
52  return s->priv_data;
53  return NULL;
54 }
55 
56 static const AVClass *codec_child_class_iterate(void **iter)
57 {
58  const AVCodec *c;
59  /* find next codec with priv options */
60  while (c = av_codec_iterate(iter))
61  if (c->priv_class)
62  return c->priv_class;
63  return NULL;
64 }
65 
66 static AVClassCategory get_category(void *ptr)
67 {
68  AVCodecContext* avctx = ptr;
69  if(avctx->codec && avctx->codec->decode) return AV_CLASS_CATEGORY_DECODER;
70  else return AV_CLASS_CATEGORY_ENCODER;
71 }
72 
74  .class_name = "AVCodecContext",
75  .item_name = context_to_name,
76  .option = avcodec_options,
77  .version = LIBAVUTIL_VERSION_INT,
78  .log_level_offset_offset = offsetof(AVCodecContext, log_level_offset),
79  .child_next = codec_child_next,
80  .child_class_iterate = codec_child_class_iterate,
82  .get_category = get_category,
83 };
84 
85 static int init_context_defaults(AVCodecContext *s, const AVCodec *codec)
86 {
87  int flags=0;
88  memset(s, 0, sizeof(AVCodecContext));
89 
90  s->av_class = &av_codec_context_class;
91 
92  s->codec_type = codec ? codec->type : AVMEDIA_TYPE_UNKNOWN;
93  if (codec) {
94  s->codec = codec;
95  s->codec_id = codec->id;
96  }
97 
98  if(s->codec_type == AVMEDIA_TYPE_AUDIO)
100  else if(s->codec_type == AVMEDIA_TYPE_VIDEO)
102  else if(s->codec_type == AVMEDIA_TYPE_SUBTITLE)
105 
106  s->time_base = (AVRational){0,1};
107  s->framerate = (AVRational){ 0, 1 };
108  s->pkt_timebase = (AVRational){ 0, 1 };
109  s->get_buffer2 = avcodec_default_get_buffer2;
110  s->get_format = avcodec_default_get_format;
111  s->get_encode_buffer = avcodec_default_get_encode_buffer;
112  s->execute = avcodec_default_execute;
113  s->execute2 = avcodec_default_execute2;
114  s->sample_aspect_ratio = (AVRational){0,1};
115  s->pix_fmt = AV_PIX_FMT_NONE;
116  s->sw_pix_fmt = AV_PIX_FMT_NONE;
117  s->sample_fmt = AV_SAMPLE_FMT_NONE;
118 
119  s->reordered_opaque = AV_NOPTS_VALUE;
120  if(codec && codec->priv_data_size){
121  s->priv_data = av_mallocz(codec->priv_data_size);
122  if (!s->priv_data)
123  return AVERROR(ENOMEM);
124  if(codec->priv_class){
125  *(const AVClass**)s->priv_data = codec->priv_class;
126  av_opt_set_defaults(s->priv_data);
127  }
128  }
129  if (codec && codec->defaults) {
130  int ret;
131  const AVCodecDefault *d = codec->defaults;
132  while (d->key) {
133  ret = av_opt_set(s, d->key, d->value, 0);
134  av_assert0(ret >= 0);
135  d++;
136  }
137  }
138  return 0;
139 }
140 
142 {
143  AVCodecContext *avctx= av_malloc(sizeof(AVCodecContext));
144 
145  if (!avctx)
146  return NULL;
147 
148  if (init_context_defaults(avctx, codec) < 0) {
149  av_free(avctx);
150  return NULL;
151  }
152 
153  return avctx;
154 }
155 
157 {
158  AVCodecContext *avctx = *pavctx;
159 
160  if (!avctx)
161  return;
162 
163  avcodec_close(avctx);
164 
165  av_freep(&avctx->extradata);
166  av_freep(&avctx->subtitle_header);
167  av_freep(&avctx->intra_matrix);
168  av_freep(&avctx->inter_matrix);
169  av_freep(&avctx->rc_override);
170 
171  av_freep(pavctx);
172 }
173 
175 {
176  return &av_codec_context_class;
177 }
178 
179 #if FF_API_GET_FRAME_CLASS
180 #define FOFFSET(x) offsetof(AVFrame,x)
181 
182 static const AVOption frame_options[]={
183 {"best_effort_timestamp", "", FOFFSET(best_effort_timestamp), AV_OPT_TYPE_INT64, {.i64 = AV_NOPTS_VALUE }, INT64_MIN, INT64_MAX, 0},
184 {"pkt_pos", "", FOFFSET(pkt_pos), AV_OPT_TYPE_INT64, {.i64 = -1 }, INT64_MIN, INT64_MAX, 0},
185 {"pkt_size", "", FOFFSET(pkt_size), AV_OPT_TYPE_INT64, {.i64 = -1 }, INT64_MIN, INT64_MAX, 0},
186 {"sample_aspect_ratio", "", FOFFSET(sample_aspect_ratio), AV_OPT_TYPE_RATIONAL, {.dbl = 0 }, 0, INT_MAX, 0},
187 {"width", "", FOFFSET(width), AV_OPT_TYPE_INT, {.i64 = 0 }, 0, INT_MAX, 0},
188 {"height", "", FOFFSET(height), AV_OPT_TYPE_INT, {.i64 = 0 }, 0, INT_MAX, 0},
189 {"format", "", FOFFSET(format), AV_OPT_TYPE_INT, {.i64 = -1 }, 0, INT_MAX, 0},
190 {"channel_layout", "", FOFFSET(channel_layout), AV_OPT_TYPE_INT64, {.i64 = 0 }, 0, INT64_MAX, 0},
191 {"sample_rate", "", FOFFSET(sample_rate), AV_OPT_TYPE_INT, {.i64 = 0 }, 0, INT_MAX, 0},
192 {NULL},
193 };
194 
195 static const AVClass av_frame_class = {
196  .class_name = "AVFrame",
197  .item_name = NULL,
198  .option = frame_options,
199  .version = LIBAVUTIL_VERSION_INT,
200 };
201 
203 {
204  return &av_frame_class;
205 }
206 #endif
207 
208 #define SROFFSET(x) offsetof(AVSubtitleRect,x)
209 
211 {"x", "", SROFFSET(x), AV_OPT_TYPE_INT, {.i64 = 0 }, 0, INT_MAX, 0},
212 {"y", "", SROFFSET(y), AV_OPT_TYPE_INT, {.i64 = 0 }, 0, INT_MAX, 0},
213 {"w", "", SROFFSET(w), AV_OPT_TYPE_INT, {.i64 = 0 }, 0, INT_MAX, 0},
214 {"h", "", SROFFSET(h), AV_OPT_TYPE_INT, {.i64 = 0 }, 0, INT_MAX, 0},
215 {"type", "", SROFFSET(type), AV_OPT_TYPE_INT, {.i64 = 0 }, 0, INT_MAX, 0},
216 {"flags", "", SROFFSET(flags), AV_OPT_TYPE_FLAGS, {.i64 = 0}, 0, 1, 0, "flags"},
217 {"forced", "", SROFFSET(flags), AV_OPT_TYPE_FLAGS, {.i64 = 0}, 0, 1, 0},
218 {NULL},
219 };
220 
222  .class_name = "AVSubtitleRect",
223  .item_name = NULL,
224  .option = subtitle_rect_options,
225  .version = LIBAVUTIL_VERSION_INT,
226 };
227 
229 {
230  return &av_subtitle_rect_class;
231 }
avcodec_close
av_cold int avcodec_close(AVCodecContext *avctx)
Close a given AVCodecContext and free all the data associated with it (but not the AVCodecContext its...
Definition: avcodec.c:455
AVCodec
AVCodec.
Definition: codec.h:197
FF_ENABLE_DEPRECATION_WARNINGS
#define FF_ENABLE_DEPRECATION_WARNINGS
Definition: internal.h:84
AVMEDIA_TYPE_SUBTITLE
@ AVMEDIA_TYPE_SUBTITLE
Definition: avutil.h:204
AVERROR
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
opt.h
AV_CLASS_CATEGORY_DECODER
@ AV_CLASS_CATEGORY_DECODER
Definition: log.h:36
AV_OPT_FLAG_VIDEO_PARAM
#define AV_OPT_FLAG_VIDEO_PARAM
Definition: opt.h:281
av_opt_set_defaults
void av_opt_set_defaults(void *s)
Set the values of all AVOption fields to their default values.
Definition: opt.c:1358
options_table.h
AVCodec::priv_class
const AVClass * priv_class
AVClass for the private context.
Definition: codec.h:223
AVCodecContext::intra_matrix
uint16_t * intra_matrix
custom intra quantization matrix Must be allocated with the av_malloc() family of functions,...
Definition: avcodec.h:974
w
uint8_t w
Definition: llviddspenc.c:39
internal.h
AVOption
AVOption.
Definition: opt.h:248
AVCodecContext::subtitle_header
uint8_t * subtitle_header
Header containing style information for text subtitles.
Definition: avcodec.h:1789
avcodec_default_get_format
enum AVPixelFormat avcodec_default_get_format(struct AVCodecContext *s, const enum AVPixelFormat *fmt)
Definition: decode.c:860
AV_OPT_TYPE_RATIONAL
@ AV_OPT_TYPE_RATIONAL
Definition: opt.h:230
sample_rate
sample_rate
Definition: ffmpeg_filter.c:156
av_malloc
#define av_malloc(s)
Definition: tableprint_vlc.h:31
AVCodecContext::codec
const struct AVCodec * codec
Definition: avcodec.h:510
av_codec_context_class
static const AVClass av_codec_context_class
Definition: options.c:73
type
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
Definition: writing_filters.txt:86
init_context_defaults
static int init_context_defaults(AVCodecContext *s, const AVCodec *codec)
Definition: options.c:85
av_opt_set
int av_opt_set(void *obj, const char *name, const char *val, int search_flags)
Definition: opt.c:465
subtitle_rect_options
static const AVOption subtitle_rect_options[]
Definition: options.c:210
avassert.h
avcodec_alloc_context3
AVCodecContext * avcodec_alloc_context3(const AVCodec *codec)
Allocate an AVCodecContext and set its fields to default values.
Definition: options.c:141
width
#define width
av_subtitle_rect_class
static const AVClass av_subtitle_rect_class
Definition: options.c:221
s
#define s(width, name)
Definition: cbs_vp9.c:257
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
AV_OPT_TYPE_INT64
@ AV_OPT_TYPE_INT64
Definition: opt.h:226
av_assert0
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
AV_OPT_FLAG_AUDIO_PARAM
#define AV_OPT_FLAG_AUDIO_PARAM
Definition: opt.h:280
AVCodecDefault
Definition: internal.h:207
LIBAVUTIL_VERSION_INT
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
avcodec_get_class
const AVClass * avcodec_get_class(void)
Get the AVClass for AVCodecContext.
Definition: options.c:174
NULL
#define NULL
Definition: coverity.c:32
AVCodec::type
enum AVMediaType type
Definition: codec.h:210
avcodec_free_context
void avcodec_free_context(AVCodecContext **pavctx)
Free the codec context and everything associated with it and write NULL to the provided pointer.
Definition: options.c:156
AVRational
Rational number (pair of numerator and denominator).
Definition: rational.h:58
codec_child_next
static void * codec_child_next(void *obj, void *prev)
Definition: options.c:48
c
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
Definition: undefined.txt:32
avcodec_get_subtitle_rect_class
const AVClass * avcodec_get_subtitle_rect_class(void)
Get the AVClass for AVSubtitleRect.
Definition: options.c:228
AVCodecContext::rc_override
RcOverride * rc_override
Definition: avcodec.h:1293
codec_child_class_iterate
static const AVClass * codec_child_class_iterate(void **iter)
Definition: options.c:56
AVClass::category
AVClassCategory category
Category used for visualization (like color) This is only set if the category is equal for all object...
Definition: log.h:120
AV_SAMPLE_FMT_NONE
@ AV_SAMPLE_FMT_NONE
Definition: samplefmt.h:59
AVCodec::defaults
const AVCodecDefault * defaults
Private codec-specific defaults.
Definition: codec.h:268
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
avcodec_get_frame_class
const AVClass * avcodec_get_frame_class(void)
Definition: options.c:202
av_opt_set_defaults2
void av_opt_set_defaults2(void *s, int mask, int flags)
Set the values of all AVOption fields to their default values.
Definition: opt.c:1363
AVMEDIA_TYPE_UNKNOWN
@ AVMEDIA_TYPE_UNKNOWN
Usually treated as AVMEDIA_TYPE_DATA.
Definition: avutil.h:200
height
#define height
avcodec_default_execute
int avcodec_default_execute(AVCodecContext *c, int(*func)(AVCodecContext *c2, void *arg2), void *arg, int *ret, int count, int size)
Definition: avcodec.c:65
AVCodec::id
enum AVCodecID id
Definition: codec.h:211
avcodec_default_get_buffer2
int avcodec_default_get_buffer2(AVCodecContext *s, AVFrame *frame, int flags)
The default callback for AVCodecContext.get_buffer2().
Definition: decode.c:1438
SROFFSET
#define SROFFSET(x)
Definition: options.c:208
AVClassCategory
AVClassCategory
Definition: log.h:29
avcodec_default_execute2
int avcodec_default_execute2(AVCodecContext *c, int(*func)(AVCodecContext *c2, void *arg2, int jobnr, int threadnr), void *arg, int *ret, int count)
Definition: avcodec.c:78
AVCodecContext::extradata
uint8_t * extradata
some codecs need / can use extradata like Huffman tables.
Definition: avcodec.h:602
internal.h
av_mallocz
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
Definition: mem.c:243
AVCodec::name
const char * name
Name of the codec implementation.
Definition: codec.h:204
AVCodec::priv_data_size
int priv_data_size
Definition: codec.h:245
av_codec_iterate
const AVCodec * av_codec_iterate(void **opaque)
Iterate over all registered codecs.
Definition: allcodecs.c:861
avcodec.h
frame_options
static const AVOption frame_options[]
Definition: options.c:182
ret
ret
Definition: filter_design.txt:187
AVClass::class_name
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:72
get_category
static AVClassCategory get_category(void *ptr)
Definition: options.c:66
AVCodecContext
main external API structure.
Definition: avcodec.h:501
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:65
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:225
FF_DISABLE_DEPRECATION_WARNINGS
#define FF_DISABLE_DEPRECATION_WARNINGS
Definition: internal.h:83
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
mem.h
AV_OPT_FLAG_SUBTITLE_PARAM
#define AV_OPT_FLAG_SUBTITLE_PARAM
Definition: opt.h:282
av_free
#define av_free(p)
Definition: tableprint_vlc.h:34
av_frame_class
static const AVClass av_frame_class
Definition: options.c:195
avcodec_default_get_encode_buffer
int avcodec_default_get_encode_buffer(AVCodecContext *s, AVPacket *pkt, int flags)
The default callback for AVCodecContext.get_encode_buffer().
Definition: encode.c:59
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:35
AVCodecContext::inter_matrix
uint16_t * inter_matrix
custom inter quantization matrix Must be allocated with the av_malloc() family of functions,...
Definition: avcodec.h:983
format
fg outputs[0] format
Definition: ffmpeg_filter.c:175
d
d
Definition: ffmpeg_filter.c:156
AV_OPT_TYPE_FLAGS
@ AV_OPT_TYPE_FLAGS
Definition: opt.h:224
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:561
avcodec_options
static const AVOption avcodec_options[]
Definition: options_table.h:45
AVCodec::decode
int(* decode)(struct AVCodecContext *avctx, void *outdata, int *got_frame_ptr, struct AVPacket *avpkt)
Decode picture or subtitle data.
Definition: codec.h:305
FOFFSET
#define FOFFSET(x)
Definition: options.c:180
AV_CLASS_CATEGORY_ENCODER
@ AV_CLASS_CATEGORY_ENCODER
Definition: log.h:35
h
h
Definition: vp9dsp_template.c:2038
context_to_name
FF_DISABLE_DEPRECATION_WARNINGS static const FF_ENABLE_DEPRECATION_WARNINGS char * context_to_name(void *ptr)
Definition: options.c:39