FFmpeg coverage

Directory: ../../../ffmpeg/
File: src/libavfilter/vf_shear.c
Date: 2026-04-30 23:37:26
Exec Total Coverage
Lines: 0 58 0.0%
Functions: 0 8 0.0%
Branches: 0 116 0.0%
Line Branch Exec Source
1 /*
2 * Copyright (c) 2021 Paul B Mahol
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 #include "libavutil/avstring.h"
22 #include "libavutil/opt.h"
23 #include "libavutil/intreadwrite.h"
24 #include "libavutil/parseutils.h"
25 #include "libavutil/pixdesc.h"
26
27 #include "avfilter.h"
28 #include "drawutils.h"
29 #include "filters.h"
30 #include "video.h"
31
32 #include <float.h>
33
34 typedef struct ShearContext {
35 const AVClass *class;
36
37 float shx, shy;
38 int interp;
39
40 uint8_t fillcolor[4]; ///< color expressed either in YUVA or RGBA colorspace for the padding area
41 char *fillcolor_str;
42 int fillcolor_enable;
43 int nb_planes;
44 int depth;
45 FFDrawContext draw;
46 FFDrawColor color;
47
48 int hsub, vsub;
49 int planewidth[4];
50 int planeheight[4];
51
52 int (*filter_slice[2])(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs);
53 } ShearContext;
54
55 typedef struct ThreadData {
56 AVFrame *in, *out;
57 } ThreadData;
58
59 #define OFFSET(x) offsetof(ShearContext, x)
60 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_RUNTIME_PARAM
61
62 static const AVOption shear_options[] = {
63 { "shx", "set x shear factor", OFFSET(shx), AV_OPT_TYPE_FLOAT, {.dbl=0.}, -2, 2, .flags=FLAGS },
64 { "shy", "set y shear factor", OFFSET(shy), AV_OPT_TYPE_FLOAT, {.dbl=0.}, -2, 2, .flags=FLAGS },
65 { "fillcolor", "set background fill color", OFFSET(fillcolor_str), AV_OPT_TYPE_STRING, {.str="black"}, 0, 0, .flags=FLAGS },
66 { "c", "set background fill color", OFFSET(fillcolor_str), AV_OPT_TYPE_STRING, {.str="black"}, 0, 0, .flags=FLAGS },
67 { "interp", "set interpolation", OFFSET(interp), AV_OPT_TYPE_INT, {.i64=1}, 0, 1, .flags=FLAGS, .unit = "interp" },
68 { "nearest", "nearest neighbour", 0, AV_OPT_TYPE_CONST, {.i64=0}, 0, 0, .flags=FLAGS, .unit = "interp" },
69 { "bilinear", "bilinear", 0, AV_OPT_TYPE_CONST, {.i64=1}, 0, 0, .flags=FLAGS, .unit = "interp" },
70 { NULL }
71 };
72
73 AVFILTER_DEFINE_CLASS(shear);
74
75 ✗ static av_cold int init(AVFilterContext *ctx)
76 {
77 ✗ ShearContext *s = ctx->priv;
78
79 ✗ if (!strcmp(s->fillcolor_str, "none"))
80 ✗ s->fillcolor_enable = 0;
81 ✗ else if (av_parse_color(s->fillcolor, s->fillcolor_str, -1, ctx) >= 0)
82 ✗ s->fillcolor_enable = 1;
83 else
84 ✗ return AVERROR(EINVAL);
85 ✗ return 0;
86 }
87
88 static const enum AVPixelFormat pix_fmts[] = {
89 AV_PIX_FMT_GRAY8, AV_PIX_FMT_GRAY9,
90 AV_PIX_FMT_GRAY10, AV_PIX_FMT_GRAY12, AV_PIX_FMT_GRAY14,
91 AV_PIX_FMT_GRAY16,
92 AV_PIX_FMT_YUV410P, AV_PIX_FMT_YUV411P,
93 AV_PIX_FMT_YUV420P, AV_PIX_FMT_YUV422P,
94 AV_PIX_FMT_YUV440P, AV_PIX_FMT_YUV444P,
95 AV_PIX_FMT_YUVJ420P, AV_PIX_FMT_YUVJ422P,
96 AV_PIX_FMT_YUVJ440P, AV_PIX_FMT_YUVJ444P,
97 AV_PIX_FMT_YUVJ411P,
98 AV_PIX_FMT_YUV420P9, AV_PIX_FMT_YUV422P9, AV_PIX_FMT_YUV444P9,
99 AV_PIX_FMT_YUV420P10, AV_PIX_FMT_YUV422P10, AV_PIX_FMT_YUV444P10,
100 AV_PIX_FMT_YUV440P10,
101 AV_PIX_FMT_YUV444P12, AV_PIX_FMT_YUV422P12, AV_PIX_FMT_YUV420P12,
102 AV_PIX_FMT_YUV440P12,
103 AV_PIX_FMT_YUV444P14, AV_PIX_FMT_YUV422P14, AV_PIX_FMT_YUV420P14,
104 AV_PIX_FMT_YUV420P16, AV_PIX_FMT_YUV422P16, AV_PIX_FMT_YUV444P16,
105 AV_PIX_FMT_GBRP, AV_PIX_FMT_GBRP9, AV_PIX_FMT_GBRP10,
106 AV_PIX_FMT_GBRP12, AV_PIX_FMT_GBRP14, AV_PIX_FMT_GBRP16,
107 AV_PIX_FMT_YUVA420P, AV_PIX_FMT_YUVA422P, AV_PIX_FMT_YUVA444P,
108 AV_PIX_FMT_YUVA444P9, AV_PIX_FMT_YUVA444P10, AV_PIX_FMT_YUVA444P12, AV_PIX_FMT_YUVA444P16,
109 AV_PIX_FMT_YUVA422P9, AV_PIX_FMT_YUVA422P10, AV_PIX_FMT_YUVA422P12, AV_PIX_FMT_YUVA422P16,
110 AV_PIX_FMT_YUVA420P9, AV_PIX_FMT_YUVA420P10, AV_PIX_FMT_YUVA420P16,
111 AV_PIX_FMT_GBRAP, AV_PIX_FMT_GBRAP10, AV_PIX_FMT_GBRAP12, AV_PIX_FMT_GBRAP16,
112 AV_PIX_FMT_NONE
113 };
114
115 #define NN(type, name) \
116 static int filter_slice_nn##name(AVFilterContext *ctx, void *arg, int jobnr, \
117 int nb_jobs) \
118 { \
119 ThreadData *td = arg; \
120 AVFrame *in = td->in; \
121 AVFrame *out = td->out; \
122 ShearContext *s = ctx->priv; \
123 const float shx = s->shx; \
124 const float shy = s->shy; \
125 \
126 for (int p = 0; p < s->nb_planes; p++) { \
127 const int hsub = (p == 1 || p == 2) ? s->hsub: 1; \
128 const int vsub = (p == 1 || p == 2) ? s->vsub: 1; \
129 const int width = s->planewidth[p]; \
130 const int height = s->planeheight[p]; \
131 const int wx = vsub * shx * height * 0.5f / hsub; \
132 const int wy = hsub * shy * width * 0.5f / vsub; \
133 const int slice_start = (height * jobnr) / nb_jobs; \
134 const int slice_end = (height * (jobnr+1)) / nb_jobs; \
135 const int src_linesize = in->linesize[p] / sizeof(type); \
136 const int dst_linesize = out->linesize[p] / sizeof(type); \
137 const type *src = (const type *)in->data[p]; \
138 type *dst = (type *)out->data[p] + slice_start * dst_linesize; \
139 \
140 for (int y = slice_start; y < slice_end; y++) { \
141 for (int x = 0; x < width; x++) { \
142 int sx = x + vsub * shx * y / hsub - wx; \
143 int sy = y + hsub * shy * x / vsub - wy; \
144 \
145 if (sx >= 0 && sx < width - 1 && \
146 sy >= 0 && sy < height - 1) { \
147 dst[x] = src[sy * src_linesize + sx]; \
148 } \
149 } \
150 \
151 dst += dst_linesize; \
152 } \
153 } \
154 \
155 return 0; \
156 }
157
158 ✗ NN(uint8_t, 8)
159 ✗ NN(uint16_t, 16)
160
161 #define BL(type, name) \
162 static int filter_slice_bl##name(AVFilterContext *ctx, void *arg, int jobnr, \
163 int nb_jobs) \
164 { \
165 ThreadData *td = arg; \
166 AVFrame *in = td->in; \
167 AVFrame *out = td->out; \
168 ShearContext *s = ctx->priv; \
169 const int depth = s->depth; \
170 const float shx = s->shx; \
171 const float shy = s->shy; \
172 \
173 for (int p = 0; p < s->nb_planes; p++) { \
174 const int hsub = (p == 1 || p == 2) ? s->hsub: 1; \
175 const int vsub = (p == 1 || p == 2) ? s->vsub: 1; \
176 const int width = s->planewidth[p]; \
177 const int height = s->planeheight[p]; \
178 const float wx = vsub * shx * height * 0.5f / hsub; \
179 const float wy = hsub * shy * width * 0.5f / vsub; \
180 const int slice_start = (height * jobnr) / nb_jobs; \
181 const int slice_end = (height * (jobnr+1)) / nb_jobs; \
182 const int src_linesize = in->linesize[p] / sizeof(type); \
183 const int dst_linesize = out->linesize[p] / sizeof(type); \
184 const type *src = (const type *)in->data[p]; \
185 type *dst = (type *)out->data[p] + slice_start * dst_linesize; \
186 \
187 for (int y = slice_start; y < slice_end; y++) { \
188 for (int x = 0; x < width; x++) { \
189 const float sx = x + vsub * shx * y / hsub - wx; \
190 const float sy = y + hsub * shy * x / vsub - wy; \
191 \
192 if (sx >= 0 && sx < width - 1 && \
193 sy >= 0 && sy < height - 1) { \
194 float sum = 0.f; \
195 int ax = floorf(sx); \
196 int ay = floorf(sy); \
197 float du = sx - ax; \
198 float dv = sy - ay; \
199 int bx = FFMIN(ax + 1, width - 1); \
200 int by = FFMIN(ay + 1, height - 1); \
201 \
202 sum += (1.f - du) * (1.f - dv) * src[ay * src_linesize + ax];\
203 sum += ( du) * (1.f - dv) * src[ay * src_linesize + bx];\
204 sum += (1.f - du) * ( dv) * src[by * src_linesize + ax];\
205 sum += ( du) * ( dv) * src[by * src_linesize + bx];\
206 dst[x] = av_clip_uintp2_c(lrintf(sum), depth); \
207 } \
208 } \
209 \
210 dst += dst_linesize; \
211 } \
212 } \
213 \
214 return 0; \
215 }
216
217 ✗ BL(uint8_t, 8)
218 ✗ BL(uint16_t, 16)
219
220 ✗ static int filter_frame(AVFilterLink *inlink, AVFrame *in)
221 {
222 ✗ AVFilterContext *ctx = inlink->dst;
223 ✗ ShearContext *s = ctx->priv;
224 ✗ AVFilterLink *outlink = ctx->outputs[0];
225 ThreadData td;
226 AVFrame *out;
227
228 ✗ out = ff_get_video_buffer(outlink, outlink->w, outlink->h);
229 ✗ if (!out) {
230 ✗ av_frame_free(&in);
231 ✗ return AVERROR(ENOMEM);
232 }
233 ✗ av_frame_copy_props(out, in);
234
235 /* fill background */
236 ✗ if (s->fillcolor_enable)
237 ✗ ff_fill_rectangle(&s->draw, &s->color, out->data, out->linesize,
238 0, 0, outlink->w, outlink->h);
239
240 ✗ td.in = in, td.out = out;
241 ✗ ff_filter_execute(ctx, s->filter_slice[s->interp], &td, NULL,
242 ✗ FFMIN(s->planeheight[1], ff_filter_get_nb_threads(ctx)));
243
244 ✗ av_frame_free(&in);
245 ✗ return ff_filter_frame(outlink, out);
246 }
247
248 ✗ static int config_output(AVFilterLink *outlink)
249 {
250 ✗ AVFilterContext *ctx = outlink->src;
251 ✗ ShearContext *s = ctx->priv;
252 ✗ const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(outlink->format);
253 int ret;
254
255 ✗ s->nb_planes = av_pix_fmt_count_planes(outlink->format);
256 ✗ s->depth = desc->comp[0].depth;
257 ✗ s->hsub = 1 << desc->log2_chroma_w;
258 ✗ s->vsub = 1 << desc->log2_chroma_h;
259 ✗ s->planewidth[1] = s->planewidth[2] = AV_CEIL_RSHIFT(ctx->inputs[0]->w, desc->log2_chroma_w);
260 ✗ s->planewidth[0] = s->planewidth[3] = ctx->inputs[0]->w;
261 ✗ s->planeheight[1] = s->planeheight[2] = AV_CEIL_RSHIFT(ctx->inputs[0]->h, desc->log2_chroma_h);
262 ✗ s->planeheight[0] = s->planeheight[3] = ctx->inputs[0]->h;
263
264 ✗ ret = ff_draw_init_from_link(&s->draw, outlink, 0);
265 ✗ if (ret < 0) {
266 ✗ av_log(ctx, AV_LOG_ERROR, "Failed to initialize FFDrawContext\n");
267 ✗ return ret;
268 }
269 ✗ ff_draw_color(&s->draw, &s->color, s->fillcolor);
270
271 ✗ s->filter_slice[0] = s->depth <= 8 ? filter_slice_nn8 : filter_slice_nn16;
272 ✗ s->filter_slice[1] = s->depth <= 8 ? filter_slice_bl8 : filter_slice_bl16;
273
274 ✗ return 0;
275 }
276
277 ✗ static int process_command(AVFilterContext *ctx,
278 const char *cmd,
279 const char *arg,
280 char *res,
281 int res_len,
282 int flags)
283 {
284 ✗ ShearContext *s = ctx->priv;
285 int ret;
286
287 ✗ ret = ff_filter_process_command(ctx, cmd, arg, res, res_len, flags);
288 ✗ if (ret < 0)
289 ✗ return ret;
290
291 ✗ ret = init(ctx);
292 ✗ if (ret < 0)
293 ✗ return ret;
294 ✗ ff_draw_color(&s->draw, &s->color, s->fillcolor);
295
296 ✗ return 0;
297 }
298
299 static const AVFilterPad inputs[] = {
300 {
301 .name = "default",
302 .type = AVMEDIA_TYPE_VIDEO,
303 .filter_frame = filter_frame,
304 },
305 };
306
307 static const AVFilterPad outputs[] = {
308 {
309 .name = "default",
310 .type = AVMEDIA_TYPE_VIDEO,
311 .config_props = config_output,
312 },
313 };
314
315 const FFFilter ff_vf_shear = {
316 .p.name = "shear",
317 .p.description = NULL_IF_CONFIG_SMALL("Shear transform the input image."),
318 .p.priv_class = &shear_class,
319 .p.flags = AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC | AVFILTER_FLAG_SLICE_THREADS,
320 .priv_size = sizeof(ShearContext),
321 .init = init,
322 FILTER_INPUTS(inputs),
323 FILTER_OUTPUTS(outputs),
324 FILTER_PIXFMTS_ARRAY(pix_fmts),
325 .process_command = process_command,
326 };
327