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.ControlSource;
26 
27 private import gstreamer.ObjectGst;
28 private import gstreamerc.gstreamer;
29 public  import gstreamerc.gstreamertypes;
30 
31 
32 /**
33  * The #GstControlSource is a base class for control value sources that could
34  * be used to get timestamp-value pairs. A control source essentially is a
35  * function over time.
36  * 
37  * A #GstControlSource is used by first getting an instance of a specific
38  * control-source, creating a binding for the control-source to the target property
39  * of the element and then adding the binding to the element. The binding will
40  * convert the data types and value range to fit to the bound property.
41  * 
42  * For implementing a new #GstControlSource one has to implement
43  * #GstControlSourceGetValue and #GstControlSourceGetValueArray functions.
44  * These are then used by gst_control_source_get_value() and
45  * gst_control_source_get_value_array() to get values for specific timestamps.
46  */
47 public class ControlSource : ObjectGst
48 {
49 	/** the main Gtk struct */
50 	protected GstControlSource* gstControlSource;
51 
52 	/** Get the main Gtk struct */
53 	public GstControlSource* getControlSourceStruct()
54 	{
55 		return gstControlSource;
56 	}
57 
58 	/** the main Gtk struct as a void* */
59 	protected override void* getStruct()
60 	{
61 		return cast(void*)gstControlSource;
62 	}
63 
64 	protected override void setStruct(GObject* obj)
65 	{
66 		gstControlSource = cast(GstControlSource*)obj;
67 		super.setStruct(obj);
68 	}
69 
70 	/**
71 	 * Sets our main struct and passes it to the parent class.
72 	 */
73 	public this (GstControlSource* gstControlSource, bool ownedRef = false)
74 	{
75 		this.gstControlSource = gstControlSource;
76 		super(cast(GstObject*)gstControlSource, ownedRef);
77 	}
78 
79 
80 	/** */
81 	public static GType getType()
82 	{
83 		return gst_control_source_get_type();
84 	}
85 
86 	/**
87 	 * Gets the value for this #GstControlSource at a given timestamp.
88 	 *
89 	 * Params:
90 	 *     timestamp = the time for which the value should be returned
91 	 *     value = the value
92 	 *
93 	 * Return: %FALSE if the value couldn't be returned, %TRUE otherwise.
94 	 */
95 	public bool getValue(GstClockTime timestamp, out double value)
96 	{
97 		return gst_control_source_get_value(gstControlSource, timestamp, &value) != 0;
98 	}
99 
100 	/**
101 	 * Gets an array of values for for this #GstControlSource. Values that are
102 	 * undefined contain NANs.
103 	 *
104 	 * Params:
105 	 *     timestamp = the first timestamp
106 	 *     interval = the time steps
107 	 *     nValues = the number of values to fetch
108 	 *     values = array to put control-values in
109 	 *
110 	 * Return: %TRUE if the given array could be filled, %FALSE otherwise
111 	 */
112 	public bool getValueArray(GstClockTime timestamp, GstClockTime interval, double[] values)
113 	{
114 		return gst_control_source_get_value_array(gstControlSource, timestamp, interval, cast(uint)values.length, values.ptr) != 0;
115 	}
116 }