![]() |
![]() |
![]() |
GStreamer 0.10 Library Reference Manual | ![]() |
---|
GstControllerGObjectGstControllerGObject — GObject convinience methods for using dynamic properties |
#include <libs/controller/gstcontroller.h> GstController* gst_object_control_properties (GObject *object, ...); gboolean gst_object_uncontrol_properties (GObject *object, ...); GstController* gst_object_get_controller (GObject *object); gboolean gst_object_set_controller (GObject *object, GstController *controller); gboolean gst_object_sync_values (GObject *object, GstClockTime timestamp); gboolean gst_object_get_value_arrays (GObject *object, GstClockTime timestamp, GSList *value_arrays); gboolean gst_object_get_value_array (GObject *object, GstClockTime timestamp, GstValueArray *value_array);
These methods allow to use some GstController functionallity directly from the GObject class.
GstController* gst_object_control_properties (GObject *object, ...);
Convenience function for GObject
Creates a GstController that allows you to dynamically control one, or more, GObject properties. If the given GObject already has a GstController, it adds the given properties to the existing controller and returns that controller.
object : |
the object of which some properties should be controlled |
... : |
NULL terminated list of property names that should be controlled
|
Returns : | The GstController with which the user can control the given properties dynamically or NULL if one or more of the given properties aren't available, or cannot be controlled, for the given element. |
Since 0.9
gboolean gst_object_uncontrol_properties (GObject *object, ...);
Convenience function for GObject
Removes the given element's properties from it's controller
object : |
the object of which some properties should not be controlled anymore |
... : |
NULL terminated list of property names that should be controlled
|
Returns : | FALSE if one of the given property names isn't handled by the
controller, TRUE otherwise
|
Since 0.9
GstController* gst_object_get_controller (GObject *object);
object : |
the object that has controlled properties |
Returns : | the controller handling some of the given element's properties, NULL if no controller
|
Since 0.9
gboolean gst_object_set_controller (GObject *object, GstController *controller);
Sets the controller on the given GObject
object : |
the object that should get the controller |
controller : |
the controller object to plug in |
Returns : | FALSE if the GObject already has an controller, TRUE otherwise
|
Since 0.9
gboolean gst_object_sync_values (GObject *object, GstClockTime timestamp);
Convenience function for GObject
object : |
the object that has controlled properties |
timestamp : |
the time that should be processed |
Returns : | same thing as gst_controller_sync_values()
|
Since 0.9
gboolean gst_object_get_value_arrays (GObject *object, GstClockTime timestamp, GSList *value_arrays);
Function to be able to get an array of values for one or more given element properties.
If the GstValueArray->values array in list nodes is NULL, it will be created by the function. The type of the values in the array are the same as the property's type.
The g_object_* functions are just convenience functions for GObject
object : |
the object that has controlled properties |
timestamp : |
the time that should be processed |
value_arrays : |
list to return the control-values in |
Returns : | TRUE if the given array(s) could be filled, FALSE otherwise
|
Since 0.9
gboolean gst_object_get_value_array (GObject *object, GstClockTime timestamp, GstValueArray *value_array);
Function to be able to get an array of values for one element properties
If the GstValueArray->values array is NULL, it will be created by the function. The type of the values in the array are the same as the property's type.
The g_object_* functions are just convenience functions for GObject
object : |
the object that has controlled properties |
timestamp : |
the time that should be processed |
value_array : |
array to put control-values in |
Returns : | TRUE if the given array(s) could be filled, FALSE otherwise
|
Since 0.9
<< GstController | GStreamer Network Classes >> |