Coverage Report

Created: 2026-04-01 07:42

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/ffmpeg/libswscale/format.h
Line
Count
Source
1
/*
2
 * Copyright (C) 2024 Niklas Haas
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
#ifndef SWSCALE_FORMAT_H
22
#define SWSCALE_FORMAT_H
23
24
#include <stdbool.h>
25
26
#include "libavutil/csp.h"
27
#include "libavutil/pixdesc.h"
28
29
#include "swscale.h"
30
31
static inline int ff_q_isnan(const AVRational a)
32
0
{
33
0
    return !a.num && !a.den;
34
0
}
Unexecuted instantiation: swscale.c:ff_q_isnan
Unexecuted instantiation: utils.c:ff_q_isnan
Unexecuted instantiation: vscale.c:ff_q_isnan
Unexecuted instantiation: yuv2rgb.c:ff_q_isnan
Unexecuted instantiation: alphablend.c:ff_q_isnan
Unexecuted instantiation: format.c:ff_q_isnan
Unexecuted instantiation: graph.c:ff_q_isnan
Unexecuted instantiation: hscale_fast_bilinear.c:ff_q_isnan
Unexecuted instantiation: input.c:ff_q_isnan
Unexecuted instantiation: lut3d.c:ff_q_isnan
Unexecuted instantiation: ops.c:ff_q_isnan
Unexecuted instantiation: ops_backend.c:ff_q_isnan
Unexecuted instantiation: ops_chain.c:ff_q_isnan
Unexecuted instantiation: ops_dispatch.c:ff_q_isnan
Unexecuted instantiation: ops_memcpy.c:ff_q_isnan
Unexecuted instantiation: ops_optimizer.c:ff_q_isnan
Unexecuted instantiation: options.c:ff_q_isnan
Unexecuted instantiation: output.c:ff_q_isnan
Unexecuted instantiation: rgb2rgb.c:ff_q_isnan
Unexecuted instantiation: slice.c:ff_q_isnan
Unexecuted instantiation: swscale_unscaled.c:ff_q_isnan
Unexecuted instantiation: cms.c:ff_q_isnan
Unexecuted instantiation: csputils.c:ff_q_isnan
Unexecuted instantiation: gamma.c:ff_q_isnan
Unexecuted instantiation: hscale.c:ff_q_isnan
35
36
/* Like av_cmp_q but considers NaN == NaN */
37
static inline int ff_q_equal(const AVRational a, const AVRational b)
38
0
{
39
0
    return (ff_q_isnan(a) && ff_q_isnan(b)) || !av_cmp_q(a, b);
40
0
}
Unexecuted instantiation: swscale.c:ff_q_equal
Unexecuted instantiation: utils.c:ff_q_equal
Unexecuted instantiation: vscale.c:ff_q_equal
Unexecuted instantiation: yuv2rgb.c:ff_q_equal
Unexecuted instantiation: alphablend.c:ff_q_equal
Unexecuted instantiation: format.c:ff_q_equal
Unexecuted instantiation: graph.c:ff_q_equal
Unexecuted instantiation: hscale_fast_bilinear.c:ff_q_equal
Unexecuted instantiation: input.c:ff_q_equal
Unexecuted instantiation: lut3d.c:ff_q_equal
Unexecuted instantiation: ops.c:ff_q_equal
Unexecuted instantiation: ops_backend.c:ff_q_equal
Unexecuted instantiation: ops_chain.c:ff_q_equal
Unexecuted instantiation: ops_dispatch.c:ff_q_equal
Unexecuted instantiation: ops_memcpy.c:ff_q_equal
Unexecuted instantiation: ops_optimizer.c:ff_q_equal
Unexecuted instantiation: options.c:ff_q_equal
Unexecuted instantiation: output.c:ff_q_equal
Unexecuted instantiation: rgb2rgb.c:ff_q_equal
Unexecuted instantiation: slice.c:ff_q_equal
Unexecuted instantiation: swscale_unscaled.c:ff_q_equal
Unexecuted instantiation: cms.c:ff_q_equal
Unexecuted instantiation: csputils.c:ff_q_equal
Unexecuted instantiation: gamma.c:ff_q_equal
Unexecuted instantiation: hscale.c:ff_q_equal
41
42
static inline int ff_cie_xy_equal(const AVCIExy a, const AVCIExy b)
43
0
{
44
0
    return ff_q_equal(a.x, b.x) && ff_q_equal(a.y, b.y);
45
0
}
Unexecuted instantiation: swscale.c:ff_cie_xy_equal
Unexecuted instantiation: utils.c:ff_cie_xy_equal
Unexecuted instantiation: vscale.c:ff_cie_xy_equal
Unexecuted instantiation: yuv2rgb.c:ff_cie_xy_equal
Unexecuted instantiation: alphablend.c:ff_cie_xy_equal
Unexecuted instantiation: format.c:ff_cie_xy_equal
Unexecuted instantiation: graph.c:ff_cie_xy_equal
Unexecuted instantiation: hscale_fast_bilinear.c:ff_cie_xy_equal
Unexecuted instantiation: input.c:ff_cie_xy_equal
Unexecuted instantiation: lut3d.c:ff_cie_xy_equal
Unexecuted instantiation: ops.c:ff_cie_xy_equal
Unexecuted instantiation: ops_backend.c:ff_cie_xy_equal
Unexecuted instantiation: ops_chain.c:ff_cie_xy_equal
Unexecuted instantiation: ops_dispatch.c:ff_cie_xy_equal
Unexecuted instantiation: ops_memcpy.c:ff_cie_xy_equal
Unexecuted instantiation: ops_optimizer.c:ff_cie_xy_equal
Unexecuted instantiation: options.c:ff_cie_xy_equal
Unexecuted instantiation: output.c:ff_cie_xy_equal
Unexecuted instantiation: rgb2rgb.c:ff_cie_xy_equal
Unexecuted instantiation: slice.c:ff_cie_xy_equal
Unexecuted instantiation: swscale_unscaled.c:ff_cie_xy_equal
Unexecuted instantiation: cms.c:ff_cie_xy_equal
Unexecuted instantiation: csputils.c:ff_cie_xy_equal
Unexecuted instantiation: gamma.c:ff_cie_xy_equal
Unexecuted instantiation: hscale.c:ff_cie_xy_equal
46
47
static inline int ff_prim_equal(const AVPrimaryCoefficients *a,
48
                                const AVPrimaryCoefficients *b)
49
0
{
50
0
    return ff_cie_xy_equal(a->r, b->r) &&
51
0
           ff_cie_xy_equal(a->g, b->g) &&
52
0
           ff_cie_xy_equal(a->b, b->b);
53
0
}
Unexecuted instantiation: swscale.c:ff_prim_equal
Unexecuted instantiation: utils.c:ff_prim_equal
Unexecuted instantiation: vscale.c:ff_prim_equal
Unexecuted instantiation: yuv2rgb.c:ff_prim_equal
Unexecuted instantiation: alphablend.c:ff_prim_equal
Unexecuted instantiation: format.c:ff_prim_equal
Unexecuted instantiation: graph.c:ff_prim_equal
Unexecuted instantiation: hscale_fast_bilinear.c:ff_prim_equal
Unexecuted instantiation: input.c:ff_prim_equal
Unexecuted instantiation: lut3d.c:ff_prim_equal
Unexecuted instantiation: ops.c:ff_prim_equal
Unexecuted instantiation: ops_backend.c:ff_prim_equal
Unexecuted instantiation: ops_chain.c:ff_prim_equal
Unexecuted instantiation: ops_dispatch.c:ff_prim_equal
Unexecuted instantiation: ops_memcpy.c:ff_prim_equal
Unexecuted instantiation: ops_optimizer.c:ff_prim_equal
Unexecuted instantiation: options.c:ff_prim_equal
Unexecuted instantiation: output.c:ff_prim_equal
Unexecuted instantiation: rgb2rgb.c:ff_prim_equal
Unexecuted instantiation: slice.c:ff_prim_equal
Unexecuted instantiation: swscale_unscaled.c:ff_prim_equal
Unexecuted instantiation: cms.c:ff_prim_equal
Unexecuted instantiation: csputils.c:ff_prim_equal
Unexecuted instantiation: gamma.c:ff_prim_equal
Unexecuted instantiation: hscale.c:ff_prim_equal
54
55
enum {
56
    FIELD_TOP, /* top/even rows, or progressive */
57
    FIELD_BOTTOM, /* bottom/odd rows */
58
};
59
60
typedef struct SwsColor {
61
    enum AVColorPrimaries prim;
62
    enum AVColorTransferCharacteristic trc;
63
    AVPrimaryCoefficients gamut; /* mastering display gamut */
64
    AVRational min_luma;         /* minimum luminance in nits */
65
    AVRational max_luma;         /* maximum luminance in nits */
66
    AVRational frame_peak;       /* per-frame/scene peak luminance, or 0 */
67
    AVRational frame_avg;        /* per-frame/scene average luminance, or 0 */
68
} SwsColor;
69
70
static inline void ff_color_update_dynamic(SwsColor *dst, const SwsColor *src)
71
0
{
72
0
    dst->frame_peak = src->frame_peak;
73
0
    dst->frame_avg  = src->frame_avg;
74
0
}
Unexecuted instantiation: swscale.c:ff_color_update_dynamic
Unexecuted instantiation: utils.c:ff_color_update_dynamic
Unexecuted instantiation: vscale.c:ff_color_update_dynamic
Unexecuted instantiation: yuv2rgb.c:ff_color_update_dynamic
Unexecuted instantiation: alphablend.c:ff_color_update_dynamic
Unexecuted instantiation: format.c:ff_color_update_dynamic
Unexecuted instantiation: graph.c:ff_color_update_dynamic
Unexecuted instantiation: hscale_fast_bilinear.c:ff_color_update_dynamic
Unexecuted instantiation: input.c:ff_color_update_dynamic
Unexecuted instantiation: lut3d.c:ff_color_update_dynamic
Unexecuted instantiation: ops.c:ff_color_update_dynamic
Unexecuted instantiation: ops_backend.c:ff_color_update_dynamic
Unexecuted instantiation: ops_chain.c:ff_color_update_dynamic
Unexecuted instantiation: ops_dispatch.c:ff_color_update_dynamic
Unexecuted instantiation: ops_memcpy.c:ff_color_update_dynamic
Unexecuted instantiation: ops_optimizer.c:ff_color_update_dynamic
Unexecuted instantiation: options.c:ff_color_update_dynamic
Unexecuted instantiation: output.c:ff_color_update_dynamic
Unexecuted instantiation: rgb2rgb.c:ff_color_update_dynamic
Unexecuted instantiation: slice.c:ff_color_update_dynamic
Unexecuted instantiation: swscale_unscaled.c:ff_color_update_dynamic
Unexecuted instantiation: cms.c:ff_color_update_dynamic
Unexecuted instantiation: csputils.c:ff_color_update_dynamic
Unexecuted instantiation: gamma.c:ff_color_update_dynamic
Unexecuted instantiation: hscale.c:ff_color_update_dynamic
75
76
/* Subset of AVFrame parameters that uniquely determine pixel representation */
77
typedef struct SwsFormat {
78
    int width, height;
79
    int interlaced;
80
    enum AVPixelFormat format;
81
    enum AVPixelFormat hw_format;
82
    enum AVColorRange range;
83
    enum AVColorSpace csp;
84
    enum AVChromaLocation loc;
85
    const AVPixFmtDescriptor *desc; /* convenience */
86
    SwsColor color;
87
} SwsFormat;
88
89
static inline void ff_fmt_clear(SwsFormat *fmt)
90
0
{
91
0
    *fmt = (SwsFormat) {
92
0
        .format     = AV_PIX_FMT_NONE,
93
0
        .range      = AVCOL_RANGE_UNSPECIFIED,
94
0
        .csp        = AVCOL_SPC_UNSPECIFIED,
95
0
        .loc        = AVCHROMA_LOC_UNSPECIFIED,
96
0
        .color = {
97
0
            .prim = AVCOL_PRI_UNSPECIFIED,
98
0
            .trc  = AVCOL_TRC_UNSPECIFIED,
99
0
        },
100
0
    };
101
0
}
Unexecuted instantiation: swscale.c:ff_fmt_clear
Unexecuted instantiation: utils.c:ff_fmt_clear
Unexecuted instantiation: vscale.c:ff_fmt_clear
Unexecuted instantiation: yuv2rgb.c:ff_fmt_clear
Unexecuted instantiation: alphablend.c:ff_fmt_clear
Unexecuted instantiation: format.c:ff_fmt_clear
Unexecuted instantiation: graph.c:ff_fmt_clear
Unexecuted instantiation: hscale_fast_bilinear.c:ff_fmt_clear
Unexecuted instantiation: input.c:ff_fmt_clear
Unexecuted instantiation: lut3d.c:ff_fmt_clear
Unexecuted instantiation: ops.c:ff_fmt_clear
Unexecuted instantiation: ops_backend.c:ff_fmt_clear
Unexecuted instantiation: ops_chain.c:ff_fmt_clear
Unexecuted instantiation: ops_dispatch.c:ff_fmt_clear
Unexecuted instantiation: ops_memcpy.c:ff_fmt_clear
Unexecuted instantiation: ops_optimizer.c:ff_fmt_clear
Unexecuted instantiation: options.c:ff_fmt_clear
Unexecuted instantiation: output.c:ff_fmt_clear
Unexecuted instantiation: rgb2rgb.c:ff_fmt_clear
Unexecuted instantiation: slice.c:ff_fmt_clear
Unexecuted instantiation: swscale_unscaled.c:ff_fmt_clear
Unexecuted instantiation: cms.c:ff_fmt_clear
Unexecuted instantiation: csputils.c:ff_fmt_clear
Unexecuted instantiation: gamma.c:ff_fmt_clear
Unexecuted instantiation: hscale.c:ff_fmt_clear
102
103
/**
104
 * This function also sanitizes and strips the input data, removing irrelevant
105
 * fields for certain formats.
106
 */
107
SwsFormat ff_fmt_from_frame(const AVFrame *frame, int field);
108
109
/**
110
 * Subset of ff_fmt_from_frame() that sets default metadata for the format.
111
 */
112
void ff_fmt_from_pixfmt(enum AVPixelFormat pixfmt, SwsFormat *fmt);
113
114
static inline int ff_color_equal(const SwsColor *c1, const SwsColor *c2)
115
0
{
116
0
    return  c1->prim == c2->prim &&
117
0
            c1->trc  == c2->trc  &&
118
0
            ff_q_equal(c1->min_luma, c2->min_luma) &&
119
0
            ff_q_equal(c1->max_luma, c2->max_luma) &&
120
0
            ff_prim_equal(&c1->gamut, &c2->gamut);
121
0
}
Unexecuted instantiation: swscale.c:ff_color_equal
Unexecuted instantiation: utils.c:ff_color_equal
Unexecuted instantiation: vscale.c:ff_color_equal
Unexecuted instantiation: yuv2rgb.c:ff_color_equal
Unexecuted instantiation: alphablend.c:ff_color_equal
Unexecuted instantiation: format.c:ff_color_equal
Unexecuted instantiation: graph.c:ff_color_equal
Unexecuted instantiation: hscale_fast_bilinear.c:ff_color_equal
Unexecuted instantiation: input.c:ff_color_equal
Unexecuted instantiation: lut3d.c:ff_color_equal
Unexecuted instantiation: ops.c:ff_color_equal
Unexecuted instantiation: ops_backend.c:ff_color_equal
Unexecuted instantiation: ops_chain.c:ff_color_equal
Unexecuted instantiation: ops_dispatch.c:ff_color_equal
Unexecuted instantiation: ops_memcpy.c:ff_color_equal
Unexecuted instantiation: ops_optimizer.c:ff_color_equal
Unexecuted instantiation: options.c:ff_color_equal
Unexecuted instantiation: output.c:ff_color_equal
Unexecuted instantiation: rgb2rgb.c:ff_color_equal
Unexecuted instantiation: slice.c:ff_color_equal
Unexecuted instantiation: swscale_unscaled.c:ff_color_equal
Unexecuted instantiation: cms.c:ff_color_equal
Unexecuted instantiation: csputils.c:ff_color_equal
Unexecuted instantiation: gamma.c:ff_color_equal
Unexecuted instantiation: hscale.c:ff_color_equal
122
123
/* Tests only the static components of a colorspace, ignoring dimensions and per-frame data */
124
static inline int ff_props_equal(const SwsFormat *fmt1, const SwsFormat *fmt2)
125
0
{
126
0
    return fmt1->interlaced == fmt2->interlaced &&
127
0
           fmt1->format     == fmt2->format     &&
128
0
           fmt1->range      == fmt2->range      &&
129
0
           fmt1->csp        == fmt2->csp        &&
130
0
           fmt1->loc        == fmt2->loc        &&
131
0
           ff_color_equal(&fmt1->color, &fmt2->color);
132
0
}
Unexecuted instantiation: swscale.c:ff_props_equal
Unexecuted instantiation: utils.c:ff_props_equal
Unexecuted instantiation: vscale.c:ff_props_equal
Unexecuted instantiation: yuv2rgb.c:ff_props_equal
Unexecuted instantiation: alphablend.c:ff_props_equal
Unexecuted instantiation: format.c:ff_props_equal
Unexecuted instantiation: graph.c:ff_props_equal
Unexecuted instantiation: hscale_fast_bilinear.c:ff_props_equal
Unexecuted instantiation: input.c:ff_props_equal
Unexecuted instantiation: lut3d.c:ff_props_equal
Unexecuted instantiation: ops.c:ff_props_equal
Unexecuted instantiation: ops_backend.c:ff_props_equal
Unexecuted instantiation: ops_chain.c:ff_props_equal
Unexecuted instantiation: ops_dispatch.c:ff_props_equal
Unexecuted instantiation: ops_memcpy.c:ff_props_equal
Unexecuted instantiation: ops_optimizer.c:ff_props_equal
Unexecuted instantiation: options.c:ff_props_equal
Unexecuted instantiation: output.c:ff_props_equal
Unexecuted instantiation: rgb2rgb.c:ff_props_equal
Unexecuted instantiation: slice.c:ff_props_equal
Unexecuted instantiation: swscale_unscaled.c:ff_props_equal
Unexecuted instantiation: cms.c:ff_props_equal
Unexecuted instantiation: csputils.c:ff_props_equal
Unexecuted instantiation: gamma.c:ff_props_equal
Unexecuted instantiation: hscale.c:ff_props_equal
133
134
/* Tests only the static components of a colorspace, ignoring per-frame data */
135
static inline int ff_fmt_equal(const SwsFormat *fmt1, const SwsFormat *fmt2)
136
0
{
137
0
    return fmt1->width      == fmt2->width      &&
138
0
           fmt1->height     == fmt2->height     &&
139
0
           ff_props_equal(fmt1, fmt2);
140
0
}
Unexecuted instantiation: swscale.c:ff_fmt_equal
Unexecuted instantiation: utils.c:ff_fmt_equal
Unexecuted instantiation: vscale.c:ff_fmt_equal
Unexecuted instantiation: yuv2rgb.c:ff_fmt_equal
Unexecuted instantiation: alphablend.c:ff_fmt_equal
Unexecuted instantiation: format.c:ff_fmt_equal
Unexecuted instantiation: graph.c:ff_fmt_equal
Unexecuted instantiation: hscale_fast_bilinear.c:ff_fmt_equal
Unexecuted instantiation: input.c:ff_fmt_equal
Unexecuted instantiation: lut3d.c:ff_fmt_equal
Unexecuted instantiation: ops.c:ff_fmt_equal
Unexecuted instantiation: ops_backend.c:ff_fmt_equal
Unexecuted instantiation: ops_chain.c:ff_fmt_equal
Unexecuted instantiation: ops_dispatch.c:ff_fmt_equal
Unexecuted instantiation: ops_memcpy.c:ff_fmt_equal
Unexecuted instantiation: ops_optimizer.c:ff_fmt_equal
Unexecuted instantiation: options.c:ff_fmt_equal
Unexecuted instantiation: output.c:ff_fmt_equal
Unexecuted instantiation: rgb2rgb.c:ff_fmt_equal
Unexecuted instantiation: slice.c:ff_fmt_equal
Unexecuted instantiation: swscale_unscaled.c:ff_fmt_equal
Unexecuted instantiation: cms.c:ff_fmt_equal
Unexecuted instantiation: csputils.c:ff_fmt_equal
Unexecuted instantiation: gamma.c:ff_fmt_equal
Unexecuted instantiation: hscale.c:ff_fmt_equal
141
142
static inline int ff_fmt_align(enum AVPixelFormat fmt)
143
0
{
144
0
    const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(fmt);
145
0
    if (desc->flags & AV_PIX_FMT_FLAG_BAYER) {
146
0
        return 2;
147
0
    } else {
148
0
        return 1 << desc->log2_chroma_h;
149
0
    }
150
0
}
Unexecuted instantiation: swscale.c:ff_fmt_align
Unexecuted instantiation: utils.c:ff_fmt_align
Unexecuted instantiation: vscale.c:ff_fmt_align
Unexecuted instantiation: yuv2rgb.c:ff_fmt_align
Unexecuted instantiation: alphablend.c:ff_fmt_align
Unexecuted instantiation: format.c:ff_fmt_align
Unexecuted instantiation: graph.c:ff_fmt_align
Unexecuted instantiation: hscale_fast_bilinear.c:ff_fmt_align
Unexecuted instantiation: input.c:ff_fmt_align
Unexecuted instantiation: lut3d.c:ff_fmt_align
Unexecuted instantiation: ops.c:ff_fmt_align
Unexecuted instantiation: ops_backend.c:ff_fmt_align
Unexecuted instantiation: ops_chain.c:ff_fmt_align
Unexecuted instantiation: ops_dispatch.c:ff_fmt_align
Unexecuted instantiation: ops_memcpy.c:ff_fmt_align
Unexecuted instantiation: ops_optimizer.c:ff_fmt_align
Unexecuted instantiation: options.c:ff_fmt_align
Unexecuted instantiation: output.c:ff_fmt_align
Unexecuted instantiation: rgb2rgb.c:ff_fmt_align
Unexecuted instantiation: slice.c:ff_fmt_align
Unexecuted instantiation: swscale_unscaled.c:ff_fmt_align
Unexecuted instantiation: cms.c:ff_fmt_align
Unexecuted instantiation: csputils.c:ff_fmt_align
Unexecuted instantiation: gamma.c:ff_fmt_align
Unexecuted instantiation: hscale.c:ff_fmt_align
151
152
int ff_test_fmt(const SwsFormat *fmt, int output);
153
154
/* Returns true if the formats are incomplete, false otherwise */
155
bool ff_infer_colors(SwsColor *src, SwsColor *dst);
156
157
typedef struct SwsOpList SwsOpList;
158
typedef enum SwsPixelType SwsPixelType;
159
160
/**
161
 * Append a set of operations for decoding/encoding raw pixels. This will
162
 * handle input read/write, swizzling, shifting and byte swapping.
163
 *
164
 * Returns 0 on success, or a negative error code on failure.
165
 */
166
int ff_sws_decode_pixfmt(SwsOpList *ops, enum AVPixelFormat fmt);
167
int ff_sws_encode_pixfmt(SwsOpList *ops, enum AVPixelFormat fmt);
168
169
/**
170
 * Append a set of operations for transforming decoded pixel values to/from
171
 * normalized RGB in the specified gamut and pixel type.
172
 *
173
 * Returns 0 on success, or a negative error code on failure.
174
 */
175
int ff_sws_decode_colors(SwsContext *ctx, SwsPixelType type, SwsOpList *ops,
176
                         const SwsFormat *fmt, bool *incomplete);
177
int ff_sws_encode_colors(SwsContext *ctx, SwsPixelType type, SwsOpList *ops,
178
                         const SwsFormat *src, const SwsFormat *dst,
179
                         bool *incomplete);
180
181
/**
182
 * Represents a view into a single field of frame data.
183
 *
184
 * Ostensibly, this is a (non-compatible) subset of AVFrame, however, the
185
 * semantics are VERY different.
186
 *
187
 * Unlike AVFrame, this struct does NOT own any data references. All buffers
188
 * referenced by a SwsFrame are managed externally. This merely represents
189
 * a view into data.
190
 *
191
 * This struct is not refcounted, and may be freely copied onto the stack.
192
 */
193
typedef struct SwsFrame {
194
    /* Data buffers and line stride */
195
    uint8_t *data[4];
196
    int linesize[4];
197
198
    /**
199
     * Dimensions and format
200
     */
201
    int width, height;
202
    enum AVPixelFormat format;
203
204
    /**
205
     * Pointer to the original AVFrame, if there is a 1:1 correspondence.
206
     **/
207
    const AVFrame *avframe;
208
} SwsFrame;
209
210
/**
211
 * Initialize a SwsFrame from an AVFrame.
212
 */
213
void ff_sws_frame_from_avframe(SwsFrame *dst, const AVFrame *src);
214
215
#endif /* SWSCALE_FORMAT_H */