Remove no-longer accurate comment
[libav.git] / libavfilter / avfilter.c
CommitLineData
4dbbcdee
VS
1/*
2 * Filter layer
3 * copyright (c) 2007 Bobby Bingham
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
e0752603 22#include <stdarg.h>
4dbbcdee
VS
23#include <stdlib.h>
24#include <string.h>
25#include <stdio.h>
26
27#include "avfilter.h"
d72a138e 28#include "allfilters.h"
4dbbcdee 29
6d8c67a7
VS
30/** list of registered filters */
31struct FilterList
32{
33 AVFilter *filter;
34 struct FilterList *next;
35} *filters = NULL;
4dbbcdee 36
6fb0648d
VS
37/** helper macros to get the in/out pad on the dst/src filter */
38#define link_dpad(link) link->dst-> input_pads[link->dstpad]
39#define link_spad(link) link->src->output_pads[link->srcpad]
40
269b9847 41AVFilterPicRef *avfilter_ref_pic(AVFilterPicRef *ref, int pmask)
4dbbcdee
VS
42{
43 AVFilterPicRef *ret = av_malloc(sizeof(AVFilterPicRef));
cdf2a332 44 *ret = *ref;
efb36bfc 45 ret->perms &= pmask;
4dbbcdee
VS
46 ret->pic->refcount ++;
47 return ret;
48}
49
50void avfilter_unref_pic(AVFilterPicRef *ref)
51{
269b9847 52 if(-- ref->pic->refcount == 0)
4dbbcdee
VS
53 ref->pic->free(ref->pic);
54 av_free(ref);
55}
56
24618441
VS
57void avfilter_insert_pad(unsigned idx, unsigned *count, size_t padidx_off,
58 AVFilterPad **pads, AVFilterLink ***links,
59 AVFilterPad *newpad)
60{
61 unsigned i;
62
63 idx = FFMIN(idx, *count);
64
65 *pads = av_realloc(*pads, sizeof(AVFilterPad) * (*count + 1));
66 *links = av_realloc(*links, sizeof(AVFilterLink*) * (*count + 1));
67 memmove(*pads +idx+1, *pads +idx, sizeof(AVFilterPad) * (*count-idx));
68 memmove(*links+idx+1, *links+idx, sizeof(AVFilterLink*) * (*count-idx));
69 memcpy(*pads+idx, newpad, sizeof(AVFilterPad));
70 (*links)[idx] = NULL;
71
72 (*count) ++;
73 for(i = idx+1; i < *count; i ++)
74 if(*links[i])
75 (*(unsigned *)((uint8_t *)(*links[i]) + padidx_off)) ++;
76}
77
4dbbcdee
VS
78int avfilter_link(AVFilterContext *src, unsigned srcpad,
79 AVFilterContext *dst, unsigned dstpad)
80{
81 AVFilterLink *link;
82
7d0e1392
VS
83 if(src->output_count <= srcpad || dst->input_count <= dstpad ||
84 src->outputs[srcpad] || dst->inputs[dstpad])
4dbbcdee
VS
85 return -1;
86
87 src->outputs[srcpad] =
c949d867 88 dst->inputs[dstpad] = link = av_mallocz(sizeof(AVFilterLink));
4dbbcdee 89
1653c11f
VS
90 link->src = src;
91 link->dst = dst;
92 link->srcpad = srcpad;
93 link->dstpad = dstpad;
01942f1d
VS
94 link->format = -1;
95
96 return 0;
97}
98
d21cbbff
VS
99static int common_format(int *fmts0, int *fmts1)
100{
101 int i, j;
102
103 for(i = 0; fmts0[i] != -1; i ++)
104 for(j = 0; fmts1[j] != -1; j ++)
105 if(fmts0[i] == fmts1[j])
106 return fmts0[i];
107
108 return -1;
109}
110
01942f1d
VS
111int avfilter_config_link(AVFilterLink *link)
112{
d21cbbff 113 int *fmts[3] = {NULL,NULL,NULL};
01942f1d 114 int (*config_link)(AVFilterLink *);
e675dccd 115 int *(*query_formats)(AVFilterLink *link);
01942f1d 116
d21cbbff
VS
117 AVFilterContext *scale;
118 AVFilterLink *link2 = NULL;
119
01942f1d
VS
120 if(!link)
121 return 0;
4dbbcdee 122
d21cbbff 123 /* find a format both filters support */
e675dccd
VS
124 if(!(query_formats = link_spad(link).query_formats))
125 query_formats = avfilter_default_query_output_formats;
126 fmts[0] = query_formats(link);
6fb0648d 127 fmts[1] = link_dpad(link).query_formats(link);
d21cbbff
VS
128 if((link->format = common_format(fmts[0], fmts[1])) == -1) {
129 /* no common format found. insert scale filter to convert */
130 if(!(scale = avfilter_open(&avfilter_vf_scale, NULL)))
131 goto format_done;
132 if(scale->filter->init(scale, NULL, NULL)) {
133 avfilter_destroy(scale);
134 goto format_done;
135 }
136
137 link->dst->inputs[link->dstpad] = NULL;
138 if(avfilter_link(scale, 0, link->dst, link->dstpad)) {
139 link->dst->inputs[link->dstpad] = link;
140 goto format_done;
141 }
142 link2 = scale->outputs[0];
143 link->dst = scale;
144 link->dstpad = 0;
145 scale->inputs[0] = link;
146
147 /* now try again to find working colorspaces.
148 * XXX: is it safe to assume that the scale filter always supports the
149 * same input and output colorspaces? */
150 fmts[2] = scale->input_pads[0].query_formats(link);
151 link->format = common_format(fmts[0], fmts[2]);
152 link2->format = common_format(fmts[1], fmts[2]);
153 }
e0752603
VS
154
155format_done:
156 av_free(fmts[0]);
157 av_free(fmts[1]);
d21cbbff
VS
158 av_free(fmts[2]);
159 if(link->format == -1 || (link2 && link2->format == -1)) {
160 if(link2) {
161 link->dst = link2->dst;
162 link->dstpad = link2->dstpad;
163 link->dst->inputs[link->dstpad] = link;
164 link->format = -1;
165 avfilter_destroy(scale);
166 av_free(link2);
167 }
e0752603 168 return -1;
d21cbbff 169 }
e0752603 170
6fb0648d 171 if(!(config_link = link_spad(link).config_props))
01942f1d
VS
172 config_link = avfilter_default_config_output_link;
173 if(config_link(link))
174 return -1;
102fb0e3 175
6fb0648d 176 if(!(config_link = link_dpad(link).config_props))
01942f1d
VS
177 config_link = avfilter_default_config_input_link;
178 if(config_link(link))
179 return -1;
102fb0e3 180
d21cbbff
VS
181 if(link2) {
182 if(!(config_link = link_spad(link2).config_props))
183 config_link = avfilter_default_config_output_link;
184 if(config_link(link2))
185 return -1;
186
187 if(!(config_link = link_dpad(link2).config_props))
188 config_link = avfilter_default_config_input_link;
189 if(config_link(link2))
190 return -1;
191 }
192
4dbbcdee
VS
193 return 0;
194}
195
196AVFilterPicRef *avfilter_get_video_buffer(AVFilterLink *link, int perms)
197{
198 AVFilterPicRef *ret = NULL;
199
6fb0648d
VS
200 if(link_dpad(link).get_video_buffer)
201 ret = link_dpad(link).get_video_buffer(link, perms);
4dbbcdee
VS
202
203 if(!ret)
204 ret = avfilter_default_get_video_buffer(link, perms);
205
206 return ret;
207}
208
3306f8bd 209int avfilter_request_frame(AVFilterLink *link)
4dbbcdee 210{
6fb0648d
VS
211 if(link_spad(link).request_frame)
212 return link_spad(link).request_frame(link);
9586ba3a 213 else if(link->src->inputs[0])
3306f8bd
VS
214 return avfilter_request_frame(link->src->inputs[0]);
215 else return -1;
4dbbcdee
VS
216}
217
218/* XXX: should we do the duplicating of the picture ref here, instead of
219 * forcing the source filter to do it? */
220void avfilter_start_frame(AVFilterLink *link, AVFilterPicRef *picref)
221{
222 void (*start_frame)(AVFilterLink *, AVFilterPicRef *);
223
e675dccd 224 if(!(start_frame = link_dpad(link).start_frame))
4dbbcdee
VS
225 start_frame = avfilter_default_start_frame;
226
c949d867 227 /* prepare to copy the picture if it has insufficient permissions */
269b9847
VS
228 if((link_dpad(link).min_perms & picref->perms) != link_dpad(link).min_perms ||
229 link_dpad(link).rej_perms & picref->perms) {
c949d867
VS
230 av_log(link->dst, AV_LOG_INFO,
231 "frame copy needed (have perms %x, need %x, reject %x)\n",
269b9847 232 picref->perms,
c949d867
VS
233 link_dpad(link).min_perms, link_dpad(link).rej_perms);
234
235 link->cur_pic = avfilter_default_get_video_buffer(link, link_dpad(link).min_perms);
236 link->srcpic = picref;
237 }
238 else
239 link->cur_pic = picref;
240
241 start_frame(link, link->cur_pic);
4dbbcdee
VS
242}
243
244void avfilter_end_frame(AVFilterLink *link)
245{
246 void (*end_frame)(AVFilterLink *);
247
c949d867
VS
248 /* unreference the source picture if we're feeding the destination filter
249 * a copied version dues to permission issues */
250 if(link->srcpic) {
251 avfilter_unref_pic(link->srcpic);
252 link->srcpic = NULL;
253 }
254
e675dccd 255 if(!(end_frame = link_dpad(link).end_frame))
4dbbcdee
VS
256 end_frame = avfilter_default_end_frame;
257
258 end_frame(link);
259}
260
ef35d13a 261void avfilter_draw_slice(AVFilterLink *link, int y, int h)
4dbbcdee 262{
c949d867
VS
263 uint8_t *src[4], *dst[4];
264 int i, j, hsub, vsub;
265
266 /* copy the slice if needed for permission reasons */
267 if(link->srcpic) {
268 avcodec_get_chroma_sub_sample(link->format, &hsub, &vsub);
269
270 src[0] = link->srcpic-> data[0] + y * link->srcpic-> linesize[0];
271 dst[0] = link->cur_pic->data[0] + y * link->cur_pic->linesize[0];
272 for(i = 1; i < 4; i ++) {
273 if(link->srcpic->data[i]) {
274 src[i] = link->srcpic-> data[i] + (y >> vsub) * link->srcpic-> linesize[i];
275 dst[i] = link->cur_pic->data[i] + (y >> vsub) * link->cur_pic->linesize[i];
276 } else
277 src[i] = dst[i] = NULL;
278 }
279 for(j = 0; j < h; j ++) {
280 memcpy(dst[0], src[0], link->cur_pic->linesize[0]);
281 src[0] += link->srcpic ->linesize[0];
282 dst[0] += link->cur_pic->linesize[0];
283 }
284 for(i = 1; i < 4; i ++) {
285 if(!src[i]) continue;
286
287 for(j = 0; j < h >> vsub; j ++) {
288 memcpy(dst[i], src[i], link->cur_pic->linesize[i]);
289 src[i] += link->srcpic ->linesize[i];
290 dst[i] += link->cur_pic->linesize[i];
291 }
292 }
293 }
294
6fb0648d 295 if(!link_dpad(link).draw_slice)
7d0e1392
VS
296 return;
297
6fb0648d 298 link_dpad(link).draw_slice(link, y, h);
4dbbcdee
VS
299}
300
4dbbcdee
VS
301AVFilter *avfilter_get_by_name(char *name)
302{
6d8c67a7
VS
303 struct FilterList *filt;
304
305 for(filt = filters; filt; filt = filt->next)
306 if(!strcmp(filt->filter->name, name))
307 return filt->filter;
4dbbcdee 308
4dbbcdee
VS
309 return NULL;
310}
311
4dbbcdee
VS
312void avfilter_register(AVFilter *filter)
313{
6d8c67a7
VS
314 struct FilterList *newfilt = av_malloc(sizeof(struct FilterList));
315
316 newfilt->filter = filter;
317 newfilt->next = filters;
318 filters = newfilt;
4dbbcdee
VS
319}
320
321void avfilter_init(void)
322{
7bce27a3
VS
323 avfilter_register(&avfilter_vf_crop);
324 avfilter_register(&avfilter_vf_fifo);
325 avfilter_register(&avfilter_vf_fps);
326 avfilter_register(&avfilter_vf_graph);
327 avfilter_register(&avfilter_vf_graphdesc);
328 avfilter_register(&avfilter_vf_graphfile);
f9033975 329 avfilter_register(&avfilter_vf_negate);
7bce27a3
VS
330 avfilter_register(&avfilter_vf_overlay);
331 avfilter_register(&avfilter_vf_passthrough);
2a553ef5 332 avfilter_register(&avfilter_vf_scale);
7bce27a3
VS
333 avfilter_register(&avfilter_vf_slicify);
334 avfilter_register(&avfilter_vf_split);
335 avfilter_register(&avfilter_vf_vflip);
4dbbcdee
VS
336}
337
338void avfilter_uninit(void)
339{
6d8c67a7
VS
340 struct FilterList *tmp;
341
342 for(; filters; filters = tmp) {
343 tmp = filters->next;
344 av_free(filters);
345 }
4dbbcdee
VS
346}
347
348static int pad_count(const AVFilterPad *pads)
349{
350 AVFilterPad *p = (AVFilterPad *) pads;
351 int count;
352
353 for(count = 0; p->name; count ++) p ++;
354 return count;
355}
356
357static const char *filter_name(void *p)
358{
359 AVFilterContext *filter = p;
360 return filter->filter->name;
361}
362
44b73497 363AVFilterContext *avfilter_open(AVFilter *filter, char *inst_name)
4dbbcdee 364{
8f618f4c
VS
365 AVFilterContext *ret;
366
367 if (!filter)
368 return 0;
369
370 ret = av_malloc(sizeof(AVFilterContext));
4dbbcdee
VS
371
372 ret->av_class = av_mallocz(sizeof(AVClass));
373 ret->av_class->item_name = filter_name;
374 ret->filter = filter;
2350e69c 375 ret->name = inst_name ? av_strdup(inst_name) : NULL;
4dbbcdee
VS
376 ret->priv = av_mallocz(filter->priv_size);
377
7d0e1392 378 ret->input_count = pad_count(filter->inputs);
c5ef7d7b
VS
379 ret->input_pads = av_malloc(sizeof(AVFilterPad) * ret->input_count);
380 memcpy(ret->input_pads, filter->inputs, sizeof(AVFilterPad)*ret->input_count);
7d0e1392 381 ret->inputs = av_mallocz(sizeof(AVFilterLink*) * ret->input_count);
c5ef7d7b 382
7d0e1392 383 ret->output_count = pad_count(filter->outputs);
c5ef7d7b
VS
384 ret->output_pads = av_malloc(sizeof(AVFilterPad) * ret->output_count);
385 memcpy(ret->output_pads, filter->outputs, sizeof(AVFilterPad)*ret->output_count);
7d0e1392
VS
386 ret->outputs = av_mallocz(sizeof(AVFilterLink*) * ret->output_count);
387
4dbbcdee
VS
388 return ret;
389}
390
391void avfilter_destroy(AVFilterContext *filter)
392{
393 int i;
394
395 if(filter->filter->uninit)
396 filter->filter->uninit(filter);
397
c5ef7d7b 398 for(i = 0; i < filter->input_count; i ++) {
4dbbcdee
VS
399 if(filter->inputs[i])
400 filter->inputs[i]->src->outputs[filter->inputs[i]->srcpad] = NULL;
f4cb4462 401 av_freep(&filter->inputs[i]);
4dbbcdee 402 }
c5ef7d7b 403 for(i = 0; i < filter->output_count; i ++) {
4dbbcdee
VS
404 if(filter->outputs[i])
405 filter->outputs[i]->dst->inputs[filter->outputs[i]->dstpad] = NULL;
f4cb4462 406 av_freep(&filter->outputs[i]);
4dbbcdee
VS
407 }
408
f4cb4462
VS
409 av_freep(&filter->name);
410 av_freep(&filter->input_pads);
411 av_freep(&filter->output_pads);
412 av_freep(&filter->inputs);
413 av_freep(&filter->outputs);
414 av_freep(&filter->priv);
415 av_freep(&filter->av_class);
4dbbcdee
VS
416 av_free(filter);
417}
418
a360f71e 419int avfilter_init_filter(AVFilterContext *filter, const char *args, void *opaque)
4dbbcdee 420{
c6b0aa68 421 int ret;
4dbbcdee
VS
422
423 if(filter->filter->init)
a360f71e 424 if((ret = filter->filter->init(filter, args, opaque))) return ret;
4dbbcdee
VS
425 return 0;
426}
427
e0752603
VS
428int *avfilter_make_format_list(int len, ...)
429{
430 int *ret, i;
431 va_list vl;
432
433 ret = av_malloc(sizeof(int) * (len + 1));
434 va_start(vl, len);
435 for(i = 0; i < len; i ++)
436 ret[i] = va_arg(vl, int);
437 va_end(vl);
438 ret[len] = -1;
439
440 return ret;
441}
442