def add_marker(self, position, name="", color=0):
"""
Create new marker and return its index.
Parameters
----------
position : float
Marker position in seconds.
name : str, optional
Marker name.
color : int or tuple of int, optional
Marker color. Integers correspond to REAPER native colors.
Tuple must be RGB triplets of integers between 0 and 255.
Returns
-------
marker : reapy.Marker
New marker.
Notes
-----
If a marker with the same position and name already exists, no
new marker will be created, and the existing marker index will
be returned.
"""
if isinstance(color, tuple):
color = reapy.rgb_to_native(color) | 0x1000000
marker_id = RPR.AddProjectMarker2(self.id, False, position, 0, name,
-1, color)
marker = reapy.Marker(self, marker_id)
return marker
def add_region(self, start, end, name="", color=0):
"""
Create new region and return its index.
Parameters
----------
start : float
Region start in seconds.
end : float
Region end in seconds.
name : str, optional
Region name.
color : int or tuple of int, optional
Region color. Integers correspond to REAPER native colors.
Tuple must be RGB triplets of integers between 0 and 255.
Returns
-------
region : reapy.Region
New region.
"""
if isinstance(color, tuple):
color = reapy.rgb_to_native(color) | 0x1000000
region_id = RPR.AddProjectMarker2(self.id, True, start, end, name, -1,
color)
region = reapy.Region(self, region_id)
return region
def color(self, color):
"""
Set track color to `color`
Parameters
----------
color : tuple
Triplet of integers between 0 and 255 corresponding to RGB
values.
"""
native_color = reapy.rgb_to_native(color)
RPR.SetTrackColor(self.id, native_color)
