/usr/include/gstreamer-0.10/gst/tag/gsttagdemux.h is in libgstreamer-plugins-base0.10-dev 0.10.36-1ubuntu0.2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 | /* GStreamer Base Class for Tag Demuxing
* Copyright (C) 2005 Jan Schmidt <thaytan@mad.scientist.com>
* Copyright (C) 2006 Tim-Philipp Müller <tim centricular net>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#ifndef __GST_TAG_DEMUX_H__
#define __GST_TAG_DEMUX_H__
#include <gst/gst.h>
G_BEGIN_DECLS
#define GST_TYPE_TAG_DEMUX (gst_tag_demux_get_type())
#define GST_TAG_DEMUX(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_TAG_DEMUX,GstTagDemux))
#define GST_TAG_DEMUX_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_TAG_DEMUX,GstTagDemuxClass))
#define GST_IS_TAG_DEMUX(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_TAG_DEMUX))
#define GST_IS_TAG_DEMUX_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_TAG_DEMUX))
typedef struct _GstTagDemux GstTagDemux;
typedef struct _GstTagDemuxClass GstTagDemuxClass;
typedef struct _GstTagDemuxPrivate GstTagDemuxPrivate;
/**
* GstTagDemuxResult:
* @GST_TAG_DEMUX_RESULT_BROKEN_TAG: cannot parse tag, just skip it
* @GST_TAG_DEMUX_RESULT_AGAIN : call again with less or more data
* @GST_TAG_DEMUX_RESULT_OK : parsed tag successfully
*
* Result values from the parse_tag virtual function.
*
* Since: 0.10.15
*/
typedef enum {
GST_TAG_DEMUX_RESULT_BROKEN_TAG,
GST_TAG_DEMUX_RESULT_AGAIN,
GST_TAG_DEMUX_RESULT_OK
} GstTagDemuxResult;
GType gst_tag_demux_result_get_type (void);
#define GST_TYPE_TAG_DEMUX_RESULT (gst_tag_demux_result_get_type())
/**
* GstTagDemux:
* @element: parent element
*
* Opaque #GstTagDemux structure.
*
* Since: 0.10.15
*/
struct _GstTagDemux
{
GstElement element;
/*< private >*/
GstTagDemuxPrivate *priv;
gpointer reserved[GST_PADDING];
};
/**
* GstTagDemuxClass:
* @parent_class: the parent class.
* @min_start_size: minimum size required to identify a tag at the start and
* determine its total size. Set to 0 if not interested in start tags.
* Subclasses should set this in their class_init function.
* @min_end_size: minimum size required to identify a tag at the end and
* determine its total size. Set to 0 if not interested in end tags.
* Subclasses should set this in their class_init function.
* @identify_tag: identify tag and determine the size required to parse the
* tag. Buffer may be larger than the specified minimum size.
* Subclassed MUST override this vfunc in their class_init function.
* @parse_tag: parse the tag. Buffer will be exactly of the size determined by
* the identify_tag vfunc before. The parse_tag vfunc may change the size
* stored in *tag_size and return GST_TAG_DEMUX_RESULT_AGAIN to request a
* larger or smaller buffer. It is also permitted to adjust the tag_size to a
* smaller value and then return GST_TAG_DEMUX_RESULT_OK in one go.
* Subclassed MUST override the parse_tag vfunc in their class_init function.
* @merge_tags: merge start and end tags. Subclasses may want to override this
* vfunc to allow prioritising of start or end tag according to user
* preference. Note that both start_tags and end_tags may be NULL. By default
* start tags are prefered over end tags.
*
* The #GstTagDemuxClass structure. See documentation at beginning of section
* for details about what subclasses need to override and do.
*
* Since: 0.10.15
*/
struct _GstTagDemuxClass
{
GstElementClass parent_class;
/* minimum size required to identify a tag at the start and determine
* its total size */
guint min_start_size;
/* minimum size required to identify a tag at the end and determine
* its total size */
guint min_end_size;
/* vtable */
/* identify tag and determine the size required to parse the tag */
gboolean (*identify_tag) (GstTagDemux * demux,
GstBuffer * buffer,
gboolean start_tag,
guint * tag_size);
/* parse the tag once it is identified and its size is known */
GstTagDemuxResult (*parse_tag) (GstTagDemux * demux,
GstBuffer * buffer,
gboolean start_tag,
guint * tag_size,
GstTagList ** tags);
/* merge start and end tags (optional) */
GstTagList * (*merge_tags) (GstTagDemux * demux,
const GstTagList * start_tags,
const GstTagList * end_tags);
/*< private >*/
gpointer reserved[GST_PADDING];
};
GType gst_tag_demux_get_type (void);
G_END_DECLS
#endif /* __GST_TAG_DEMUX_H__ */
|