Annotations¶
This page documents the Annotation type, which corresponds to a time-aligned annotation of a sound file, on one or more layers.
Global functions¶
-
get_annotations()¶
Return a list of all the annotations in the current project.
-
get_selected_annotations()¶
Return a list of all the selected annotations in the current project.
-
get_annotation(path)¶
Return the Annotation object from the current project whose path is path, or null if there is no such
annotation. If the object exists but is not an annotation, an error is thrown.
-
get_current_annotation()¶
Return the Annotation object loaded in the current view, or null if the current view is not an annotation view.
Methods¶
-
class
Annotation¶
-
add_property(category, value)¶
Adds a property to the annotation. category must be a string and value can be a string, a number or a Boolean.
If the file already has a property with the same category, the value will be replaced with the new one.
-
remove_property(category)¶
Removes the property whose category is category from the annotation. If there is no such category, this method
does nothing.
-
remove_property(category)
Gets the property whose category is category from the annotation, or null if there is no such category.
-
bind_to_sound(path)¶
Binds the annotation to the sound file whose path is path. If the sound file is not in the current project,
it will be automatically imported.
-
get_event_start(layer_index, event_index)¶
Gets the start time of an event on a given layer. Note that if the event is an instant, its start time is equal to its end time.
-
get_event_end(layer_index, event_index)¶
Gets the end time of an event on a given layer. Note that if the event is an instant, its end time is equal to its start time.
-
get_event_text(layer_index, event_index)¶
Gets the text of an event on a given layer.
-
set_event_text(layer_index, event_index, new_text)¶
Sets the text of an event on a given layer.
-
get_event_count(layer_index)¶
Returns the number of events on a given layer.
-
get_layer_label(layer_index)¶
Gets the layer’s label.
-
set_layer_label(layer_index, new_label)¶
Sets the layer’s label.