![]() |
![]() |
![]() |
GStreamer 0.11 Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <gst/controller/gstcontroller.h> struct GstController; gboolean gst_controller_init (int *argc
,char ***argv
); GstController * gst_controller_new (GObject *object
,...
); GstController * gst_controller_new_list (GObject *object
,GList *list
); GstController * gst_controller_new_valist (GObject *object
,va_list var_args
); gboolean gst_controller_remove_properties (GstController *self
,...
); gboolean gst_controller_remove_properties_list (GstController *self
,GList *list
); gboolean gst_controller_remove_properties_valist (GstController *self
,va_list var_args
); void gst_controller_set_disabled (GstController *self
,gboolean disabled
); void gst_controller_set_property_disabled (GstController *self
,const gchar *property_name
,gboolean disabled
); GstClockTime gst_controller_suggest_next_sync (GstController *self
); gboolean gst_controller_sync_values (GstController *self
,GstClockTime timestamp
); GstControlSource * gst_controller_get_control_source (GstController *self
,const gchar *property_name
); gboolean gst_controller_set_control_source (GstController *self
,const gchar *property_name
,GstControlSource *csource
); GValue * gst_controller_get (GstController *self
,const gchar *property_name
,GstClockTime timestamp
); gboolean gst_controller_get_value_arrays (GstController *self
,GstClockTime timestamp
,GSList *value_arrays
); gboolean gst_controller_get_value_array (GstController *self
,GstClockTime timestamp
,GstValueArray *value_array
);
The controller subsystem offers a lightweight way to adjust gobject properties over stream-time. It works by using time-stamped value pairs that are queued for element-properties. At run-time the elements continously pull values changes for the current stream-time.
What needs to be changed in a GstElement? Very little - it is just two steps to make a plugin controllable!
mark gobject-properties paramspecs that make sense to be controlled, by GST_PARAM_CONTROLLABLE.
when processing data (get, chain, loop function) at the beginning call gst_object_sync_values(element,timestamp). This will made the controller to update all gobject properties that are under control with the current values based on timestamp.
What needs to be done in applications? Again its not a lot to change.
first put some properties under control, by calling controller = gst_object_control_properties (object, "prop1", "prop2",...);
Get a GstControlSource for the property and set it up.
csource = gst_interpolation_control_source_new()
;
gst_interpolation_control_source_set_interpolation_mode(csource, mode);
gst_interpolation_control_source_set (csource,0 * GST_SECOND, value1);
gst_interpolation_control_source_set (csource,1 * GST_SECOND, value2);
Set the GstControlSource in the controller. gst_controller_set_control_source (controller, "prop1", csource);
start your pipeline
gboolean gst_controller_init (int *argc
,char ***argv
);
Initializes the use of the controller library. Suggested to be called right
after gst_init()
.
|
pointer to the commandline argument count |
|
pointer to the commandline argument values |
Returns : |
the TRUE for success. |
GstController * gst_controller_new (GObject *object
,...
);
Creates a new GstController for the given object's properties
|
the object of which some properties should be controlled |
|
NULL terminated list of property names that should be controlled |
Returns : |
the new controller. |
GstController * gst_controller_new_list (GObject *object
,GList *list
);
Creates a new GstController for the given object's properties
|
the object of which some properties should be controlled |
|
list of property names that should be controlled |
Returns : |
the new controller. |
GstController * gst_controller_new_valist (GObject *object
,va_list var_args
);
Creates a new GstController for the given object's properties
|
the object of which some properties should be controlled |
|
NULL terminated list of property names that should be controlled |
Returns : |
the new controller. |
gboolean gst_controller_remove_properties (GstController *self
,...
);
Removes the given object properties from the controller
gboolean gst_controller_remove_properties_list (GstController *self
,GList *list
);
Removes the given object properties from the controller
gboolean gst_controller_remove_properties_valist (GstController *self
,va_list var_args
);
Removes the given object properties from the controller
void gst_controller_set_disabled (GstController *self
,gboolean disabled
);
This function is used to disable all properties of the GstController
for some time, i.e. gst_controller_sync_values()
will do nothing.
|
the GstController which should be disabled |
|
boolean that specifies whether to disable the controller or not. |
Since 0.10.14
void gst_controller_set_property_disabled (GstController *self
,const gchar *property_name
,gboolean disabled
);
This function is used to disable the GstController on a property for
some time, i.e. gst_controller_sync_values()
will do nothing for the
property.
|
the GstController which should be disabled |
|
property to disable |
|
boolean that specifies whether to disable the controller or not. |
Since 0.10.14
GstClockTime gst_controller_suggest_next_sync (GstController *self
);
Returns a suggestion for timestamps where buffers should be split to get best controller results.
|
the controller that handles the values |
Returns : |
Returns the suggested timestamp or GST_CLOCK_TIME_NONE
if no control-rate was set. |
Since 0.10.13
gboolean gst_controller_sync_values (GstController *self
,GstClockTime timestamp
);
Sets the properties of the element, according to the controller that (maybe) handles 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.
GstControlSource * gst_controller_get_control_source (GstController *self
,const gchar *property_name
);
Gets the corresponding GstControlSource for the property. This should be unreferenced again after use.
|
the controller object |
|
name of the property for which the GstControlSource should be get |
Returns : |
the GstControlSource for property_name or NULL if the property is not
controlled by this controller or no GstControlSource was assigned yet. |
Since 0.10.14
gboolean gst_controller_set_control_source (GstController *self
,const gchar *property_name
,GstControlSource *csource
);
Sets the GstControlSource for property_name
. If there already was a GstControlSource
for this property it will be unreferenced.
|
the controller object |
|
name of the property for which the GstControlSource should be set |
|
the GstControlSource that should be used for the property |
Returns : |
FALSE if the given property isn't handled by the controller or the new GstControlSource
couldn't be bound to the property, TRUE if everything worked as expected. |
Since 0.10.14
GValue * gst_controller_get (GstController *self
,const gchar *property_name
,GstClockTime timestamp
);
Gets the value for the given controller-handled property at the requested time.
|
the controller object which handles the properties |
|
the name of the property to get |
|
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 handled by the controller |
gboolean gst_controller_get_value_arrays (GstController *self
,GstClockTime timestamp
,GSList *value_arrays
);
Function to be able to get an array of values for one or more given element properties.
All fields of the GstValueArray
in the list must be filled correctly.
Especially the GstValueArray->values arrays must be big enough to keep
the requested amount of values.
The types of the values in the array are the same as the property's type.
This doesn't modify the controlled GObject properties!
gboolean gst_controller_get_value_array (GstController *self
,GstClockTime timestamp
,GstValueArray *value_array
);
Function to be able to get an array of values for one element property.
All fields of value_array
must be filled correctly. Especially the
value_array->values
array must be big enough to keep the requested amount
of values (as indicated by the nbsamples field).
The type of the values in the array is the same as the property's type.
This doesn't modify the controlled GObject property!
"control-rate"
property"control-rate" guint64 : Read / Write
Controlled properties will be updated at least every control-rate nanoseconds.
Allowed values: [1,4294967295]
Default value: 100000000