![]() |
![]() |
![]() |
GStreamer 1.0 Core Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <gst/gst.h> struct GstControlBinding; struct GstControlBindingClass; void (*GstControlBindingConvert) (GstControlBinding *binding
,gdouble src_value
,GValue *dest_value
); gboolean gst_control_binding_sync_values (GstControlBinding *binding
,GstObject *object
,GstClockTime timestamp
,GstClockTime last_sync
); GValue * gst_control_binding_get_value (GstControlBinding *binding
,GstClockTime timestamp
); gboolean gst_control_binding_get_value_array (GstControlBinding *binding
,GstClockTime timestamp
,GstClockTime interval
,guint n_values
,gpointer values
); gboolean gst_control_binding_get_g_value_array (GstControlBinding *binding
,GstClockTime timestamp
,GstClockTime interval
,guint n_values
,GValue *values
); void gst_control_binding_set_disabled (GstControlBinding *binding
,gboolean disabled
); gboolean gst_control_binding_is_disabled (GstControlBinding *binding
);
"name" gchar* : Read / Write / Construct Only "object" GstObject* : Read / Write / Construct Only
struct GstControlBinding { gchar *name; GParamSpec *pspec; };
The instance structure of GstControlBinding.
gchar * |
name of the property of this binding |
GParamSpec * |
GParamSpec for this property |
struct GstControlBindingClass { GstObjectClass parent_class; /* virtual methods */ gboolean (* sync_values) (GstControlBinding *binding, GstObject *object, GstClockTime timestamp, GstClockTime last_sync); GValue * (* get_value) (GstControlBinding *binding, GstClockTime timestamp); gboolean (* get_value_array) (GstControlBinding *binding, GstClockTime timestamp,GstClockTime interval, guint n_values, gpointer values); gboolean (* get_g_value_array) (GstControlBinding *binding, GstClockTime timestamp,GstClockTime interval, guint n_values, GValue *values); };
The class structure of GstControlBinding.
GstObjectClass |
Parent class |
void (*GstControlBindingConvert) (GstControlBinding *binding
,gdouble src_value
,GValue *dest_value
);
Function to map a control-value to the target GValue.
|
the GstControlBinding instance |
|
the value returned by the cotnrol source |
|
the target GValue |
gboolean gst_control_binding_sync_values (GstControlBinding *binding
,GstObject *object
,GstClockTime timestamp
,GstClockTime last_sync
);
Sets the property of the object
, according to the GstControlSources that
handle them and for the given timestamp.
If this function fails, it is most likely the application developers fault. Most probably the control sources are not setup correctly.
GValue * gst_control_binding_get_value (GstControlBinding *binding
,GstClockTime timestamp
);
Gets the value for the given controlled property at the requested time.
|
the control binding |
|
the time the control-change should be read from |
Returns : |
the GValue of the property at the given time, or NULL if the
property isn't controlled. |
gboolean gst_control_binding_get_value_array (GstControlBinding *binding
,GstClockTime timestamp
,GstClockTime interval
,guint n_values
,gpointer values
);
Gets a number of values for the given controlled property starting at the
requested time. The array values
need to hold enough space for n_values
of
the same type as the objects property's type.
This function is useful if one wants to e.g. draw a graph of the control curve or apply a control curve sample by sample.
The values are unboxed and ready to be used. The similar function
gst_control_binding_get_g_value_array()
returns the array as GValues and is
better suites for bindings.
gboolean gst_control_binding_get_g_value_array (GstControlBinding *binding
,GstClockTime timestamp
,GstClockTime interval
,guint n_values
,GValue *values
);
Gets a number of GValues for the given controlled property starting at the
requested time. The array values
need to hold enough space for n_values
of
GValue.
This function is useful if one wants to e.g. draw a graph of the control curve or apply a control curve sample by sample.
void gst_control_binding_set_disabled (GstControlBinding *binding
,gboolean disabled
);
This function is used to disable a control binding for some time, i.e.
gst_object_sync_values()
will do nothing.
|
the control binding |
|
boolean that specifies whether to disable the controller or not. |
gboolean gst_control_binding_is_disabled (GstControlBinding *binding
);
Check if the control binding is disabled.
|
the control binding |
Returns : |
TRUE if the binding is inactive |