Coverage Report

Created: 2026-01-25 07:18

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/ffmpeg/libavutil/imgutils.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
/**
20
 * @file
21
 * misc image utilities
22
 */
23
24
#include "avassert.h"
25
#include "common.h"
26
#include "imgutils.h"
27
#include "imgutils_internal.h"
28
#include "intreadwrite.h"
29
#include "log.h"
30
#include "mathematics.h"
31
#include "mem.h"
32
#include "pixdesc.h"
33
#include "rational.h"
34
35
void av_image_fill_max_pixsteps(int max_pixsteps[4], int max_pixstep_comps[4],
36
                                const AVPixFmtDescriptor *pixdesc)
37
0
{
38
0
    int i;
39
0
    memset(max_pixsteps, 0, 4*sizeof(max_pixsteps[0]));
40
0
    if (max_pixstep_comps)
41
0
        memset(max_pixstep_comps, 0, 4*sizeof(max_pixstep_comps[0]));
42
43
0
    for (i = 0; i < 4; i++) {
44
0
        const AVComponentDescriptor *comp = &(pixdesc->comp[i]);
45
0
        if (comp->step > max_pixsteps[comp->plane]) {
46
0
            max_pixsteps[comp->plane] = comp->step;
47
0
            if (max_pixstep_comps)
48
0
                max_pixstep_comps[comp->plane] = i;
49
0
        }
50
0
    }
51
0
}
52
53
static inline
54
int image_get_linesize(int width, int plane,
55
                       int max_step, int max_step_comp,
56
                       const AVPixFmtDescriptor *desc)
57
0
{
58
0
    int s, shifted_w, linesize;
59
60
0
    if (!desc)
61
0
        return AVERROR(EINVAL);
62
63
0
    if (width < 0)
64
0
        return AVERROR(EINVAL);
65
0
    s = (max_step_comp == 1 || max_step_comp == 2) ? desc->log2_chroma_w : 0;
66
0
    shifted_w = AV_CEIL_RSHIFT(width, s);
67
0
    if (shifted_w && max_step > INT_MAX / shifted_w)
68
0
        return AVERROR(EINVAL);
69
0
    linesize = max_step * shifted_w;
70
71
0
    if (desc->flags & AV_PIX_FMT_FLAG_BITSTREAM)
72
0
        linesize = (linesize + 7) >> 3;
73
0
    return linesize;
74
0
}
75
76
int av_image_get_linesize(enum AVPixelFormat pix_fmt, int width, int plane)
77
0
{
78
0
    const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
79
0
    int max_step     [4];       /* max pixel step for each plane */
80
0
    int max_step_comp[4];       /* the component for each plane which has the max pixel step */
81
82
0
    if (!desc || desc->flags & AV_PIX_FMT_FLAG_HWACCEL)
83
0
        return AVERROR(EINVAL);
84
85
0
    av_image_fill_max_pixsteps(max_step, max_step_comp, desc);
86
0
    return image_get_linesize(width, plane, max_step[plane], max_step_comp[plane], desc);
87
0
}
88
89
int av_image_fill_linesizes(int linesizes[4], enum AVPixelFormat pix_fmt, int width)
90
0
{
91
0
    int i, ret;
92
0
    const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
93
0
    int max_step     [4];       /* max pixel step for each plane */
94
0
    int max_step_comp[4];       /* the component for each plane which has the max pixel step */
95
96
0
    memset(linesizes, 0, 4*sizeof(linesizes[0]));
97
98
0
    if (!desc || desc->flags & AV_PIX_FMT_FLAG_HWACCEL)
99
0
        return AVERROR(EINVAL);
100
101
0
    av_image_fill_max_pixsteps(max_step, max_step_comp, desc);
102
0
    for (i = 0; i < 4; i++) {
103
0
        if ((ret = image_get_linesize(width, i, max_step[i], max_step_comp[i], desc)) < 0)
104
0
            return ret;
105
0
        linesizes[i] = ret;
106
0
    }
107
108
0
    return 0;
109
0
}
110
111
int av_image_fill_plane_sizes(size_t sizes[4], enum AVPixelFormat pix_fmt,
112
                              int height, const ptrdiff_t linesizes[4])
113
0
{
114
0
    int i, has_plane[4] = { 0 };
115
116
0
    const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
117
0
    memset(sizes    , 0, sizeof(sizes[0])*4);
118
119
0
    if (!desc || desc->flags & AV_PIX_FMT_FLAG_HWACCEL)
120
0
        return AVERROR(EINVAL);
121
122
0
    if (linesizes[0] > SIZE_MAX / height)
123
0
        return AVERROR(EINVAL);
124
0
    sizes[0] = linesizes[0] * (size_t)height;
125
126
0
    if (desc->flags & AV_PIX_FMT_FLAG_PAL) {
127
0
        sizes[1] = 256 * 4; /* palette is stored here as 256 32 bits words */
128
0
        return 0;
129
0
    }
130
131
0
    for (i = 0; i < 4; i++)
132
0
        has_plane[desc->comp[i].plane] = 1;
133
134
0
    for (i = 1; i < 4 && has_plane[i]; i++) {
135
0
        int h, s = (i == 1 || i == 2) ? desc->log2_chroma_h : 0;
136
0
        h = AV_CEIL_RSHIFT(height, s);
137
0
        if (linesizes[i] > SIZE_MAX / h)
138
0
            return AVERROR(EINVAL);
139
0
        sizes[i] = (size_t)h * linesizes[i];
140
0
    }
141
142
0
    return 0;
143
0
}
144
145
int av_image_fill_pointers(uint8_t *data[4], enum AVPixelFormat pix_fmt, int height,
146
                           uint8_t *ptr, const int linesizes[4])
147
0
{
148
0
    int i, ret;
149
0
    ptrdiff_t linesizes1[4];
150
0
    size_t sizes[4];
151
152
0
    memset(data     , 0, sizeof(data[0])*4);
153
154
0
    for (i = 0; i < 4; i++)
155
0
        linesizes1[i] = linesizes[i];
156
157
0
    ret = av_image_fill_plane_sizes(sizes, pix_fmt, height, linesizes1);
158
0
    if (ret < 0)
159
0
        return ret;
160
161
0
    ret = 0;
162
0
    for (i = 0; i < 4; i++) {
163
0
        if (sizes[i] > INT_MAX - ret)
164
0
            return AVERROR(EINVAL);
165
0
        ret += sizes[i];
166
0
    }
167
168
0
    if (!ptr)
169
0
        return ret;
170
171
0
    data[0] = ptr;
172
0
    for (i = 1; i < 4 && sizes[i]; i++)
173
0
        data[i] = data[i - 1] + sizes[i - 1];
174
175
0
    return ret;
176
0
}
177
178
int avpriv_set_systematic_pal2(uint32_t pal[256], enum AVPixelFormat pix_fmt)
179
0
{
180
0
    int i;
181
182
0
    for (i = 0; i < 256; i++) {
183
0
        int r, g, b;
184
185
0
        switch (pix_fmt) {
186
0
        case AV_PIX_FMT_RGB8:
187
0
            r = (i>>5    )*36;
188
0
            g = ((i>>2)&7)*36;
189
0
            b = (i&3     )*85;
190
0
            break;
191
0
        case AV_PIX_FMT_BGR8:
192
0
            b = (i>>6    )*85;
193
0
            g = ((i>>3)&7)*36;
194
0
            r = (i&7     )*36;
195
0
            break;
196
0
        case AV_PIX_FMT_RGB4_BYTE:
197
0
            r = (i>>3    )*255;
198
0
            g = ((i>>1)&3)*85;
199
0
            b = (i&1     )*255;
200
0
            break;
201
0
        case AV_PIX_FMT_BGR4_BYTE:
202
0
            b = (i>>3    )*255;
203
0
            g = ((i>>1)&3)*85;
204
0
            r = (i&1     )*255;
205
0
            break;
206
0
        case AV_PIX_FMT_GRAY8:
207
0
            r = b = g = i;
208
0
            break;
209
0
        default:
210
0
            return AVERROR(EINVAL);
211
0
        }
212
0
        pal[i] = b + (g << 8) + (r << 16) + (0xFFU << 24);
213
0
    }
214
215
0
    return 0;
216
0
}
217
218
int av_image_alloc(uint8_t *pointers[4], int linesizes[4],
219
                   int w, int h, enum AVPixelFormat pix_fmt, int align)
220
0
{
221
0
    const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
222
0
    int i, ret;
223
0
    ptrdiff_t linesizes1[4];
224
0
    size_t total_size, sizes[4];
225
0
    uint8_t *buf;
226
227
0
    if (!desc)
228
0
        return AVERROR(EINVAL);
229
230
0
    if ((ret = av_image_check_size(w, h, 0, NULL)) < 0)
231
0
        return ret;
232
0
    if ((ret = av_image_fill_linesizes(linesizes, pix_fmt, align>7 ? FFALIGN(w, 8) : w)) < 0)
233
0
        return ret;
234
235
0
    for (i = 0; i < 4; i++) {
236
0
        linesizes[i] = FFALIGN(linesizes[i], align);
237
0
        linesizes1[i] = linesizes[i];
238
0
    }
239
240
0
    if ((ret = av_image_fill_plane_sizes(sizes, pix_fmt, h, linesizes1)) < 0)
241
0
        return ret;
242
0
    total_size = align;
243
0
    for (i = 0; i < 4; i++) {
244
0
        if (total_size > SIZE_MAX - sizes[i])
245
0
            return AVERROR(EINVAL);
246
0
        total_size += sizes[i];
247
0
    }
248
0
    buf = av_malloc(total_size);
249
0
    if (!buf)
250
0
        return AVERROR(ENOMEM);
251
0
    if ((ret = av_image_fill_pointers(pointers, pix_fmt, h, buf, linesizes)) < 0) {
252
0
        av_free(buf);
253
0
        return ret;
254
0
    }
255
0
    if (desc->flags & AV_PIX_FMT_FLAG_PAL) {
256
0
        avpriv_set_systematic_pal2((uint32_t*)pointers[1], pix_fmt);
257
0
        if (align < 4) {
258
0
            av_log(NULL, AV_LOG_ERROR, "Formats with a palette require a minimum alignment of 4\n");
259
0
            av_free(buf);
260
0
            return AVERROR(EINVAL);
261
0
        }
262
0
    }
263
264
0
    if (desc->flags & AV_PIX_FMT_FLAG_PAL && pointers[1] &&
265
0
        pointers[1] - pointers[0] > linesizes[0] * h) {
266
        /* zero-initialize the padding before the palette */
267
0
        memset(pointers[0] + linesizes[0] * h, 0,
268
0
               pointers[1] - pointers[0] - linesizes[0] * h);
269
0
    }
270
271
0
    return ret;
272
0
}
273
274
typedef struct ImgUtils {
275
    const AVClass *class;
276
    int   log_offset;
277
    void *log_ctx;
278
} ImgUtils;
279
280
static const AVClass imgutils_class = {
281
    .class_name                = "IMGUTILS",
282
    .item_name                 = av_default_item_name,
283
    .option                    = NULL,
284
    .version                   = LIBAVUTIL_VERSION_INT,
285
    .log_level_offset_offset   = offsetof(ImgUtils, log_offset),
286
    .parent_log_context_offset = offsetof(ImgUtils, log_ctx),
287
};
288
289
int av_image_check_size2(unsigned int w, unsigned int h, int64_t max_pixels, enum AVPixelFormat pix_fmt, int log_offset, void *log_ctx)
290
0
{
291
0
    ImgUtils imgutils = {
292
0
        .class      = &imgutils_class,
293
0
        .log_offset = log_offset,
294
0
        .log_ctx    = log_ctx,
295
0
    };
296
0
    int64_t stride = av_image_get_linesize(pix_fmt, w, 0);
297
0
    if (stride <= 0)
298
0
        stride = 8LL*w;
299
0
    stride += 128*8;
300
301
0
    if (w==0 || h==0 || w > INT32_MAX || h > INT32_MAX || stride >= INT_MAX || stride*(h + 128ULL) >= INT_MAX) {
302
0
        av_log(&imgutils, AV_LOG_ERROR, "Picture size %ux%u is invalid\n", w, h);
303
0
        return AVERROR(EINVAL);
304
0
    }
305
306
0
    if (max_pixels < INT64_MAX) {
307
0
        if (w*(int64_t)h > max_pixels) {
308
0
            av_log(&imgutils, AV_LOG_ERROR,
309
0
                    "Picture size %ux%u exceeds specified max pixel count %"PRId64", see the documentation if you wish to increase it\n",
310
0
                    w, h, max_pixels);
311
0
            return AVERROR(EINVAL);
312
0
        }
313
0
    }
314
315
0
    return 0;
316
0
}
317
318
int av_image_check_size(unsigned int w, unsigned int h, int log_offset, void *log_ctx)
319
0
{
320
0
    return av_image_check_size2(w, h, INT64_MAX, AV_PIX_FMT_NONE, log_offset, log_ctx);
321
0
}
322
323
int av_image_check_sar(unsigned int w, unsigned int h, AVRational sar)
324
0
{
325
0
    int64_t scaled_dim;
326
327
0
    if (sar.den <= 0 || sar.num < 0)
328
0
        return AVERROR(EINVAL);
329
330
0
    if (!sar.num || sar.num == sar.den)
331
0
        return 0;
332
333
0
    if (sar.num < sar.den)
334
0
        scaled_dim = av_rescale_rnd(w, sar.num, sar.den, AV_ROUND_ZERO);
335
0
    else
336
0
        scaled_dim = av_rescale_rnd(h, sar.den, sar.num, AV_ROUND_ZERO);
337
338
0
    if (scaled_dim > 0)
339
0
        return 0;
340
341
0
    return AVERROR(EINVAL);
342
0
}
343
344
static void image_copy_plane(uint8_t       *dst, ptrdiff_t dst_linesize,
345
                             const uint8_t *src, ptrdiff_t src_linesize,
346
                             ptrdiff_t bytewidth, int height)
347
0
{
348
0
    if (!dst || !src)
349
0
        return;
350
0
    av_assert0(FFABS(src_linesize) >= bytewidth);
351
0
    av_assert0(FFABS(dst_linesize) >= bytewidth);
352
0
    for (;height > 0; height--) {
353
0
        memcpy(dst, src, bytewidth);
354
0
        dst += dst_linesize;
355
0
        src += src_linesize;
356
0
    }
357
0
}
358
359
void av_image_copy_plane_uc_from(uint8_t *dst, ptrdiff_t dst_linesize,
360
                                 const uint8_t *src, ptrdiff_t src_linesize,
361
                                 ptrdiff_t bytewidth, int height)
362
0
{
363
0
    int ret = -1;
364
365
0
#if ARCH_X86 && HAVE_X86ASM
366
0
    ret = ff_image_copy_plane_uc_from_x86(dst, dst_linesize, src, src_linesize,
367
0
                                          bytewidth, height);
368
0
#endif
369
370
0
    if (ret < 0)
371
0
        image_copy_plane(dst, dst_linesize, src, src_linesize, bytewidth, height);
372
0
}
373
374
void av_image_copy_plane(uint8_t       *dst, int dst_linesize,
375
                         const uint8_t *src, int src_linesize,
376
                         int bytewidth, int height)
377
0
{
378
0
    image_copy_plane(dst, dst_linesize, src, src_linesize, bytewidth, height);
379
0
}
380
381
static void image_copy(uint8_t *const dst_data[4], const ptrdiff_t dst_linesizes[4],
382
                       const uint8_t *const src_data[4], const ptrdiff_t src_linesizes[4],
383
                       enum AVPixelFormat pix_fmt, int width, int height,
384
                       void (*copy_plane)(uint8_t *, ptrdiff_t, const uint8_t *,
385
                                          ptrdiff_t, ptrdiff_t, int))
386
0
{
387
0
    const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
388
389
0
    if (!desc || desc->flags & AV_PIX_FMT_FLAG_HWACCEL)
390
0
        return;
391
392
0
    if (desc->flags & AV_PIX_FMT_FLAG_PAL) {
393
0
        copy_plane(dst_data[0], dst_linesizes[0],
394
0
                   src_data[0], src_linesizes[0],
395
0
                   width, height);
396
        /* copy the palette */
397
0
        if ((desc->flags & AV_PIX_FMT_FLAG_PAL) || (dst_data[1] && src_data[1]))
398
0
            memcpy(dst_data[1], src_data[1], 4*256);
399
0
    } else {
400
0
        int i, planes_nb = 0;
401
402
0
        for (i = 0; i < desc->nb_components; i++)
403
0
            planes_nb = FFMAX(planes_nb, desc->comp[i].plane + 1);
404
405
0
        for (i = 0; i < planes_nb; i++) {
406
0
            int h = height;
407
0
            ptrdiff_t bwidth = av_image_get_linesize(pix_fmt, width, i);
408
0
            if (bwidth < 0) {
409
0
                av_log(NULL, AV_LOG_ERROR, "av_image_get_linesize failed\n");
410
0
                return;
411
0
            }
412
0
            if (i == 1 || i == 2) {
413
0
                h = AV_CEIL_RSHIFT(height, desc->log2_chroma_h);
414
0
            }
415
0
            copy_plane(dst_data[i], dst_linesizes[i],
416
0
                       src_data[i], src_linesizes[i],
417
0
                       bwidth, h);
418
0
        }
419
0
    }
420
0
}
421
422
void av_image_copy(uint8_t *const dst_data[4], const int dst_linesizes[4],
423
                   const uint8_t * const src_data[4], const int src_linesizes[4],
424
                   enum AVPixelFormat pix_fmt, int width, int height)
425
0
{
426
0
    ptrdiff_t dst_linesizes1[4], src_linesizes1[4];
427
0
    int i;
428
429
0
    for (i = 0; i < 4; i++) {
430
0
        dst_linesizes1[i] = dst_linesizes[i];
431
0
        src_linesizes1[i] = src_linesizes[i];
432
0
    }
433
434
0
    image_copy(dst_data, dst_linesizes1, src_data, src_linesizes1, pix_fmt,
435
0
               width, height, image_copy_plane);
436
0
}
437
438
void av_image_copy_uc_from(uint8_t * const dst_data[4], const ptrdiff_t dst_linesizes[4],
439
                           const uint8_t * const src_data[4], const ptrdiff_t src_linesizes[4],
440
                           enum AVPixelFormat pix_fmt, int width, int height)
441
0
{
442
0
    image_copy(dst_data, dst_linesizes, src_data, src_linesizes, pix_fmt,
443
0
               width, height, av_image_copy_plane_uc_from);
444
0
}
445
446
int av_image_fill_arrays(uint8_t *dst_data[4], int dst_linesize[4],
447
                         const uint8_t *src, enum AVPixelFormat pix_fmt,
448
                         int width, int height, int align)
449
0
{
450
0
    int ret, i;
451
452
0
    ret = av_image_check_size(width, height, 0, NULL);
453
0
    if (ret < 0)
454
0
        return ret;
455
456
0
    ret = av_image_fill_linesizes(dst_linesize, pix_fmt, width);
457
0
    if (ret < 0)
458
0
        return ret;
459
460
0
    for (i = 0; i < 4; i++)
461
0
        dst_linesize[i] = FFALIGN(dst_linesize[i], align);
462
463
0
    return av_image_fill_pointers(dst_data, pix_fmt, height, (uint8_t *)src, dst_linesize);
464
0
}
465
466
int av_image_get_buffer_size(enum AVPixelFormat pix_fmt,
467
                             int width, int height, int align)
468
0
{
469
0
    int ret, i;
470
0
    int linesize[4];
471
0
    ptrdiff_t aligned_linesize[4];
472
0
    size_t sizes[4];
473
0
    const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
474
0
    if (!desc)
475
0
        return AVERROR(EINVAL);
476
477
0
    ret = av_image_check_size(width, height, 0, NULL);
478
0
    if (ret < 0)
479
0
        return ret;
480
481
0
    ret = av_image_fill_linesizes(linesize, pix_fmt, width);
482
0
    if (ret < 0)
483
0
        return ret;
484
485
0
    for (i = 0; i < 4; i++)
486
0
        aligned_linesize[i] = FFALIGN(linesize[i], align);
487
488
0
    ret = av_image_fill_plane_sizes(sizes, pix_fmt, height, aligned_linesize);
489
0
    if (ret < 0)
490
0
        return ret;
491
492
0
    ret = 0;
493
0
    for (i = 0; i < 4; i++) {
494
0
        if (sizes[i] > INT_MAX - ret)
495
0
            return AVERROR(EINVAL);
496
0
        ret += sizes[i];
497
0
    }
498
0
    return ret;
499
0
}
500
501
int av_image_copy_to_buffer(uint8_t *dst, int dst_size,
502
                            const uint8_t * const src_data[4],
503
                            const int src_linesize[4],
504
                            enum AVPixelFormat pix_fmt,
505
                            int width, int height, int align)
506
0
{
507
0
    int i, j, nb_planes = 0, linesize[4];
508
0
    int size = av_image_get_buffer_size(pix_fmt, width, height, align);
509
0
    const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
510
0
    int ret;
511
512
0
    if (size > dst_size || size < 0 || !desc)
513
0
        return AVERROR(EINVAL);
514
515
0
    for (i = 0; i < desc->nb_components; i++)
516
0
        nb_planes = FFMAX(desc->comp[i].plane, nb_planes);
517
518
0
    nb_planes++;
519
520
0
    ret = av_image_fill_linesizes(linesize, pix_fmt, width);
521
0
    av_assert0(ret >= 0); // was checked previously
522
523
0
    for (i = 0; i < nb_planes; i++) {
524
0
        int h, shift = (i == 1 || i == 2) ? desc->log2_chroma_h : 0;
525
0
        const uint8_t *src = src_data[i];
526
0
        h = AV_CEIL_RSHIFT(height, shift);
527
528
0
        for (j = 0; j < h; j++) {
529
0
            memcpy(dst, src, linesize[i]);
530
0
            dst += FFALIGN(linesize[i], align);
531
0
            src += src_linesize[i];
532
0
        }
533
0
    }
534
535
0
    if (desc->flags & AV_PIX_FMT_FLAG_PAL) {
536
0
        uint32_t *d32 = (uint32_t *)dst;
537
538
0
        for (i = 0; i<256; i++)
539
0
            AV_WL32(d32 + i, AV_RN32(src_data[1] + 4*i));
540
0
    }
541
542
0
    return size;
543
0
}
544
545
// Fill dst[0..dst_size] with the bytes in clear[0..clear_size]. The clear
546
// bytes are repeated until dst_size is reached. If dst_size is unaligned (i.e.
547
// dst_size%clear_size!=0), the remaining data will be filled with the beginning
548
// of the clear data only.
549
static void memset_bytes(uint8_t *dst, size_t dst_size, uint8_t *clear,
550
                         size_t clear_size)
551
0
{
552
0
    int same = 1;
553
0
    int i;
554
555
0
    if (!clear_size)
556
0
        return;
557
558
    // Reduce to memset() if possible.
559
0
    for (i = 0; i < clear_size; i++) {
560
0
        if (clear[i] != clear[0]) {
561
0
            same = 0;
562
0
            break;
563
0
        }
564
0
    }
565
0
    if (same)
566
0
        clear_size = 1;
567
568
0
    if (clear_size == 1) {
569
0
        memset(dst, clear[0], dst_size);
570
0
    } else {
571
0
        if (clear_size > dst_size)
572
0
            clear_size = dst_size;
573
0
        memcpy(dst, clear, clear_size);
574
0
        av_memcpy_backptr(dst + clear_size, clear_size, dst_size - clear_size);
575
0
    }
576
0
}
577
578
// Maximum size in bytes of a plane element (usually a pixel, or multiple pixels
579
// if it's a subsampled packed format).
580
0
#define MAX_BLOCK_SIZE 32
581
582
int av_image_fill_color(uint8_t * const dst_data[4], const ptrdiff_t dst_linesize[4],
583
                        enum AVPixelFormat pix_fmt, const uint32_t color[4],
584
                        int width, int height, int flags)
585
0
{
586
0
    const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
587
0
    int nb_planes = av_pix_fmt_count_planes(pix_fmt);
588
    // A pixel or a group of pixels on each plane, with a value that represents the color.
589
    // Consider e.g. AV_PIX_FMT_UYVY422 for non-trivial cases.
590
0
    uint8_t clear_block[4][MAX_BLOCK_SIZE] = {{0}}; // clear padding with 0
591
0
    int clear_block_size[4] = {0};
592
0
    ptrdiff_t plane_line_bytes[4] = {0};
593
0
    int bitstream;
594
0
    int plane, c;
595
596
0
    if (!desc || nb_planes < 1 || nb_planes > 4 || desc->flags & AV_PIX_FMT_FLAG_HWACCEL)
597
0
        return AVERROR(EINVAL);
598
599
0
    bitstream = !!(desc->flags & AV_PIX_FMT_FLAG_BITSTREAM);
600
601
0
    for (c = 0; c < desc->nb_components; c++) {
602
0
        const AVComponentDescriptor comp = desc->comp[c];
603
604
        // We try to operate on entire non-subsampled pixel groups (for
605
        // AV_PIX_FMT_UYVY422 this would mean two consecutive pixels).
606
0
        clear_block_size[comp.plane] = FFMAX(clear_block_size[comp.plane], comp.step);
607
608
0
        if (clear_block_size[comp.plane] > MAX_BLOCK_SIZE)
609
0
            return AVERROR(EINVAL);
610
0
    }
611
612
    // Create a byte array for clearing 1 pixel (sometimes several pixels).
613
0
    for (c = 0; c < desc->nb_components; c++) {
614
0
        const AVComponentDescriptor comp = desc->comp[c];
615
        // (Multiple pixels happen e.g. with AV_PIX_FMT_UYVY422.)
616
0
        int w = (bitstream ? 8 : 1) * clear_block_size[comp.plane] / comp.step;
617
0
        uint8_t *c_data[4];
618
0
        const int c_linesize[4] = {0};
619
0
        uint32_t src_array[MAX_BLOCK_SIZE];
620
0
        int x;
621
622
0
        if (comp.depth > 32)
623
0
            return AVERROR(EINVAL);
624
0
        if (w < 1)
625
0
            return AVERROR(EINVAL);
626
627
0
        for (x = 0; x < w; x++)
628
0
            src_array[x] = color[c];
629
630
0
        for (x = 0; x < 4; x++)
631
0
            c_data[x] = &clear_block[x][0];
632
633
0
        av_write_image_line2(src_array, c_data, c_linesize, desc, 0, 0, c, w, 4);
634
0
    }
635
636
0
    for (plane = 0; plane < nb_planes; plane++) {
637
0
        plane_line_bytes[plane] = av_image_get_linesize(pix_fmt, width, plane);
638
0
        if (plane_line_bytes[plane] < 0)
639
0
            return AVERROR(EINVAL);
640
0
    }
641
642
0
    if (!dst_data)
643
0
        return 0;
644
645
0
    for (plane = 0; plane < nb_planes; plane++) {
646
0
        size_t bytewidth = plane_line_bytes[plane];
647
0
        uint8_t *data = dst_data[plane];
648
0
        int chroma_div = plane == 1 || plane == 2 ? desc->log2_chroma_h : 0;
649
0
        int plane_h = AV_CEIL_RSHIFT(height, chroma_div);
650
651
0
        for (; plane_h > 0; plane_h--) {
652
0
            memset_bytes(data, bytewidth, &clear_block[plane][0], clear_block_size[plane]);
653
0
            data += dst_linesize[plane];
654
0
        }
655
0
    }
656
657
0
    return 0;
658
0
}
659
660
int av_image_fill_black(uint8_t * const dst_data[4], const ptrdiff_t dst_linesize[4],
661
                        enum AVPixelFormat pix_fmt, enum AVColorRange range,
662
                        int width, int height)
663
0
{
664
0
    const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
665
0
    int nb_planes = av_pix_fmt_count_planes(pix_fmt);
666
0
    int rgb, xyz, pal, limited, alpha, fltp;
667
0
    uint32_t colors[4] = {0};
668
669
0
    if (!desc || nb_planes < 1 || nb_planes > 4 || desc->flags & AV_PIX_FMT_FLAG_HWACCEL)
670
0
        return AVERROR(EINVAL);
671
672
0
    rgb = !!(desc->flags & AV_PIX_FMT_FLAG_RGB);
673
0
    xyz = !!(desc->flags & AV_PIX_FMT_FLAG_XYZ);
674
0
    pal = !!(desc->flags & AV_PIX_FMT_FLAG_PAL);
675
0
    limited = !rgb && !xyz && !pal && range != AVCOL_RANGE_JPEG;
676
0
    alpha = !pal && !!(desc->flags & AV_PIX_FMT_FLAG_ALPHA);
677
0
    fltp = !!(desc->flags & AV_PIX_FMT_FLAG_FLOAT);
678
679
0
    for (int c = 0; c < desc->nb_components; c++) {
680
0
        const AVComponentDescriptor comp = desc->comp[c];
681
0
        uint32_t color = 0;
682
683
0
        if (comp.depth > 32)
684
0
            return AVERROR(EINVAL);
685
686
0
        if (pix_fmt == AV_PIX_FMT_MONOWHITE) {
687
0
            color = 1;
688
0
        } else if (c + 1 == desc->nb_components && alpha) {
689
            // (Assume even limited YUV uses full range alpha.)
690
0
            if (fltp) {
691
0
                if (comp.depth != 16 && comp.depth != 32)
692
0
                    return AVERROR(EINVAL);
693
0
                color = (comp.depth == 16 ? 0x3C00 : 0x3F800000); // 1.0
694
0
             } else {
695
0
                color = (comp.depth == 32 ? 0 : (1 << comp.depth)) - 1;
696
0
             }
697
0
        } else if (c == 0 && limited && comp.depth > 1) {
698
0
            if (comp.depth < 8 || (fltp && comp.depth != 16 && comp.depth != 32))
699
0
                return AVERROR(EINVAL);
700
0
            if (fltp)
701
0
                color = (comp.depth == 16 ? 0x2C00 : 0x3D800000); // 0.0625
702
0
            else
703
0
                color = 16 << (comp.depth - 8);
704
0
        } else if ((c == 1 || c == 2) && !rgb && !xyz) {
705
0
            if (comp.depth < 8 || fltp && comp.depth != 16 && comp.depth != 32)
706
0
                return AVERROR(EINVAL);
707
0
            if (fltp)
708
0
                color = (comp.depth == 16 ? 0x3800 : 0x3F000000); // 0.5
709
0
            else
710
0
                color = 128 << (comp.depth - 8);
711
0
        }
712
713
0
        colors[c] = color;
714
0
    }
715
716
0
    return av_image_fill_color(dst_data, dst_linesize, pix_fmt, colors, width, height, 0);
717
0
}