Coverage Report

Created: 2026-07-15 07:31

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/ffmpeg/libavcodec/bsf.c
Line
Count
Source
1
/*
2
 * This file is part of FFmpeg.
3
 *
4
 * FFmpeg is free software; you can redistribute it and/or
5
 * modify it under the terms of the GNU Lesser General Public
6
 * License as published by the Free Software Foundation; either
7
 * version 2.1 of the License, or (at your option) any later version.
8
 *
9
 * FFmpeg is distributed in the hope that it will be useful,
10
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12
 * Lesser General Public License for more details.
13
 *
14
 * You should have received a copy of the GNU Lesser General Public
15
 * License along with FFmpeg; if not, write to the Free Software
16
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
 */
18
19
#include <string.h>
20
21
#include "config_components.h"
22
23
#include "libavutil/avassert.h"
24
#include "libavutil/log.h"
25
#include "libavutil/mem.h"
26
#include "libavutil/opt.h"
27
#include "libavutil/avstring.h"
28
#include "libavutil/bprint.h"
29
30
#include "bsf.h"
31
#include "bsf_internal.h"
32
#include "codec_desc.h"
33
#include "codec_par.h"
34
#include "packet_internal.h"
35
36
typedef struct FFBSFContext {
37
    AVBSFContext pub;
38
    AVPacket *buffer_pkt;
39
    int eof;
40
} FFBSFContext;
41
42
static av_always_inline FFBSFContext *ffbsfcontext(AVBSFContext *ctx)
43
0
{
44
0
    return (FFBSFContext *)ctx;
45
0
}
46
47
void av_bsf_free(AVBSFContext **pctx)
48
0
{
49
0
    AVBSFContext *ctx;
50
0
    FFBSFContext *bsfi;
51
52
0
    if (!pctx || !*pctx)
53
0
        return;
54
0
    ctx  = *pctx;
55
0
    bsfi = ffbsfcontext(ctx);
56
57
0
    if (ctx->priv_data) {
58
0
        if (ff_bsf(ctx->filter)->close)
59
0
            ff_bsf(ctx->filter)->close(ctx);
60
0
        if (ctx->filter->priv_class)
61
0
            av_opt_free(ctx->priv_data);
62
0
        av_freep(&ctx->priv_data);
63
0
    }
64
0
    av_packet_free(&bsfi->buffer_pkt);
65
66
0
    avcodec_parameters_free(&ctx->par_in);
67
0
    avcodec_parameters_free(&ctx->par_out);
68
69
0
    av_freep(pctx);
70
0
}
71
72
static void *bsf_child_next(void *obj, void *prev)
73
0
{
74
0
    AVBSFContext *ctx = obj;
75
0
    if (!prev && ctx->filter->priv_class)
76
0
        return ctx->priv_data;
77
0
    return NULL;
78
0
}
79
80
static const char *bsf_to_name(void *bsf)
81
0
{
82
0
    return ((AVBSFContext *)bsf)->filter->name;
83
0
}
84
85
static const AVClass bsf_class = {
86
    .class_name       = "AVBSFContext",
87
    .item_name        = bsf_to_name,
88
    .version          = LIBAVUTIL_VERSION_INT,
89
    .child_next       = bsf_child_next,
90
    .child_class_iterate = ff_bsf_child_class_iterate,
91
    .category         = AV_CLASS_CATEGORY_BITSTREAM_FILTER,
92
};
93
94
const AVClass *av_bsf_get_class(void)
95
0
{
96
0
    return &bsf_class;
97
0
}
98
99
int av_bsf_alloc(const AVBitStreamFilter *filter, AVBSFContext **pctx)
100
0
{
101
0
    AVBSFContext *ctx;
102
0
    FFBSFContext *bsfi;
103
0
    int ret;
104
105
0
    if (!ff_bsf(filter)->filter)
106
0
        return AVERROR(ENOTSUP);
107
108
0
    bsfi = av_mallocz(sizeof(*bsfi));
109
0
    if (!bsfi)
110
0
        return AVERROR(ENOMEM);
111
0
    ctx  = &bsfi->pub;
112
113
0
    ctx->av_class = &bsf_class;
114
0
    ctx->filter   = filter;
115
116
0
    ctx->par_in  = avcodec_parameters_alloc();
117
0
    ctx->par_out = avcodec_parameters_alloc();
118
0
    if (!ctx->par_in || !ctx->par_out) {
119
0
        ret = AVERROR(ENOMEM);
120
0
        goto fail;
121
0
    }
122
    /* allocate priv data and init private options */
123
0
    if (ff_bsf(filter)->priv_data_size) {
124
0
        ctx->priv_data = av_mallocz(ff_bsf(filter)->priv_data_size);
125
0
        if (!ctx->priv_data) {
126
0
            ret = AVERROR(ENOMEM);
127
0
            goto fail;
128
0
        }
129
0
        if (filter->priv_class) {
130
0
            *(const AVClass **)ctx->priv_data = filter->priv_class;
131
0
            av_opt_set_defaults(ctx->priv_data);
132
0
        }
133
0
    }
134
0
    bsfi->buffer_pkt = av_packet_alloc();
135
0
    if (!bsfi->buffer_pkt) {
136
0
        ret = AVERROR(ENOMEM);
137
0
        goto fail;
138
0
    }
139
140
0
    *pctx = ctx;
141
0
    return 0;
142
0
fail:
143
0
    av_bsf_free(&ctx);
144
0
    return ret;
145
0
}
146
147
int av_bsf_init(AVBSFContext *ctx)
148
0
{
149
0
    int ret, i;
150
151
    /* check that the codec is supported */
152
0
    if (ctx->filter->codec_ids) {
153
0
        for (i = 0; ctx->filter->codec_ids[i] != AV_CODEC_ID_NONE; i++)
154
0
            if (ctx->par_in->codec_id == ctx->filter->codec_ids[i])
155
0
                break;
156
0
        if (ctx->filter->codec_ids[i] == AV_CODEC_ID_NONE) {
157
0
            const AVCodecDescriptor *desc = avcodec_descriptor_get(ctx->par_in->codec_id);
158
0
            av_log(ctx, AV_LOG_ERROR, "Codec '%s' (%d) is not supported by the "
159
0
                   "bitstream filter '%s'. Supported codecs are: ",
160
0
                   desc ? desc->name : "unknown", ctx->par_in->codec_id, ctx->filter->name);
161
0
            for (i = 0; ctx->filter->codec_ids[i] != AV_CODEC_ID_NONE; i++) {
162
0
                enum AVCodecID codec_id = ctx->filter->codec_ids[i];
163
0
                av_log(ctx, AV_LOG_ERROR, "%s (%d) ",
164
0
                       avcodec_get_name(codec_id), codec_id);
165
0
            }
166
0
            av_log(ctx, AV_LOG_ERROR, "\n");
167
0
            return AVERROR(EINVAL);
168
0
        }
169
0
    }
170
171
    /* initialize output parameters to be the same as input
172
     * init below might overwrite that */
173
0
    ret = avcodec_parameters_copy(ctx->par_out, ctx->par_in);
174
0
    if (ret < 0)
175
0
        return ret;
176
177
0
    ctx->time_base_out = ctx->time_base_in;
178
179
0
    if (ff_bsf(ctx->filter)->init) {
180
0
        ret = ff_bsf(ctx->filter)->init(ctx);
181
0
        if (ret < 0)
182
0
            return ret;
183
0
    }
184
185
0
    return 0;
186
0
}
187
188
void av_bsf_flush(AVBSFContext *ctx)
189
0
{
190
0
    FFBSFContext *const bsfi = ffbsfcontext(ctx);
191
192
0
    bsfi->eof = 0;
193
194
0
    av_packet_unref(bsfi->buffer_pkt);
195
196
0
    if (ff_bsf(ctx->filter)->flush)
197
0
        ff_bsf(ctx->filter)->flush(ctx);
198
0
}
199
200
int av_bsf_send_packet(AVBSFContext *ctx, AVPacket *pkt)
201
0
{
202
0
    FFBSFContext *const bsfi = ffbsfcontext(ctx);
203
0
    int ret;
204
205
0
    if (!pkt || AVPACKET_IS_EMPTY(pkt)) {
206
0
        if (pkt)
207
0
            av_packet_unref(pkt);
208
0
        bsfi->eof = 1;
209
0
        return 0;
210
0
    }
211
212
0
    if (bsfi->eof) {
213
0
        av_log(ctx, AV_LOG_ERROR, "A non-NULL packet sent after an EOF.\n");
214
0
        return AVERROR(EINVAL);
215
0
    }
216
217
0
    if (!AVPACKET_IS_EMPTY(bsfi->buffer_pkt))
218
0
        return AVERROR(EAGAIN);
219
220
0
    ret = av_packet_make_refcounted(pkt);
221
0
    if (ret < 0)
222
0
        return ret;
223
0
    av_packet_move_ref(bsfi->buffer_pkt, pkt);
224
225
0
    return 0;
226
0
}
227
228
int av_bsf_receive_packet(AVBSFContext *ctx, AVPacket *pkt)
229
0
{
230
0
    return ff_bsf(ctx->filter)->filter(ctx, pkt);
231
0
}
232
233
int ff_bsf_get_packet(AVBSFContext *ctx, AVPacket **pkt)
234
0
{
235
0
    FFBSFContext *const bsfi = ffbsfcontext(ctx);
236
0
    AVPacket *tmp_pkt;
237
238
0
    if (bsfi->eof)
239
0
        return AVERROR_EOF;
240
241
0
    if (AVPACKET_IS_EMPTY(bsfi->buffer_pkt))
242
0
        return AVERROR(EAGAIN);
243
244
0
    tmp_pkt = av_packet_alloc();
245
0
    if (!tmp_pkt)
246
0
        return AVERROR(ENOMEM);
247
248
0
    *pkt = bsfi->buffer_pkt;
249
0
    bsfi->buffer_pkt = tmp_pkt;
250
251
0
    return 0;
252
0
}
253
254
int ff_bsf_get_packet_ref(AVBSFContext *ctx, AVPacket *pkt)
255
0
{
256
0
    FFBSFContext *const bsfi = ffbsfcontext(ctx);
257
258
0
    if (bsfi->eof)
259
0
        return AVERROR_EOF;
260
261
0
    if (AVPACKET_IS_EMPTY(bsfi->buffer_pkt))
262
0
        return AVERROR(EAGAIN);
263
264
0
    av_packet_move_ref(pkt, bsfi->buffer_pkt);
265
266
0
    return 0;
267
0
}
268
269
typedef struct BSFListContext {
270
    const AVClass *class;
271
272
    AVBSFContext **bsfs;
273
    int nb_bsfs;
274
275
    unsigned idx;           // index of currently processed BSF
276
277
    char * item_name;
278
} BSFListContext;
279
280
281
static int bsf_list_init(AVBSFContext *bsf)
282
0
{
283
0
    BSFListContext *lst = bsf->priv_data;
284
0
    int ret, i;
285
0
    const AVCodecParameters *cod_par = bsf->par_in;
286
0
    AVRational tb = bsf->time_base_in;
287
288
0
    for (i = 0; i < lst->nb_bsfs; ++i) {
289
0
        ret = avcodec_parameters_copy(lst->bsfs[i]->par_in, cod_par);
290
0
        if (ret < 0)
291
0
            goto fail;
292
293
0
        lst->bsfs[i]->time_base_in = tb;
294
295
0
        ret = av_bsf_init(lst->bsfs[i]);
296
0
        if (ret < 0)
297
0
            goto fail;
298
299
0
        cod_par = lst->bsfs[i]->par_out;
300
0
        tb = lst->bsfs[i]->time_base_out;
301
0
    }
302
303
0
    bsf->time_base_out = tb;
304
0
    ret = avcodec_parameters_copy(bsf->par_out, cod_par);
305
306
0
fail:
307
0
    return ret;
308
0
}
309
310
static int bsf_list_filter(AVBSFContext *bsf, AVPacket *out)
311
0
{
312
0
    BSFListContext *lst = bsf->priv_data;
313
0
    int ret, eof = 0;
314
315
0
    if (!lst->nb_bsfs)
316
0
        return ff_bsf_get_packet_ref(bsf, out);
317
318
0
    while (1) {
319
        /* get a packet from the previous filter up the chain */
320
0
        if (lst->idx)
321
0
            ret = av_bsf_receive_packet(lst->bsfs[lst->idx-1], out);
322
0
        else
323
0
            ret = ff_bsf_get_packet_ref(bsf, out);
324
0
        if (ret == AVERROR(EAGAIN)) {
325
0
            if (!lst->idx)
326
0
                return ret;
327
0
            lst->idx--;
328
0
            continue;
329
0
        } else if (ret == AVERROR_EOF) {
330
0
            eof = 1;
331
0
        } else if (ret < 0)
332
0
            return ret;
333
334
        /* send it to the next filter down the chain */
335
0
        if (lst->idx < lst->nb_bsfs) {
336
0
            ret = av_bsf_send_packet(lst->bsfs[lst->idx], eof ? NULL : out);
337
0
            av_assert1(ret != AVERROR(EAGAIN));
338
0
            if (ret < 0) {
339
0
                av_packet_unref(out);
340
0
                return ret;
341
0
            }
342
0
            lst->idx++;
343
0
            eof = 0;
344
0
        } else if (eof) {
345
0
            return ret;
346
0
        } else {
347
0
            return 0;
348
0
        }
349
0
    }
350
0
}
351
352
static void bsf_list_flush(AVBSFContext *bsf)
353
0
{
354
0
    BSFListContext *lst = bsf->priv_data;
355
356
0
    for (int i = 0; i < lst->nb_bsfs; i++)
357
0
        av_bsf_flush(lst->bsfs[i]);
358
0
    lst->idx = 0;
359
0
}
360
361
static void bsf_list_close(AVBSFContext *bsf)
362
0
{
363
0
    BSFListContext *lst = bsf->priv_data;
364
0
    int i;
365
366
0
    for (i = 0; i < lst->nb_bsfs; ++i)
367
0
        av_bsf_free(&lst->bsfs[i]);
368
0
    av_freep(&lst->bsfs);
369
0
    av_freep(&lst->item_name);
370
0
}
371
372
static const char *bsf_list_item_name(void *ctx)
373
0
{
374
0
    static const char *null_filter_name = "null";
375
0
    AVBSFContext *bsf_ctx = ctx;
376
0
    BSFListContext *lst = bsf_ctx->priv_data;
377
378
0
    if (!lst->nb_bsfs)
379
0
        return null_filter_name;
380
381
0
    if (!lst->item_name) {
382
0
        int i;
383
0
        AVBPrint bp;
384
0
        av_bprint_init(&bp, 16, 128);
385
386
0
        av_bprintf(&bp, "bsf_list(");
387
0
        for (i = 0; i < lst->nb_bsfs; i++)
388
0
            av_bprintf(&bp, i ? ",%s" : "%s", lst->bsfs[i]->filter->name);
389
0
        av_bprintf(&bp, ")");
390
391
0
        av_bprint_finalize(&bp, &lst->item_name);
392
0
    }
393
394
0
    return lst->item_name;
395
0
}
396
397
static const AVClass bsf_list_class = {
398
        .class_name = "bsf_list",
399
        .item_name  = bsf_list_item_name,
400
        .version    = LIBAVUTIL_VERSION_INT,
401
};
402
403
static const FFBitStreamFilter list_bsf = {
404
        .p.name         = "bsf_list",
405
        .p.priv_class   = &bsf_list_class,
406
        .priv_data_size = sizeof(BSFListContext),
407
        .init           = bsf_list_init,
408
        .filter         = bsf_list_filter,
409
        .flush          = bsf_list_flush,
410
        .close          = bsf_list_close,
411
};
412
413
struct AVBSFList {
414
    AVBSFContext **bsfs;
415
    int nb_bsfs;
416
};
417
418
AVBSFList *av_bsf_list_alloc(void)
419
0
{
420
0
    return av_mallocz(sizeof(AVBSFList));
421
0
}
422
423
void av_bsf_list_free(AVBSFList **lst)
424
0
{
425
0
    int i;
426
427
0
    if (!*lst)
428
0
        return;
429
430
0
    for (i = 0; i < (*lst)->nb_bsfs; ++i)
431
0
        av_bsf_free(&(*lst)->bsfs[i]);
432
0
    av_free((*lst)->bsfs);
433
0
    av_freep(lst);
434
0
}
435
436
int av_bsf_list_append(AVBSFList *lst, AVBSFContext *bsf)
437
0
{
438
0
    return av_dynarray_add_nofree(&lst->bsfs, &lst->nb_bsfs, bsf);
439
0
}
440
441
static int bsf_list_append_internal(AVBSFList *lst, const char *bsf_name, const char *options, AVDictionary ** options_dict)
442
0
{
443
0
    int ret;
444
0
    const AVBitStreamFilter *filter;
445
0
    AVBSFContext *bsf;
446
447
0
    filter = av_bsf_get_by_name(bsf_name);
448
0
    if (!filter)
449
0
        return AVERROR_BSF_NOT_FOUND;
450
451
0
    ret = av_bsf_alloc(filter, &bsf);
452
0
    if (ret < 0)
453
0
        return ret;
454
455
0
    if (options && filter->priv_class) {
456
0
        const AVOption *opt = av_opt_next(bsf->priv_data, NULL);
457
0
        const char * shorthand[2] = {NULL};
458
459
0
        if (opt)
460
0
            shorthand[0] = opt->name;
461
462
0
        ret = av_opt_set_from_string(bsf->priv_data, options, shorthand, "=", ":");
463
0
        if (ret < 0)
464
0
            goto end;
465
0
    }
466
467
0
    if (options_dict) {
468
0
        ret = av_opt_set_dict2(bsf, options_dict, AV_OPT_SEARCH_CHILDREN);
469
0
        if (ret < 0)
470
0
            goto end;
471
0
    }
472
473
0
    ret = av_bsf_list_append(lst, bsf);
474
475
0
end:
476
0
    if (ret < 0)
477
0
        av_bsf_free(&bsf);
478
479
0
    return ret;
480
0
}
481
482
int av_bsf_list_append2(AVBSFList *lst, const char *bsf_name, AVDictionary ** options)
483
0
{
484
0
    return bsf_list_append_internal(lst, bsf_name, NULL, options);
485
0
}
486
487
int av_bsf_list_finalize(AVBSFList **lst, AVBSFContext **bsf)
488
0
{
489
0
    int ret = 0;
490
0
    BSFListContext *ctx;
491
492
0
    if ((*lst)->nb_bsfs == 1) {
493
0
        *bsf = (*lst)->bsfs[0];
494
0
        av_freep(&(*lst)->bsfs);
495
0
        (*lst)->nb_bsfs = 0;
496
0
        goto end;
497
0
    }
498
499
0
    ret = av_bsf_alloc(&list_bsf.p, bsf);
500
0
    if (ret < 0)
501
0
        return ret;
502
503
0
    ctx = (*bsf)->priv_data;
504
505
0
    ctx->bsfs = (*lst)->bsfs;
506
0
    ctx->nb_bsfs = (*lst)->nb_bsfs;
507
508
0
end:
509
0
    av_freep(lst);
510
0
    return ret;
511
0
}
512
513
static int bsf_parse_single(char *str, AVBSFList *bsf_lst)
514
0
{
515
0
    char *bsf_name, *bsf_options_str;
516
517
0
    bsf_name = av_strtok(str, "=", &bsf_options_str);
518
0
    if (!bsf_name)
519
0
        return AVERROR(EINVAL);
520
521
0
    return bsf_list_append_internal(bsf_lst, bsf_name, bsf_options_str, NULL);
522
0
}
523
524
int av_bsf_list_parse_str(const char *str, AVBSFContext **bsf_lst)
525
0
{
526
0
    AVBSFList *lst;
527
0
    int ret;
528
529
0
    if (!str)
530
0
        return av_bsf_get_null_filter(bsf_lst);
531
532
0
    lst = av_bsf_list_alloc();
533
0
    if (!lst)
534
0
        return AVERROR(ENOMEM);
535
536
0
    do {
537
0
        char *bsf_str = av_get_token(&str, ",");
538
0
        ret = bsf_parse_single(bsf_str, lst);
539
0
        av_free(bsf_str);
540
0
        if (ret < 0)
541
0
            goto end;
542
0
    } while (*str && *++str);
543
544
0
    ret = av_bsf_list_finalize(&lst, bsf_lst);
545
0
end:
546
0
    if (ret < 0)
547
0
        av_bsf_list_free(&lst);
548
0
    return ret;
549
0
}
550
551
int av_bsf_get_null_filter(AVBSFContext **bsf)
552
0
{
553
#if CONFIG_NULL_BSF
554
    extern const FFBitStreamFilter ff_null_bsf;
555
    return av_bsf_alloc(&ff_null_bsf.p, bsf);
556
#else
557
0
    return av_bsf_alloc(&list_bsf.p, bsf);
558
0
#endif
559
0
}