*
* 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__
G_BEGIN_DECLS
-#define GST_TYPE_TOC (gst_toc_get_type ())
-#define GST_TYPE_TOC_ENTRY (gst_toc_entry_get_type ())
+GST_API GType _gst_toc_type;
+
+GST_API 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;
GST_TOC_ENTRY_TYPE_CHAPTER = 3,
} GstTocEntryType;
+/**
+ * GST_TOC_ENTRY_TYPE_IS_ALTERNATIVE:
+ * @entry_type: The #GstTocEntryType from a #GstTocEntry
+ *
+ * Checks if @entry_type indicates that its #GstTocEntry is an alternative.
+ */
#define GST_TOC_ENTRY_TYPE_IS_ALTERNATIVE(entry_type) (entry_type < 0)
+
+/**
+ * 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)
+/**
+ * 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;
+
+/**
+ * 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.
+ *
+ * Since: 1.4
+ */
+#define GST_TOC_REPEAT_COUNT_INFINITE (-1)
+
/* functions to return type structures */
+
+GST_API
GType gst_toc_get_type (void);
+
+GST_API
GType gst_toc_entry_get_type (void);
/* functions to create, ref and unref/free TOCs */
+
+GST_API
GstToc * gst_toc_new (GstTocScope scope);
+GST_API
GstTocScope gst_toc_get_scope (const GstToc *toc);
+GST_API
void gst_toc_set_tags (GstToc *toc, GstTagList * tags);
+
+GST_API
void gst_toc_merge_tags (GstToc *toc, GstTagList *tags, GstTagMergeMode mode);
+
+GST_API
GstTagList * gst_toc_get_tags (const GstToc *toc);
-void gst_toc_append_entry (GstToc *toc, GstTocEntry *entry);
+GST_API
+void gst_toc_append_entry (GstToc *toc, GstTocEntry *entry);
+
+GST_API
GList * gst_toc_get_entries (const GstToc *toc);
+GST_API
void gst_toc_dump (GstToc *toc);
#define gst_toc_ref(toc) (GstToc*)gst_mini_object_ref(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 */
+
+GST_API
GstTocEntry * gst_toc_entry_new (GstTocEntryType type, const gchar *uid);
#define gst_toc_entry_ref(entry) (GstTocEntry*)gst_mini_object_ref(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))
+GST_API
GstTocEntry * gst_toc_find_entry (const GstToc *toc, const gchar *uid);
+GST_API
GstTocEntryType gst_toc_entry_get_entry_type (const GstTocEntry *entry);
+
+GST_API
const gchar * gst_toc_entry_get_uid (const GstTocEntry *entry);
-void gst_toc_entry_append_sub_entry (GstTocEntry *entry, GstTocEntry *subentry);
+GST_API
+void gst_toc_entry_append_sub_entry (GstTocEntry *entry, GstTocEntry *subentry);
+
+GST_API
GList * gst_toc_entry_get_sub_entries (const GstTocEntry *entry);
+GST_API
void gst_toc_entry_set_tags (GstTocEntry *entry, GstTagList *tags);
+
+GST_API
void gst_toc_entry_merge_tags (GstTocEntry *entry, GstTagList *tags, GstTagMergeMode mode);
+
+GST_API
GstTagList * gst_toc_entry_get_tags (const GstTocEntry *entry);
+GST_API
gboolean gst_toc_entry_is_alternative (const GstTocEntry *entry);
+
+GST_API
gboolean gst_toc_entry_is_sequence (const GstTocEntry *entry);
+GST_API
void gst_toc_entry_set_start_stop_times (GstTocEntry *entry, gint64 start, gint64 stop);
+
+GST_API
gboolean gst_toc_entry_get_start_stop_times (const GstTocEntry *entry, gint64 *start, gint64 *stop);
+GST_API
+void gst_toc_entry_set_loop (GstTocEntry *entry, GstTocLoopType loop_type, gint repeat_count);
+
+GST_API
+gboolean gst_toc_entry_get_loop (const GstTocEntry *entry, GstTocLoopType *loop_type, gint *repeat_count);
+
+GST_API
GstToc * gst_toc_entry_get_toc (GstTocEntry *entry);
+
+GST_API
GstTocEntry * gst_toc_entry_get_parent (GstTocEntry *entry);
+GST_API
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);
+}
+
+static inline void
+_gst_autoptr_toc_entry_unref (GstTocEntry *entry)
+{
+ gst_toc_entry_unref (entry);
+}
+
+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
#endif /* __GST_TOC_H__ */