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_FLAG_LAST: first flag that can be used by subclasses.
102 * Flags for the padtemplate
106 GST_PAD_TEMPLATE_FLAG_LAST = (GST_OBJECT_FLAG_LAST << 4)
107 } GstPadTemplateFlags;
110 * GST_PAD_TEMPLATE_IS_FIXED:
111 * @templ: the template to query
113 * Check if the properties of the padtemplate are fixed
115 #define GST_PAD_TEMPLATE_IS_FIXED(templ) (GST_OBJECT_FLAG_IS_SET(templ, GST_PAD_TEMPLATE_FIXED))
120 * The padtemplate object.
122 struct _GstPadTemplate {
125 gchar *name_template;
126 GstPadDirection direction;
127 GstPadPresence presence;
130 gpointer _gst_reserved[GST_PADDING];
133 struct _GstPadTemplateClass {
134 GstObjectClass parent_class;
136 /* signal callbacks */
137 void (*pad_created) (GstPadTemplate *templ, GstPad *pad);
139 gpointer _gst_reserved[GST_PADDING];
143 * GstStaticPadTemplate:
144 * @name_template: the name of the template
145 * @direction: the direction of the template
146 * @presence: the presence of the template
147 * @static_caps: the caps of the template.
149 * Structure describing the #GstStaticPadTemplate.
151 struct _GstStaticPadTemplate {
152 const gchar *name_template;
153 GstPadDirection direction;
154 GstPadPresence presence;
155 GstStaticCaps static_caps;
159 * GST_STATIC_PAD_TEMPLATE:
160 * @padname: the name template of the pad
161 * @dir: the GstPadDirection of the pad
162 * @pres: the GstPadPresence of the pad
163 * @caps: the GstStaticCaps of the pad
165 * Convenience macro to fill the values of a GstStaticPadTemplate
168 #define GST_STATIC_PAD_TEMPLATE(padname, dir, pres, caps) \
170 /* name_template */ padname, \
171 /* direction */ dir, \
172 /* presence */ pres, \
176 /* templates and factories */
177 GType gst_pad_template_get_type (void);
178 GType gst_static_pad_template_get_type (void);
180 GstPadTemplate* gst_pad_template_new (const gchar *name_template,
181 GstPadDirection direction, GstPadPresence presence,
184 GstPadTemplate * gst_static_pad_template_get (GstStaticPadTemplate *pad_template);
185 GstCaps* gst_static_pad_template_get_caps (GstStaticPadTemplate *templ);
186 GstCaps* gst_pad_template_get_caps (GstPadTemplate *templ);
188 void gst_pad_template_pad_created (GstPadTemplate * templ, GstPad * pad);
192 #endif /* __GST_PAD_TEMPLATE_H__ */