gst/gstpadtemplate.h

   1 /* GStreamer
   2  * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
   3  *                    2000 Wim Taymans <wim.taymans@chello.be>
   4  *
   5  * gstpadtemplate.h: Header for GstPadTemplate object
   6  *
   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.
  11  *
  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.
  16  *
  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., 51 Franklin St, Fifth Floor,
  20  * Boston, MA 02110-1301, USA.
  21  */
  22
  23
  24 #ifndef __GST_PAD_TEMPLATE_H__
  25 #define __GST_PAD_TEMPLATE_H__
  26
  27 #include <gst/gstconfig.h>
  28
  29 typedef struct _GstPadTemplate GstPadTemplate;
  30 typedef struct _GstPadTemplateClass GstPadTemplateClass;
  31 typedef struct _GstStaticPadTemplate GstStaticPadTemplate;
  32
  33 #include <gst/gstobject.h>
  34 #include <gst/gstbuffer.h>
  35 #include <gst/gstcaps.h>
  36 #include <gst/gstevent.h>
  37 #include <gst/gstquery.h>
  38 #include <gst/gsttask.h>
  39
  40 G_BEGIN_DECLS
  41
  42 #define GST_TYPE_STATIC_PAD_TEMPLATE    (gst_static_pad_template_get_type ())
  43
  44 #define GST_TYPE_PAD_TEMPLATE           (gst_pad_template_get_type ())
  45 #define GST_PAD_TEMPLATE(obj)           (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_PAD_TEMPLATE,GstPadTemplate))
  46 #define GST_PAD_TEMPLATE_CLASS(klass)   (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_PAD_TEMPLATE,GstPadTemplateClass))
  47 #define GST_IS_PAD_TEMPLATE(obj)        (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_PAD_TEMPLATE))
  48 #define GST_IS_PAD_TEMPLATE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_PAD_TEMPLATE))
  49
  50 /**
  51  * GstPadPresence:
  52  * @GST_PAD_ALWAYS: the pad is always available
  53  * @GST_PAD_SOMETIMES: the pad will become available depending on the media stream
  54  * @GST_PAD_REQUEST: the pad is only available on request with
  55  *  gst_element_request_pad().
  56  *
  57  * Indicates when this pad will become available.
  58  */
  59 typedef enum {
  60   GST_PAD_ALWAYS,
  61   GST_PAD_SOMETIMES,
  62   GST_PAD_REQUEST
  63 } GstPadPresence;
  64
  65 /**
  66  * GST_PAD_TEMPLATE_NAME_TEMPLATE:
  67  * @templ: the template to query
  68  *
  69  * Get the nametemplate of the padtemplate.
  70  */
  71 #define GST_PAD_TEMPLATE_NAME_TEMPLATE(templ)   (((GstPadTemplate *)(templ))->name_template)
  72
  73 /**
  74  * GST_PAD_TEMPLATE_DIRECTION:
  75  * @templ: the template to query
  76  *
  77  * Get the #GstPadDirection of the padtemplate.
  78  */
  79 #define GST_PAD_TEMPLATE_DIRECTION(templ)       (((GstPadTemplate *)(templ))->direction)
  80
  81 /**
  82  * GST_PAD_TEMPLATE_PRESENCE:
  83  * @templ: the template to query
  84  *
  85  * Get the #GstPadPresence of the padtemplate.
  86  */
  87 #define GST_PAD_TEMPLATE_PRESENCE(templ)        (((GstPadTemplate *)(templ))->presence)
  88
  89 /**
  90  * GST_PAD_TEMPLATE_CAPS:
  91  * @templ: the template to query
  92  *
  93  * Get a handle to the padtemplate #GstCaps
  94  */
  95 #define GST_PAD_TEMPLATE_CAPS(templ)            (((GstPadTemplate *)(templ))->caps)
  96
  97 /**
  98  * GstPadTemplateFlags:
  99  * @GST_PAD_TEMPLATE_FLAG_LAST: first flag that can be used by subclasses.
 100  *
 101  * Flags for the padtemplate
 102  */
 103 typedef enum {
 104   /* padding */
 105   GST_PAD_TEMPLATE_FLAG_LAST    = (GST_OBJECT_FLAG_LAST << 4)
 106 } GstPadTemplateFlags;
 107
 108 /**
 109  * GST_PAD_TEMPLATE_IS_FIXED:
 110  * @templ: the template to query
 111  *
 112  * Check if the properties of the padtemplate are fixed
 113  */
 114 #define GST_PAD_TEMPLATE_IS_FIXED(templ)        (GST_OBJECT_FLAG_IS_SET(templ, GST_PAD_TEMPLATE_FIXED))
 115
 116 /**
 117  * GstPadTemplate:
 118  *
 119  * The padtemplate object.
 120  */
 121 struct _GstPadTemplate {
 122   GstObject        object;
 123
 124   gchar           *name_template;
 125   GstPadDirection  direction;
 126   GstPadPresence   presence;
 127   GstCaps         *caps;
 128
 129   /*< private >*/
 130   gpointer _gst_reserved[GST_PADDING];
 131 };
 132
 133 struct _GstPadTemplateClass {
 134   GstObjectClass   parent_class;
 135
 136   /* signal callbacks */
 137   void (*pad_created)   (GstPadTemplate *templ, GstPad *pad);
 138
 139   /*< private >*/
 140   gpointer _gst_reserved[GST_PADDING];
 141 };
 142
 143 /**
 144  * GstStaticPadTemplate:
 145  * @name_template: the name of the template
 146  * @direction: the direction of the template
 147  * @presence: the presence of the template
 148  * @static_caps: the caps of the template.
 149  *
 150  * Structure describing the #GstStaticPadTemplate.
 151  */
 152 struct _GstStaticPadTemplate {
 153   const gchar     *name_template;
 154   GstPadDirection  direction;
 155   GstPadPresence   presence;
 156   GstStaticCaps    static_caps;
 157 };
 158
 159 /**
 160  * GST_STATIC_PAD_TEMPLATE:
 161  * @padname: the name template of the pad
 162  * @dir: the GstPadDirection of the pad
 163  * @pres: the GstPadPresence of the pad
 164  * @caps: the GstStaticCaps of the pad
 165  *
 166  * Convenience macro to fill the values of a GstStaticPadTemplate
 167  * structure.
 168  */
 169 #define GST_STATIC_PAD_TEMPLATE(padname, dir, pres, caps) \
 170 { \
 171   /* name_template */    padname, \
 172   /* direction */        dir, \
 173   /* presence */         pres, \
 174   /* caps */             caps \
 175 }
 176
 177 /* templates and factories */
 178
 179 GST_EXPORT
 180 GType                   gst_pad_template_get_type               (void);
 181
 182 GST_EXPORT
 183 GType                   gst_static_pad_template_get_type        (void);
 184
 185 GST_EXPORT
 186 GstPadTemplate*         gst_pad_template_new                    (const gchar *name_template,
 187                                                                  GstPadDirection direction, GstPadPresence presence,
 188                                                                  GstCaps *caps) G_GNUC_MALLOC;
 189 GST_EXPORT
 190 GstPadTemplate *        gst_static_pad_template_get             (GstStaticPadTemplate *pad_template);
 191
 192 GST_EXPORT
 193 GstCaps*                gst_static_pad_template_get_caps        (GstStaticPadTemplate *templ);
 194
 195 GST_EXPORT
 196 GstCaps*                gst_pad_template_get_caps               (GstPadTemplate *templ);
 197
 198 GST_EXPORT
 199 void                    gst_pad_template_pad_created            (GstPadTemplate * templ, GstPad * pad);
 200
 201 #ifdef G_DEFINE_AUTOPTR_CLEANUP_FUNC
 202 G_DEFINE_AUTOPTR_CLEANUP_FUNC(GstPadTemplate, gst_object_unref)
 203 #endif
 204
 205 G_END_DECLS
 206
 207 #endif /* __GST_PAD_TEMPLATE_H__ */
 208