summaryrefslogtreecommitdiff
path: root/gegl/gegl-apply.h
blob: fb164565de1b148ae0c26d7c25905b425e25349d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
/* This file is part of GEGL
 *
 * GEGL is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 3 of the License, or (at your option) any later version.
 *
 * GEGL is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with GEGL; if not, see <http://www.gnu.org/licenses/>.
 *
 * Copyright 2003 Calvin Williamson
 *           2006 Øyvind Kolås
 */

#ifndef __GEGL_APPLY_H__
#define __GEGL_APPLY_H__

G_BEGIN_DECLS

/**
 * gegl_apply_op:
 * @buffer: the #GeglBuffer to apply onto
 * @operation_name: name of the operation to apply
 * @...: the settings for the operation. Zero or more key/value pairs,
 * ended terminated with NULL.
 *
 * Apply the operation to buffer, overwritting the contents of buffer.
 *
 */
void        gegl_apply_op  (GeglBuffer    *buffer,
                            const gchar   *operation_name,
                            ...) G_GNUC_NULL_TERMINATED;

/**
 * gegl_filter_op:
 * @source_buffer: the source #GeglBuffer for the filter
 * @operation_name: name of the operation to apply
 * @...: the settings for the operation. Zero or more key/value pairs,
 * ended terminated with NULL.
 *
 * Apply the operation to source_buffer, returning the result in a new buffer.
 *
 * Return value: (transfer full): the result of the filter
 */
GeglBuffer *gegl_filter_op (GeglBuffer    *source_buffer,
                            const gchar   *operation_name,
                            ...) G_GNUC_NULL_TERMINATED;


/**
 * gegl_render_op:
 * @source_buffer: the source #GeglBuffer for the filter
 * @target_buffer: the source #GeglBuffer for the filter
 * @operation_name: name of the operation to apply
 * @...: the settings for the operation. Zero or more key/value pairs,
 * ended terminated with NULL.
 *
 * Apply the operation to source_buffer, writing the results to target_buffer.
 *
 */
void        gegl_render_op (GeglBuffer    *source_buffer,
                            GeglBuffer    *target_buffer,
                            const gchar   *operation_name,
                            ...) G_GNUC_NULL_TERMINATED;

/* the following only exist to make gegl_apply and gegl_filter bindable */

/**
 * gegl_apply_op_valist:
 * @buffer: the #GeglBuffer to apply onto
 * @operation_name: name of the operation to apply
 * @var_args: the settings for the operation. Zero or more key/value pairs,
 * ended terminated with NULL.
 *
 * Apply the operation to buffer, overwritting the contents of buffer.
 *
 */
void        gegl_apply_op_valist (GeglBuffer    *buffer,
                                  const gchar   *operation_name,
                                  va_list        var_args);

/**
 * gegl_filter_op_valist:
 * @source_buffer: the source #GeglBuffer for the filter
 * @operation_name: name of the operation to apply
 * @var_args: the settings for the operation. Zero or more key/value pairs,
 * ended terminated with NULL.
 *
 * Apply the operation to source_buffer, returning the result in a new buffer.
 *
 * Return value: (transfer full): the result of the filter
 */
GeglBuffer *gegl_filter_op_valist (GeglBuffer   *source_buffer,
                                   const gchar  *operation_name,
                                   va_list       var_args);

/**
 * gegl_render_op_valist:
 * @source_buffer: the source #GeglBuffer for the filter
 * @target_buffer: the source #GeglBuffer for the filter
 * @operation_name: name of the operation to apply
 * @var_args: the settings for the operation. Zero or more key/value pairs,
 * ended terminated with NULL.
 *
 * Apply the operation to source_buffer, writing the results to target_buffer.
 *
 */
void        gegl_render_op_valist (GeglBuffer   *source_buffer,
                                   GeglBuffer   *target_buffer,
                                   const gchar  *operation_name,
                                   va_list       var_args);

G_END_DECLS

#endif /* __GEGL_APPLY_H__ */