Coverage Report

Created: 2026-01-25 07:18

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/ffmpeg/libavcodec/avcodec.c
Line
Count
Source
1
/*
2
 * AVCodecContext functions for libavcodec
3
 *
4
 * This file is part of FFmpeg.
5
 *
6
 * FFmpeg 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
 * FFmpeg 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 FFmpeg; if not, write to the Free Software
18
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19
 */
20
21
/**
22
 * @file
23
 * AVCodecContext functions for libavcodec
24
 */
25
26
#include <assert.h>
27
28
#include "config.h"
29
#include "libavutil/avassert.h"
30
#include "libavutil/avstring.h"
31
#include "libavutil/bprint.h"
32
#include "libavutil/channel_layout.h"
33
#include "libavutil/common.h"
34
#include "libavutil/emms.h"
35
#include "libavutil/imgutils.h"
36
#include "libavutil/mem.h"
37
#include "libavutil/opt.h"
38
#include "libavutil/thread.h"
39
#include "avcodec.h"
40
#include "avcodec_internal.h"
41
#include "bsf.h"
42
#include "codec_desc.h"
43
#include "codec_internal.h"
44
#include "decode.h"
45
#include "frame_thread_encoder.h"
46
#include "hwconfig.h"
47
#include "internal.h"
48
#include "libavutil/refstruct.h"
49
50
/**
51
 * Maximum size in bytes of extradata.
52
 * This value was chosen such that every bit of the buffer is
53
 * addressable by a 32-bit signed integer as used by get_bits.
54
 */
55
0
#define FF_MAX_EXTRADATA_SIZE ((1 << 28) - AV_INPUT_BUFFER_PADDING_SIZE)
56
57
const SideDataMap ff_sd_global_map[] = {
58
    { AV_PKT_DATA_REPLAYGAIN ,                AV_FRAME_DATA_REPLAYGAIN },
59
    { AV_PKT_DATA_DISPLAYMATRIX,              AV_FRAME_DATA_DISPLAYMATRIX },
60
    { AV_PKT_DATA_SPHERICAL,                  AV_FRAME_DATA_SPHERICAL },
61
    { AV_PKT_DATA_STEREO3D,                   AV_FRAME_DATA_STEREO3D },
62
    { AV_PKT_DATA_AUDIO_SERVICE_TYPE,         AV_FRAME_DATA_AUDIO_SERVICE_TYPE },
63
    { AV_PKT_DATA_MASTERING_DISPLAY_METADATA, AV_FRAME_DATA_MASTERING_DISPLAY_METADATA },
64
    { AV_PKT_DATA_CONTENT_LIGHT_LEVEL,        AV_FRAME_DATA_CONTENT_LIGHT_LEVEL },
65
    { AV_PKT_DATA_ICC_PROFILE,                AV_FRAME_DATA_ICC_PROFILE },
66
    { AV_PKT_DATA_AMBIENT_VIEWING_ENVIRONMENT,AV_FRAME_DATA_AMBIENT_VIEWING_ENVIRONMENT },
67
    { AV_PKT_DATA_3D_REFERENCE_DISPLAYS,      AV_FRAME_DATA_3D_REFERENCE_DISPLAYS },
68
    { AV_PKT_DATA_EXIF,                       AV_FRAME_DATA_EXIF },
69
    { AV_PKT_DATA_NB },
70
};
71
72
73
int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2), void *arg, int *ret, int count, int size)
74
0
{
75
0
    size_t i;
76
77
0
    for (i = 0; i < count; i++) {
78
0
        size_t offset = i * size;
79
0
        int r = func(c, FF_PTR_ADD((char *)arg, offset));
80
0
        if (ret)
81
0
            ret[i] = r;
82
0
    }
83
0
    emms_c();
84
0
    return 0;
85
0
}
86
87
int avcodec_default_execute2(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2, int jobnr, int threadnr), void *arg, int *ret, int count)
88
0
{
89
0
    int i;
90
91
0
    for (i = 0; i < count; i++) {
92
0
        int r = func(c, arg, i, 0);
93
0
        if (ret)
94
0
            ret[i] = r;
95
0
    }
96
0
    emms_c();
97
0
    return 0;
98
0
}
99
100
static AVMutex codec_mutex = AV_MUTEX_INITIALIZER;
101
102
static void lock_avcodec(const FFCodec *codec)
103
0
{
104
0
    if (codec->caps_internal & FF_CODEC_CAP_NOT_INIT_THREADSAFE && codec->init)
105
0
        ff_mutex_lock(&codec_mutex);
106
0
}
107
108
static void unlock_avcodec(const FFCodec *codec)
109
0
{
110
0
    if (codec->caps_internal & FF_CODEC_CAP_NOT_INIT_THREADSAFE && codec->init)
111
0
        ff_mutex_unlock(&codec_mutex);
112
0
}
113
114
static int64_t get_bit_rate(AVCodecContext *ctx)
115
0
{
116
0
    int64_t bit_rate;
117
0
    int bits_per_sample;
118
119
0
    switch (ctx->codec_type) {
120
0
    case AVMEDIA_TYPE_VIDEO:
121
0
    case AVMEDIA_TYPE_DATA:
122
0
    case AVMEDIA_TYPE_SUBTITLE:
123
0
    case AVMEDIA_TYPE_ATTACHMENT:
124
0
        bit_rate = ctx->bit_rate;
125
0
        break;
126
0
    case AVMEDIA_TYPE_AUDIO:
127
0
        bits_per_sample = av_get_bits_per_sample(ctx->codec_id);
128
0
        if (bits_per_sample) {
129
0
            bit_rate = ctx->sample_rate * (int64_t)ctx->ch_layout.nb_channels;
130
0
            if (bit_rate > INT64_MAX / bits_per_sample) {
131
0
                bit_rate = 0;
132
0
            } else
133
0
                bit_rate *= bits_per_sample;
134
0
        } else
135
0
            bit_rate = ctx->bit_rate;
136
0
        break;
137
0
    default:
138
0
        bit_rate = 0;
139
0
        break;
140
0
    }
141
0
    return bit_rate;
142
0
}
143
144
int attribute_align_arg avcodec_open2(AVCodecContext *avctx, const AVCodec *codec, AVDictionary **options)
145
0
{
146
0
    int ret = 0;
147
0
    AVCodecInternal *avci;
148
0
    const FFCodec *codec2;
149
0
    const AVDictionaryEntry *e;
150
151
0
    if (avcodec_is_open(avctx))
152
0
        return 0;
153
154
0
    if (!codec && !avctx->codec) {
155
0
        av_log(avctx, AV_LOG_ERROR, "No codec provided to avcodec_open2()\n");
156
0
        return AVERROR(EINVAL);
157
0
    }
158
0
    if (codec && avctx->codec && codec != avctx->codec) {
159
0
        av_log(avctx, AV_LOG_ERROR, "This AVCodecContext was allocated for %s, "
160
0
                                    "but %s passed to avcodec_open2()\n", avctx->codec->name, codec->name);
161
0
        return AVERROR(EINVAL);
162
0
    }
163
0
    if (!codec)
164
0
        codec = avctx->codec;
165
0
    codec2 = ffcodec(codec);
166
167
0
    if ((avctx->codec_type != AVMEDIA_TYPE_UNKNOWN && avctx->codec_type != codec->type) ||
168
0
        (avctx->codec_id   != AV_CODEC_ID_NONE     && avctx->codec_id   != codec->id)) {
169
0
        av_log(avctx, AV_LOG_ERROR, "Codec type or id mismatches\n");
170
0
        return AVERROR(EINVAL);
171
0
    }
172
173
0
    avctx->codec_type = codec->type;
174
0
    avctx->codec_id   = codec->id;
175
0
    avctx->codec      = codec;
176
177
0
    if (avctx->extradata_size < 0 || avctx->extradata_size >= FF_MAX_EXTRADATA_SIZE)
178
0
        return AVERROR(EINVAL);
179
180
    // set the whitelist from provided options dict,
181
    // so we can check it immediately
182
0
    e = options ? av_dict_get(*options, "codec_whitelist", NULL, 0) : NULL;
183
0
    if (e) {
184
0
        ret = av_opt_set(avctx, e->key, e->value, 0);
185
0
        if (ret < 0)
186
0
            return ret;
187
0
    }
188
189
0
    if (avctx->codec_whitelist && av_match_list(codec->name, avctx->codec_whitelist, ',') <= 0) {
190
0
        av_log(avctx, AV_LOG_ERROR, "Codec (%s) not on whitelist \'%s\'\n", codec->name, avctx->codec_whitelist);
191
0
        return AVERROR(EINVAL);
192
0
    }
193
194
0
    avci = ff_codec_is_decoder(codec) ?
195
0
        ff_decode_internal_alloc()    :
196
0
        ff_encode_internal_alloc();
197
0
    if (!avci) {
198
0
        ret = AVERROR(ENOMEM);
199
0
        goto end;
200
0
    }
201
0
    avctx->internal = avci;
202
203
0
    avci->buffer_frame = av_frame_alloc();
204
0
    avci->buffer_pkt = av_packet_alloc();
205
0
    if (!avci->buffer_frame || !avci->buffer_pkt) {
206
0
        ret = AVERROR(ENOMEM);
207
0
        goto free_and_end;
208
0
    }
209
210
0
    if (codec2->priv_data_size > 0) {
211
0
        if (!avctx->priv_data) {
212
0
            avctx->priv_data = av_mallocz(codec2->priv_data_size);
213
0
            if (!avctx->priv_data) {
214
0
                ret = AVERROR(ENOMEM);
215
0
                goto free_and_end;
216
0
            }
217
0
            if (codec->priv_class) {
218
0
                *(const AVClass **)avctx->priv_data = codec->priv_class;
219
0
                av_opt_set_defaults(avctx->priv_data);
220
0
            }
221
0
        }
222
0
    } else {
223
0
        avctx->priv_data = NULL;
224
0
    }
225
226
0
    ret = av_opt_set_dict2(avctx, options, AV_OPT_SEARCH_CHILDREN);
227
0
    if (ret < 0)
228
0
        goto free_and_end;
229
230
    // only call ff_set_dimensions() for non H.264/VP6F/DXV codecs so as not to overwrite previously setup dimensions
231
0
    if (!(avctx->coded_width && avctx->coded_height && avctx->width && avctx->height &&
232
0
          (avctx->codec_id == AV_CODEC_ID_H264 || avctx->codec_id == AV_CODEC_ID_VP6F || avctx->codec_id == AV_CODEC_ID_DXV))) {
233
0
        if (avctx->coded_width && avctx->coded_height)
234
0
            ret = ff_set_dimensions(avctx, avctx->coded_width, avctx->coded_height);
235
0
        else if (avctx->width && avctx->height)
236
0
            ret = ff_set_dimensions(avctx, avctx->width, avctx->height);
237
0
        if (ret < 0)
238
0
            goto free_and_end;
239
0
    }
240
241
0
    if ((avctx->coded_width || avctx->coded_height || avctx->width || avctx->height)
242
0
        && (  av_image_check_size2(avctx->coded_width, avctx->coded_height, avctx->max_pixels, AV_PIX_FMT_NONE, 0, avctx) < 0
243
0
           || av_image_check_size2(avctx->width,       avctx->height,       avctx->max_pixels, AV_PIX_FMT_NONE, 0, avctx) < 0)) {
244
0
        av_log(avctx, AV_LOG_WARNING, "Ignoring invalid width/height values\n");
245
0
        ff_set_dimensions(avctx, 0, 0);
246
0
    }
247
248
0
    if (avctx->width > 0 && avctx->height > 0) {
249
0
        if (av_image_check_sar(avctx->width, avctx->height,
250
0
                               avctx->sample_aspect_ratio) < 0) {
251
0
            av_log(avctx, AV_LOG_WARNING, "ignoring invalid SAR: %u/%u\n",
252
0
                   avctx->sample_aspect_ratio.num,
253
0
                   avctx->sample_aspect_ratio.den);
254
0
            avctx->sample_aspect_ratio = (AVRational){ 0, 1 };
255
0
        }
256
0
    }
257
258
    /* AV_CODEC_CAP_CHANNEL_CONF is a decoder-only flag; so the code below
259
     * in particular checks that sample_rate is set for all audio encoders. */
260
0
    if (avctx->sample_rate < 0 ||
261
0
        avctx->sample_rate == 0 && avctx->codec_type == AVMEDIA_TYPE_AUDIO &&
262
0
        !(codec->capabilities & AV_CODEC_CAP_CHANNEL_CONF)) {
263
0
        av_log(avctx, AV_LOG_ERROR, "Invalid sample rate: %d\n", avctx->sample_rate);
264
0
        ret = AVERROR(EINVAL);
265
0
        goto free_and_end;
266
0
    }
267
0
    if (avctx->block_align < 0) {
268
0
        av_log(avctx, AV_LOG_ERROR, "Invalid block align: %d\n", avctx->block_align);
269
0
        ret = AVERROR(EINVAL);
270
0
        goto free_and_end;
271
0
    }
272
273
    /* AV_CODEC_CAP_CHANNEL_CONF is a decoder-only flag; so the code below
274
     * in particular checks that nb_channels is set for all audio encoders. */
275
0
    if (avctx->codec_type == AVMEDIA_TYPE_AUDIO && !avctx->ch_layout.nb_channels
276
0
        && !(codec->capabilities & AV_CODEC_CAP_CHANNEL_CONF)) {
277
0
        av_log(avctx, AV_LOG_ERROR, "%s requires channel layout to be set\n",
278
0
               ff_codec_is_decoder(codec) ? "Decoder" : "Encoder");
279
0
        ret = AVERROR(EINVAL);
280
0
        goto free_and_end;
281
0
    }
282
0
    if (avctx->ch_layout.nb_channels && !av_channel_layout_check(&avctx->ch_layout)) {
283
0
        av_log(avctx, AV_LOG_ERROR, "Invalid channel layout\n");
284
0
        ret = AVERROR(EINVAL);
285
0
        goto free_and_end;
286
0
    }
287
0
    if (avctx->ch_layout.nb_channels > FF_SANE_NB_CHANNELS) {
288
0
        av_log(avctx, AV_LOG_ERROR, "Too many channels: %d\n", avctx->ch_layout.nb_channels);
289
0
        ret = AVERROR(EINVAL);
290
0
        goto free_and_end;
291
0
    }
292
293
0
    avctx->frame_num = 0;
294
0
    avctx->codec_descriptor = avcodec_descriptor_get(avctx->codec_id);
295
296
0
    if ((avctx->codec->capabilities & AV_CODEC_CAP_EXPERIMENTAL) &&
297
0
        avctx->strict_std_compliance > FF_COMPLIANCE_EXPERIMENTAL) {
298
0
        const char *codec_string = ff_codec_is_encoder(codec) ? "encoder" : "decoder";
299
0
        const AVCodec *codec2;
300
0
        av_log(avctx, AV_LOG_ERROR,
301
0
               "The %s '%s' is experimental but experimental codecs are not enabled, "
302
0
               "add '-strict %d' if you want to use it.\n",
303
0
               codec_string, codec->name, FF_COMPLIANCE_EXPERIMENTAL);
304
0
        codec2 = ff_codec_is_encoder(codec) ? avcodec_find_encoder(codec->id) : avcodec_find_decoder(codec->id);
305
0
        if (!(codec2->capabilities & AV_CODEC_CAP_EXPERIMENTAL))
306
0
            av_log(avctx, AV_LOG_ERROR, "Alternatively use the non experimental %s '%s'.\n",
307
0
                codec_string, codec2->name);
308
0
        ret = AVERROR_EXPERIMENTAL;
309
0
        goto free_and_end;
310
0
    }
311
312
0
    if (avctx->codec_type == AVMEDIA_TYPE_AUDIO &&
313
0
        (!avctx->time_base.num || !avctx->time_base.den)) {
314
0
        avctx->time_base.num = 1;
315
0
        avctx->time_base.den = avctx->sample_rate;
316
0
    }
317
318
0
    if (ff_codec_is_encoder(avctx->codec))
319
0
        ret = ff_encode_preinit(avctx);
320
0
    else
321
0
        ret = ff_decode_preinit(avctx);
322
0
    if (ret < 0)
323
0
        goto free_and_end;
324
325
0
    if (HAVE_THREADS && !avci->frame_thread_encoder) {
326
        /* Frame-threaded decoders call FFCodec.init for their child contexts. */
327
0
        lock_avcodec(codec2);
328
0
        ret = ff_thread_init(avctx);
329
0
        unlock_avcodec(codec2);
330
0
        if (ret < 0) {
331
0
            goto free_and_end;
332
0
        }
333
0
    }
334
0
    if (!HAVE_THREADS && !(codec2->caps_internal & FF_CODEC_CAP_AUTO_THREADS))
335
0
        avctx->thread_count = 1;
336
337
0
    if (!(avctx->active_thread_type & FF_THREAD_FRAME) ||
338
0
        avci->frame_thread_encoder) {
339
0
        if (codec2->init) {
340
0
            lock_avcodec(codec2);
341
0
            ret = codec2->init(avctx);
342
0
            unlock_avcodec(codec2);
343
0
            if (ret < 0) {
344
0
                avci->needs_close = codec2->caps_internal & FF_CODEC_CAP_INIT_CLEANUP;
345
0
                goto free_and_end;
346
0
            }
347
0
        }
348
0
        avci->needs_close = 1;
349
0
    }
350
351
0
    ret=0;
352
353
0
    if (ff_codec_is_decoder(avctx->codec)) {
354
0
        if (!avctx->bit_rate)
355
0
            avctx->bit_rate = get_bit_rate(avctx);
356
357
        /* validate channel layout from the decoder */
358
0
        if ((avctx->ch_layout.nb_channels && !av_channel_layout_check(&avctx->ch_layout)) ||
359
0
            avctx->ch_layout.nb_channels > FF_SANE_NB_CHANNELS) {
360
0
            ret = AVERROR(EINVAL);
361
0
            goto free_and_end;
362
0
        }
363
0
        if (avctx->bits_per_coded_sample < 0) {
364
0
            ret = AVERROR(EINVAL);
365
0
            goto free_and_end;
366
0
        }
367
0
    }
368
0
    if (codec->priv_class)
369
0
        av_assert0(*(const AVClass **)avctx->priv_data == codec->priv_class);
370
371
0
end:
372
373
0
    return ret;
374
0
free_and_end:
375
0
    ff_codec_close(avctx);
376
0
    goto end;
377
0
}
378
379
void avcodec_flush_buffers(AVCodecContext *avctx)
380
0
{
381
0
    AVCodecInternal *avci = avctx->internal;
382
383
0
    if (av_codec_is_encoder(avctx->codec)) {
384
0
        int caps = avctx->codec->capabilities;
385
386
0
        if (!(caps & AV_CODEC_CAP_ENCODER_FLUSH)) {
387
            // Only encoders that explicitly declare support for it can be
388
            // flushed. Otherwise, this is a no-op.
389
0
            av_log(avctx, AV_LOG_WARNING, "Ignoring attempt to flush encoder "
390
0
                   "that doesn't support it\n");
391
0
            return;
392
0
        }
393
0
        ff_encode_flush_buffers(avctx);
394
0
    } else
395
0
        ff_decode_flush_buffers(avctx);
396
397
0
    avci->draining      = 0;
398
0
    avci->draining_done = 0;
399
0
    if (avci->buffer_frame)
400
0
        av_frame_unref(avci->buffer_frame);
401
0
    if (avci->buffer_pkt)
402
0
        av_packet_unref(avci->buffer_pkt);
403
404
0
    if (HAVE_THREADS && avctx->active_thread_type & FF_THREAD_FRAME &&
405
0
        !avci->is_frame_mt)
406
0
        ff_thread_flush(avctx);
407
0
    else if (ffcodec(avctx->codec)->flush)
408
0
        ffcodec(avctx->codec)->flush(avctx);
409
0
}
410
411
void avsubtitle_free(AVSubtitle *sub)
412
0
{
413
0
    int i;
414
415
0
    for (i = 0; i < sub->num_rects; i++) {
416
0
        AVSubtitleRect *const rect = sub->rects[i];
417
418
0
        av_freep(&rect->data[0]);
419
0
        av_freep(&rect->data[1]);
420
0
        av_freep(&rect->data[2]);
421
0
        av_freep(&rect->data[3]);
422
0
        av_freep(&rect->text);
423
0
        av_freep(&rect->ass);
424
425
0
        av_freep(&sub->rects[i]);
426
0
    }
427
428
0
    av_freep(&sub->rects);
429
430
0
    memset(sub, 0, sizeof(*sub));
431
0
}
432
433
av_cold void ff_codec_close(AVCodecContext *avctx)
434
0
{
435
0
    int i;
436
437
0
    if (avcodec_is_open(avctx)) {
438
0
        AVCodecInternal *avci = avctx->internal;
439
440
#if CONFIG_FRAME_THREAD_ENCODER
441
        if (avci->frame_thread_encoder && avctx->thread_count > 1) {
442
            ff_frame_thread_encoder_free(avctx);
443
        }
444
#endif
445
0
        if (HAVE_THREADS && avci->thread_ctx)
446
0
            ff_thread_free(avctx);
447
0
        if (avci->needs_close && ffcodec(avctx->codec)->close)
448
0
            ffcodec(avctx->codec)->close(avctx);
449
0
        avci->byte_buffer_size = 0;
450
0
        av_freep(&avci->byte_buffer);
451
0
        av_frame_free(&avci->buffer_frame);
452
0
        av_packet_free(&avci->buffer_pkt);
453
0
        av_packet_free(&avci->last_pkt_props);
454
455
0
        av_packet_free(&avci->in_pkt);
456
0
        av_frame_free(&avci->in_frame);
457
0
        av_frame_free(&avci->recon_frame);
458
459
0
        av_refstruct_unref(&avci->pool);
460
0
        av_refstruct_pool_uninit(&avci->progress_frame_pool);
461
0
        if (av_codec_is_decoder(avctx->codec))
462
0
            ff_decode_internal_uninit(avctx);
463
464
0
        ff_hwaccel_uninit(avctx);
465
466
0
        av_bsf_free(&avci->bsf);
467
468
#if CONFIG_LCMS2
469
        ff_icc_context_uninit(&avci->icc);
470
#endif
471
472
0
        av_freep(&avctx->internal);
473
0
    }
474
475
0
    for (i = 0; i < avctx->nb_coded_side_data; i++)
476
0
        av_freep(&avctx->coded_side_data[i].data);
477
0
    av_freep(&avctx->coded_side_data);
478
0
    avctx->nb_coded_side_data = 0;
479
0
    av_frame_side_data_free(&avctx->decoded_side_data,
480
0
                            &avctx->nb_decoded_side_data);
481
482
0
    av_buffer_unref(&avctx->hw_frames_ctx);
483
0
    av_buffer_unref(&avctx->hw_device_ctx);
484
485
0
    if (avctx->priv_data && avctx->codec && avctx->codec->priv_class)
486
0
        av_opt_free(avctx->priv_data);
487
0
    av_opt_free(avctx);
488
0
    av_freep(&avctx->priv_data);
489
0
    if (av_codec_is_encoder(avctx->codec)) {
490
0
        av_freep(&avctx->extradata);
491
0
        avctx->extradata_size = 0;
492
0
    } else if (av_codec_is_decoder(avctx->codec))
493
0
        av_freep(&avctx->subtitle_header);
494
495
0
    avctx->codec = NULL;
496
0
    avctx->active_thread_type = 0;
497
0
}
498
499
static const char *unknown_if_null(const char *str)
500
0
{
501
0
    return str ? str : "unknown";
502
0
}
503
504
void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode)
505
0
{
506
0
    const char *codec_type;
507
0
    const char *codec_name;
508
0
    const char *profile = NULL;
509
0
    AVBPrint bprint;
510
0
    int64_t bitrate;
511
0
    int new_line = 0;
512
0
    AVRational display_aspect_ratio;
513
0
    const char *separator = enc->dump_separator ? (const char *)enc->dump_separator : ", ";
514
0
    const char *str;
515
516
0
    if (!buf || buf_size <= 0)
517
0
        return;
518
0
    av_bprint_init_for_buffer(&bprint, buf, buf_size);
519
0
    codec_type = av_get_media_type_string(enc->codec_type);
520
0
    codec_name = avcodec_get_name(enc->codec_id);
521
0
    profile = avcodec_profile_name(enc->codec_id, enc->profile);
522
523
0
    av_bprintf(&bprint, "%s: %s", codec_type ? codec_type : "unknown",
524
0
               codec_name);
525
0
    buf[0] ^= 'a' ^ 'A'; /* first letter in uppercase */
526
527
0
    if (enc->codec && strcmp(enc->codec->name, codec_name))
528
0
        av_bprintf(&bprint, " (%s)", enc->codec->name);
529
530
0
    if (profile)
531
0
        av_bprintf(&bprint, " (%s)", profile);
532
0
    if (   enc->codec_type == AVMEDIA_TYPE_VIDEO
533
0
        && av_log_get_level() >= AV_LOG_VERBOSE
534
0
        && enc->refs)
535
0
        av_bprintf(&bprint, ", %d reference frame%s",
536
0
                   enc->refs, enc->refs > 1 ? "s" : "");
537
538
0
    if (enc->codec_tag)
539
0
        av_bprintf(&bprint, " (%s / 0x%04X)",
540
0
                   av_fourcc2str(enc->codec_tag), enc->codec_tag);
541
542
0
    switch (enc->codec_type) {
543
0
    case AVMEDIA_TYPE_VIDEO:
544
0
        {
545
0
            unsigned len;
546
547
0
            av_bprintf(&bprint, "%s%s", separator,
548
0
                       enc->pix_fmt == AV_PIX_FMT_NONE ? "none" :
549
0
                       unknown_if_null(av_get_pix_fmt_name(enc->pix_fmt)));
550
551
0
            av_bprint_chars(&bprint, '(', 1);
552
0
            len = bprint.len;
553
554
            /* The following check ensures that '(' has been written
555
             * and therefore allows us to erase it if it turns out
556
             * to be unnecessary. */
557
0
            if (!av_bprint_is_complete(&bprint))
558
0
                return;
559
560
0
            if (enc->bits_per_raw_sample && enc->pix_fmt != AV_PIX_FMT_NONE &&
561
0
                enc->bits_per_raw_sample < av_pix_fmt_desc_get(enc->pix_fmt)->comp[0].depth)
562
0
                av_bprintf(&bprint, "%d bpc, ", enc->bits_per_raw_sample);
563
0
            if (enc->color_range != AVCOL_RANGE_UNSPECIFIED &&
564
0
                (str = av_color_range_name(enc->color_range)))
565
0
                av_bprintf(&bprint, "%s, ", str);
566
567
0
            if (enc->colorspace != AVCOL_SPC_UNSPECIFIED ||
568
0
                enc->color_primaries != AVCOL_PRI_UNSPECIFIED ||
569
0
                enc->color_trc != AVCOL_TRC_UNSPECIFIED) {
570
0
                const char *col = unknown_if_null(av_color_space_name(enc->colorspace));
571
0
                const char *pri = unknown_if_null(av_color_primaries_name(enc->color_primaries));
572
0
                const char *trc = unknown_if_null(av_color_transfer_name(enc->color_trc));
573
0
                if (strcmp(col, pri) || strcmp(col, trc)) {
574
0
                    new_line = 1;
575
0
                    av_bprintf(&bprint, "%s/%s/%s, ", col, pri, trc);
576
0
                } else
577
0
                    av_bprintf(&bprint, "%s, ", col);
578
0
            }
579
580
0
            if (enc->field_order != AV_FIELD_UNKNOWN) {
581
0
                const char *field_order = "progressive";
582
0
                if (enc->field_order == AV_FIELD_TT)
583
0
                    field_order = "top first";
584
0
                else if (enc->field_order == AV_FIELD_BB)
585
0
                    field_order = "bottom first";
586
0
                else if (enc->field_order == AV_FIELD_TB)
587
0
                    field_order = "top coded first (swapped)";
588
0
                else if (enc->field_order == AV_FIELD_BT)
589
0
                    field_order = "bottom coded first (swapped)";
590
591
0
                av_bprintf(&bprint, "%s, ", field_order);
592
0
            }
593
594
0
            if (av_log_get_level() >= AV_LOG_VERBOSE &&
595
0
                enc->chroma_sample_location != AVCHROMA_LOC_UNSPECIFIED &&
596
0
                (str = av_chroma_location_name(enc->chroma_sample_location)))
597
0
                av_bprintf(&bprint, "%s, ", str);
598
599
0
            if (len == bprint.len) {
600
0
                bprint.str[len - 1] = '\0';
601
0
                bprint.len--;
602
0
            } else {
603
0
                if (bprint.len - 2 < bprint.size) {
604
                    /* Erase the last ", " */
605
0
                    bprint.len -= 2;
606
0
                    bprint.str[bprint.len] = '\0';
607
0
                }
608
0
                av_bprint_chars(&bprint, ')', 1);
609
0
            }
610
0
        }
611
612
0
        if (enc->width) {
613
0
            av_bprintf(&bprint, "%s%dx%d", new_line ? separator : ", ",
614
0
                       enc->width, enc->height);
615
616
0
            if (av_log_get_level() >= AV_LOG_VERBOSE &&
617
0
                enc->coded_width && enc->coded_height &&
618
0
                (enc->width != enc->coded_width ||
619
0
                 enc->height != enc->coded_height))
620
0
                av_bprintf(&bprint, " (%dx%d)",
621
0
                           enc->coded_width, enc->coded_height);
622
623
0
            if (enc->sample_aspect_ratio.num) {
624
0
                av_reduce(&display_aspect_ratio.num, &display_aspect_ratio.den,
625
0
                          enc->width * (int64_t)enc->sample_aspect_ratio.num,
626
0
                          enc->height * (int64_t)enc->sample_aspect_ratio.den,
627
0
                          1024 * 1024);
628
0
                av_bprintf(&bprint, " [SAR %d:%d DAR %d:%d]",
629
0
                         enc->sample_aspect_ratio.num, enc->sample_aspect_ratio.den,
630
0
                         display_aspect_ratio.num, display_aspect_ratio.den);
631
0
            }
632
0
            if (av_log_get_level() >= AV_LOG_DEBUG) {
633
0
                int g = av_gcd(enc->time_base.num, enc->time_base.den);
634
0
                av_bprintf(&bprint, ", %d/%d",
635
0
                           enc->time_base.num / g, enc->time_base.den / g);
636
0
            }
637
0
        }
638
0
        if (encode) {
639
0
            av_bprintf(&bprint, ", q=%d-%d", enc->qmin, enc->qmax);
640
0
        } else {
641
0
#if FF_API_CODEC_PROPS
642
0
FF_DISABLE_DEPRECATION_WARNINGS
643
0
            if (enc->properties & FF_CODEC_PROPERTY_CLOSED_CAPTIONS)
644
0
                av_bprintf(&bprint, ", Closed Captions");
645
0
            if (enc->properties & FF_CODEC_PROPERTY_FILM_GRAIN)
646
0
                av_bprintf(&bprint, ", Film Grain");
647
0
            if (enc->properties & FF_CODEC_PROPERTY_LOSSLESS)
648
0
                av_bprintf(&bprint, ", lossless");
649
0
FF_ENABLE_DEPRECATION_WARNINGS
650
0
#endif
651
0
        }
652
0
        break;
653
0
    case AVMEDIA_TYPE_AUDIO:
654
0
        av_bprintf(&bprint, "%s", separator);
655
656
0
        if (enc->sample_rate) {
657
0
            av_bprintf(&bprint, "%d Hz, ", enc->sample_rate);
658
0
        }
659
0
        av_channel_layout_describe_bprint(&enc->ch_layout, &bprint);
660
0
        if (enc->sample_fmt != AV_SAMPLE_FMT_NONE &&
661
0
            (str = av_get_sample_fmt_name(enc->sample_fmt))) {
662
0
            av_bprintf(&bprint, ", %s", str);
663
0
        }
664
0
        if (   enc->bits_per_raw_sample > 0
665
0
            && enc->bits_per_raw_sample != av_get_bytes_per_sample(enc->sample_fmt) * 8)
666
0
            av_bprintf(&bprint, " (%d bit)", enc->bits_per_raw_sample);
667
0
        if (av_log_get_level() >= AV_LOG_VERBOSE) {
668
0
            if (enc->initial_padding)
669
0
                av_bprintf(&bprint, ", delay %d", enc->initial_padding);
670
0
            if (enc->trailing_padding)
671
0
                av_bprintf(&bprint, ", padding %d", enc->trailing_padding);
672
0
        }
673
0
        break;
674
0
    case AVMEDIA_TYPE_DATA:
675
0
        if (av_log_get_level() >= AV_LOG_DEBUG) {
676
0
            int g = av_gcd(enc->time_base.num, enc->time_base.den);
677
0
            if (g)
678
0
                av_bprintf(&bprint, ", %d/%d",
679
0
                           enc->time_base.num / g, enc->time_base.den / g);
680
0
        }
681
0
        break;
682
0
    case AVMEDIA_TYPE_SUBTITLE:
683
0
        if (enc->width)
684
0
            av_bprintf(&bprint, ", %dx%d", enc->width, enc->height);
685
0
        break;
686
0
    default:
687
0
        return;
688
0
    }
689
0
    if (encode) {
690
0
        if (enc->flags & AV_CODEC_FLAG_PASS1)
691
0
            av_bprintf(&bprint, ", pass 1");
692
0
        if (enc->flags & AV_CODEC_FLAG_PASS2)
693
0
            av_bprintf(&bprint, ", pass 2");
694
0
    }
695
0
    bitrate = get_bit_rate(enc);
696
0
    if (bitrate != 0) {
697
0
        av_bprintf(&bprint, ", %"PRId64" kb/s", bitrate / 1000);
698
0
    } else if (enc->rc_max_rate > 0) {
699
0
        av_bprintf(&bprint, ", max. %"PRId64" kb/s", enc->rc_max_rate / 1000);
700
0
    }
701
0
}
702
703
int avcodec_is_open(AVCodecContext *s)
704
0
{
705
0
    return !!s->internal;
706
0
}
707
708
int attribute_align_arg avcodec_receive_frame_flags(AVCodecContext *avctx,
709
                                               AVFrame *frame, unsigned flags)
710
0
{
711
0
    av_frame_unref(frame);
712
713
0
    if (!avcodec_is_open(avctx) || !avctx->codec)
714
0
        return AVERROR(EINVAL);
715
716
0
    if (ff_codec_is_decoder(avctx->codec))
717
0
        return ff_decode_receive_frame(avctx, frame, flags);
718
0
    return ff_encode_receive_frame(avctx, frame);
719
0
}
720
721
int avcodec_receive_frame(AVCodecContext *avctx, AVFrame *frame)
722
0
{
723
0
    return avcodec_receive_frame_flags(avctx, frame, 0);
724
0
}
725
726
#define WRAP_CONFIG(allowed_type, field, var, field_type, sentinel_check)   \
727
0
    do {                                                                    \
728
0
        if (codec->type != (allowed_type))                                  \
729
0
            return AVERROR(EINVAL);                                         \
730
0
        const field_type *ptr = codec->field;                               \
731
0
        *out_configs = ptr;                                                 \
732
0
        if (ptr) {                                                          \
733
0
            for (int i = 0;; i++) {                                         \
734
0
                const field_type var = ptr[i];                              \
735
0
                if (sentinel_check) {                                       \
736
0
                    *out_num_configs = i;                                   \
737
0
                    break;                                                  \
738
0
                }                                                           \
739
0
            }                                                               \
740
0
        } else                                                              \
741
0
            *out_num_configs = 0;                                           \
742
0
        return 0;                                                           \
743
0
    } while (0)
744
745
static const enum AVColorRange color_range_tab[] = {
746
    AVCOL_RANGE_MPEG, AVCOL_RANGE_JPEG, AVCOL_RANGE_UNSPECIFIED,
747
    AVCOL_RANGE_MPEG, AVCOL_RANGE_UNSPECIFIED,
748
};
749
750
static const enum AVAlphaMode alpha_mode_tab[] = {
751
    AVALPHA_MODE_PREMULTIPLIED, AVALPHA_MODE_STRAIGHT, AVALPHA_MODE_UNSPECIFIED,
752
    AVALPHA_MODE_PREMULTIPLIED, AVALPHA_MODE_UNSPECIFIED
753
};
754
755
static_assert((int)AVCOL_RANGE_MPEG == (int)AVALPHA_MODE_PREMULTIPLIED, "unexpected enum values");
756
static_assert((int)AVCOL_RANGE_JPEG == (int)AVALPHA_MODE_STRAIGHT, "unexpected enum values");
757
static_assert(AVCOL_RANGE_UNSPECIFIED == 0 && AVALPHA_MODE_UNSPECIFIED == 0, "unexpected enum values");
758
static_assert(AVCOL_RANGE_NB == 3 && AVALPHA_MODE_NB == 3, "unexpected enum values");
759
760
static const uint8_t offset_tab[] = {
761
    [AVCOL_RANGE_MPEG] = 3,
762
    [AVCOL_RANGE_JPEG] = 1,
763
    [AVCOL_RANGE_MPEG | AVCOL_RANGE_JPEG] = 0,
764
};
765
766
int ff_default_get_supported_config(const AVCodecContext *avctx,
767
                                    const AVCodec *codec,
768
                                    enum AVCodecConfig config,
769
                                    unsigned flags,
770
                                    const void **out_configs,
771
                                    int *out_num_configs)
772
0
{
773
0
    const FFCodec *codec2 = ffcodec(codec);
774
775
0
    switch (config) {
776
0
FF_DISABLE_DEPRECATION_WARNINGS
777
0
    case AV_CODEC_CONFIG_PIX_FORMAT:
778
0
        WRAP_CONFIG(AVMEDIA_TYPE_VIDEO, pix_fmts, pix_fmt, enum AVPixelFormat, pix_fmt == AV_PIX_FMT_NONE);
779
0
    case AV_CODEC_CONFIG_FRAME_RATE:
780
0
        WRAP_CONFIG(AVMEDIA_TYPE_VIDEO, supported_framerates, framerate, AVRational, framerate.num == 0);
781
0
    case AV_CODEC_CONFIG_SAMPLE_RATE:
782
0
        WRAP_CONFIG(AVMEDIA_TYPE_AUDIO, supported_samplerates, samplerate, int, samplerate == 0);
783
0
    case AV_CODEC_CONFIG_SAMPLE_FORMAT:
784
0
        WRAP_CONFIG(AVMEDIA_TYPE_AUDIO, sample_fmts, sample_fmt, enum AVSampleFormat, sample_fmt == AV_SAMPLE_FMT_NONE);
785
0
    case AV_CODEC_CONFIG_CHANNEL_LAYOUT:
786
0
        WRAP_CONFIG(AVMEDIA_TYPE_AUDIO, ch_layouts, ch_layout, AVChannelLayout, ch_layout.nb_channels == 0);
787
0
FF_ENABLE_DEPRECATION_WARNINGS
788
789
0
    case AV_CODEC_CONFIG_COLOR_RANGE:
790
0
        if (codec->type != AVMEDIA_TYPE_VIDEO)
791
0
            return AVERROR(EINVAL);
792
0
        unsigned color_ranges = codec2->color_ranges;
793
0
        if (color_ranges)
794
0
            *out_configs = color_range_tab + offset_tab[color_ranges];
795
0
        else
796
0
            *out_configs = NULL;
797
0
        *out_num_configs = av_popcount(color_ranges);
798
0
        return 0;
799
800
0
    case AV_CODEC_CONFIG_COLOR_SPACE:
801
0
        *out_configs = NULL;
802
0
        *out_num_configs = 0;
803
0
        return 0;
804
805
0
    case AV_CODEC_CONFIG_ALPHA_MODE:
806
0
        if (codec->type != AVMEDIA_TYPE_VIDEO)
807
0
            return AVERROR(EINVAL);
808
0
        unsigned alpha_modes = codec2->alpha_modes;
809
0
        if (alpha_modes)
810
0
            *out_configs = alpha_mode_tab + offset_tab[alpha_modes];
811
0
        else
812
0
            *out_configs = NULL;
813
0
        *out_num_configs = av_popcount(alpha_modes);
814
0
        return 0;
815
816
0
    default:
817
0
        return AVERROR(EINVAL);
818
0
    }
819
0
}
820
821
int avcodec_get_supported_config(const AVCodecContext *avctx, const AVCodec *codec,
822
                                 enum AVCodecConfig config, unsigned flags,
823
                                 const void **out, int *out_num)
824
0
{
825
0
    const FFCodec *codec2;
826
0
    int dummy_num = 0;
827
0
    if (!codec)
828
0
        codec = avctx->codec;
829
0
    if (!out_num)
830
0
        out_num = &dummy_num;
831
832
0
    codec2 = ffcodec(codec);
833
0
    if (codec2->get_supported_config) {
834
0
        return codec2->get_supported_config(avctx, codec, config, flags, out, out_num);
835
0
    } else {
836
0
        return ff_default_get_supported_config(avctx, codec, config, flags, out, out_num);
837
0
    }
838
0
}
839
840
int av_packet_side_data_from_frame(AVPacketSideData **psd, int *pnb_sd,
841
                                   const AVFrameSideData *src, unsigned int flags)
842
0
{
843
0
    AVPacketSideData *sd = NULL;
844
845
0
    for (unsigned j = 0; ff_sd_global_map[j].packet < AV_PKT_DATA_NB; j++) {
846
0
        if (ff_sd_global_map[j].frame != src->type)
847
0
            continue;
848
849
0
        sd = av_packet_side_data_new(psd, pnb_sd, ff_sd_global_map[j].packet,
850
0
                                     src->size, 0);
851
852
0
        if (!sd)
853
0
            return AVERROR(ENOMEM);
854
855
0
        memcpy(sd->data, src->data, src->size);
856
0
        break;
857
0
    }
858
859
0
    if (!sd)
860
0
        return AVERROR(EINVAL);
861
862
0
    return 0;
863
0
}
864
865
int av_packet_side_data_to_frame(AVFrameSideData ***psd, int *pnb_sd,
866
                                 const AVPacketSideData *src, unsigned int flags)
867
0
{
868
0
    AVFrameSideData *sd = NULL;
869
870
0
    for (unsigned j = 0; ff_sd_global_map[j].packet < AV_PKT_DATA_NB; j++) {
871
0
        if (ff_sd_global_map[j].packet != src->type)
872
0
            continue;
873
874
0
        sd = av_frame_side_data_new(psd, pnb_sd, ff_sd_global_map[j].frame,
875
0
                                    src->size, flags);
876
877
0
        if (!sd)
878
0
            return AVERROR(ENOMEM);
879
880
0
        memcpy(sd->data, src->data, src->size);
881
0
        break;
882
0
    }
883
884
0
    if (!sd)
885
0
        return AVERROR(EINVAL);
886
887
0
    return 0;
888
0
}