FFmpeg
avf_showspatial.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2019 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 <float.h>
22 #include <math.h>
23 
24 #include "libavcodec/avfft.h"
25 #include "libavutil/audio_fifo.h"
26 #include "libavutil/avassert.h"
27 #include "libavutil/channel_layout.h"
28 #include "libavutil/opt.h"
29 #include "libavutil/parseutils.h"
30 #include "audio.h"
31 #include "video.h"
32 #include "avfilter.h"
33 #include "filters.h"
34 #include "internal.h"
35 #include "window_func.h"
36 
37 typedef struct ShowSpatialContext {
38  const AVClass *class;
39  int w, h;
40  AVRational frame_rate;
41  FFTContext *fft[2]; ///< Fast Fourier Transform context
42  FFTContext *ifft[2]; ///< Inverse Fast Fourier Transform context
43  int fft_bits; ///< number of bits (FFT window size = 1<<fft_bits)
44  FFTComplex *fft_data[2]; ///< bins holder for each (displayed) channels
45  float *window_func_lut; ///< Window function LUT
46  int win_func;
47  int win_size;
48  int buf_size;
49  float overlap;
50  int consumed;
51  int hop_size;
52  AVAudioFifo *fifo;
53  int64_t pts;
54 } ShowSpatialContext;
55 
56 #define OFFSET(x) offsetof(ShowSpatialContext, x)
57 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
58 
59 static const AVOption showspatial_options[] = {
60  { "size", "set video size", OFFSET(w), AV_OPT_TYPE_IMAGE_SIZE, {.str = "512x512"}, 0, 0, FLAGS },
61  { "s", "set video size", OFFSET(w), AV_OPT_TYPE_IMAGE_SIZE, {.str = "512x512"}, 0, 0, FLAGS },
62  { "win_size", "set window size", OFFSET(win_size), AV_OPT_TYPE_INT, {.i64 = 4096}, 1024, 65536, FLAGS },
63  { "win_func", "set window function", OFFSET(win_func), AV_OPT_TYPE_INT, {.i64 = WFUNC_HANNING}, 0, NB_WFUNC-1, FLAGS, "win_func" },
64  { "rect", "Rectangular", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_RECT}, 0, 0, FLAGS, "win_func" },
65  { "bartlett", "Bartlett", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_BARTLETT}, 0, 0, FLAGS, "win_func" },
66  { "hann", "Hann", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_HANNING}, 0, 0, FLAGS, "win_func" },
67  { "hanning", "Hanning", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_HANNING}, 0, 0, FLAGS, "win_func" },
68  { "hamming", "Hamming", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_HAMMING}, 0, 0, FLAGS, "win_func" },
69  { "blackman", "Blackman", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_BLACKMAN}, 0, 0, FLAGS, "win_func" },
70  { "welch", "Welch", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_WELCH}, 0, 0, FLAGS, "win_func" },
71  { "flattop", "Flat-top", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_FLATTOP}, 0, 0, FLAGS, "win_func" },
72  { "bharris", "Blackman-Harris", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_BHARRIS}, 0, 0, FLAGS, "win_func" },
73  { "bnuttall", "Blackman-Nuttall", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_BNUTTALL}, 0, 0, FLAGS, "win_func" },
74  { "bhann", "Bartlett-Hann", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_BHANN}, 0, 0, FLAGS, "win_func" },
75  { "sine", "Sine", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_SINE}, 0, 0, FLAGS, "win_func" },
76  { "nuttall", "Nuttall", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_NUTTALL}, 0, 0, FLAGS, "win_func" },
77  { "lanczos", "Lanczos", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_LANCZOS}, 0, 0, FLAGS, "win_func" },
78  { "gauss", "Gauss", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_GAUSS}, 0, 0, FLAGS, "win_func" },
79  { "tukey", "Tukey", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_TUKEY}, 0, 0, FLAGS, "win_func" },
80  { "dolph", "Dolph-Chebyshev", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_DOLPH}, 0, 0, FLAGS, "win_func" },
81  { "cauchy", "Cauchy", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_CAUCHY}, 0, 0, FLAGS, "win_func" },
82  { "parzen", "Parzen", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_PARZEN}, 0, 0, FLAGS, "win_func" },
83  { "poisson", "Poisson", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_POISSON}, 0, 0, FLAGS, "win_func" },
84  { "bohman", "Bohman", 0, AV_OPT_TYPE_CONST, {.i64=WFUNC_BOHMAN}, 0, 0, FLAGS, "win_func" },
85  { "overlap", "set window overlap", OFFSET(overlap), AV_OPT_TYPE_FLOAT, {.dbl=0.5}, 0, 1, FLAGS },
86  { NULL }
87 };
88 
89 AVFILTER_DEFINE_CLASS(showspatial);
90 
91 static av_cold void uninit(AVFilterContext *ctx)
92 {
93  ShowSpatialContext *s = ctx->priv;
94  int i;
95 
96  for (i = 0; i < 2; i++)
97  av_fft_end(s->fft[i]);
98  for (i = 0; i < 2; i++)
99  av_fft_end(s->ifft[i]);
100  for (i = 0; i < 2; i++)
101  av_freep(&s->fft_data[i]);
102  av_freep(&s->window_func_lut);
103  av_audio_fifo_free(s->fifo);
104 }
105 
106 static int query_formats(AVFilterContext *ctx)
107 {
108  AVFilterFormats *formats = NULL;
109  AVFilterChannelLayouts *layout = NULL;
110  AVFilterLink *inlink = ctx->inputs[0];
111  AVFilterLink *outlink = ctx->outputs[0];
112  static const enum AVSampleFormat sample_fmts[] = { AV_SAMPLE_FMT_FLTP, AV_SAMPLE_FMT_NONE };
113  static const enum AVPixelFormat pix_fmts[] = { AV_PIX_FMT_GBRP, AV_PIX_FMT_NONE };
114  int ret;
115 
116  formats = ff_make_format_list(sample_fmts);
117  if ((ret = ff_formats_ref (formats, &inlink->outcfg.formats )) < 0 ||
118  (ret = ff_add_channel_layout (&layout, AV_CH_LAYOUT_STEREO )) < 0 ||
119  (ret = ff_channel_layouts_ref (layout , &inlink->outcfg.channel_layouts)) < 0)
120  return ret;
121 
122  formats = ff_all_samplerates();
123  if ((ret = ff_formats_ref(formats, &inlink->outcfg.samplerates)) < 0)
124  return ret;
125 
126  formats = ff_make_format_list(pix_fmts);
127  if ((ret = ff_formats_ref(formats, &outlink->incfg.formats)) < 0)
128  return ret;
129 
130  return 0;
131 }
132 
133 static int run_channel_fft(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
134 {
135  ShowSpatialContext *s = ctx->priv;
136  const float *window_func_lut = s->window_func_lut;
137  AVFrame *fin = arg;
138  const int ch = jobnr;
139  const float *p = (float *)fin->extended_data[ch];
140 
141  for (int n = 0; n < fin->nb_samples; n++) {
142  s->fft_data[ch][n].re = p[n] * window_func_lut[n];
143  s->fft_data[ch][n].im = 0;
144  }
145 
146  av_fft_permute(s->fft[ch], s->fft_data[ch]);
147  av_fft_calc(s->fft[ch], s->fft_data[ch]);
148 
149  return 0;
150 }
151 
152 static int config_output(AVFilterLink *outlink)
153 {
154  AVFilterContext *ctx = outlink->src;
155  AVFilterLink *inlink = ctx->inputs[0];
156  ShowSpatialContext *s = ctx->priv;
157  int i, fft_bits;
158  float overlap;
159 
160  outlink->w = s->w;
161  outlink->h = s->h;
162  outlink->sample_aspect_ratio = (AVRational){1,1};
163 
164  s->buf_size = 1 << av_log2(s->win_size);
165  s->win_size = s->buf_size;
166  fft_bits = av_log2(s->win_size);
167 
168  /* (re-)configuration if the video output changed (or first init) */
169  if (fft_bits != s->fft_bits) {
170  s->fft_bits = fft_bits;
171 
172  /* FFT buffers: x2 for each channel buffer.
173  * Note: we use free and malloc instead of a realloc-like function to
174  * make sure the buffer is aligned in memory for the FFT functions. */
175  for (i = 0; i < 2; i++) {
176  av_fft_end(s->fft[i]);
177  av_freep(&s->fft_data[i]);
178  }
179  for (i = 0; i < 2; i++) {
180  s->fft[i] = av_fft_init(fft_bits, 0);
181  if (!s->fft[i]) {
182  av_log(ctx, AV_LOG_ERROR, "Unable to create FFT context. "
183  "The window size might be too high.\n");
184  return AVERROR(EINVAL);
185  }
186  }
187 
188  for (i = 0; i < 2; i++) {
189  s->fft_data[i] = av_calloc(s->buf_size, sizeof(**s->fft_data));
190  if (!s->fft_data[i])
191  return AVERROR(ENOMEM);
192  }
193 
194  /* pre-calc windowing function */
195  s->window_func_lut =
196  av_realloc_f(s->window_func_lut, s->win_size,
197  sizeof(*s->window_func_lut));
198  if (!s->window_func_lut)
199  return AVERROR(ENOMEM);
200  generate_window_func(s->window_func_lut, s->win_size, s->win_func, &overlap);
201  if (s->overlap == 1)
202  s->overlap = overlap;
203 
204  s->hop_size = (1.f - s->overlap) * s->win_size;
205  if (s->hop_size < 1) {
206  av_log(ctx, AV_LOG_ERROR, "overlap %f too big\n", s->overlap);
207  return AVERROR(EINVAL);
208  }
209  }
210 
211  outlink->time_base = av_inv_q(outlink->frame_rate);
212 
213  av_audio_fifo_free(s->fifo);
214  s->fifo = av_audio_fifo_alloc(inlink->format, inlink->channels, s->win_size);
215  if (!s->fifo)
216  return AVERROR(ENOMEM);
217  return 0;
218 }
219 
220 #define RE(y, ch) s->fft_data[ch][y].re
221 #define IM(y, ch) s->fft_data[ch][y].im
222 
223 static void draw_dot(uint8_t *dst, int linesize, int value)
224 {
225  dst[0] = value;
226  dst[1] = value;
227  dst[-1] = value;
228  dst[linesize] = value;
229  dst[-linesize] = value;
230 }
231 
232 static int draw_spatial(AVFilterLink *inlink, AVFrame *insamples)
233 {
234  AVFilterContext *ctx = inlink->dst;
235  AVFilterLink *outlink = ctx->outputs[0];
236  ShowSpatialContext *s = ctx->priv;
237  AVFrame *outpicref;
238  int h = s->h - 2;
239  int w = s->w - 2;
240  int z = s->win_size / 2;
241 
242  outpicref = ff_get_video_buffer(outlink, outlink->w, outlink->h);
243  if (!outpicref)
244  return AVERROR(ENOMEM);
245 
246  outpicref->sample_aspect_ratio = (AVRational){1,1};
247  for (int i = 0; i < outlink->h; i++) {
248  memset(outpicref->data[0] + i * outpicref->linesize[0], 0, outlink->w);
249  memset(outpicref->data[1] + i * outpicref->linesize[1], 0, outlink->w);
250  memset(outpicref->data[2] + i * outpicref->linesize[2], 0, outlink->w);
251  }
252 
253  for (int j = 0; j < z; j++) {
254  const int idx = z - 1 - j;
255  float l = hypotf(RE(idx, 0), IM(idx, 0));
256  float r = hypotf(RE(idx, 1), IM(idx, 1));
257  float sum = l + r;
258  float lp = atan2f(IM(idx, 0), RE(idx, 0));
259  float rp = atan2f(IM(idx, 1), RE(idx, 1));
260  float diffp = ((rp - lp) / (2.f * M_PI) + 1.f) * 0.5f;
261  float diff = (sum < 0.000001f ? 0.f : (r - l) / sum) * 0.5f + 0.5f;
262  float cr = av_clipf(cbrtf(l / sum), 0, 1) * 255.f;
263  float cb = av_clipf(cbrtf(r / sum), 0, 1) * 255.f;
264  float cg;
265  int x, y;
266 
267  cg = diffp * 255.f;
268  x = av_clip(w * diff, 0, w - 2) + 1;
269  y = av_clip(h * diffp, 0, h - 2) + 1;
270 
271  draw_dot(outpicref->data[0] + outpicref->linesize[0] * y + x, outpicref->linesize[0], cg);
272  draw_dot(outpicref->data[1] + outpicref->linesize[1] * y + x, outpicref->linesize[1], cb);
273  draw_dot(outpicref->data[2] + outpicref->linesize[2] * y + x, outpicref->linesize[2], cr);
274  }
275 
276  outpicref->pts = av_rescale_q(insamples->pts, inlink->time_base, outlink->time_base);
277 
278  return ff_filter_frame(outlink, outpicref);
279 }
280 
281 static int spatial_activate(AVFilterContext *ctx)
282 {
283  AVFilterLink *inlink = ctx->inputs[0];
284  AVFilterLink *outlink = ctx->outputs[0];
285  ShowSpatialContext *s = ctx->priv;
286  int ret;
287 
288  FF_FILTER_FORWARD_STATUS_BACK(outlink, inlink);
289 
290  if (av_audio_fifo_size(s->fifo) < s->win_size) {
291  AVFrame *frame = NULL;
292 
293  ret = ff_inlink_consume_frame(inlink, &frame);
294  if (ret < 0)
295  return ret;
296  if (ret > 0) {
297  s->pts = frame->pts;
298  s->consumed = 0;
299 
300  av_audio_fifo_write(s->fifo, (void **)frame->extended_data, frame->nb_samples);
301  av_frame_free(&frame);
302  }
303  }
304 
305  if (av_audio_fifo_size(s->fifo) >= s->win_size) {
306  AVFrame *fin = ff_get_audio_buffer(inlink, s->win_size);
307  if (!fin)
308  return AVERROR(ENOMEM);
309 
310  fin->pts = s->pts + s->consumed;
311  s->consumed += s->hop_size;
312  ret = av_audio_fifo_peek(s->fifo, (void **)fin->extended_data,
313  FFMIN(s->win_size, av_audio_fifo_size(s->fifo)));
314  if (ret < 0) {
315  av_frame_free(&fin);
316  return ret;
317  }
318 
319  av_assert0(fin->nb_samples == s->win_size);
320 
321  ctx->internal->execute(ctx, run_channel_fft, fin, NULL, 2);
322 
323  ret = draw_spatial(inlink, fin);
324 
325  av_frame_free(&fin);
326  av_audio_fifo_drain(s->fifo, s->hop_size);
327  if (ret <= 0)
328  return ret;
329  }
330 
331  FF_FILTER_FORWARD_STATUS(inlink, outlink);
332  if (ff_outlink_frame_wanted(outlink) && av_audio_fifo_size(s->fifo) < s->win_size) {
333  ff_inlink_request_frame(inlink);
334  return 0;
335  }
336 
337  if (av_audio_fifo_size(s->fifo) >= s->win_size) {
338  ff_filter_set_ready(ctx, 10);
339  return 0;
340  }
341  return FFERROR_NOT_READY;
342 }
343 
344 static const AVFilterPad showspatial_inputs[] = {
345  {
346  .name = "default",
347  .type = AVMEDIA_TYPE_AUDIO,
348  },
349  { NULL }
350 };
351 
352 static const AVFilterPad showspatial_outputs[] = {
353  {
354  .name = "default",
355  .type = AVMEDIA_TYPE_VIDEO,
356  .config_props = config_output,
357  },
358  { NULL }
359 };
360 
361 const AVFilter ff_avf_showspatial = {
362  .name = "showspatial",
363  .description = NULL_IF_CONFIG_SMALL("Convert input audio to a spatial video output."),
364  .uninit = uninit,
365  .query_formats = query_formats,
366  .priv_size = sizeof(ShowSpatialContext),
367  .inputs = showspatial_inputs,
368  .outputs = showspatial_outputs,
369  .activate = spatial_activate,
370  .priv_class = &showspatial_class,
371  .flags = AVFILTER_FLAG_SLICE_THREADS,
372 };
av_audio_fifo_free
void av_audio_fifo_free(AVAudioFifo *af)
Free an AVAudioFifo.
Definition: audio_fifo.c:45
formats
formats
Definition: signature.h:48
ff_get_video_buffer
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
av_fft_end
av_cold void av_fft_end(FFTContext *s)
Definition: avfft.c:48
ff_get_audio_buffer
AVFrame * ff_get_audio_buffer(AVFilterLink *link, int nb_samples)
Request an audio samples buffer with a specific set of permissions.
Definition: audio.c:86
AV_SAMPLE_FMT_FLTP
@ AV_SAMPLE_FMT_FLTP
float, planar
Definition: samplefmt.h:69
AVFilterChannelLayouts
A list of supported channel layouts.
Definition: formats.h:86
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
showspatial_outputs
static const AVFilterPad showspatial_outputs[]
Definition: avf_showspatial.c:352
ShowSpatialContext::hop_size
int hop_size
Definition: avf_showspatial.c:51
av_clip
#define av_clip
Definition: common.h:122
r
const char * r
Definition: vf_curves.c:116
AVERROR
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
opt.h
ff_make_format_list
AVFilterFormats * ff_make_format_list(const int *fmts)
Create a list of supported formats.
Definition: formats.c:286
cb
static double cb(void *priv, double x, double y)
Definition: vf_geq.c:215
ff_filter_frame
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:978
sample_fmts
static enum AVSampleFormat sample_fmts[]
Definition: adpcmenc.c:953
ff_channel_layouts_ref
int ff_channel_layouts_ref(AVFilterChannelLayouts *f, AVFilterChannelLayouts **ref)
Add *ref as a new reference to f.
Definition: formats.c:454
FFERROR_NOT_READY
return FFERROR_NOT_READY
Definition: filter_design.txt:204
atan2f
#define atan2f(y, x)
Definition: libm.h:45
spatial_activate
static int spatial_activate(AVFilterContext *ctx)
Definition: avf_showspatial.c:281
inlink
The exact code depends on how similar the blocks are and how related they are to the and needs to apply these operations to the correct inlink or outlink if there are several Macros are available to factor that when no extra processing is inlink
Definition: filter_design.txt:212
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:111
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:303
AVFrame::pts
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:396
w
uint8_t w
Definition: llviddspenc.c:39
AVOption
AVOption.
Definition: opt.h:248
av_fft_permute
void av_fft_permute(FFTContext *s, FFTComplex *z)
Do the permutation needed BEFORE calling ff_fft_calc().
Definition: avfft.c:38
ShowSpatialContext::window_func_lut
float * window_func_lut
Window function LUT.
Definition: avf_showspatial.c:45
ShowSpatialContext::fft
FFTContext * fft[2]
Fast Fourier Transform context.
Definition: avf_showspatial.c:41
float.h
ShowSpatialContext::frame_rate
AVRational frame_rate
Definition: avf_showspatial.c:40
AVFilter::name
const char * name
Filter name.
Definition: avfilter.h:149
uninit
static av_cold void uninit(AVFilterContext *ctx)
Definition: avf_showspatial.c:91
video.h
AVFormatContext::internal
AVFormatInternal * internal
An opaque field for libavformat internal usage.
Definition: avformat.h:1555
FF_FILTER_FORWARD_STATUS_BACK
#define FF_FILTER_FORWARD_STATUS_BACK(outlink, inlink)
Forward the status on an output link to an input link.
Definition: filters.h:199
WFUNC_FLATTOP
@ WFUNC_FLATTOP
Definition: window_func.h:29
AVFrame::data
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:317
AVFilterFormats
A list of supported formats for one end of a filter link.
Definition: formats.h:65
ff_inlink_consume_frame
int ff_inlink_consume_frame(AVFilterLink *link, AVFrame **rframe)
Take a frame from the link's FIFO and update the link's stats.
Definition: avfilter.c:1376
WFUNC_BLACKMAN
@ WFUNC_BLACKMAN
Definition: af_firequalizer.c:36
WFUNC_PARZEN
@ WFUNC_PARZEN
Definition: window_func.h:32
AVAudioFifo
Context for an Audio FIFO Buffer.
Definition: audio_fifo.c:34
RE
#define RE(y, ch)
Definition: avf_showspatial.c:220
av_audio_fifo_drain
int av_audio_fifo_drain(AVAudioFifo *af, int nb_samples)
Drain data from an AVAudioFifo.
Definition: audio_fifo.c:201
AV_CH_LAYOUT_STEREO
#define AV_CH_LAYOUT_STEREO
Definition: channel_layout.h:91
WFUNC_BHANN
@ WFUNC_BHANN
Definition: window_func.h:31
ShowSpatialContext::fft_data
FFTComplex * fft_data[2]
bins holder for each (displayed) channels
Definition: avf_showspatial.c:44
AVFilterPad
A filter pad used for either input or output.
Definition: internal.h:54
avassert.h
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:181
WFUNC_DOLPH
@ WFUNC_DOLPH
Definition: window_func.h:32
av_cold
#define av_cold
Definition: attributes.h:90
showspatial_options
static const AVOption showspatial_options[]
Definition: avf_showspatial.c:59
inputs
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several inputs
Definition: filter_design.txt:243
WFUNC_NUTTALL
@ WFUNC_NUTTALL
Definition: af_firequalizer.c:39
ff_add_channel_layout
int ff_add_channel_layout(AVFilterChannelLayouts **l, uint64_t channel_layout)
Definition: formats.c:331
ShowSpatialContext::consumed
int consumed
Definition: avf_showspatial.c:50
ff_inlink_request_frame
void ff_inlink_request_frame(AVFilterLink *link)
Mark that a frame is wanted on the link.
Definition: avfilter.c:1502
s
#define s(width, name)
Definition: cbs_vp9.c:257
av_audio_fifo_write
int av_audio_fifo_write(AVAudioFifo *af, void **data, int nb_samples)
Write data to an AVAudioFifo.
Definition: audio_fifo.c:112
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
ff_formats_ref
int ff_formats_ref(AVFilterFormats *f, AVFilterFormats **ref)
Add *ref as a new reference to formats.
Definition: formats.c:459
ShowSpatialContext::ifft
FFTContext * ifft[2]
Inverse Fast Fourier Transform context.
Definition: avf_showspatial.c:42
av_assert0
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
WFUNC_LANCZOS
@ WFUNC_LANCZOS
Definition: window_func.h:31
outputs
static const AVFilterPad outputs[]
Definition: af_acontrast.c:203
filters.h
pix_fmts
static enum AVPixelFormat pix_fmts[]
Definition: libkvazaar.c:290
WFUNC_RECT
@ WFUNC_RECT
Definition: window_func.h:28
ctx
AVFormatContext * ctx
Definition: movenc.c:48
WFUNC_BHARRIS
@ WFUNC_BHARRIS
Definition: af_firequalizer.c:41
av_rescale_q
int64_t av_rescale_q(int64_t a, AVRational bq, AVRational cq)
Rescale a 64-bit integer by 2 rational numbers.
Definition: mathematics.c:142
FLAGS
#define FLAGS
Definition: avf_showspatial.c:57
f
#define f(width, name)
Definition: cbs_vp9.c:255
OFFSET
#define OFFSET(x)
Definition: avf_showspatial.c:56
ShowSpatialContext
Definition: avf_showspatial.c:37
arg
const char * arg
Definition: jacosubdec.c:67
if
if(ret)
Definition: filter_design.txt:179
av_realloc_f
#define av_realloc_f(p, o, n)
Definition: tableprint_vlc.h:33
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
NULL
#define NULL
Definition: coverity.c:32
AVRational
Rational number (pair of numerator and denominator).
Definition: rational.h:58
av_audio_fifo_alloc
AVAudioFifo * av_audio_fifo_alloc(enum AVSampleFormat sample_fmt, int channels, int nb_samples)
Allocate an AVAudioFifo.
Definition: audio_fifo.c:59
WFUNC_HAMMING
@ WFUNC_HAMMING
Definition: af_firequalizer.c:35
activate
filter_frame For filters that do not use the activate() callback
AV_OPT_TYPE_IMAGE_SIZE
@ AV_OPT_TYPE_IMAGE_SIZE
offset must point to two consecutive integers
Definition: opt.h:235
av_clipf
#define av_clipf
Definition: common.h:170
parseutils.h
generate_window_func
static void generate_window_func(float *lut, int N, int win_func, float *overlap)
Definition: window_func.h:36
avfft.h
WFUNC_HANNING
@ WFUNC_HANNING
Definition: window_func.h:28
WFUNC_BARTLETT
@ WFUNC_BARTLETT
Definition: window_func.h:29
WFUNC_BOHMAN
@ WFUNC_BOHMAN
Definition: window_func.h:33
AVFILTER_DEFINE_CLASS
AVFILTER_DEFINE_CLASS(showspatial)
for
for(j=16;j >0;--j)
Definition: h264pred_template.c:469
ShowSpatialContext::overlap
float overlap
Definition: avf_showspatial.c:49
query_formats
static int query_formats(AVFilterContext *ctx)
Definition: avf_showspatial.c:106
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:117
ShowSpatialContext::buf_size
int buf_size
Definition: avf_showspatial.c:48
AV_SAMPLE_FMT_NONE
@ AV_SAMPLE_FMT_NONE
Definition: samplefmt.h:59
WFUNC_TUKEY
@ WFUNC_TUKEY
Definition: af_firequalizer.c:42
ShowSpatialContext::fifo
AVAudioFifo * fifo
Definition: avf_showspatial.c:52
ShowSpatialContext::h
int h
Definition: avf_showspatial.c:39
FFMIN
#define FFMIN(a, b)
Definition: common.h:105
ShowSpatialContext::win_size
int win_size
Definition: avf_showspatial.c:47
run_channel_fft
static int run_channel_fft(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
Definition: avf_showspatial.c:133
av_audio_fifo_size
int av_audio_fifo_size(AVAudioFifo *af)
Get the current number of samples in the AVAudioFifo available for reading.
Definition: audio_fifo.c:228
M_PI
#define M_PI
Definition: mathematics.h:52
internal.h
AV_OPT_TYPE_FLOAT
@ AV_OPT_TYPE_FLOAT
Definition: opt.h:228
layout
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel layout
Definition: filter_design.txt:18
IM
#define IM(y, ch)
Definition: avf_showspatial.c:221
ShowSpatialContext::pts
int64_t pts
Definition: avf_showspatial.c:53
AVFrame::nb_samples
int nb_samples
number of audio samples (per channel) described by this frame
Definition: frame.h:369
FFTContext
Definition: fft.h:83
i
int i
Definition: input.c:407
AVFrame::extended_data
uint8_t ** extended_data
pointers to the data planes/channels.
Definition: frame.h:350
AVSampleFormat
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:58
value
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default value
Definition: writing_filters.txt:86
cbrtf
static av_always_inline float cbrtf(float x)
Definition: libm.h:61
audio_fifo.h
av_inv_q
static av_always_inline AVRational av_inv_q(AVRational q)
Invert a rational.
Definition: rational.h:159
showspatial_inputs
static const AVFilterPad showspatial_inputs[]
Definition: avf_showspatial.c:344
AVFilterPad::name
const char * name
Pad name.
Definition: internal.h:60
AVFilter
Filter definition.
Definition: avfilter.h:145
ret
ret
Definition: filter_design.txt:187
frame
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
Definition: filter_design.txt:264
AVFrame::sample_aspect_ratio
AVRational sample_aspect_ratio
Sample aspect ratio for the video frame, 0/1 if unknown/unspecified.
Definition: frame.h:391
av_fft_init
FFTContext * av_fft_init(int nbits, int inverse)
Set up a complex FFT.
Definition: avfft.c:28
window_func.h
NB_WFUNC
@ NB_WFUNC
Definition: af_firequalizer.c:43
ff_all_samplerates
AVFilterFormats * ff_all_samplerates(void)
Definition: formats.c:414
av_calloc
void * av_calloc(size_t nmemb, size_t size)
Non-inlined equivalent of av_mallocz_array().
Definition: mem.c:252
channel_layout.h
WFUNC_SINE
@ WFUNC_SINE
Definition: window_func.h:30
WFUNC_CAUCHY
@ WFUNC_CAUCHY
Definition: window_func.h:32
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:65
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:225
avfilter.h
draw_dot
static void draw_dot(uint8_t *dst, int linesize, int value)
Definition: avf_showspatial.c:223
AVFilterContext
An instance of a filter.
Definition: avfilter.h:333
AV_PIX_FMT_GBRP
@ AV_PIX_FMT_GBRP
planar GBR 4:4:4 24bpp
Definition: pixfmt.h:158
AVFILTER_FLAG_SLICE_THREADS
#define AVFILTER_FLAG_SLICE_THREADS
The filter supports multithreading by splitting frames into multiple parts and processing them concur...
Definition: avfilter.h:117
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
ShowSpatialContext::fft_bits
int fft_bits
number of bits (FFT window size = 1<<fft_bits)
Definition: avf_showspatial.c:43
WFUNC_GAUSS
@ WFUNC_GAUSS
Definition: window_func.h:31
WFUNC_BNUTTALL
@ WFUNC_BNUTTALL
Definition: af_firequalizer.c:40
audio.h
AVFilterFormatsConfig::formats
AVFilterFormats * formats
List of supported formats (pixel or sample).
Definition: avfilter.h:437
WFUNC_POISSON
@ WFUNC_POISSON
Definition: window_func.h:32
ff_avf_showspatial
const AVFilter ff_avf_showspatial
Definition: avf_showspatial.c:361
diff
static av_always_inline int diff(const uint32_t a, const uint32_t b)
Definition: vf_palettegen.c:136
FF_FILTER_FORWARD_STATUS
FF_FILTER_FORWARD_STATUS(inlink, outlink)
cr
static double cr(void *priv, double x, double y)
Definition: vf_geq.c:216
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:35
draw_spatial
static int draw_spatial(AVFilterLink *inlink, AVFrame *insamples)
Definition: avf_showspatial.c:232
ShowSpatialContext::win_func
int win_func
Definition: avf_showspatial.c:46
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:561
AVFrame::linesize
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:334
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:28
h
h
Definition: vp9dsp_template.c:2038
ff_outlink_frame_wanted
the definition of that something depends on the semantic of the filter The callback must examine the status of the filter s links and proceed accordingly The status of output links is stored in the status_in and status_out fields and tested by the ff_outlink_frame_wanted() function. If this function returns true
av_audio_fifo_peek
int av_audio_fifo_peek(AVAudioFifo *af, void **data, int nb_samples)
Peek data from an AVAudioFifo.
Definition: audio_fifo.c:138
AV_OPT_TYPE_CONST
@ AV_OPT_TYPE_CONST
Definition: opt.h:234
av_fft_calc
void av_fft_calc(FFTContext *s, FFTComplex *z)
Do a complex FFT with the parameters defined in av_fft_init().
Definition: avfft.c:43
av_log2
int av_log2(unsigned v)
Definition: intmath.c:26
config_output
static int config_output(AVFilterLink *outlink)
Definition: avf_showspatial.c:152
WFUNC_WELCH
@ WFUNC_WELCH
Definition: window_func.h:29
FFTComplex
Definition: avfft.h:37
ff_filter_set_ready
void ff_filter_set_ready(AVFilterContext *filter, unsigned priority)
Mark a filter ready and schedule it for activation.
Definition: avfilter.c:186
ShowSpatialContext::w
int w
Definition: avf_showspatial.c:39
Generated on Tue Jun 22 2021 19:21:45 for FFmpeg by   doxygen 1.8.17