Skip to content

Marker

Represents a marker in the FL Studio piano roll.

mode: int property writable

Action associated with the marker.

Possible values

  • 0: no action.

  • 6: pattern length.

  • 8: time signature (numerator and denominator can be accessed from properties tsnum and tsden, respectively).

  • 9: start recording.

  • 10: stop recording.

  • 12: key/scale (key and scale helper can be accessed from properties scale_root and scale_helper, respectively).

name: str property writable

Name of the marker.

Note that for markers that have an associated action, this won't be displayed to the user.

scale_helper: str property writable

Notes that are highlighted in the piano roll, as a comma-separated list of boolean integers.

For example, if C, D and Eb were highlighted, the elements would be:

>>> marker.scale_helper
'1,0,1,1,0,0,0,0,0,0,0,0'

To parse this into a more Pythonic form, you could use the following code:

>>> [n == '1' for n in marker.scale_helper.split(',')]
[True, False, True, True, False, False, False, False, False, False, False, False]

To assign this value in a more pythonic form, you could use the following code:

>>> scale = [True, False, True, True, False, False, False, False, False, False, False, False]
>>> marker.scale_helper = ",".join(str(int(v)) for v in scale)

scale_root: int property writable

Root note of the scale of a key/scale marker, where C is note 0.

time: int property writable

Time at which the marker is placed (in ticks).

tsden: int property writable

Denominator of a time signature marker.

tsnum: int property writable

Numerator of a time signature marker.