FFmpeg coverage

Directory: ../../../ffmpeg/
File: src/libavfilter/vf_il.c
Date: 2026-04-20 20:24:43
Exec Total Coverage
Lines: 42 55 76.4%
Functions: 4 4 100.0%
Branches: 9 18 50.0%
Line Branch Exec Source
1 /*
2 * Copyright (c) 2002 Michael Niedermayer <michaelni@gmx.at>
3 * Copyright (c) 2013 Paul B Mahol
4 *
5 * This file is part of FFmpeg.
6 *
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
11 *
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
21
22 /**
23 * @file
24 * (de)interleave fields filter
25 */
26
27 #include "libavutil/opt.h"
28 #include "libavutil/imgutils.h"
29 #include "libavutil/pixdesc.h"
30 #include "avfilter.h"
31 #include "filters.h"
32 #include "formats.h"
33 #include "video.h"
34
35 enum FilterMode {
36 MODE_NONE,
37 MODE_INTERLEAVE,
38 MODE_DEINTERLEAVE
39 };
40
41 typedef struct IlContext {
42 const AVClass *class;
43 int luma_mode, chroma_mode, alpha_mode; ///<FilterMode
44 int luma_swap, chroma_swap, alpha_swap;
45 int nb_planes;
46 int linesize[4], chroma_height;
47 int has_alpha;
48 } IlContext;
49
50 #define OFFSET(x) offsetof(IlContext, x)
51 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_RUNTIME_PARAM
52
53 static const AVOption il_options[] = {
54 {"luma_mode", "select luma mode", OFFSET(luma_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, .unit = "luma_mode"},
55 {"l", "select luma mode", OFFSET(luma_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, .unit = "luma_mode"},
56 {"none", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_NONE}, 0, 0, FLAGS, .unit = "luma_mode"},
57 {"interleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, .unit = "luma_mode"},
58 {"i", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, .unit = "luma_mode"},
59 {"deinterleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, .unit = "luma_mode"},
60 {"d", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, .unit = "luma_mode"},
61 {"chroma_mode", "select chroma mode", OFFSET(chroma_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, .unit = "chroma_mode"},
62 {"c", "select chroma mode", OFFSET(chroma_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, .unit = "chroma_mode"},
63 {"none", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_NONE}, 0, 0, FLAGS, .unit = "chroma_mode"},
64 {"interleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, .unit = "chroma_mode"},
65 {"i", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, .unit = "chroma_mode"},
66 {"deinterleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, .unit = "chroma_mode"},
67 {"d", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, .unit = "chroma_mode"},
68 {"alpha_mode", "select alpha mode", OFFSET(alpha_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, .unit = "alpha_mode"},
69 {"a", "select alpha mode", OFFSET(alpha_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, .unit = "alpha_mode"},
70 {"none", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_NONE}, 0, 0, FLAGS, .unit = "alpha_mode"},
71 {"interleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, .unit = "alpha_mode"},
72 {"i", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, .unit = "alpha_mode"},
73 {"deinterleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, .unit = "alpha_mode"},
74 {"d", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, .unit = "alpha_mode"},
75 {"luma_swap", "swap luma fields", OFFSET(luma_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
76 {"ls", "swap luma fields", OFFSET(luma_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
77 {"chroma_swap", "swap chroma fields", OFFSET(chroma_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
78 {"cs", "swap chroma fields", OFFSET(chroma_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
79 {"alpha_swap", "swap alpha fields", OFFSET(alpha_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
80 {"as", "swap alpha fields", OFFSET(alpha_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
81 {NULL}
82 };
83
84 AVFILTER_DEFINE_CLASS(il);
85
86 203 static int query_formats(const AVFilterContext *ctx,
87 AVFilterFormatsConfig **cfg_in,
88 AVFilterFormatsConfig **cfg_out)
89 {
90 203 int reject_flags = AV_PIX_FMT_FLAG_PAL | AV_PIX_FMT_FLAG_HWACCEL;
91
92 203 return ff_set_common_formats2(ctx, cfg_in, cfg_out,
93 ff_formats_pixdesc_filter(0, reject_flags));
94 }
95
96 202 static int config_input(AVFilterLink *inlink)
97 {
98 202 IlContext *s = inlink->dst->priv;
99 202 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
100 int ret;
101
102 202 s->nb_planes = av_pix_fmt_count_planes(inlink->format);
103
104 202 s->has_alpha = !!(desc->flags & AV_PIX_FMT_FLAG_ALPHA);
105
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 202 times.
 202 if ((ret = av_image_fill_linesizes(s->linesize, inlink->format, inlink->w)) < 0)
106 ✗ return ret;
107
108 202 s->chroma_height = AV_CEIL_RSHIFT(inlink->h, desc->log2_chroma_h);
109
110 202 return 0;
111 }
112
113 966 static void interleave(uint8_t *dst, uint8_t *src, int w, int h,
114 int dst_linesize, int src_linesize,
115 enum FilterMode mode, int swap)
116 {
117 966 const int a = swap;
118 966 const int b = 1 - a;
119 966 const int m = h >> 1;
120 int y;
121
122
1/4
✓ Branch 0 taken 966 times.
✗ Branch 1 not taken.
✗ Branch 2 not taken.
✗ Branch 3 not taken.
 966 switch (mode) {
123 966 case MODE_DEINTERLEAVE:
124
2/2
✓ Branch 0 taken 130320 times.
✓ Branch 1 taken 966 times.
 131286 for (y = 0; y < m; y++) {
125 130320 memcpy(dst + dst_linesize * y , src + src_linesize * (y * 2 + a), w);
126 130320 memcpy(dst + dst_linesize * (y + m), src + src_linesize * (y * 2 + b), w);
127 }
128 966 break;
129 ✗ case MODE_NONE:
130 ✗ for (y = 0; y < m; y++) {
131 ✗ memcpy(dst + dst_linesize * y * 2 , src + src_linesize * (y * 2 + a), w);
132 ✗ memcpy(dst + dst_linesize * (y * 2 + 1), src + src_linesize * (y * 2 + b), w);
133 }
134 ✗ break;
135 ✗ case MODE_INTERLEAVE:
136 ✗ for (y = 0; y < m; y++) {
137 ✗ memcpy(dst + dst_linesize * (y * 2 + a), src + src_linesize * y , w);
138 ✗ memcpy(dst + dst_linesize * (y * 2 + b), src + src_linesize * (y + m), w);
139 }
140 ✗ break;
141 }
142 966 }
143
144 404 static int filter_frame(AVFilterLink *inlink, AVFrame *inpicref)
145 {
146 404 IlContext *s = inlink->dst->priv;
147 404 AVFilterLink *outlink = inlink->dst->outputs[0];
148 AVFrame *out;
149 int comp;
150
151 404 out = ff_get_video_buffer(outlink, outlink->w, outlink->h);
152
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 404 times.
 404 if (!out) {
153 ✗ av_frame_free(&inpicref);
154 ✗ return AVERROR(ENOMEM);
155 }
156 404 av_frame_copy_props(out, inpicref);
157
158 404 interleave(out->data[0], inpicref->data[0],
159 s->linesize[0], inlink->h,
160 404 out->linesize[0], inpicref->linesize[0],
161 404 s->luma_mode, s->luma_swap);
162
163
2/2
✓ Branch 0 taken 458 times.
✓ Branch 1 taken 404 times.
 862 for (comp = 1; comp < (s->nb_planes - s->has_alpha); comp++) {
164 458 interleave(out->data[comp], inpicref->data[comp],
165 s->linesize[comp], s->chroma_height,
166 458 out->linesize[comp], inpicref->linesize[comp],
167 458 s->chroma_mode, s->chroma_swap);
168 }
169
170
2/2
✓ Branch 0 taken 104 times.
✓ Branch 1 taken 300 times.
 404 if (s->has_alpha) {
171 104 comp = s->nb_planes - 1;
172 104 interleave(out->data[comp], inpicref->data[comp],
173 s->linesize[comp], inlink->h,
174 104 out->linesize[comp], inpicref->linesize[comp],
175 104 s->alpha_mode, s->alpha_swap);
176 }
177
178 404 av_frame_free(&inpicref);
179 404 return ff_filter_frame(outlink, out);
180 }
181
182 static const AVFilterPad inputs[] = {
183 {
184 .name = "default",
185 .type = AVMEDIA_TYPE_VIDEO,
186 .filter_frame = filter_frame,
187 .config_props = config_input,
188 },
189 };
190
191 const FFFilter ff_vf_il = {
192 .p.name = "il",
193 .p.description = NULL_IF_CONFIG_SMALL("Deinterleave or interleave fields."),
194 .p.priv_class = &il_class,
195 .p.flags = AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC,
196 .priv_size = sizeof(IlContext),
197 FILTER_INPUTS(inputs),
198 FILTER_OUTPUTS(ff_video_default_filterpad),
199 FILTER_QUERY_FUNC2(query_formats),
200 .process_command = ff_filter_process_command,
201 };
202