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 #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>
  35
  36 G_BEGIN_DECLS
  37
  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;
  42
  43 #define GST_TYPE_STATIC_PAD_TEMPLATE    (gst_static_pad_template_get_type ())
  44
  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))
  50
  51 /**
  52  * GstPadPresence:
  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().
  57  *
  58  * Indicates when this pad will become available.
  59  */
  60 typedef enum {
  61   GST_PAD_ALWAYS,
  62   GST_PAD_SOMETIMES,
  63   GST_PAD_REQUEST
  64 } GstPadPresence;
  65
  66 /**
  67  * GST_PAD_TEMPLATE_NAME_TEMPLATE:
  68  * @templ: the template to query
  69  *
  70  * Get the nametemplate of the padtemplate.
  71  */
  72 #define GST_PAD_TEMPLATE_NAME_TEMPLATE(templ)   (((GstPadTemplate *)(templ))->name_template)
  73
  74 /**
  75  * GST_PAD_TEMPLATE_DIRECTION:
  76  * @templ: the template to query
  77  *
  78  * Get the #GstPadDirection of the padtemplate.
  79  */
  80 #define GST_PAD_TEMPLATE_DIRECTION(templ)       (((GstPadTemplate *)(templ))->direction)
  81
  82 /**
  83  * GST_PAD_TEMPLATE_PRESENCE:
  84  * @templ: the template to query
  85  *
  86  * Get the #GstPadPresence of the padtemplate.
  87  */
  88 #define GST_PAD_TEMPLATE_PRESENCE(templ)        (((GstPadTemplate *)(templ))->presence)
  89
  90 /**
  91  * GST_PAD_TEMPLATE_CAPS:
  92  * @templ: the template to query
  93  *
  94  * Get a handle to the padtemplate #GstCaps
  95  */
  96 #define GST_PAD_TEMPLATE_CAPS(templ)            (((GstPadTemplate *)(templ))->caps)
  97
  98 /**
  99  * GstPadTemplateFlags:
 100  * @GST_PAD_TEMPLATE_FLAG_LAST: first flag that can be used by subclasses.
 101  *
 102  * Flags for the padtemplate
 103  */
 104 typedef enum {
 105   /* padding */
 106   GST_PAD_TEMPLATE_FLAG_LAST    = (GST_OBJECT_FLAG_LAST << 4)
 107 } GstPadTemplateFlags;
 108
 109 /**
 110  * GST_PAD_TEMPLATE_IS_FIXED:
 111  * @templ: the template to query
 112  *
 113  * Check if the properties of the padtemplate are fixed
 114  */
 115 #define GST_PAD_TEMPLATE_IS_FIXED(templ)        (GST_OBJECT_FLAG_IS_SET(templ, GST_PAD_TEMPLATE_FIXED))
 116
 117 /**
 118  * GstPadTemplate:
 119  *
 120  * The padtemplate object.
 121  */
 122 struct _GstPadTemplate {
 123   GstObject        object;
 124
 125   gchar           *name_template;
 126   GstPadDirection  direction;
 127   GstPadPresence   presence;
 128   GstCaps         *caps;
 129
 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   gpointer _gst_reserved[GST_PADDING];
 140 };
 141
 142 /**
 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.
 148  *
 149  * Structure describing the #GstStaticPadTemplate.
 150  */
 151 struct _GstStaticPadTemplate {
 152   const gchar     *name_template;
 153   GstPadDirection  direction;
 154   GstPadPresence   presence;
 155   GstStaticCaps    static_caps;
 156 };
 157
 158 /**
 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
 164  *
 165  * Convenience macro to fill the values of a GstStaticPadTemplate
 166  * structure.
 167  */
 168 #define GST_STATIC_PAD_TEMPLATE(padname, dir, pres, caps) \
 169 { \
 170   /* name_template */    padname, \
 171   /* direction */        dir, \
 172   /* presence */         pres, \
 173   /* caps */             caps \
 174 }
 175
 176 /* templates and factories */
 177 GType                   gst_pad_template_get_type               (void);
 178 GType                   gst_static_pad_template_get_type        (void);
 179
 180 GstPadTemplate*         gst_pad_template_new                    (const gchar *name_template,
 181                                                                  GstPadDirection direction, GstPadPresence presence,
 182                                                                  GstCaps *caps);
 183
 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);
 187
 188 void                    gst_pad_template_pad_created            (GstPadTemplate * templ, GstPad * pad);
 189
 190 G_END_DECLS
 191
 192 #endif /* __GST_PAD_TEMPLATE_H__ */
 193