2 * Copyright (c) 2012 Stefano Sabatini
4 * This file is part of FFmpeg.
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.
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.
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
23 * audio to video multimedia filter
26 #include "libavutil/avassert.h"
27 #include "libavutil/channel_layout.h"
28 #include "libavutil/opt.h"
29 #include "libavutil/parseutils.h"
46 struct frame_node *next;
54 int16_t *buf_idy; /* y coordinate of previous sample for each channel */
59 int mode; ///< ShowWavesMode
61 void (*draw_sample)(uint8_t *buf, int height, int linesize,
62 int16_t sample, int16_t *prev_y, int intensity);
66 struct frame_node *audio_frames;
67 struct frame_node *last_frame;
68 int64_t total_samples;
69 int64_t *sum; /* abs sum of the samples per channel */
72 #define OFFSET(x) offsetof(ShowWavesContext, x)
73 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
75 static const AVOption showwaves_options[] = {
76 { "size", "set video size", OFFSET(w), AV_OPT_TYPE_IMAGE_SIZE, {.str = "600x240"}, 0, 0, FLAGS },
77 { "s", "set video size", OFFSET(w), AV_OPT_TYPE_IMAGE_SIZE, {.str = "600x240"}, 0, 0, FLAGS },
78 { "mode", "select display mode", OFFSET(mode), AV_OPT_TYPE_INT, {.i64=MODE_POINT}, 0, MODE_NB-1, FLAGS, "mode"},
79 { "point", "draw a point for each sample", 0, AV_OPT_TYPE_CONST, {.i64=MODE_POINT}, .flags=FLAGS, .unit="mode"},
80 { "line", "draw a line for each sample", 0, AV_OPT_TYPE_CONST, {.i64=MODE_LINE}, .flags=FLAGS, .unit="mode"},
81 { "p2p", "draw a line between samples", 0, AV_OPT_TYPE_CONST, {.i64=MODE_P2P}, .flags=FLAGS, .unit="mode"},
82 { "cline", "draw a centered line for each sample", 0, AV_OPT_TYPE_CONST, {.i64=MODE_CENTERED_LINE}, .flags=FLAGS, .unit="mode"},
83 { "n", "set how many samples to show in the same point", OFFSET(n), AV_OPT_TYPE_INT, {.i64 = 0}, 0, INT_MAX, FLAGS },
84 { "rate", "set video rate", OFFSET(rate), AV_OPT_TYPE_VIDEO_RATE, {.str = "25"}, 0, 0, FLAGS },
85 { "r", "set video rate", OFFSET(rate), AV_OPT_TYPE_VIDEO_RATE, {.str = "25"}, 0, 0, FLAGS },
86 { "split_channels", "draw channels separately", OFFSET(split_channels), AV_OPT_TYPE_INT, {.i64 = 0}, 0, 1, FLAGS },
90 AVFILTER_DEFINE_CLASS(showwaves);
92 static av_cold void uninit(AVFilterContext *ctx)
94 ShowWavesContext *showwaves = ctx->priv;
96 av_frame_free(&showwaves->outpicref);
97 av_freep(&showwaves->buf_idy);
99 if (showwaves->single_pic) {
100 struct frame_node *node = showwaves->audio_frames;
102 struct frame_node *tmp = node;
105 av_frame_free(&tmp->frame);
108 av_freep(&showwaves->sum);
109 showwaves->last_frame = NULL;
113 static int query_formats(AVFilterContext *ctx)
115 AVFilterFormats *formats = NULL;
116 AVFilterChannelLayouts *layouts = NULL;
117 AVFilterLink *inlink = ctx->inputs[0];
118 AVFilterLink *outlink = ctx->outputs[0];
119 static const enum AVSampleFormat sample_fmts[] = { AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_NONE };
120 static const enum AVPixelFormat pix_fmts[] = { AV_PIX_FMT_GRAY8, AV_PIX_FMT_NONE };
122 /* set input audio formats */
123 formats = ff_make_format_list(sample_fmts);
125 return AVERROR(ENOMEM);
126 ff_formats_ref(formats, &inlink->out_formats);
128 layouts = ff_all_channel_layouts();
130 return AVERROR(ENOMEM);
131 ff_channel_layouts_ref(layouts, &inlink->out_channel_layouts);
133 formats = ff_all_samplerates();
135 return AVERROR(ENOMEM);
136 ff_formats_ref(formats, &inlink->out_samplerates);
138 /* set output video format */
139 formats = ff_make_format_list(pix_fmts);
141 return AVERROR(ENOMEM);
142 ff_formats_ref(formats, &outlink->in_formats);
147 static int config_output(AVFilterLink *outlink)
149 AVFilterContext *ctx = outlink->src;
150 AVFilterLink *inlink = ctx->inputs[0];
151 ShowWavesContext *showwaves = ctx->priv;
152 int nb_channels = inlink->channels;
155 showwaves->n = FFMAX(1, ((double)inlink->sample_rate / (showwaves->w * av_q2d(showwaves->rate))) + 0.5);
157 showwaves->buf_idx = 0;
158 if (!(showwaves->buf_idy = av_mallocz_array(nb_channels, sizeof(*showwaves->buf_idy)))) {
159 av_log(ctx, AV_LOG_ERROR, "Could not allocate showwaves buffer\n");
160 return AVERROR(ENOMEM);
162 outlink->w = showwaves->w;
163 outlink->h = showwaves->h;
164 outlink->sample_aspect_ratio = (AVRational){1,1};
166 outlink->frame_rate = av_div_q((AVRational){inlink->sample_rate,showwaves->n},
167 (AVRational){showwaves->w,1});
169 av_log(ctx, AV_LOG_VERBOSE, "s:%dx%d r:%f n:%d\n",
170 showwaves->w, showwaves->h, av_q2d(outlink->frame_rate), showwaves->n);
174 inline static int push_frame(AVFilterLink *outlink)
176 AVFilterContext *ctx = outlink->src;
177 AVFilterLink *inlink = ctx->inputs[0];
178 ShowWavesContext *showwaves = outlink->src->priv;
179 int nb_channels = inlink->channels;
182 if ((ret = ff_filter_frame(outlink, showwaves->outpicref)) >= 0)
183 showwaves->req_fullfilled = 1;
184 showwaves->outpicref = NULL;
185 showwaves->buf_idx = 0;
186 for (i = 0; i < nb_channels; i++)
187 showwaves->buf_idy[i] = 0;
191 static int push_single_pic(AVFilterLink *outlink)
193 AVFilterContext *ctx = outlink->src;
194 AVFilterLink *inlink = ctx->inputs[0];
195 ShowWavesContext *showwaves = ctx->priv;
196 int64_t n = 0, max_samples = showwaves->total_samples / outlink->w;
197 AVFrame *out = showwaves->outpicref;
198 struct frame_node *node;
199 const int nb_channels = inlink->channels;
200 const int x = 255 / (showwaves->split_channels ? 1 : nb_channels);
201 const int ch_height = showwaves->split_channels ? outlink->h / nb_channels : outlink->h;
202 const int linesize = out->linesize[0];
204 int64_t *sum = showwaves->sum;
206 if (max_samples == 0) {
207 av_log(ctx, AV_LOG_ERROR, "Too few samples\n");
208 return AVERROR(EINVAL);
211 av_log(ctx, AV_LOG_DEBUG, "Create frame averaging %"PRId64" samples per column\n", max_samples);
213 memset(sum, 0, nb_channels);
215 for (node = showwaves->audio_frames; node; node = node->next) {
217 const AVFrame *frame = node->frame;
218 const int16_t *p = (const int16_t *)frame->data[0];
220 for (i = 0; i < frame->nb_samples; i++) {
223 for (ch = 0; ch < nb_channels; ch++)
224 sum[ch] += abs(p[ch + i*nb_channels]) << 1;
225 if (n++ == max_samples) {
226 for (ch = 0; ch < nb_channels; ch++) {
227 int16_t sample = sum[ch] / max_samples;
228 uint8_t *buf = out->data[0] + col;
229 if (showwaves->split_channels)
230 buf += ch*ch_height*linesize;
231 av_assert0(col < outlink->w);
232 showwaves->draw_sample(buf, ch_height, linesize, sample, &showwaves->buf_idy[ch], x);
241 return push_frame(outlink);
245 static int request_frame(AVFilterLink *outlink)
247 ShowWavesContext *showwaves = outlink->src->priv;
248 AVFilterLink *inlink = outlink->src->inputs[0];
251 showwaves->req_fullfilled = 0;
253 ret = ff_request_frame(inlink);
254 } while (!showwaves->req_fullfilled && ret >= 0);
256 if (ret == AVERROR_EOF && showwaves->outpicref) {
257 if (showwaves->single_pic)
258 push_single_pic(outlink);
266 static void draw_sample_point(uint8_t *buf, int height, int linesize,
267 int16_t sample, int16_t *prev_y, int intensity)
269 const int h = height/2 - av_rescale(sample, height/2, INT16_MAX);
270 if (h >= 0 && h < height)
271 buf[h * linesize] += intensity;
274 static void draw_sample_line(uint8_t *buf, int height, int linesize,
275 int16_t sample, int16_t *prev_y, int intensity)
278 const int h = height/2 - av_rescale(sample, height/2, INT16_MAX);
279 int start = height/2;
280 int end = av_clip(h, 0, height-1);
282 FFSWAP(int16_t, start, end);
283 for (k = start; k < end; k++)
284 buf[k * linesize] += intensity;
287 static void draw_sample_p2p(uint8_t *buf, int height, int linesize,
288 int16_t sample, int16_t *prev_y, int intensity)
291 const int h = height/2 - av_rescale(sample, height/2, INT16_MAX);
292 if (h >= 0 && h < height) {
293 buf[h * linesize] += intensity;
294 if (*prev_y && h != *prev_y) {
296 int end = av_clip(h, 0, height-1);
298 FFSWAP(int16_t, start, end);
299 for (k = start + 1; k < end; k++)
300 buf[k * linesize] += intensity;
306 static void draw_sample_cline(uint8_t *buf, int height, int linesize,
307 int16_t sample, int16_t *prev_y, int intensity)
310 const int h = av_rescale(abs(sample), height, INT16_MAX);
311 const int start = (height - h) / 2;
312 const int end = start + h;
313 for (k = start; k < end; k++)
314 buf[k * linesize] += intensity;
317 static int alloc_out_frame(ShowWavesContext *showwaves, const int16_t *p,
318 const AVFilterLink *inlink, AVFilterLink *outlink,
321 if (!showwaves->outpicref) {
323 AVFrame *out = showwaves->outpicref =
324 ff_get_video_buffer(outlink, outlink->w, outlink->h);
326 return AVERROR(ENOMEM);
327 out->width = outlink->w;
328 out->height = outlink->h;
329 out->pts = in->pts + av_rescale_q((p - (int16_t *)in->data[0]) / inlink->channels,
330 av_make_q(1, inlink->sample_rate),
332 for (j = 0; j < outlink->h; j++)
333 memset(out->data[0] + j*out->linesize[0], 0, outlink->w);
338 static av_cold int init(AVFilterContext *ctx)
340 ShowWavesContext *showwaves = ctx->priv;
342 if (!strcmp(ctx->filter->name, "showwavespic")) {
343 showwaves->single_pic = 1;
344 showwaves->mode = MODE_CENTERED_LINE;
347 switch (showwaves->mode) {
348 case MODE_POINT: showwaves->draw_sample = draw_sample_point; break;
349 case MODE_LINE: showwaves->draw_sample = draw_sample_line; break;
350 case MODE_P2P: showwaves->draw_sample = draw_sample_p2p; break;
351 case MODE_CENTERED_LINE: showwaves->draw_sample = draw_sample_cline; break;
358 #if CONFIG_SHOWWAVES_FILTER
360 static int showwaves_filter_frame(AVFilterLink *inlink, AVFrame *insamples)
362 AVFilterContext *ctx = inlink->dst;
363 AVFilterLink *outlink = ctx->outputs[0];
364 ShowWavesContext *showwaves = ctx->priv;
365 const int nb_samples = insamples->nb_samples;
366 AVFrame *outpicref = showwaves->outpicref;
367 int16_t *p = (int16_t *)insamples->data[0];
368 int nb_channels = inlink->channels;
370 const int n = showwaves->n;
371 const int x = 255 / ((showwaves->split_channels ? 1 : nb_channels) * n); /* multiplication factor, pre-computed to avoid in-loop divisions */
372 const int ch_height = showwaves->split_channels ? outlink->h / nb_channels : outlink->h;
374 /* draw data in the buffer */
375 for (i = 0; i < nb_samples; i++) {
377 ret = alloc_out_frame(showwaves, p, inlink, outlink, insamples);
380 outpicref = showwaves->outpicref;
382 for (j = 0; j < nb_channels; j++) {
383 uint8_t *buf = outpicref->data[0] + showwaves->buf_idx;
384 const int linesize = outpicref->linesize[0];
385 if (showwaves->split_channels)
386 buf += j*ch_height*linesize;
387 showwaves->draw_sample(buf, ch_height, linesize, *p++,
388 &showwaves->buf_idy[j], x);
391 showwaves->sample_count_mod++;
392 if (showwaves->sample_count_mod == n) {
393 showwaves->sample_count_mod = 0;
394 showwaves->buf_idx++;
396 if (showwaves->buf_idx == showwaves->w)
397 if ((ret = push_frame(outlink)) < 0)
399 outpicref = showwaves->outpicref;
403 av_frame_free(&insamples);
407 static const AVFilterPad showwaves_inputs[] = {
410 .type = AVMEDIA_TYPE_AUDIO,
411 .filter_frame = showwaves_filter_frame,
416 static const AVFilterPad showwaves_outputs[] = {
419 .type = AVMEDIA_TYPE_VIDEO,
420 .config_props = config_output,
421 .request_frame = request_frame,
426 AVFilter ff_avf_showwaves = {
428 .description = NULL_IF_CONFIG_SMALL("Convert input audio to a video output."),
431 .query_formats = query_formats,
432 .priv_size = sizeof(ShowWavesContext),
433 .inputs = showwaves_inputs,
434 .outputs = showwaves_outputs,
435 .priv_class = &showwaves_class,
438 #endif // CONFIG_SHOWWAVES_FILTER
440 #if CONFIG_SHOWWAVESPIC_FILTER
442 #define OFFSET(x) offsetof(ShowWavesContext, x)
443 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
445 static const AVOption showwavespic_options[] = {
446 { "size", "set video size", OFFSET(w), AV_OPT_TYPE_IMAGE_SIZE, {.str = "600x240"}, 0, 0, FLAGS },
447 { "s", "set video size", OFFSET(w), AV_OPT_TYPE_IMAGE_SIZE, {.str = "600x240"}, 0, 0, FLAGS },
448 { "split_channels", "draw channels separately", OFFSET(split_channels), AV_OPT_TYPE_INT, {.i64 = 0}, 0, 1, FLAGS },
452 AVFILTER_DEFINE_CLASS(showwavespic);
454 static int showwavespic_config_input(AVFilterLink *inlink)
456 AVFilterContext *ctx = inlink->dst;
457 ShowWavesContext *showwaves = ctx->priv;
459 if (showwaves->single_pic) {
460 showwaves->sum = av_mallocz_array(inlink->channels, sizeof(*showwaves->sum));
462 return AVERROR(ENOMEM);
468 static int showwavespic_filter_frame(AVFilterLink *inlink, AVFrame *insamples)
470 AVFilterContext *ctx = inlink->dst;
471 AVFilterLink *outlink = ctx->outputs[0];
472 ShowWavesContext *showwaves = ctx->priv;
473 int16_t *p = (int16_t *)insamples->data[0];
476 if (showwaves->single_pic) {
477 struct frame_node *f;
479 ret = alloc_out_frame(showwaves, p, inlink, outlink, insamples);
483 /* queue the audio frame */
484 f = av_malloc(sizeof(*f));
486 ret = AVERROR(ENOMEM);
489 f->frame = insamples;
491 if (!showwaves->last_frame) {
492 showwaves->audio_frames =
493 showwaves->last_frame = f;
495 showwaves->last_frame->next = f;
496 showwaves->last_frame = f;
498 showwaves->total_samples += insamples->nb_samples;
504 av_frame_free(&insamples);
508 static const AVFilterPad showwavespic_inputs[] = {
511 .type = AVMEDIA_TYPE_AUDIO,
512 .config_props = showwavespic_config_input,
513 .filter_frame = showwavespic_filter_frame,
518 static const AVFilterPad showwavespic_outputs[] = {
521 .type = AVMEDIA_TYPE_VIDEO,
522 .config_props = config_output,
523 .request_frame = request_frame,
528 AVFilter ff_avf_showwavespic = {
529 .name = "showwavespic",
530 .description = NULL_IF_CONFIG_SMALL("Convert input audio to a video output single picture."),
533 .query_formats = query_formats,
534 .priv_size = sizeof(ShowWavesContext),
535 .inputs = showwavespic_inputs,
536 .outputs = showwavespic_outputs,
537 .priv_class = &showwavespic_class,
540 #endif // CONFIG_SHOWWAVESPIC_FILTER