FFmpeg coverage

Directory: ../../../ffmpeg/
File: src/libavfilter/vf_limitdiff.c
Date: 2025-11-02 12:19:36
Exec Total Coverage
Lines: 0 167 0.0%
Functions: 0 9 0.0%
Branches: 0 66 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/imgutils.h"
22 #include "libavutil/pixdesc.h"
23 #include "libavutil/opt.h"
24 #include "avfilter.h"
25 #include "filters.h"
26 #include "video.h"
27 #include "framesync.h"
28
29 typedef struct ThreadData {
30 AVFrame *filtered, *source, *reference, *dst;
31 } ThreadData;
32
33 typedef struct LimitDiffContext {
34 const AVClass *class;
35
36 float threshold;
37 float elasticity;
38 int reference;
39 int planes;
40
41 int thr1, thr2;
42
43 int linesize[4];
44 int planewidth[4], planeheight[4];
45 int nb_planes;
46 int depth;
47 FFFrameSync fs;
48
49 void (*limitdiff)(const uint8_t *filtered, uint8_t *dst,
50 const uint8_t *source, const uint8_t *reference,
51 int thr1, int thr2, int w, int depth);
52 } LimitDiffContext;
53
54 #define OFFSET(x) offsetof(LimitDiffContext, x)
55 #define TFLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_RUNTIME_PARAM
56 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
57
58 static const AVOption limitdiff_options[] = {
59 { "threshold", "set the threshold", OFFSET(threshold), AV_OPT_TYPE_FLOAT, {.dbl=1/255.f}, 0, 1, TFLAGS },
60 { "elasticity", "set the elasticity", OFFSET(elasticity), AV_OPT_TYPE_FLOAT, {.dbl=2.f}, 0, 10, TFLAGS },
61 { "reference", "enable reference stream", OFFSET(reference), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
62 { "planes", "set the planes to filter", OFFSET(planes), AV_OPT_TYPE_INT, {.i64=0xF}, 0, 0xF, TFLAGS },
63 { NULL }
64 };
65
66 static const enum AVPixelFormat pix_fmts[] = {
67 AV_PIX_FMT_YUVA444P, AV_PIX_FMT_YUV444P, AV_PIX_FMT_YUV440P,
68 AV_PIX_FMT_YUVJ444P, AV_PIX_FMT_YUVJ440P,
69 AV_PIX_FMT_YUVA422P, AV_PIX_FMT_YUV422P, AV_PIX_FMT_YUVA420P, AV_PIX_FMT_YUV420P,
70 AV_PIX_FMT_YUVJ422P, AV_PIX_FMT_YUVJ420P,
71 AV_PIX_FMT_YUVJ411P, AV_PIX_FMT_YUV411P, AV_PIX_FMT_YUV410P,
72 AV_PIX_FMT_YUV420P9, AV_PIX_FMT_YUV422P9, AV_PIX_FMT_YUV444P9,
73 AV_PIX_FMT_YUV420P10, AV_PIX_FMT_YUV422P10, AV_PIX_FMT_YUV444P10,
74 AV_PIX_FMT_YUV420P12, AV_PIX_FMT_YUV422P12, AV_PIX_FMT_YUV444P12, AV_PIX_FMT_YUV440P12,
75 AV_PIX_FMT_YUV420P14, AV_PIX_FMT_YUV422P14, AV_PIX_FMT_YUV444P14,
76 AV_PIX_FMT_YUV420P16, AV_PIX_FMT_YUV422P16, AV_PIX_FMT_YUV444P16,
77 AV_PIX_FMT_YUVA420P9, AV_PIX_FMT_YUVA422P9, AV_PIX_FMT_YUVA444P9,
78 AV_PIX_FMT_YUVA420P10, AV_PIX_FMT_YUVA422P10, AV_PIX_FMT_YUVA444P10,
79 AV_PIX_FMT_YUVA422P12, AV_PIX_FMT_YUVA444P12,
80 AV_PIX_FMT_YUVA420P16, AV_PIX_FMT_YUVA422P16, AV_PIX_FMT_YUVA444P16,
81 AV_PIX_FMT_GBRP, AV_PIX_FMT_GBRP9, AV_PIX_FMT_GBRP10,
82 AV_PIX_FMT_GBRP12, AV_PIX_FMT_GBRP14, AV_PIX_FMT_GBRP16,
83 AV_PIX_FMT_GBRAP, AV_PIX_FMT_GBRAP10, AV_PIX_FMT_GBRAP12, AV_PIX_FMT_GBRAP16,
84 AV_PIX_FMT_GRAY8, AV_PIX_FMT_GRAY9, AV_PIX_FMT_GRAY10, AV_PIX_FMT_GRAY12, AV_PIX_FMT_GRAY14, AV_PIX_FMT_GRAY16,
85 AV_PIX_FMT_NONE
86 };
87
88 ✗ static void limitdiff8(const uint8_t *filtered, uint8_t *dst,
89 const uint8_t *source, const uint8_t *reference,
90 int thr1, int thr2, int w, int depth)
91 {
92 ✗ for (int x = 0; x < w; x++) {
93 ✗ const int diff = filtered[x] - source[x];
94 ✗ const int diff_ref = FFABS(filtered[x] - reference[x]);
95
96 ✗ if (diff_ref <= thr1)
97 ✗ dst[x] = filtered[x];
98 ✗ else if (diff_ref >= thr2)
99 ✗ dst[x] = source[x];
100 else
101 ✗ dst[x] = av_clip_uint8(source[x] + diff * (thr2 - diff_ref) / (thr2 - thr1));
102 }
103 ✗ }
104
105 ✗ static void limitdiff16(const uint8_t *ffiltered, uint8_t *ddst,
106 const uint8_t *ssource, const uint8_t *rreference,
107 int thr1, int thr2, int w, int depth)
108 {
109 ✗ const uint16_t *source = (const uint16_t *)ssource;
110 ✗ const uint16_t *filtered = (const uint16_t *)ffiltered;
111 ✗ const uint16_t *reference = (const uint16_t *)rreference;
112 ✗ uint16_t *dst = (uint16_t *)ddst;
113
114 ✗ for (int x = 0; x < w; x++) {
115 ✗ const int diff = filtered[x] - source[x];
116 ✗ const int diff_ref = FFABS(filtered[x] - reference[x]);
117
118 ✗ if (diff_ref <= thr1)
119 ✗ dst[x] = filtered[x];
120 ✗ else if (diff_ref >= thr2)
121 ✗ dst[x] = source[x];
122 else
123 ✗ dst[x] = av_clip_uintp2_c(source[x] + diff * (thr2 - diff_ref) / (thr2 - thr1), depth);
124 }
125 ✗ }
126
127 ✗ static int config_input(AVFilterLink *inlink)
128 {
129 ✗ AVFilterContext *ctx = inlink->dst;
130 ✗ LimitDiffContext *s = ctx->priv;
131 ✗ const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
132 int vsub, hsub, ret;
133
134 ✗ s->nb_planes = av_pix_fmt_count_planes(inlink->format);
135
136 ✗ if ((ret = av_image_fill_linesizes(s->linesize, inlink->format, inlink->w)) < 0)
137 ✗ return ret;
138
139 ✗ hsub = desc->log2_chroma_w;
140 ✗ vsub = desc->log2_chroma_h;
141 ✗ s->planeheight[1] = s->planeheight[2] = AV_CEIL_RSHIFT(inlink->h, vsub);
142 ✗ s->planeheight[0] = s->planeheight[3] = inlink->h;
143 ✗ s->planewidth[1] = s->planewidth[2] = AV_CEIL_RSHIFT(inlink->w, hsub);
144 ✗ s->planewidth[0] = s->planewidth[3] = inlink->w;
145
146 ✗ s->depth = desc->comp[0].depth;
147 ✗ s->thr1 = s->threshold * ((1 << s->depth) - 1);
148 ✗ s->thr2 = s->thr1 * s->elasticity;
149
150 ✗ if (desc->comp[0].depth == 8)
151 ✗ s->limitdiff = limitdiff8;
152 else
153 ✗ s->limitdiff = limitdiff16;
154
155 ✗ return 0;
156 }
157
158 ✗ static int limitdiff_slice(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
159 {
160 ✗ LimitDiffContext *s = ctx->priv;
161 ✗ const int depth = s->depth;
162 ✗ ThreadData *td = arg;
163
164 ✗ for (int p = 0; p < s->nb_planes; p++) {
165 ✗ const ptrdiff_t filtered_linesize = td->filtered->linesize[p];
166 ✗ const ptrdiff_t source_linesize = td->source->linesize[p];
167 ✗ const ptrdiff_t reference_linesize = td->reference->linesize[p];
168 ✗ const ptrdiff_t dst_linesize = td->dst->linesize[p];
169 ✗ const int thr1 = s->thr1;
170 ✗ const int thr2 = s->thr2;
171 ✗ const int w = s->planewidth[p];
172 ✗ const int h = s->planeheight[p];
173 ✗ const int slice_start = (h * jobnr) / nb_jobs;
174 ✗ const int slice_end = (h * (jobnr+1)) / nb_jobs;
175 ✗ const uint8_t *filtered = td->filtered->data[p] + slice_start * filtered_linesize;
176 ✗ const uint8_t *source = td->source->data[p] + slice_start * source_linesize;
177 ✗ const uint8_t *reference = td->reference->data[p] + slice_start * reference_linesize;
178 ✗ uint8_t *dst = td->dst->data[p] + slice_start * dst_linesize;
179
180 ✗ if (!((1 << p) & s->planes)) {
181 ✗ av_image_copy_plane(dst, dst_linesize, filtered, filtered_linesize,
182 s->linesize[p], slice_end - slice_start);
183 ✗ continue;
184 }
185
186 ✗ for (int y = slice_start; y < slice_end; y++) {
187 ✗ s->limitdiff(filtered, dst, source, reference, thr1, thr2, w, depth);
188
189 ✗ dst += dst_linesize;
190 ✗ filtered += filtered_linesize;
191 ✗ source += source_linesize;
192 ✗ reference += reference_linesize;
193 }
194 }
195
196 ✗ return 0;
197 }
198
199 ✗ static int process_frame(FFFrameSync *fs)
200 {
201 ✗ AVFilterContext *ctx = fs->parent;
202 ✗ LimitDiffContext *s = fs->opaque;
203 ✗ AVFilterLink *outlink = ctx->outputs[0];
204 ✗ AVFrame *out, *filtered, *source, *reference = NULL;
205 int ret;
206
207 ✗ if ((ret = ff_framesync_get_frame(&s->fs, 0, &filtered, 0)) < 0 ||
208 ✗ (ret = ff_framesync_get_frame(&s->fs, 1, &source, 0)) < 0)
209 ✗ return ret;
210 ✗ if (s->reference) {
211 ✗ if ((ret = ff_framesync_get_frame(&s->fs, 2, &reference, 0)) < 0)
212 ✗ return ret;
213 }
214
215 ✗ if (ctx->is_disabled) {
216 ✗ out = av_frame_clone(filtered);
217 ✗ if (!out)
218 ✗ return AVERROR(ENOMEM);
219 } else {
220 ThreadData td;
221
222 ✗ out = ff_get_video_buffer(outlink, outlink->w, outlink->h);
223 ✗ if (!out)
224 ✗ return AVERROR(ENOMEM);
225 ✗ av_frame_copy_props(out, filtered);
226
227 ✗ td.filtered = filtered;
228 ✗ td.source = source;
229 ✗ td.reference = reference ? reference : source;
230 ✗ td.dst = out;
231
232 ✗ ff_filter_execute(ctx, limitdiff_slice, &td, NULL,
233 ✗ FFMIN(s->planeheight[0], ff_filter_get_nb_threads(ctx)));
234 }
235 ✗ out->pts = av_rescale_q(s->fs.pts, s->fs.time_base, outlink->time_base);
236
237 ✗ return ff_filter_frame(outlink, out);
238 }
239
240 ✗ static int config_output(AVFilterLink *outlink)
241 {
242 ✗ AVFilterContext *ctx = outlink->src;
243 ✗ LimitDiffContext *s = ctx->priv;
244 ✗ AVFilterLink *filtered = ctx->inputs[0];
245 ✗ AVFilterLink *source = ctx->inputs[1];
246 ✗ FilterLink *il = ff_filter_link(filtered);
247 ✗ FilterLink *ol = ff_filter_link(outlink);
248 FFFrameSyncIn *in;
249 int ret;
250
251 ✗ if (filtered->w != source->w || filtered->h != source->h) {
252 ✗ av_log(ctx, AV_LOG_ERROR, "First input link %s parameters "
253 "(size %dx%d) do not match the corresponding "
254 "second input link %s parameters (%dx%d)\n",
255 ✗ ctx->input_pads[0].name, filtered->w, filtered->h,
256 ✗ ctx->input_pads[1].name, source->w, source->h);
257 ✗ return AVERROR(EINVAL);
258 }
259
260 ✗ if (s->reference) {
261 ✗ AVFilterLink *reference = ctx->inputs[2];
262
263 ✗ if (filtered->w != reference->w || filtered->h != reference->h) {
264 ✗ av_log(ctx, AV_LOG_ERROR, "First input link %s parameters "
265 "(size %dx%d) do not match the corresponding "
266 "third input link %s parameters (%dx%d)\n",
267 ✗ ctx->input_pads[0].name, filtered->w, filtered->h,
268 ✗ ctx->input_pads[1].name, reference->w, reference->h);
269 ✗ return AVERROR(EINVAL);
270 }
271 }
272
273 ✗ outlink->w = filtered->w;
274 ✗ outlink->h = filtered->h;
275 ✗ outlink->sample_aspect_ratio = filtered->sample_aspect_ratio;
276 ✗ ol->frame_rate = il->frame_rate;
277
278 ✗ if ((ret = ff_framesync_init(&s->fs, ctx, 2 + !!s->reference)) < 0)
279 ✗ return ret;
280
281 ✗ in = s->fs.in;
282 ✗ in[0].time_base = filtered->time_base;
283 ✗ in[1].time_base = source->time_base;
284 ✗ if (s->reference)
285 ✗ in[2].time_base = ctx->inputs[2]->time_base;
286 ✗ in[0].sync = 1;
287 ✗ in[0].before = EXT_STOP;
288 ✗ in[0].after = EXT_INFINITY;
289 ✗ in[1].sync = 1;
290 ✗ in[1].before = EXT_STOP;
291 ✗ in[1].after = EXT_INFINITY;
292 ✗ if (s->reference) {
293 ✗ in[2].sync = 1;
294 ✗ in[2].before = EXT_STOP;
295 ✗ in[2].after = EXT_INFINITY;
296 }
297 ✗ s->fs.opaque = s;
298 ✗ s->fs.on_event = process_frame;
299
300 ✗ ret = ff_framesync_configure(&s->fs);
301 ✗ outlink->time_base = s->fs.time_base;
302
303 ✗ return ret;
304 }
305
306 ✗ static int activate(AVFilterContext *ctx)
307 {
308 ✗ LimitDiffContext *s = ctx->priv;
309 ✗ return ff_framesync_activate(&s->fs);
310 }
311
312 ✗ static av_cold int init(AVFilterContext *ctx)
313 {
314 ✗ const LimitDiffContext *s = ctx->priv;
315 ✗ AVFilterPad pad = {
316 .name = "filtered",
317 .type = AVMEDIA_TYPE_VIDEO,
318 .config_props = config_input,
319 };
320 int ret;
321
322 ✗ if ((ret = ff_append_inpad(ctx, &pad)) < 0)
323 ✗ return ret;
324
325 ✗ pad.name = "source";
326 ✗ pad.config_props = NULL;
327 ✗ if ((ret = ff_append_inpad(ctx, &pad)) < 0)
328 ✗ return ret;
329
330 ✗ if (s->reference) {
331 ✗ pad.name = "reference";
332 ✗ pad.config_props = NULL;
333 ✗ if ((ret = ff_append_inpad(ctx, &pad)) < 0)
334 ✗ return ret;
335 }
336
337 ✗ return 0;
338 }
339
340 ✗ static av_cold void uninit(AVFilterContext *ctx)
341 {
342 ✗ LimitDiffContext *s = ctx->priv;
343
344 ✗ ff_framesync_uninit(&s->fs);
345 ✗ }
346
347 static const AVFilterPad limitdiff_outputs[] = {
348 {
349 .name = "default",
350 .type = AVMEDIA_TYPE_VIDEO,
351 .config_props = config_output,
352 },
353 };
354
355 AVFILTER_DEFINE_CLASS(limitdiff);
356
357 const FFFilter ff_vf_limitdiff = {
358 .p.name = "limitdiff",
359 .p.description = NULL_IF_CONFIG_SMALL("Apply filtering with limiting difference."),
360 .p.priv_class = &limitdiff_class,
361 .p.flags = AVFILTER_FLAG_SUPPORT_TIMELINE_INTERNAL |
362 AVFILTER_FLAG_SLICE_THREADS |
363 AVFILTER_FLAG_DYNAMIC_INPUTS,
364 .priv_size = sizeof(LimitDiffContext),
365 .init = init,
366 .uninit = uninit,
367 .activate = activate,
368 FILTER_OUTPUTS(limitdiff_outputs),
369 FILTER_PIXFMTS_ARRAY(pix_fmts),
370 .process_command = ff_filter_process_command,
371 };
372