FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
vf_lenscorrection.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2007 Richard Spindler (author of frei0r plugin from which this was derived)
3  * Copyright (C) 2014 Daniel Oberhoff
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  * Lenscorrection filter, algorithm from the frei0r plugin with the same name
25 */
26 #include <stdlib.h>
27 #include <math.h>
28 
29 #include "libavutil/opt.h"
30 #include "libavutil/intreadwrite.h"
31 #include "libavutil/pixdesc.h"
32 
33 #include "avfilter.h"
34 #include "internal.h"
35 #include "video.h"
36 
37 typedef struct LenscorrectionCtx {
38  const AVClass *av_class;
39  unsigned int width;
40  unsigned int height;
41  int hsub, vsub;
42  int nb_planes;
43  double cx, cy, k1, k2;
46 
47 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
48 static const AVOption lenscorrection_options[] = {
49  { "cx", "set relative center x", offsetof(LenscorrectionCtx, cx), AV_OPT_TYPE_DOUBLE, {.dbl=0.5}, 0, 1, .flags=FLAGS },
50  { "cy", "set relative center y", offsetof(LenscorrectionCtx, cy), AV_OPT_TYPE_DOUBLE, {.dbl=0.5}, 0, 1, .flags=FLAGS },
51  { "k1", "set quadratic distortion factor", offsetof(LenscorrectionCtx, k1), AV_OPT_TYPE_DOUBLE, {.dbl=0.0}, -1, 1, .flags=FLAGS },
52  { "k2", "set double quadratic distortion factor", offsetof(LenscorrectionCtx, k2), AV_OPT_TYPE_DOUBLE, {.dbl=0.0}, -1, 1, .flags=FLAGS },
53  { NULL }
54 };
55 
56 AVFILTER_DEFINE_CLASS(lenscorrection);
57 
58 typedef struct ThreadData {
59  AVFrame *in, *out;
60  int w, h;
61  int plane;
64 } ThreadData;
65 
66 static int filter_slice(AVFilterContext *ctx, void *arg, int job, int nb_jobs)
67 {
68  ThreadData *td = (ThreadData*)arg;
69  AVFrame *in = td->in;
70  AVFrame *out = td->out;
71 
72  const int w = td->w, h = td->h;
73  const int xcenter = td->xcenter;
74  const int ycenter = td->ycenter;
75  const int start = (h * job ) / nb_jobs;
76  const int end = (h * (job+1)) / nb_jobs;
77  const int plane = td->plane;
78  const int inlinesize = in->linesize[plane];
79  const int outlinesize = out->linesize[plane];
80  const uint8_t *indata = in->data[plane];
81  uint8_t *outrow = out->data[plane] + start * outlinesize;
82  int i;
83  for (i = start; i < end; i++, outrow += outlinesize) {
84  const int off_y = i - ycenter;
85  uint8_t *out = outrow;
86  int j;
87  for (j = 0; j < w; j++) {
88  const int off_x = j - xcenter;
89  const int64_t radius_mult = td->correction[j + i*w];
90  const int x = xcenter + ((radius_mult * off_x + (1<<23))>>24);
91  const int y = ycenter + ((radius_mult * off_y + (1<<23))>>24);
92  const char isvalid = x > 0 && x < w - 1 && y > 0 && y < h - 1;
93  *out++ = isvalid ? indata[y * inlinesize + x] : 0;
94  }
95  }
96  return 0;
97 }
98 
100 {
101  static const enum AVPixelFormat pix_fmts[] = {
109  };
110  AVFilterFormats *fmts_list = ff_make_format_list(pix_fmts);
111  if (!fmts_list)
112  return AVERROR(ENOMEM);
113  return ff_set_common_formats(ctx, fmts_list);
114 }
115 
117 {
118  LenscorrectionCtx *rect = ctx->priv;
119  int i;
120 
121  for (i = 0; i < FF_ARRAY_ELEMS(rect->correction); i++) {
122  av_freep(&rect->correction[i]);
123  }
124 }
125 
126 static int config_props(AVFilterLink *outlink)
127 {
128  AVFilterContext *ctx = outlink->src;
129  LenscorrectionCtx *rect = ctx->priv;
130  AVFilterLink *inlink = ctx->inputs[0];
131  const AVPixFmtDescriptor *pixdesc = av_pix_fmt_desc_get(inlink->format);
132  rect->hsub = pixdesc->log2_chroma_w;
133  rect->vsub = pixdesc->log2_chroma_h;
134  outlink->w = rect->width = inlink->w;
135  outlink->h = rect->height = inlink->h;
136  rect->nb_planes = av_pix_fmt_count_planes(inlink->format);
137  return 0;
138 }
139 
140 static int filter_frame(AVFilterLink *inlink, AVFrame *in)
141 {
142  AVFilterContext *ctx = inlink->dst;
143  AVFilterLink *outlink = ctx->outputs[0];
145  AVFrame *out = ff_get_video_buffer(outlink, outlink->w, outlink->h);
146  int plane;
147 
148  if (!out) {
149  av_frame_free(&in);
150  return AVERROR(ENOMEM);
151  }
152 
154 
155  for (plane = 0; plane < rect->nb_planes; ++plane) {
156  int hsub = plane == 1 || plane == 2 ? rect->hsub : 0;
157  int vsub = plane == 1 || plane == 2 ? rect->vsub : 0;
158  int hdiv = 1 << hsub;
159  int vdiv = 1 << vsub;
160  int w = rect->width / hdiv;
161  int h = rect->height / vdiv;
162  int xcenter = rect->cx * w;
163  int ycenter = rect->cy * h;
164  int k1 = rect->k1 * (1<<24);
165  int k2 = rect->k2 * (1<<24);
166  ThreadData td = {
167  .in = in,
168  .out = out,
169  .w = w,
170  .h = h,
171  .xcenter = xcenter,
172  .ycenter = ycenter,
173  .plane = plane};
174 
175  if (!rect->correction[plane]) {
176  int i,j;
177  const int64_t r2inv = (4LL<<60) / (w * w + h * h);
178 
179  rect->correction[plane] = av_malloc_array(w, h * sizeof(**rect->correction));
180  if (!rect->correction[plane])
181  return AVERROR(ENOMEM);
182  for (j = 0; j < h; j++) {
183  const int off_y = j - ycenter;
184  const int off_y2 = off_y * off_y;
185  for (i = 0; i < w; i++) {
186  const int off_x = i - xcenter;
187  const int64_t r2 = ((off_x * off_x + off_y2) * r2inv + (1LL<<31)) >> 32;
188  const int64_t r4 = (r2 * r2 + (1<<27)) >> 28;
189  const int radius_mult = (r2 * k1 + r4 * k2 + (1LL<<27) + (1LL<<52))>>28;
190  rect->correction[plane][j * w + i] = radius_mult;
191  }
192  }
193  }
194 
195  td.correction = rect->correction[plane];
196  ctx->internal->execute(ctx, filter_slice, &td, NULL, FFMIN(h, ff_filter_get_nb_threads(ctx)));
197  }
198 
199  av_frame_free(&in);
200  return ff_filter_frame(outlink, out);
201 }
202 
204  {
205  .name = "default",
206  .type = AVMEDIA_TYPE_VIDEO,
207  .filter_frame = filter_frame,
208  },
209  { NULL }
210 };
211 
213  {
214  .name = "default",
215  .type = AVMEDIA_TYPE_VIDEO,
216  .config_props = config_props,
217  },
218  { NULL }
219 };
220 
222  .name = "lenscorrection",
223  .description = NULL_IF_CONFIG_SMALL("Rectify the image by correcting for lens distortion."),
224  .priv_size = sizeof(LenscorrectionCtx),
226  .inputs = lenscorrection_inputs,
227  .outputs = lenscorrection_outputs,
228  .priv_class = &lenscorrection_class,
229  .uninit = uninit,
231 };
int plane
Definition: avisynth_c.h:422
#define NULL
Definition: coverity.c:32
AVFrame * out
Definition: af_sofalizer.c:585
static const AVFilterPad lenscorrection_inputs[]
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2266
This structure describes decoded (raw) audio or video data.
Definition: frame.h:184
AVOption.
Definition: opt.h:245
int32_t * correction[4]
planar YUV 4:4:4, 24bpp, (1 Cr & Cb sample per 1x1 Y samples)
Definition: pixfmt.h:67
int av_pix_fmt_count_planes(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:2306
Main libavfilter public API header.
planar GBR 4:4:4 24bpp
Definition: pixfmt.h:180
int32_t * correction
AVFrame * ff_get_video_buffer(AVFilterLink *link, int w, int h)
Request a picture buffer with a specific set of permissions.
Definition: video.c:76
uint8_t log2_chroma_w
Amount to shift the luma width right to find the chroma width.
Definition: pixdesc.h:92
AVFilterFormats * ff_make_format_list(const int *fmts)
Create a list of supported formats.
Definition: formats.c:283
const char * name
Pad name.
Definition: internal.h:59
AVFilterLink ** inputs
array of pointers to input links
Definition: avfilter.h:315
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1189
AVFrame * in
Definition: af_sofalizer.c:585
planar YUV 4:2:0, 20bpp, (1 Cr & Cb sample per 2x2 Y & A samples)
Definition: pixfmt.h:102
uint8_t
#define av_cold
Definition: attributes.h:82
AVOptions.
static av_cold int end(AVCodecContext *avctx)
Definition: avrndec.c:90
static av_cold void uninit(AVFilterContext *ctx)
int plane
Definition: vf_blend.c:57
A filter pad used for either input or output.
Definition: internal.h:53
static int filter_slice(AVFilterContext *ctx, void *arg, int job, int nb_jobs)
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
#define td
Definition: regdef.h:70
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:158
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:176
void * priv
private data for use by the filter
Definition: avfilter.h:322
#define AVFILTER_FLAG_SLICE_THREADS
The filter supports multithreading by splitting frames into multiple parts and processing them concur...
Definition: avfilter.h:116
const char * arg
Definition: jacosubdec.c:66
planar YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
Definition: pixfmt.h:66
static int config_props(AVFilterLink *outlink)
int ff_filter_get_nb_threads(AVFilterContext *ctx)
Get number of threads for current filter instance.
Definition: avfilter.c:786
#define FFMIN(a, b)
Definition: common.h:96
planar YUV 4:2:0, 12bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV420P and setting col...
Definition: pixfmt.h:74
int32_t
AVFormatContext * ctx
Definition: movenc.c:48
static const AVFilterPad outputs[]
Definition: af_afftfilt.c:386
#define FF_ARRAY_ELEMS(a)
static const AVFilterPad inputs[]
Definition: af_afftfilt.c:376
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:215
planar YUV 4:4:4 32bpp, (1 Cr & Cb sample per 1x1 Y & A samples)
Definition: pixfmt.h:189
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
Definition: pixdesc.h:81
static const AVOption lenscorrection_options[]
uint8_t pi<< 24) CONV_FUNC_GROUP(AV_SAMPLE_FMT_FLT, float, AV_SAMPLE_FMT_U8, uint8_t,(*(constuint8_t *) pi-0x80)*(1.0f/(1<< 7))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_DBL, double, AV_SAMPLE_FMT_U8, uint8_t,(*(constuint8_t *) pi-0x80)*(1.0/(1<< 7))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_U8, uint8_t, AV_SAMPLE_FMT_S16, int16_t,(*(constint16_t *) pi >>8)+0x80) CONV_FUNC_GROUP(AV_SAMPLE_FMT_FLT, float, AV_SAMPLE_FMT_S16, int16_t,*(constint16_t *) pi *(1.0f/(1<< 15))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_DBL, double, AV_SAMPLE_FMT_S16, int16_t,*(constint16_t *) pi *(1.0/(1<< 15))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_U8, uint8_t, AV_SAMPLE_FMT_S32, int32_t,(*(constint32_t *) pi >>24)+0x80) CONV_FUNC_GROUP(AV_SAMPLE_FMT_FLT, float, AV_SAMPLE_FMT_S32, int32_t,*(constint32_t *) pi *(1.0f/(1U<< 31))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_DBL, double, AV_SAMPLE_FMT_S32, int32_t,*(constint32_t *) pi *(1.0/(1U<< 31))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_U8, uint8_t, AV_SAMPLE_FMT_FLT, float, av_clip_uint8(lrintf(*(constfloat *) pi *(1<< 7))+0x80)) CONV_FUNC_GROUP(AV_SAMPLE_FMT_S16, int16_t, AV_SAMPLE_FMT_FLT, float, av_clip_int16(lrintf(*(constfloat *) pi *(1<< 15)))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_S32, int32_t, AV_SAMPLE_FMT_FLT, float, av_clipl_int32(llrintf(*(constfloat *) pi *(1U<< 31)))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_U8, uint8_t, AV_SAMPLE_FMT_DBL, double, av_clip_uint8(lrint(*(constdouble *) pi *(1<< 7))+0x80)) CONV_FUNC_GROUP(AV_SAMPLE_FMT_S16, int16_t, AV_SAMPLE_FMT_DBL, double, av_clip_int16(lrint(*(constdouble *) pi *(1<< 15)))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_S32, int32_t, AV_SAMPLE_FMT_DBL, double, av_clipl_int32(llrint(*(constdouble *) pi *(1U<< 31))))#defineSET_CONV_FUNC_GROUP(ofmt, ifmt) staticvoidset_generic_function(AudioConvert *ac){}voidff_audio_convert_free(AudioConvert **ac){if(!*ac) return;ff_dither_free(&(*ac) ->dc);av_freep(ac);}AudioConvert *ff_audio_convert_alloc(AVAudioResampleContext *avr, enumAVSampleFormatout_fmt, enumAVSampleFormatin_fmt, intchannels, intsample_rate, intapply_map){AudioConvert *ac;intin_planar, out_planar;ac=av_mallocz(sizeof(*ac));if(!ac) returnNULL;ac->avr=avr;ac->out_fmt=out_fmt;ac->in_fmt=in_fmt;ac->channels=channels;ac->apply_map=apply_map;if(avr->dither_method!=AV_RESAMPLE_DITHER_NONE &&av_get_packed_sample_fmt(out_fmt)==AV_SAMPLE_FMT_S16 &&av_get_bytes_per_sample(in_fmt)>2){ac->dc=ff_dither_alloc(avr, out_fmt, in_fmt, channels, sample_rate, apply_map);if(!ac->dc){av_free(ac);returnNULL;}returnac;}in_planar=ff_sample_fmt_is_planar(in_fmt, channels);out_planar=ff_sample_fmt_is_planar(out_fmt, channels);if(in_planar==out_planar){ac->func_type=CONV_FUNC_TYPE_FLAT;ac->planes=in_planar?ac->channels:1;}elseif(in_planar) ac->func_type=CONV_FUNC_TYPE_INTERLEAVE;elseac->func_type=CONV_FUNC_TYPE_DEINTERLEAVE;set_generic_function(ac);if(ARCH_AARCH64) ff_audio_convert_init_aarch64(ac);if(ARCH_ARM) ff_audio_convert_init_arm(ac);if(ARCH_X86) ff_audio_convert_init_x86(ac);returnac;}intff_audio_convert(AudioConvert *ac, AudioData *out, AudioData *in){intuse_generic=1;intlen=in->nb_samples;intp;if(ac->dc){av_log(ac->avr, AV_LOG_TRACE,"%dsamples-audio_convert:%sto%s(dithered)\n", len, av_get_sample_fmt_name(ac->in_fmt), av_get_sample_fmt_name(ac->out_fmt));returnff_convert_dither(ac-> in
planar YUV 4:1:0, 9bpp, (1 Cr & Cb sample per 4x4 Y samples)
Definition: pixfmt.h:68
static int query_formats(AVFilterContext *ctx)
Describe the class of an AVClass context structure.
Definition: log.h:67
Filter definition.
Definition: avfilter.h:144
Definition: f_ebur128.c:91
const char * name
Filter name.
Definition: avfilter.h:148
AVFilter ff_vf_lenscorrection
AVFilterLink ** outputs
array of pointers to output links
Definition: avfilter.h:319
static enum AVPixelFormat pix_fmts[]
Definition: libkvazaar.c:262
AVFilterInternal * internal
An opaque struct for libavfilter internal use.
Definition: avfilter.h:347
static int flags
Definition: cpu.c:47
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:198
static int filter_frame(AVFilterLink *inlink, AVFrame *in)
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:62
planar GBRA 4:4:4:4 32bpp
Definition: pixfmt.h:229
const AVClass * av_class
planar YUV 4:4:4, 24bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV444P and setting col...
Definition: pixfmt.h:76
avfilter_execute_func * execute
Definition: internal.h:153
AVFILTER_DEFINE_CLASS(lenscorrection)
A list of supported formats for one end of a filter link.
Definition: formats.h:64
An instance of a filter.
Definition: avfilter.h:307
FILE * out
Definition: movenc.c:54
#define av_freep(p)
void INT64 start
Definition: avisynth_c.h:690
#define av_malloc_array(a, b)
static const AVFilterPad lenscorrection_outputs[]
internal API functions
#define FLAGS
AVPixelFormat
Pixel format.
Definition: pixfmt.h:60
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
Definition: frame.c:589