FFmpeg coverage

Directory: ../../../ffmpeg/
File: src/libswscale/format.h
Date: 2026-07-16 17:05:34
Exec Total Coverage
Lines: 33 33 100.0%
Functions: 8 8 100.0%
Branches: 31 48 64.6%
Line Branch Exec 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 4579622 static inline int ff_q_isnan(const AVRational a)
32 {
33
4/4
✓ Branch 0 taken 4245544 times.
✓ Branch 1 taken 334078 times.
✓ Branch 2 taken 3917964 times.
✓ Branch 3 taken 327580 times.
 4579622 return !a.num && !a.den;
34 }
35
36 /* Like av_cmp_q but considers NaN == NaN */
37 2620640 static inline int ff_q_equal(const AVRational a, const AVRational b)
38 {
39
4/6
✓ Branch 1 taken 1958982 times.
✓ Branch 2 taken 661658 times.
✗ Branch 4 not taken.
✓ Branch 5 taken 1958982 times.
✓ Branch 7 taken 661658 times.
✗ Branch 8 not taken.
 2620640 return (ff_q_isnan(a) && ff_q_isnan(b)) || !av_cmp_q(a, b);
40 }
41
42 982740 static inline int ff_cie_xy_equal(const AVCIExy a, const AVCIExy b)
43 {
44
2/4
✓ Branch 1 taken 982740 times.
✗ Branch 2 not taken.
✓ Branch 4 taken 982740 times.
✗ Branch 5 not taken.
 982740 return ff_q_equal(a.x, b.x) && ff_q_equal(a.y, b.y);
45 }
46
47 327580 static inline int ff_prim_equal(const AVPrimaryCoefficients *a,
48 const AVPrimaryCoefficients *b)
49 {
50
1/2
✓ Branch 1 taken 327580 times.
✗ Branch 2 not taken.
 655160 return ff_cie_xy_equal(a->r, b->r) &&
51
2/4
✓ Branch 0 taken 327580 times.
✗ Branch 1 not taken.
✓ Branch 3 taken 327580 times.
✗ Branch 4 not taken.
 655160 ff_cie_xy_equal(a->g, b->g) &&
52 327580 ff_cie_xy_equal(a->b, b->b);
53 }
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 140553 static inline void ff_color_update_dynamic(SwsColor *dst, const SwsColor *src)
71 {
72 140553 dst->frame_peak = src->frame_peak;
73 140553 dst->frame_avg = src->frame_avg;
74 140553 }
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 2445738 static inline void ff_fmt_clear(SwsFormat *fmt)
91 {
92 2445738 *fmt = (SwsFormat) {
93 .format = AV_PIX_FMT_NONE,
94 .range = AVCOL_RANGE_UNSPECIFIED,
95 .csp = AVCOL_SPC_UNSPECIFIED,
96 .loc = AVCHROMA_LOC_UNSPECIFIED,
97 .color = {
98 .prim = AVCOL_PRI_UNSPECIFIED,
99 .trc = AVCOL_TRC_UNSPECIFIED,
100 },
101 };
102 2445738 }
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 327580 static inline int ff_color_equal(const SwsColor *c1, const SwsColor *c2)
116 {
117 655160 return c1->prim == c2->prim &&
118
2/4
✓ Branch 0 taken 327580 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 327580 times.
✗ Branch 3 not taken.
 655160 c1->trc == c2->trc &&
119
1/2
✓ Branch 1 taken 327580 times.
✗ Branch 2 not taken.
 655160 ff_q_equal(c1->min_luma, c2->min_luma) &&
120
2/4
✓ Branch 0 taken 327580 times.
✗ Branch 1 not taken.
✓ Branch 3 taken 327580 times.
✗ Branch 4 not taken.
 982740 ff_q_equal(c1->max_luma, c2->max_luma) &&
121 327580 ff_prim_equal(&c1->gamut, &c2->gamut);
122 }
123
124 /* Tests only the static components of a colorspace, ignoring per-frame data */
125 600964 static inline int ff_fmt_equal(const SwsFormat *fmt1, const SwsFormat *fmt2)
126 {
127 1126781 return fmt1->width == fmt2->width &&
128
2/2
✓ Branch 0 taken 505868 times.
✓ Branch 1 taken 19949 times.
 525817 fmt1->height == fmt2->height &&
129
1/2
✓ Branch 0 taken 505868 times.
✗ Branch 1 not taken.
 505868 fmt1->interlaced == fmt2->interlaced &&
130
1/2
✓ Branch 0 taken 505868 times.
✗ Branch 1 not taken.
 505868 fmt1->field == fmt2->field &&
131
2/2
✓ Branch 0 taken 327831 times.
✓ Branch 1 taken 178037 times.
 505868 fmt1->format == fmt2->format &&
132
2/2
✓ Branch 0 taken 327580 times.
✓ Branch 1 taken 251 times.
 327831 fmt1->range == fmt2->range &&
133
1/2
✓ Branch 0 taken 327580 times.
✗ Branch 1 not taken.
 327580 fmt1->csp == fmt2->csp &&
134
4/6
✓ Branch 0 taken 525817 times.
✓ Branch 1 taken 75147 times.
✓ Branch 2 taken 327580 times.
✗ Branch 3 not taken.
✓ Branch 4 taken 327580 times.
✗ Branch 5 not taken.
 1454361 fmt1->loc == fmt2->loc &&
135 327580 ff_color_equal(&fmt1->color, &fmt2->color);
136 }
137
138 static inline int ff_fmt_align(enum AVPixelFormat fmt)
139 {
140 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(fmt);
141 if (desc->flags & AV_PIX_FMT_FLAG_BAYER) {
142 return 2;
143 } else {
144 return 1 << desc->log2_chroma_h;
145 }
146 }
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 */
247