register_rate_property
Description:
public class bool register_rate_property (string element_name, string property_name)
Register an element that can change the rate at which media is playing.
The property type must be float or double, and must be a factor of the rate, i.e. a value of 2.0 must mean that the media plays twice as fast.
Several properties may be registered for a single element type, provided they all contribute to the rate as independent factors. For example,
this is true for the "GstPitch:GESEffect:rate" and "GstPitch:GESEffect:tempo" properties. These are already registered
by default in GES, along with videorate:rate for videorate and scaletempo:rate for scaletempo
.
If such a rate property becomes a child property of a Effect upon its creation (the element is part of its bin_description), it will be automatically registered as a time property (see register_time_property) and will have its time translation functions set (see set_time_translation_funcs) to use the overall rate of the rate properties. Note that if an effect contains a rate property as well as a non-rate time property, you should ensure to set the time translation functions to some other methods using set_time_translation_funcs.
Note, you can obtain a reference to the GESEffectClass using
``` GES_EFFECT_CLASS (g_type_class_ref (GES_TYPE_EFFECT)); ```
Parameters:
| this |
Instance of the GESEffectClass |
| element_name |
The ElementFactory name of the element that changes the rate |
| property_name |
The name of the property that changes the rate |
Returns:
|
true if the rate property was successfully registered. When this method returns false, a warning is emitted with more information. |