FFmpeg  4.0
vf_il.c
Go to the documentation of this file.
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 "internal.h"
32 
33 enum FilterMode {
37 };
38 
39 typedef struct IlContext {
40  const AVClass *class;
41  int luma_mode, chroma_mode, alpha_mode; ///<FilterMode
43  int nb_planes;
45  int has_alpha;
46 } IlContext;
47 
48 #define OFFSET(x) offsetof(IlContext, x)
49 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
50 
51 static const AVOption il_options[] = {
52  {"luma_mode", "select luma mode", OFFSET(luma_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, "luma_mode"},
53  {"l", "select luma mode", OFFSET(luma_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, "luma_mode"},
54  {"none", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_NONE}, 0, 0, FLAGS, "luma_mode"},
55  {"interleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, "luma_mode"},
56  {"i", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, "luma_mode"},
57  {"deinterleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, "luma_mode"},
58  {"d", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, "luma_mode"},
59  {"chroma_mode", "select chroma mode", OFFSET(chroma_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, "chroma_mode"},
60  {"c", "select chroma mode", OFFSET(chroma_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, "chroma_mode"},
61  {"none", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_NONE}, 0, 0, FLAGS, "chroma_mode"},
62  {"interleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, "chroma_mode"},
63  {"i", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, "chroma_mode"},
64  {"deinterleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, "chroma_mode"},
65  {"d", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, "chroma_mode"},
66  {"alpha_mode", "select alpha mode", OFFSET(alpha_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, "alpha_mode"},
67  {"a", "select alpha mode", OFFSET(alpha_mode), AV_OPT_TYPE_INT, {.i64=MODE_NONE}, MODE_NONE, MODE_DEINTERLEAVE, FLAGS, "alpha_mode"},
68  {"none", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_NONE}, 0, 0, FLAGS, "alpha_mode"},
69  {"interleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, "alpha_mode"},
70  {"i", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_INTERLEAVE}, 0, 0, FLAGS, "alpha_mode"},
71  {"deinterleave", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, "alpha_mode"},
72  {"d", NULL, 0, AV_OPT_TYPE_CONST, {.i64=MODE_DEINTERLEAVE}, 0, 0, FLAGS, "alpha_mode"},
73  {"luma_swap", "swap luma fields", OFFSET(luma_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
74  {"ls", "swap luma fields", OFFSET(luma_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
75  {"chroma_swap", "swap chroma fields", OFFSET(chroma_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
76  {"cs", "swap chroma fields", OFFSET(chroma_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
77  {"alpha_swap", "swap alpha fields", OFFSET(alpha_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
78  {"as", "swap alpha fields", OFFSET(alpha_swap), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
79  {NULL}
80 };
81 
83 
85 {
87  int fmt, ret;
88 
89  for (fmt = 0; av_pix_fmt_desc_get(fmt); fmt++) {
91  if (!(desc->flags & AV_PIX_FMT_FLAG_PAL) &&
92  !(desc->flags & AV_PIX_FMT_FLAG_HWACCEL) &&
93  (ret = ff_add_format(&formats, fmt)) < 0)
94  return ret;
95  }
96 
97  return ff_set_common_formats(ctx, formats);
98 }
99 
100 static int config_input(AVFilterLink *inlink)
101 {
102  IlContext *s = inlink->dst->priv;
104  int ret;
105 
107 
108  s->has_alpha = !!(desc->flags & AV_PIX_FMT_FLAG_ALPHA);
109  if ((ret = av_image_fill_linesizes(s->linesize, inlink->format, inlink->w)) < 0)
110  return ret;
111 
112  s->chroma_height = AV_CEIL_RSHIFT(inlink->h, desc->log2_chroma_h);
113 
114  return 0;
115 }
116 
117 static void interleave(uint8_t *dst, uint8_t *src, int w, int h,
118  int dst_linesize, int src_linesize,
119  enum FilterMode mode, int swap)
120 {
121  const int a = swap;
122  const int b = 1 - a;
123  const int m = h >> 1;
124  int y;
125 
126  switch (mode) {
127  case MODE_DEINTERLEAVE:
128  for (y = 0; y < m; y++) {
129  memcpy(dst + dst_linesize * y , src + src_linesize * (y * 2 + a), w);
130  memcpy(dst + dst_linesize * (y + m), src + src_linesize * (y * 2 + b), w);
131  }
132  break;
133  case MODE_NONE:
134  for (y = 0; y < m; y++) {
135  memcpy(dst + dst_linesize * y * 2 , src + src_linesize * (y * 2 + a), w);
136  memcpy(dst + dst_linesize * (y * 2 + 1), src + src_linesize * (y * 2 + b), w);
137  }
138  break;
139  case MODE_INTERLEAVE:
140  for (y = 0; y < m; y++) {
141  memcpy(dst + dst_linesize * (y * 2 + a), src + src_linesize * y , w);
142  memcpy(dst + dst_linesize * (y * 2 + b), src + src_linesize * (y + m), w);
143  }
144  break;
145  }
146 }
147 
148 static int filter_frame(AVFilterLink *inlink, AVFrame *inpicref)
149 {
150  IlContext *s = inlink->dst->priv;
151  AVFilterLink *outlink = inlink->dst->outputs[0];
152  AVFrame *out;
153  int comp;
154 
155  out = ff_get_video_buffer(outlink, outlink->w, outlink->h);
156  if (!out) {
157  av_frame_free(&inpicref);
158  return AVERROR(ENOMEM);
159  }
160  av_frame_copy_props(out, inpicref);
161 
162  interleave(out->data[0], inpicref->data[0],
163  s->linesize[0], inlink->h,
164  out->linesize[0], inpicref->linesize[0],
165  s->luma_mode, s->luma_swap);
166 
167  for (comp = 1; comp < (s->nb_planes - s->has_alpha); comp++) {
168  interleave(out->data[comp], inpicref->data[comp],
169  s->linesize[comp], s->chroma_height,
170  out->linesize[comp], inpicref->linesize[comp],
171  s->chroma_mode, s->chroma_swap);
172  }
173 
174  if (s->has_alpha) {
175  comp = s->nb_planes - 1;
176  interleave(out->data[comp], inpicref->data[comp],
177  s->linesize[comp], inlink->h,
178  out->linesize[comp], inpicref->linesize[comp],
179  s->alpha_mode, s->alpha_swap);
180  }
181 
182  av_frame_free(&inpicref);
183  return ff_filter_frame(outlink, out);
184 }
185 
186 static const AVFilterPad inputs[] = {
187  {
188  .name = "default",
189  .type = AVMEDIA_TYPE_VIDEO,
190  .filter_frame = filter_frame,
191  .config_props = config_input,
192  },
193  { NULL }
194 };
195 
196 static const AVFilterPad outputs[] = {
197  {
198  .name = "default",
199  .type = AVMEDIA_TYPE_VIDEO,
200  },
201  { NULL }
202 };
203 
205  .name = "il",
206  .description = NULL_IF_CONFIG_SMALL("Deinterleave or interleave fields."),
207  .priv_size = sizeof(IlContext),
209  .inputs = inputs,
210  .outputs = outputs,
211  .priv_class = &il_class,
213 };
#define AV_PIX_FMT_FLAG_PAL
Pixel format has a palette in data[1], values are indexes in this palette.
Definition: pixdesc.h:132
#define NULL
Definition: coverity.c:32
const char * s
Definition: avisynth_c.h:768
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2363
int alpha_mode
FilterMode.
Definition: vf_il.c:41
This structure describes decoded (raw) audio or video data.
Definition: frame.h:218
static int query_formats(AVFilterContext *ctx)
Definition: vf_il.c:84
AVOption.
Definition: opt.h:246
const char * fmt
Definition: avisynth_c.h:769
misc image utilities
int av_pix_fmt_count_planes(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2403
Main libavfilter public API header.
const char * desc
Definition: nvenc.c:65
const char * b
Definition: vf_curves.c:113
AVFrame * ff_get_video_buffer(AVFilterLink *link, int w, int h)
Request a picture buffer with a specific set of permissions.
Definition: video.c:99
#define src
Definition: vp8dsp.c:254
AVFILTER_DEFINE_CLASS(il)
#define AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC
Some filters support a generic "enable" expression option that can be used to enable or disable a fil...
Definition: avfilter.h:125
const char * name
Pad name.
Definition: internal.h:60
static void interleave(uint8_t *dst, uint8_t *src, int w, int h, int dst_linesize, int src_linesize, enum FilterMode mode, int swap)
Definition: vf_il.c:117
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1080
int chroma_swap
Definition: vf_il.c:42
uint8_t
#define AV_PIX_FMT_FLAG_ALPHA
The pixel format has an alpha channel.
Definition: pixdesc.h:181
AVOptions.
static const AVOption il_options[]
Definition: vf_il.c:51
static int flags
Definition: log.c:55
int luma_swap
Definition: vf_il.c:42
static int config_input(AVFilterLink *inlink)
Definition: vf_il.c:100
A filter pad used for either input or output.
Definition: internal.h:54
int chroma_mode
Definition: vf_il.c:41
int ff_set_common_formats(AVFilterContext *ctx, AVFilterFormats *formats)
A helper for query_formats() which sets all links to the same list of formats.
Definition: formats.c:568
uint8_t log2_chroma_h
Amount to shift the luma height right to find the chroma height.
Definition: pixdesc.h:101
#define AVERROR(e)
Definition: error.h:43
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:202
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:186
void * priv
private data for use by the filter
Definition: avfilter.h:353
#define AV_PIX_FMT_FLAG_HWACCEL
Pixel format is an HW accelerated format.
Definition: pixdesc.h:140
int ff_add_format(AVFilterFormats **avff, int64_t fmt)
Add fmt to the list of media formats contained in *avff.
Definition: formats.c:337
uint64_t flags
Combination of AV_PIX_FMT_FLAG_...
Definition: pixdesc.h:106
int nb_planes
Definition: vf_il.c:43
int luma_mode
Definition: vf_il.c:41
uint8_t w
Definition: llviddspenc.c:38
AVFormatContext * ctx
Definition: movenc.c:48
int linesize[4]
Definition: vf_il.c:44
static const AVFilterPad outputs[]
Definition: vf_il.c:196
static void comp(unsigned char *dst, ptrdiff_t dst_stride, unsigned char *src, ptrdiff_t src_stride, int add)
Definition: eamad.c:83
FilterMode
Definition: vp9.h:64
int alpha_swap
Definition: vf_il.c:42
#define FLAGS
Definition: vf_il.c:49
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:249
AVFilter ff_vf_il
Definition: vf_il.c:204
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
Definition: pixdesc.h:81
Describe the class of an AVClass context structure.
Definition: log.h:67
Filter definition.
Definition: avfilter.h:144
int av_image_fill_linesizes(int linesizes[4], enum AVPixelFormat pix_fmt, int width)
Fill plane linesizes for an image with pixel format pix_fmt and width width.
Definition: imgutils.c:89
const char * name
Filter name.
Definition: avfilter.h:148
AVFilterLink ** outputs
array of pointers to output links
Definition: avfilter.h:350
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:232
#define OFFSET(x)
Definition: vf_il.c:48
int has_alpha
Definition: vf_il.c:45
int chroma_height
Definition: vf_il.c:44
A list of supported formats for one end of a filter link.
Definition: formats.h:64
An instance of a filter.
Definition: avfilter.h:338
FILE * out
Definition: movenc.c:54
formats
Definition: signature.h:48
internal API functions
static const AVFilterPad inputs[]
Definition: vf_il.c:186
mode
Use these values in ebur128_init (or&#39;ed).
Definition: ebur128.h:83
static int filter_frame(AVFilterLink *inlink, AVFrame *inpicref)
Definition: vf_il.c:148
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
Definition: frame.c:652
#define AV_CEIL_RSHIFT(a, b)
Definition: common.h:58