2 * Filter layer - default implementations
3 * Copyright (c) 2007 Bobby Bingham
5 * This file is part of FFmpeg.
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.
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.
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
22 #include "libavcore/audioconvert.h"
23 #include "libavcore/imgutils.h"
24 #include "libavcore/samplefmt.h"
28 /* TODO: buffer pool. see comment for avfilter_default_get_video_buffer() */
29 void ff_avfilter_default_free_buffer(AVFilterBuffer *ptr)
31 av_free(ptr->data[0]);
35 /* TODO: set the buffer's priv member to a context structure for the whole
36 * filter chain. This will allow for a buffer pool instead of the constant
37 * alloc & free cycle currently implemented. */
38 AVFilterBufferRef *avfilter_default_get_video_buffer(AVFilterLink *link, int perms, int w, int h)
42 AVFilterBufferRef *picref = NULL;
44 // +2 is needed for swscaler, +16 to be SIMD-friendly
45 if (av_image_alloc(data, linesize, w, h, link->format, 16) < 0)
48 picref = avfilter_get_video_buffer_ref_from_arrays(data, linesize,
49 perms, w, h, link->format);
58 AVFilterBufferRef *avfilter_default_get_audio_buffer(AVFilterLink *link, int perms,
59 enum AVSampleFormat sample_fmt, int size,
60 int64_t channel_layout, int planar)
62 AVFilterBuffer *samples = av_mallocz(sizeof(AVFilterBuffer));
63 AVFilterBufferRef *ref = NULL;
64 int i, sample_size, chans_nb, bufsize, per_channel_size, step_size = 0;
67 if (!samples || !(ref = av_mallocz(sizeof(AVFilterBufferRef))))
71 ref->format = sample_fmt;
73 ref->audio = av_mallocz(sizeof(AVFilterBufferRefAudioProps));
77 ref->audio->channel_layout = channel_layout;
78 ref->audio->size = size;
79 ref->audio->planar = planar;
81 /* make sure the buffer gets read permission or it's useless for output */
82 ref->perms = perms | AV_PERM_READ;
84 samples->refcount = 1;
85 samples->free = ff_avfilter_default_free_buffer;
87 sample_size = av_get_bits_per_sample_fmt(sample_fmt) >>3;
88 chans_nb = av_get_channel_layout_nb_channels(channel_layout);
90 per_channel_size = size/chans_nb;
91 ref->audio->nb_samples = per_channel_size/sample_size;
93 /* Set the number of bytes to traverse to reach next sample of a particular channel:
94 * For planar, this is simply the sample size.
95 * For packed, this is the number of samples * sample_size.
97 for (i = 0; i < chans_nb; i++)
98 samples->linesize[i] = planar > 0 ? per_channel_size : sample_size;
99 memset(&samples->linesize[chans_nb], 0, (8-chans_nb) * sizeof(samples->linesize[0]));
101 /* Calculate total buffer size, round to multiple of 16 to be SIMD friendly */
102 bufsize = (size + 15)&~15;
103 buf = av_malloc(bufsize);
107 /* For planar, set the start point of each channel's data within the buffer
108 * For packed, set the start point of the entire buffer only
110 samples->data[0] = buf;
112 for (i = 1; i < chans_nb; i++) {
113 step_size += per_channel_size;
114 samples->data[i] = buf + step_size;
117 for (i = 1; i < chans_nb; i++)
118 samples->data[i] = buf;
121 memset(&samples->data[chans_nb], 0, (8-chans_nb) * sizeof(samples->data[0]));
123 memcpy(ref->data, samples->data, sizeof(ref->data));
124 memcpy(ref->linesize, samples->linesize, sizeof(ref->linesize));
130 if (ref && ref->audio)
137 void avfilter_default_start_frame(AVFilterLink *inlink, AVFilterBufferRef *picref)
139 AVFilterLink *outlink = NULL;
141 if (inlink->dst->output_count)
142 outlink = inlink->dst->outputs[0];
145 outlink->out_buf = avfilter_get_video_buffer(outlink, AV_PERM_WRITE, outlink->w, outlink->h);
146 avfilter_copy_buffer_ref_props(outlink->out_buf, picref);
147 avfilter_start_frame(outlink, avfilter_ref_buffer(outlink->out_buf, ~0));
151 void avfilter_default_draw_slice(AVFilterLink *inlink, int y, int h, int slice_dir)
153 AVFilterLink *outlink = NULL;
155 if (inlink->dst->output_count)
156 outlink = inlink->dst->outputs[0];
159 avfilter_draw_slice(outlink, y, h, slice_dir);
162 void avfilter_default_end_frame(AVFilterLink *inlink)
164 AVFilterLink *outlink = NULL;
166 if (inlink->dst->output_count)
167 outlink = inlink->dst->outputs[0];
169 avfilter_unref_buffer(inlink->cur_buf);
170 inlink->cur_buf = NULL;
173 if (outlink->out_buf) {
174 avfilter_unref_buffer(outlink->out_buf);
175 outlink->out_buf = NULL;
177 avfilter_end_frame(outlink);
181 /* FIXME: samplesref is same as link->cur_buf. Need to consider removing the redundant parameter. */
182 void avfilter_default_filter_samples(AVFilterLink *inlink, AVFilterBufferRef *samplesref)
184 AVFilterLink *outlink = NULL;
186 if (inlink->dst->output_count)
187 outlink = inlink->dst->outputs[0];
190 outlink->out_buf = avfilter_default_get_audio_buffer(inlink, AV_PERM_WRITE, samplesref->format,
191 samplesref->audio->size,
192 samplesref->audio->channel_layout,
193 samplesref->audio->planar);
194 outlink->out_buf->pts = samplesref->pts;
195 outlink->out_buf->audio->sample_rate = samplesref->audio->sample_rate;
196 avfilter_filter_samples(outlink, avfilter_ref_buffer(outlink->out_buf, ~0));
197 avfilter_unref_buffer(outlink->out_buf);
198 outlink->out_buf = NULL;
200 avfilter_unref_buffer(samplesref);
201 inlink->cur_buf = NULL;
205 * default config_link() implementation for output video links to simplify
206 * the implementation of one input one output video filters */
207 int avfilter_default_config_output_link(AVFilterLink *link)
209 if (link->src->input_count && link->src->inputs[0]) {
210 if (link->type == AVMEDIA_TYPE_VIDEO) {
211 link->w = link->src->inputs[0]->w;
212 link->h = link->src->inputs[0]->h;
213 link->time_base = link->src->inputs[0]->time_base;
214 } else if (link->type == AVMEDIA_TYPE_AUDIO) {
215 link->channel_layout = link->src->inputs[0]->channel_layout;
216 link->sample_rate = link->src->inputs[0]->sample_rate;
219 /* XXX: any non-simple filter which would cause this branch to be taken
220 * really should implement its own config_props() for this link. */
228 * A helper for query_formats() which sets all links to the same list of
229 * formats. If there are no links hooked to this filter, the list of formats is
232 * FIXME: this will need changed for filters with a mix of pad types
233 * (video + audio, etc)
235 void avfilter_set_common_formats(AVFilterContext *ctx, AVFilterFormats *formats)
239 for (i = 0; i < ctx->input_count; i++) {
240 if (ctx->inputs[i]) {
241 avfilter_formats_ref(formats, &ctx->inputs[i]->out_formats);
245 for (i = 0; i < ctx->output_count; i++) {
246 if (ctx->outputs[i]) {
247 avfilter_formats_ref(formats, &ctx->outputs[i]->in_formats);
253 av_free(formats->formats);
254 av_free(formats->refs);
259 int avfilter_default_query_formats(AVFilterContext *ctx)
261 enum AVMediaType type = ctx->inputs && ctx->inputs [0] ? ctx->inputs [0]->type :
262 ctx->outputs && ctx->outputs[0] ? ctx->outputs[0]->type :
265 avfilter_set_common_formats(ctx, avfilter_all_formats(type));
269 void avfilter_null_start_frame(AVFilterLink *link, AVFilterBufferRef *picref)
271 avfilter_start_frame(link->dst->outputs[0], picref);
274 void avfilter_null_draw_slice(AVFilterLink *link, int y, int h, int slice_dir)
276 avfilter_draw_slice(link->dst->outputs[0], y, h, slice_dir);
279 void avfilter_null_end_frame(AVFilterLink *link)
281 avfilter_end_frame(link->dst->outputs[0]);
284 void avfilter_null_filter_samples(AVFilterLink *link, AVFilterBufferRef *samplesref)
286 avfilter_filter_samples(link->dst->outputs[0], samplesref);
289 AVFilterBufferRef *avfilter_null_get_video_buffer(AVFilterLink *link, int perms, int w, int h)
291 return avfilter_get_video_buffer(link->dst->outputs[0], perms, w, h);
294 AVFilterBufferRef *avfilter_null_get_audio_buffer(AVFilterLink *link, int perms,
295 enum AVSampleFormat sample_fmt, int size,
296 int64_t channel_layout, int packed)
298 return avfilter_get_audio_buffer(link->dst->outputs[0], perms, sample_fmt,
299 size, channel_layout, packed);