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., 59 Temple Place - Suite 330,
  20  * Boston, MA 02111-1307, 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_get_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   gpointer _gst_reserved[GST_PADDING];
 130 };
 131
 132 struct _GstPadTemplateClass {
 133   GstObjectClass   parent_class;
 134
 135   /* signal callbacks */
 136   void (*pad_created)   (GstPadTemplate *templ, GstPad *pad);
 137
 138   gpointer _gst_reserved[GST_PADDING];
 139 };
 140
 141 /**
 142  * GstStaticPadTemplate:
 143  * @name_template: the name of the template
 144  * @direction: the direction of the template
 145  * @presence: the presence of the template
 146  * @static_caps: the caps of the template.
 147  *
 148  * Structure describing the #GstStaticPadTemplate.
 149  */
 150 struct _GstStaticPadTemplate {
 151   const gchar     *name_template;
 152   GstPadDirection  direction;
 153   GstPadPresence   presence;
 154   GstStaticCaps    static_caps;
 155 };
 156
 157 /**
 158  * GST_STATIC_PAD_TEMPLATE:
 159  * @padname: the name template of the pad
 160  * @dir: the GstPadDirection of the pad
 161  * @pres: the GstPadPresence of the pad
 162  * @caps: the GstStaticCaps of the pad
 163  *
 164  * Convenience macro to fill the values of a GstStaticPadTemplate
 165  * structure.
 166  */
 167 #define GST_STATIC_PAD_TEMPLATE(padname, dir, pres, caps) \
 168 { \
 169   /* name_template */    padname, \
 170   /* direction */        dir, \
 171   /* presence */         pres, \
 172   /* caps */             caps \
 173 }
 174
 175 /* templates and factories */
 176 GType                   gst_pad_template_get_type               (void);
 177 GType                   gst_static_pad_template_get_type        (void);
 178
 179 GstPadTemplate*         gst_pad_template_new                    (const gchar *name_template,
 180                                                                  GstPadDirection direction, GstPadPresence presence,
 181                                                                  GstCaps *caps) G_GNUC_MALLOC;
 182
 183 GstPadTemplate *        gst_static_pad_template_get             (GstStaticPadTemplate *pad_template);
 184 GstCaps*                gst_static_pad_template_get_caps        (GstStaticPadTemplate *templ);
 185 GstCaps*                gst_pad_template_get_caps               (GstPadTemplate *templ);
 186
 187 void                    gst_pad_template_pad_created            (GstPadTemplate * templ, GstPad * pad);
 188
 189 G_END_DECLS
 190
 191 #endif /* __GST_PAD_TEMPLATE_H__ */
 192