Remove AVFilterGraphDesc struct.
[ffmpeg.git] / libavfilter / avfiltergraph.c
1 /*
2  * filter graphs
3  * copyright (c) 2008 Vitor Sessak
4  * copyright (c) 2007 Bobby Bingham
5  *
6  * This file is part of FFmpeg.
7  *
8  * FFmpeg is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * FFmpeg is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with FFmpeg; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22
23 #include <ctype.h>
24 #include <string.h>
25
26 #include "avfilter.h"
27 #include "avfiltergraph.h"
28
29 /**
30  * For use in av_log
31  */
32 static const char *log_name(void *p)
33 {
34     return "Filter parser";
35 }
36
37 static const AVClass filter_parser_class = {
38     "Filter parser",
39     log_name
40 };
41
42 static const AVClass *log_ctx = &filter_parser_class;
43
44 void avfilter_destroy_graph(AVFilterGraph *graph)
45 {
46     for(; graph->filter_count > 0; graph->filter_count --)
47         avfilter_destroy(graph->filters[graph->filter_count - 1]);
48     av_freep(&graph->filters);
49 }
50
51 /* TODO: insert in sorted order */
52 void avfilter_graph_add_filter(AVFilterGraph *graph, AVFilterContext *filter)
53 {
54     graph->filters = av_realloc(graph->filters,
55                                 sizeof(AVFilterContext*) * ++graph->filter_count);
56     graph->filters[graph->filter_count - 1] = filter;
57 }
58
59 /* search intelligently, once we insert in order */
60 AVFilterContext *avfilter_graph_get_filter(AVFilterGraph *graph, char *name)
61 {
62     int i;
63
64     if(!name)
65         return NULL;
66
67     for(i = 0; i < graph->filter_count; i ++)
68         if(graph->filters[i]->name && !strcmp(name, graph->filters[i]->name))
69             return graph->filters[i];
70
71     return NULL;
72 }
73
74 static int query_formats(AVFilterGraph *graph)
75 {
76     int i, j;
77
78     /* ask all the sub-filters for their supported colorspaces */
79     for(i = 0; i < graph->filter_count; i ++) {
80         if(graph->filters[i]->filter->query_formats)
81             graph->filters[i]->filter->query_formats(graph->filters[i]);
82         else
83             avfilter_default_query_formats(graph->filters[i]);
84     }
85
86     /* go through and merge as many format lists as possible */
87     for(i = 0; i < graph->filter_count; i ++) {
88         AVFilterContext *filter = graph->filters[i];
89
90         for(j = 0; j < filter->input_count; j ++) {
91             AVFilterLink *link;
92             if(!(link = filter->inputs[j]))
93                 continue;
94             if(link->in_formats != link->out_formats) {
95                 if(!avfilter_merge_formats(link->in_formats,
96                                            link->out_formats)) {
97                     /* couldn't merge format lists. auto-insert scale filter */
98                     AVFilterContext *scale;
99
100                     if(!(scale =
101                          avfilter_open(avfilter_get_by_name("scale"), NULL)))
102                         return -1;
103                     if(scale->filter->init(scale, NULL, NULL) ||
104                        avfilter_insert_filter(link, scale, 0, 0)) {
105                         avfilter_destroy(scale);
106                         return -1;
107                     }
108
109                     avfilter_graph_add_filter(graph, scale);
110                     scale->filter->query_formats(scale);
111                     if(!avfilter_merge_formats(scale-> inputs[0]->in_formats,
112                                               scale-> inputs[0]->out_formats) ||
113                        !avfilter_merge_formats(scale->outputs[0]->in_formats,
114                                               scale->outputs[0]->out_formats))
115                         return -1;
116                 }
117             }
118         }
119     }
120
121     return 0;
122 }
123
124 static void pick_format(AVFilterLink *link)
125 {
126     if(!link || !link->in_formats)
127         return;
128
129     link->in_formats->format_count = 1;
130     link->format = link->in_formats->formats[0];
131
132     avfilter_formats_unref(&link->in_formats);
133     avfilter_formats_unref(&link->out_formats);
134 }
135
136 static void pick_formats(AVFilterGraph *graph)
137 {
138     int i, j;
139
140     for(i = 0; i < graph->filter_count; i ++) {
141         AVFilterContext *filter = graph->filters[i];
142
143         for(j = 0; j < filter->input_count; j ++)
144             pick_format(filter->inputs[j]);
145         for(j = 0; j < filter->output_count; j ++)
146             pick_format(filter->outputs[j]);
147     }
148 }
149
150 int avfilter_graph_config_formats(AVFilterGraph *graph)
151 {
152     /* find supported formats from sub-filters, and merge along links */
153     if(query_formats(graph))
154         return -1;
155
156     /* Once everything is merged, it's possible that we'll still have
157      * multiple valid colorspace choices. We pick the first one. */
158     pick_formats(graph);
159
160     return 0;
161 }
162
163 static int create_filter(AVFilterGraph *ctx, int index, char *name,
164                          char *args)
165 {
166     AVFilterContext *filt;
167
168     AVFilter *filterdef;
169     char tmp[20];
170
171     snprintf(tmp, 20, "%d", index);
172     if(!(filterdef = avfilter_get_by_name(name)) ||
173        !(filt = avfilter_open(filterdef, tmp))) {
174         av_log(&log_ctx, AV_LOG_ERROR,
175                "error creating filter '%s'\n", name);
176         return -1;
177     }
178     avfilter_graph_add_filter(ctx, filt);
179     if(avfilter_init_filter(filt, args, NULL)) {
180         av_log(&log_ctx, AV_LOG_ERROR,
181                "error initializing filter '%s'\n", name);
182         return -1;
183     }
184
185     return 0;
186 }
187
188 static int link_filter(AVFilterGraph *ctx, int src, int srcpad,
189                        int dst, int dstpad)
190 {
191     AVFilterContext *filt, *filtb;
192
193     char tmp[20];
194
195     snprintf(tmp, 20, "%d", src);
196     if(!(filt = avfilter_graph_get_filter(ctx, tmp))) {
197         av_log(&log_ctx, AV_LOG_ERROR, "link source does not exist in graph\n");
198         return -1;
199     }
200     snprintf(tmp, 20, "%d", dst);
201     if(!(filtb = avfilter_graph_get_filter(ctx, tmp))) {
202         av_log(&log_ctx, AV_LOG_ERROR, "link destination does not exist in graph\n");
203         return -1;
204     }
205     if(avfilter_link(filt, srcpad, filtb, dstpad)) {
206         av_log(&log_ctx, AV_LOG_ERROR, "cannot create link between source and destination filters\n");
207         return -1;
208     }
209
210     return 0;
211 }
212
213 static void consume_whitespace(const char **buf)
214 {
215     *buf += strspn(*buf, " \n\t");
216 }
217
218 /**
219  * get the next non-whitespace char
220  */
221 static char consume_char(const char **buf)
222 {
223     char out;
224     consume_whitespace(buf);
225
226     out = **buf;
227
228     if (out)
229         (*buf)++;
230
231     return out;
232 }
233
234 /**
235  * remove the quotation marks from a string. Ex: "aaa'bb'cc" -> "aaabbcc"
236  */
237 static void unquote(char *str)
238 {
239     char *p1, *p2;
240     p1=p2=str;
241     while (*p1 != 0) {
242         if (*p1 != '\'')
243             *p2++ = *p1;
244         p1++;
245     }
246
247     *p2 = 0;
248 }
249
250 /**
251  * Consumes a string from *buf.
252  * @return a copy of the consumed string, which should be free'd after use
253  */
254 static char *consume_string(const char **buf)
255 {
256     const char *start;
257     char *ret;
258     int size;
259
260     consume_whitespace(buf);
261
262     if (!(**buf))
263         return av_mallocz(1);
264
265     start = *buf;
266
267     *buf += strcspn(*buf, " ()=,'");
268
269     if (**buf == '\'') {
270         char *p = strchr(*buf + 1, '\'');
271         if (p)
272             *buf = p + 1;
273         else
274             *buf += strlen(*buf); // Move the pointer to the null end byte
275     }
276
277     size = *buf - start + 1;
278     ret = av_malloc(size);
279     memcpy(ret, start, size - 1);
280     ret[size-1] = 0;
281
282     unquote(ret);
283
284     return ret;
285 }
286
287 /**
288  * Parse "(linkname)"
289  * @arg name a pointer (that need to be free'd after use) to the name between
290  *           parenthesis
291  */
292 static void parse_link_name(const char **buf, char **name)
293 {
294     consume_char(buf);
295
296     *name = consume_string(buf);
297
298     if (!*name[0])
299         goto fail;
300
301     if (consume_char(buf) != ')')
302         goto fail;
303
304     return;
305  fail:
306     av_freep(name);
307     av_log(&log_ctx, AV_LOG_ERROR, "Could not parse link name!\n");
308 }
309
310 /**
311  * Parse "filter=params"
312  * @arg name a pointer (that need to be free'd after use) to the name of the
313  *           filter
314  * @arg ars  a pointer (that need to be free'd after use) to the args of the
315  *           filter
316  */
317 static int parse_filter(const char **buf, AVFilterGraph *graph, int index)
318 {
319     char *name, *opts;
320     name = consume_string(buf);
321
322     if (**buf == '=') {
323         consume_char(buf);
324         opts = consume_string(buf);
325     } else {
326         opts = NULL;
327     }
328
329     return create_filter(graph, index, name, opts);
330 }
331
332 enum LinkType {
333     LinkTypeIn,
334     LinkTypeOut,
335 };
336
337 /**
338  * A linked-list of the inputs/outputs of the filter chain.
339  */
340 typedef struct AVFilterInOut {
341     enum LinkType type;
342     char *name;
343     int instance;
344     int pad_idx;
345
346     struct AVFilterInOut *next;
347 } AVFilterInOut;
348
349 static void free_inout(AVFilterInOut *head)
350 {
351     while (head) {
352         AVFilterInOut *next;
353         next = head->next;
354         av_free(head);
355         head = next;
356     }
357 }
358
359 /**
360  * Parse "(a1)(link2) ... (etc)"
361  */
362 static int parse_inouts(const char **buf, AVFilterInOut **inout, int firstpad,
363                         enum LinkType type, int instance)
364 {
365     int pad = firstpad;
366     while (**buf == '(') {
367         AVFilterInOut *inoutn = av_malloc(sizeof(AVFilterInOut));
368         parse_link_name(buf, &inoutn->name);
369         inoutn->type = type;
370         inoutn->instance = instance;
371         inoutn->pad_idx = pad++;
372         inoutn->next = *inout;
373         *inout = inoutn;
374     }
375     return pad;
376 }
377
378 /**
379  * Parse a string describing a filter graph.
380  */
381 int avfilter_graph_parse_chain(AVFilterGraph *graph, const char *filters, AVFilterContext *in, int inpad, AVFilterContext *out, int outpad)
382 {
383     AVFilterInOut           *inout=NULL;
384     AVFilterInOut           *head=NULL;
385
386     int index = 0;
387     char chr = 0;
388     int pad = 0;
389     int has_out = 0;
390
391     char tmp[20];
392     AVFilterContext *filt;
393
394     consume_whitespace(&filters);
395
396     do {
397         int oldpad = pad;
398
399         pad = parse_inouts(&filters, &inout, chr == ',', LinkTypeIn, index);
400
401         if (parse_filter(&filters, graph, index) < 0)
402             goto fail;
403
404         // If the first filter has an input and none was given, it is
405         // implicitly the input of the whole graph.
406         if (pad == 0 && graph->filters[graph->filter_count-1]->input_count == 1) {
407             snprintf(tmp, 20, "%d", index);
408             if(!(filt = avfilter_graph_get_filter(graph, tmp))) {
409                 av_log(&log_ctx, AV_LOG_ERROR, "filter owning exported pad does not exist\n");
410                 goto fail;
411             }
412             if(avfilter_link(in, inpad, filt, 0)) {
413                 av_log(&log_ctx, AV_LOG_ERROR, "cannot create link between source and destination filters\n");
414                 goto fail;
415             }
416         }
417
418         if(chr == ',') {
419             if (link_filter(graph, index-1, oldpad, index, 0) < 0)
420                 goto fail;
421
422         }
423         pad = parse_inouts(&filters, &inout, 0, LinkTypeOut, index);
424         chr = consume_char(&filters);
425         index++;
426     } while (chr == ',' || chr == ';');
427
428     head = inout;
429     for (; inout != NULL; inout = inout->next) {
430         if (inout->instance == -1)
431             continue; // Already processed
432
433         if (!strcmp(inout->name, "in")) {
434             snprintf(tmp, 20, "%d", inout->instance);
435             if(!(filt = avfilter_graph_get_filter(graph, tmp))) {
436                 av_log(&log_ctx, AV_LOG_ERROR, "filter owning exported pad does not exist\n");
437                 goto fail;
438             }
439             if(avfilter_link(in, inpad, filt, inout->pad_idx)) {
440                 av_log(&log_ctx, AV_LOG_ERROR, "cannot create link between source and destination filters\n");
441                 goto fail;
442             }
443         } else if (!strcmp(inout->name, "out")) {
444             has_out = 1;
445             snprintf(tmp, 20, "%d", inout->instance);
446             if(!(filt = avfilter_graph_get_filter(graph, tmp))) {
447                 av_log(&log_ctx, AV_LOG_ERROR, "filter owning exported pad does not exist\n");
448                 goto fail;
449             }
450
451             if(avfilter_link(filt, inout->pad_idx, out, outpad)) {
452                 av_log(&log_ctx, AV_LOG_ERROR, "cannot create link between source and destination filters\n");
453                 goto fail;
454         }
455
456         } else {
457             AVFilterInOut *p, *src, *dst;
458             for (p = inout->next;
459                  p && strcmp(p->name,inout->name); p = p->next);
460
461             if (!p) {
462                 av_log(&log_ctx, AV_LOG_ERROR, "Unmatched link: %s.\n",
463                        inout->name);
464                 goto fail;
465             }
466
467             if (p->type == LinkTypeIn && inout->type == LinkTypeOut) {
468                 src = inout;
469                 dst = p;
470             } else if (p->type == LinkTypeOut && inout->type == LinkTypeIn) {
471                 src = p;
472                 dst = inout;
473             } else {
474                 av_log(&log_ctx, AV_LOG_ERROR, "Two links named '%s' are either both input or both output\n",
475                        inout->name);
476                 goto fail;
477             }
478
479             if (link_filter(graph, src->instance, src->pad_idx, dst->instance, dst->pad_idx) < 0)
480                 goto fail;
481
482             src->instance = -1;
483             dst->instance = -1;
484         }
485     }
486
487     free_inout(head);
488
489     if (!has_out) {
490         snprintf(tmp, 20, "%d", index-1);
491         if(!(filt = avfilter_graph_get_filter(graph, tmp))) {
492             av_log(&log_ctx, AV_LOG_ERROR, "filter owning exported pad does not exist\n");
493             goto fail;
494         }
495
496         if(avfilter_link(filt, pad, out, outpad)) {
497             av_log(&log_ctx, AV_LOG_ERROR, "cannot create link between source and destination filters\n");
498             goto fail;
499         }
500
501     }
502
503     return 0;
504
505  fail:
506     free_inout(head);
507     avfilter_destroy_graph(graph);
508     return -1;
509 }