2 * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
3 * 2000 Wim Taymans <wim.taymans@chello.be>
5 * gstpadtemplate.h: Header for GstPadTemplate object
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Library General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library 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 * Library General Public License for more details.
17 * You should have received a copy of the GNU Library General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
24 #ifndef __GST_PAD_TEMPLATE_H__
25 #define __GST_PAD_TEMPLATE_H__
27 #include <gst/gstconfig.h>
29 #include <gst/gstobject.h>
30 #include <gst/gstbuffer.h>
31 #include <gst/gstcaps.h>
32 #include <gst/gstevent.h>
33 #include <gst/gstquery.h>
34 #include <gst/gsttask.h>
38 /* FIXME: this awful circular dependency need to be resolved properly (see pad.h) */
39 /*typedef struct _GstPadTemplate GstPadTemplate; */
40 typedef struct _GstPadTemplateClass GstPadTemplateClass;
41 typedef struct _GstStaticPadTemplate GstStaticPadTemplate;
43 #define GST_TYPE_STATIC_PAD_TEMPLATE (gst_static_pad_template_get_type ())
45 #define GST_TYPE_PAD_TEMPLATE (gst_pad_template_get_type ())
46 #define GST_PAD_TEMPLATE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_PAD_TEMPLATE,GstPadTemplate))
47 #define GST_PAD_TEMPLATE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_PAD_TEMPLATE,GstPadTemplateClass))
48 #define GST_IS_PAD_TEMPLATE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_PAD_TEMPLATE))
49 #define GST_IS_PAD_TEMPLATE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_PAD_TEMPLATE))
53 * @GST_PAD_ALWAYS: the pad is always available
54 * @GST_PAD_SOMETIMES: the pad will become available depending on the media stream
55 * @GST_PAD_REQUEST: the pad is only available on request with
56 * gst_element_get_request_pad().
58 * Indicates when this pad will become available.
67 * GST_PAD_TEMPLATE_NAME_TEMPLATE:
68 * @templ: the template to query
70 * Get the nametemplate of the padtemplate.
72 #define GST_PAD_TEMPLATE_NAME_TEMPLATE(templ) (((GstPadTemplate *)(templ))->name_template)
75 * GST_PAD_TEMPLATE_DIRECTION:
76 * @templ: the template to query
78 * Get the #GstPadDirection of the padtemplate.
80 #define GST_PAD_TEMPLATE_DIRECTION(templ) (((GstPadTemplate *)(templ))->direction)
83 * GST_PAD_TEMPLATE_PRESENCE:
84 * @templ: the template to query
86 * Get the #GstPadPresence of the padtemplate.
88 #define GST_PAD_TEMPLATE_PRESENCE(templ) (((GstPadTemplate *)(templ))->presence)
91 * GST_PAD_TEMPLATE_CAPS:
92 * @templ: the template to query
94 * Get a handle to the padtemplate #GstCaps
96 #define GST_PAD_TEMPLATE_CAPS(templ) (((GstPadTemplate *)(templ))->caps)
99 * GstPadTemplateFlags:
100 * @GST_PAD_TEMPLATE_FIXED: the padtemplate has no variable properties
101 * @GST_PAD_TEMPLATE_FLAG_LAST: first flag that can be used by subclasses.
103 * Flags for the padtemplate
106 /* FIXME0.11: this is not used and the purpose is unclear */
107 GST_PAD_TEMPLATE_FIXED = (GST_OBJECT_FLAG_LAST << 0),
109 GST_PAD_TEMPLATE_FLAG_LAST = (GST_OBJECT_FLAG_LAST << 4)
110 } GstPadTemplateFlags;
113 * GST_PAD_TEMPLATE_IS_FIXED:
114 * @templ: the template to query
116 * Check if the properties of the padtemplate are fixed
118 #define GST_PAD_TEMPLATE_IS_FIXED(templ) (GST_OBJECT_FLAG_IS_SET(templ, GST_PAD_TEMPLATE_FIXED))
123 * The padtemplate object.
125 struct _GstPadTemplate {
128 gchar *name_template;
129 GstPadDirection direction;
130 GstPadPresence presence;
133 gpointer _gst_reserved[GST_PADDING];
136 struct _GstPadTemplateClass {
137 GstObjectClass parent_class;
139 /* signal callbacks */
140 void (*pad_created) (GstPadTemplate *templ, GstPad *pad);
142 gpointer _gst_reserved[GST_PADDING];
146 * GstStaticPadTemplate:
147 * @name_template: the name of the template
148 * @direction: the direction of the template
149 * @presence: the presence of the template
150 * @static_caps: the caps of the template.
152 * Structure describing the #GstStaticPadTemplate.
154 struct _GstStaticPadTemplate {
155 const gchar *name_template;
156 GstPadDirection direction;
157 GstPadPresence presence;
158 GstStaticCaps static_caps;
162 * GST_STATIC_PAD_TEMPLATE:
163 * @padname: the name template of the pad
164 * @dir: the GstPadDirection of the pad
165 * @pres: the GstPadPresence of the pad
166 * @caps: the GstStaticCaps of the pad
168 * Convenience macro to fill the values of a GstStaticPadTemplate
171 #define GST_STATIC_PAD_TEMPLATE(padname, dir, pres, caps) \
173 /* name_template */ padname, \
174 /* direction */ dir, \
175 /* presence */ pres, \
179 /* templates and factories */
180 GType gst_pad_template_get_type (void);
181 GType gst_static_pad_template_get_type (void);
183 GstPadTemplate* gst_pad_template_new (const gchar *name_template,
184 GstPadDirection direction, GstPadPresence presence,
185 GstCaps *caps) G_GNUC_MALLOC;
187 GstPadTemplate * gst_static_pad_template_get (GstStaticPadTemplate *pad_template);
188 GstCaps* gst_static_pad_template_get_caps (GstStaticPadTemplate *templ);
189 GstCaps* gst_pad_template_get_caps (GstPadTemplate *templ);
191 void gst_pad_template_pad_created (GstPadTemplate * templ, GstPad * pad);
195 #endif /* __GST_PAD_TEMPLATE_H__ */