1 /*
2  * This file is part of gtkD.
3  *
4  * gtkD is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU Lesser General Public License
6  * as published by the Free Software Foundation; either version 3
7  * of the License, or (at your option) any later version, with
8  * some exceptions, please read the COPYING file.
9  *
10  * gtkD is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public License
16  * along with gtkD; if not, write to the Free Software
17  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
18  */
19 
20 // generated automatically - do not change
21 // find conversion definition on APILookup.txt
22 // implement new conversion functionalities on the wrap.utils pakage
23 
24 
25 module gstreamer.TocSetterIF;
26 
27 private import gobject.ObjectG;
28 private import gstreamer.Toc;
29 private import gstreamer.c.functions;
30 public  import gstreamer.c.types;
31 public  import gstreamerc.gstreamertypes;
32 
33 
34 /**
35  * Element interface that allows setting of the TOC.
36  * 
37  * Elements that support some kind of chapters or editions (or tracks like in
38  * the FLAC cue sheet) will implement this interface.
39  * 
40  * If you just want to retrieve the TOC in your application then all you
41  * need to do is watch for TOC messages on your pipeline's bus (or you can
42  * perform TOC query). This interface is only for setting TOC data, not for
43  * extracting it. To set TOC from the application, find proper tocsetter element
44  * and set TOC using gst_toc_setter_set_toc().
45  * 
46  * Elements implementing the #GstTocSetter interface can extend existing TOC
47  * by getting extend UID for that (you can use gst_toc_find_entry() to retrieve it)
48  * with any TOC entries received from downstream.
49  */
50 public interface TocSetterIF{
51 	/** Get the main Gtk struct */
52 	public GstTocSetter* getTocSetterStruct(bool transferOwnership = false);
53 
54 	/** the main Gtk struct as a void* */
55 	protected void* getStruct();
56 
57 
58 	/** */
59 	public static GType getType()
60 	{
61 		return gst_toc_setter_get_type();
62 	}
63 
64 	/**
65 	 * Return current TOC the setter uses. The TOC should not be
66 	 * modified without making it writable first.
67 	 *
68 	 * Returns: TOC set, or %NULL. Unref with
69 	 *     gst_toc_unref() when no longer needed
70 	 */
71 	public Toc getToc();
72 
73 	/**
74 	 * Reset the internal TOC. Elements should call this from within the
75 	 * state-change handler.
76 	 */
77 	public void reset();
78 
79 	/**
80 	 * Set the given TOC on the setter. Previously set TOC will be
81 	 * unreffed before setting a new one.
82 	 *
83 	 * Params:
84 	 *     toc = a #GstToc to set.
85 	 */
86 	public void setToc(Toc toc);
87 }