Coverage Report

Created: 2026-07-15 07:31

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_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: uops_backend.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
Unexecuted instantiation: ops_chain.c:ff_q_isnan
Unexecuted instantiation: uops.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_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: uops_backend.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
Unexecuted instantiation: ops_chain.c:ff_q_equal
Unexecuted instantiation: uops.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_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: uops_backend.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
Unexecuted instantiation: ops_chain.c:ff_cie_xy_equal
Unexecuted instantiation: uops.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_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: uops_backend.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
Unexecuted instantiation: ops_chain.c:ff_prim_equal
Unexecuted instantiation: uops.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_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: uops_backend.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
Unexecuted instantiation: ops_chain.c:ff_color_update_dynamic
Unexecuted instantiation: uops.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
    int field;
81
    enum AVPixelFormat format;
82
    enum AVPixelFormat hw_format;
83
    enum AVColorRange range;
84
    enum AVColorSpace csp;
85
    enum AVChromaLocation loc;
86
    const AVPixFmtDescriptor *desc; /* convenience */
87
    SwsColor color;
88
} SwsFormat;
89
90
static inline void ff_fmt_clear(SwsFormat *fmt)
91
0
{
92
0
    *fmt = (SwsFormat) {
93
0
        .format     = AV_PIX_FMT_NONE,
94
0
        .range      = AVCOL_RANGE_UNSPECIFIED,
95
0
        .csp        = AVCOL_SPC_UNSPECIFIED,
96
0
        .loc        = AVCHROMA_LOC_UNSPECIFIED,
97
0
        .color = {
98
0
            .prim = AVCOL_PRI_UNSPECIFIED,
99
0
            .trc  = AVCOL_TRC_UNSPECIFIED,
100
0
        },
101
0
    };
102
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_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: uops_backend.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
Unexecuted instantiation: ops_chain.c:ff_fmt_clear
Unexecuted instantiation: uops.c:ff_fmt_clear
103
104
/**
105
 * This function also sanitizes and strips the input data, removing irrelevant
106
 * fields for certain formats.
107
 */
108
SwsFormat ff_fmt_from_frame(const AVFrame *frame, int field);
109
110
/**
111
 * Subset of ff_fmt_from_frame() that sets default metadata for the format.
112
 */
113
void ff_fmt_from_pixfmt(enum AVPixelFormat pixfmt, SwsFormat *fmt);
114
115
static inline int ff_color_equal(const SwsColor *c1, const SwsColor *c2)
116
0
{
117
0
    return  c1->prim == c2->prim &&
118
0
            c1->trc  == c2->trc  &&
119
0
            ff_q_equal(c1->min_luma, c2->min_luma) &&
120
0
            ff_q_equal(c1->max_luma, c2->max_luma) &&
121
0
            ff_prim_equal(&c1->gamut, &c2->gamut);
122
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_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: uops_backend.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
Unexecuted instantiation: ops_chain.c:ff_color_equal
Unexecuted instantiation: uops.c:ff_color_equal
123
124
/* Tests only the static components of a colorspace, ignoring per-frame data */
125
static inline int ff_fmt_equal(const SwsFormat *fmt1, const SwsFormat *fmt2)
126
0
{
127
0
    return fmt1->width      == fmt2->width      &&
128
0
           fmt1->height     == fmt2->height     &&
129
0
           fmt1->interlaced == fmt2->interlaced &&
130
0
           fmt1->field      == fmt2->field      &&
131
0
           fmt1->format     == fmt2->format     &&
132
0
           fmt1->range      == fmt2->range      &&
133
0
           fmt1->csp        == fmt2->csp        &&
134
0
           fmt1->loc        == fmt2->loc        &&
135
0
           ff_color_equal(&fmt1->color, &fmt2->color);
136
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_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: uops_backend.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
Unexecuted instantiation: ops_chain.c:ff_fmt_equal
Unexecuted instantiation: uops.c:ff_fmt_equal
137
138
static inline int ff_fmt_align(enum AVPixelFormat fmt)
139
0
{
140
0
    const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(fmt);
141
0
    if (desc->flags & AV_PIX_FMT_FLAG_BAYER) {
142
0
        return 2;
143
0
    } else {
144
0
        return 1 << desc->log2_chroma_h;
145
0
    }
146
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_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: uops_backend.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
Unexecuted instantiation: ops_chain.c:ff_fmt_align
Unexecuted instantiation: uops.c:ff_fmt_align
147
148
/* Internal helper to test a format for either the legacy backend or the
149
 * ops-based backends, depending on `backends` (must be nonzero). */
150
int ff_sws_test_pixfmt_backend(const SwsBackend backends,
151
                               enum AVPixelFormat format, int output);
152
153
/**
154
 * Statically test if a given format is supported by the given set of
155
 * backends. This is a heuristic, which may have false positives if a
156
 * specific backend does not actually implement all operations that would be
157
 * required to support the format.
158
 */
159
int ff_test_fmt(SwsBackend backends, const SwsFormat *fmt, int output);
160
161
/* Returns true if the formats are incomplete, false otherwise */
162
bool ff_infer_colors(SwsColor *src, SwsColor *dst);
163
164
/**
165
 * Wrapper around av_chroma_location_enum_to_pos() that accounts for
166
 * the per-field offset introduced by interlacing.
167
 */
168
void ff_sws_chroma_pos(const SwsFormat *fmt, bool *incomplete,
169
                       int *out_xpos, int *out_ypos);
170
171
typedef struct SwsOpList SwsOpList;
172
typedef enum SwsPixelType SwsPixelType;
173
174
/**
175
 * Append a set of operations for decoding/encoding raw pixels. This will
176
 * handle input read/write, swizzling, shifting and byte swapping.
177
 *
178
 * Returns 0 on success, or a negative error code on failure.
179
 */
180
int ff_sws_decode_pixfmt(SwsOpList *ops, const SwsFormat *fmt);
181
int ff_sws_encode_pixfmt(SwsOpList *ops, const SwsFormat *fmt);
182
183
/**
184
 * Append a set of operations for transforming decoded pixel values to/from
185
 * normalized RGB in the specified gamut and pixel type.
186
 *
187
 * Returns 0 on success, or a negative error code on failure.
188
 */
189
int ff_sws_decode_colors(SwsContext *ctx, SwsPixelType type, SwsOpList *ops,
190
                         const SwsFormat *fmt, bool *incomplete);
191
int ff_sws_encode_colors(SwsContext *ctx, SwsPixelType type, SwsOpList *ops,
192
                         const SwsFormat *src, const SwsFormat *dst,
193
                         bool *incomplete);
194
195
/**
196
 * Append a set of operations for scaling pixels to a different resolution.
197
 *
198
 * Returns 0 on success, or a negative error code on failure.
199
 */
200
int ff_sws_add_filters(SwsContext *ctx, SwsPixelType type, SwsOpList *ops,
201
                       const SwsFormat *src, const SwsFormat *dst);
202
203
/**
204
 * Generate an SwsOpList defining a conversion from `src` to `dst`.
205
 *
206
 * Returns 0 on success, or a negative error code on failure.
207
 */
208
int ff_sws_op_list_generate(SwsContext *ctx, const SwsFormat *src,
209
                            const SwsFormat *dst, SwsOpList **out_ops,
210
                            bool *incomplete);
211
212
/**
213
 * Represents a view into a single field of frame data.
214
 *
215
 * Ostensibly, this is a (non-compatible) subset of AVFrame, however, the
216
 * semantics are VERY different.
217
 *
218
 * Unlike AVFrame, this struct does NOT own any data references. All buffers
219
 * referenced by a SwsFrame are managed externally. This merely represents
220
 * a view into data.
221
 *
222
 * This struct is not refcounted, and may be freely copied onto the stack.
223
 */
224
typedef struct SwsFrame {
225
    /* Data buffers and line stride */
226
    uint8_t *data[4];
227
    int linesize[4];
228
229
    /**
230
     * Dimensions and format
231
     */
232
    int width, height;
233
    enum AVPixelFormat format;
234
235
    /**
236
     * Pointer to the original AVFrame, if there is a 1:1 correspondence.
237
     **/
238
    const AVFrame *avframe;
239
} SwsFrame;
240
241
/**
242
 * Initialize a SwsFrame from an AVFrame.
243
 */
244
void ff_sws_frame_from_avframe(SwsFrame *dst, const AVFrame *src);
245
246
#endif /* SWSCALE_FORMAT_H */