*
* 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.
+ * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
*/
#ifndef __GST_TOC_H__
#define __GST_TOC_H__
#include <gst/gstconfig.h>
+#include <gst/gstminiobject.h>
#include <gst/gststructure.h>
#include <gst/gsttaglist.h>
#include <gst/gstformat.h>
G_BEGIN_DECLS
+GST_EXPORT GType _gst_toc_type;
+GST_EXPORT GType _gst_toc_entry_type;
+
+#define GST_TYPE_TOC (_gst_toc_type)
+#define GST_TYPE_TOC_ENTRY (_gst_toc_entry_type)
+
typedef struct _GstTocEntry GstTocEntry;
typedef struct _GstToc GstToc;
/**
+ * GstTocScope:
+ * @GST_TOC_SCOPE_GLOBAL: global TOC representing all selectable options
+ * (this is what applications are usually interested in)
+ * @GST_TOC_SCOPE_CURRENT: TOC for the currently active/selected stream
+ * (this is a TOC representing the current stream from start to EOS,
+ * and is what a TOC writer / muxer is usually interested in; it will
+ * usually be a subset of the global TOC, e.g. just the chapters of
+ * the current title, or the chapters selected for playback from the
+ * current title)
+ *
+ * The scope of a TOC.
+ */
+typedef enum {
+ GST_TOC_SCOPE_GLOBAL = 1,
+ GST_TOC_SCOPE_CURRENT = 2
+} GstTocScope;
+
+/**
* GstTocEntryType:
- * @GST_TOC_ENTRY_TYPE_CHAPTER: a chapter type entry.
- * @GST_TOC_ENTRY_TYPE_EDITION: an edition entry (angle or alternative in other terms).
+ * @GST_TOC_ENTRY_TYPE_ANGLE: entry is an angle (i.e. an alternative)
+ * @GST_TOC_ENTRY_TYPE_VERSION: entry is a version (i.e. alternative)
+ * @GST_TOC_ENTRY_TYPE_EDITION: entry is an edition (i.e. alternative)
+ * @GST_TOC_ENTRY_TYPE_INVALID: invalid entry type value
+ * @GST_TOC_ENTRY_TYPE_TITLE: entry is a title (i.e. a part of a sequence)
+ * @GST_TOC_ENTRY_TYPE_TRACK: entry is a track (i.e. a part of a sequence)
+ * @GST_TOC_ENTRY_TYPE_CHAPTER: entry is a chapter (i.e. a part of a sequence)
*
- * The different types of TOC entry.
+ * The different types of TOC entries (see #GstTocEntry).
+ *
+ * There are two types of TOC entries: alternatives or parts in a sequence.
*/
typedef enum {
- GST_TOC_ENTRY_TYPE_CHAPTER = 0,
- GST_TOC_ENTRY_TYPE_EDITION = 1
+ GST_TOC_ENTRY_TYPE_ANGLE = -3,
+ GST_TOC_ENTRY_TYPE_VERSION = -2,
+ GST_TOC_ENTRY_TYPE_EDITION = -1,
+ GST_TOC_ENTRY_TYPE_INVALID = 0,
+ GST_TOC_ENTRY_TYPE_TITLE = 1,
+ GST_TOC_ENTRY_TYPE_TRACK = 2,
+ GST_TOC_ENTRY_TYPE_CHAPTER = 3,
} GstTocEntryType;
/**
- * GstTocEntry:
- * @uid: unique (for a whole TOC) id of the entry. This value should be persistent and
- * should not be changed while updating TOC. @uid should be handled as "opaque" value
- * without meaning (e.g. applications should not assume the /editionX/chapterY/chapter/Z structure,
- * other demuxers could do something else), it should help to track updates of certain entries.
- * @type: #GstTocEntryType of this entry.
- * @subentries: list of #GstTocEntry children.
- * @pads: list of #GstPad objects, related to this #GstTocEntry.
- * @tags: tags related to this entry.
- * @info: extra information related to this entry.
+ * GST_TOC_ENTRY_TYPE_IS_ALTERNATIVE:
+ * @entry_type: The #GstTocEntryType from a #GstTocEntry
*
- * Definition of TOC entry structure.
+ * Checks if @entry_type indicates that its #GstTocEntry is an alternative.
*/
-struct _GstTocEntry {
- gchar *uid;
- GstTocEntryType type;
- GList *subentries;
- GList *pads;
- GstTagList *tags;
- GstStructure *info;
+#define GST_TOC_ENTRY_TYPE_IS_ALTERNATIVE(entry_type) (entry_type < 0)
- /*< private >*/
- gpointer _gst_reserved[GST_PADDING];
-};
+/**
+ * GST_TOC_ENTRY_TYPE_IS_SEQUENCE:
+ * @entry_type: The #GstTocEntryType from a #GstTocEntry
+ *
+ * Checks if @entry_type indicates that its #GstTocEntry is a sequence.
+ */
+#define GST_TOC_ENTRY_TYPE_IS_SEQUENCE(entry_type) (entry_type > 0)
-/* FIXME: pad member should be GstPad type, but that's
- * impossible due to recursive includes */
+/**
+ * GstTocLoopType:
+ * @GST_TOC_LOOP_NONE: single forward playback
+ * @GST_TOC_LOOP_FORWARD: repeat forward
+ * @GST_TOC_LOOP_REVERSE: repeat backward
+ * @GST_TOC_LOOP_PING_PONG: repeat forward and backward
+ *
+ * How a #GstTocEntry should be repeated. By default, entries are played a
+ * single time.
+ *
+ * Since: 1.4
+ */
+typedef enum {
+ GST_TOC_LOOP_NONE = 0,
+ GST_TOC_LOOP_FORWARD,
+ GST_TOC_LOOP_REVERSE,
+ GST_TOC_LOOP_PING_PONG
+} GstTocLoopType;
/**
- * GstToc:
- * @entries: list of #GstTocEntry entries of the TOC.
- * @tags: tags related to the whole TOC.
- * @info: extra information related to the TOC.
+ * GST_TOC_REPEAT_COUNT_INFINITE:
+ *
+ * Special value for the repeat_count set in gst_toc_entry_set_loop() or
+ * returned by gst_toc_entry_set_loop() to indicate infinite looping.
*
- * Definition of TOC structure.
+ * Since: 1.4
*/
-struct _GstToc {
- GList *entries;
- GstTagList *tags;
- GstStructure *info;
+#define GST_TOC_REPEAT_COUNT_INFINITE (-1)
- /*< private >*/
- gpointer _gst_reserved[GST_PADDING];
-};
+/* functions to return type structures */
+GType gst_toc_get_type (void);
+GType gst_toc_entry_get_type (void);
-/* functions to create new structures */
-GstToc * gst_toc_new (void);
+/* functions to create, ref and unref/free TOCs */
+GstToc * gst_toc_new (GstTocScope scope);
+
+GstTocScope gst_toc_get_scope (const GstToc *toc);
+
+void gst_toc_set_tags (GstToc *toc, GstTagList * tags);
+void gst_toc_merge_tags (GstToc *toc, GstTagList *tags, GstTagMergeMode mode);
+GstTagList * gst_toc_get_tags (const GstToc *toc);
+
+void gst_toc_append_entry (GstToc *toc, GstTocEntry *entry);
+GList * gst_toc_get_entries (const GstToc *toc);
+
+void gst_toc_dump (GstToc *toc);
+
+#define gst_toc_ref(toc) (GstToc*)gst_mini_object_ref(GST_MINI_OBJECT_CAST(toc))
+#define gst_toc_unref(toc) gst_mini_object_unref(GST_MINI_OBJECT_CAST(toc))
+#define gst_toc_copy(toc) (GstToc*)gst_mini_object_copy(GST_MINI_OBJECT_CAST(toc))
+#define gst_toc_make_writable(toc) (GstToc*)gst_mini_object_make_writable(GST_MINI_OBJECT_CAST(toc))
+
+/* functions to create, ref and unref/free TOC entries */
GstTocEntry * gst_toc_entry_new (GstTocEntryType type, const gchar *uid);
-GstTocEntry * gst_toc_entry_new_with_pad (GstTocEntryType type, const gchar *uid, GstPad * pad);
-/* functions to free structures */
-void gst_toc_entry_free (GstTocEntry *entry);
-void gst_toc_free (GstToc *toc);
+#define gst_toc_entry_ref(entry) (GstTocEntry*)gst_mini_object_ref(GST_MINI_OBJECT_CAST(entry))
+#define gst_toc_entry_unref(entry) gst_mini_object_unref(GST_MINI_OBJECT_CAST(entry))
+#define gst_toc_entry_copy(entry) (GstTocEntry*)gst_mini_object_copy(GST_MINI_OBJECT_CAST(entry))
+#define gst_toc_entry_make_writable(entry) (GstTocEntry*)gst_mini_object_make_writable(GST_MINI_OBJECT_CAST(entry))
+
+GstTocEntry * gst_toc_find_entry (const GstToc *toc, const gchar *uid);
+
+GstTocEntryType gst_toc_entry_get_entry_type (const GstTocEntry *entry);
+const gchar * gst_toc_entry_get_uid (const GstTocEntry *entry);
+
+void gst_toc_entry_append_sub_entry (GstTocEntry *entry, GstTocEntry *subentry);
+GList * gst_toc_entry_get_sub_entries (const GstTocEntry *entry);
+
+void gst_toc_entry_set_tags (GstTocEntry *entry, GstTagList *tags);
+void gst_toc_entry_merge_tags (GstTocEntry *entry, GstTagList *tags, GstTagMergeMode mode);
+GstTagList * gst_toc_entry_get_tags (const GstTocEntry *entry);
+
+gboolean gst_toc_entry_is_alternative (const GstTocEntry *entry);
+gboolean gst_toc_entry_is_sequence (const GstTocEntry *entry);
+
+void gst_toc_entry_set_start_stop_times (GstTocEntry *entry, gint64 start, gint64 stop);
+gboolean gst_toc_entry_get_start_stop_times (const GstTocEntry *entry, gint64 *start, gint64 *stop);
+
+void gst_toc_entry_set_loop (GstTocEntry *entry, GstTocLoopType loop_type, gint repeat_count);
+gboolean gst_toc_entry_get_loop (const GstTocEntry *entry, GstTocLoopType *loop_type, gint *repeat_count);
+
+GstToc * gst_toc_entry_get_toc (GstTocEntry *entry);
+GstTocEntry * gst_toc_entry_get_parent (GstTocEntry *entry);
+
+
+const gchar * gst_toc_entry_type_get_nick (GstTocEntryType type);
+
+#ifdef G_DEFINE_AUTOPTR_CLEANUP_FUNC
+static inline void
+_gst_autoptr_toc_unref (GstToc *toc)
+{
+ gst_toc_unref (toc);
+}
-GstTocEntry * gst_toc_find_entry (const GstToc *toc, const gchar *uid);
-GstTocEntry * gst_toc_entry_copy (const GstTocEntry *entry);
-GstToc * gst_toc_copy (const GstToc *toc);
+static inline void
+_gst_autoptr_toc_entry_unref (GstTocEntry *entry)
+{
+ gst_toc_entry_unref (entry);
+}
-void gst_toc_entry_set_start_stop (GstTocEntry *entry, gint64 start, gint64 stop);
-gboolean gst_toc_entry_get_start_stop (const GstTocEntry *entry, gint64 *start, gint64 *stop);
-const gchar * gst_toc_entry_type_get_nick (GstTocEntryType type);
+G_DEFINE_AUTOPTR_CLEANUP_FUNC(GstToc, _gst_autoptr_toc_unref)
+G_DEFINE_AUTOPTR_CLEANUP_FUNC(GstTocEntry, _gst_autoptr_toc_entry_unref)
+#endif
G_END_DECLS