Note Object

Updated 4 years ago

This documentation applies to plugins for 1.x only!

( ⇒ In Musescore press Ctrl+Shift+P, then F1 to bring it up. )

Represents a single note. Notes belong to Chord Object objects.

A new Note can be created with:
note = new Note();
or
note = new Note(score);
where score is a Score Object object.

Notes belonging to a given Chord can be accessed with the Chord.note(index) and Chord.topNote() methods of the Chord object.

Name	Type	Description
boundingRect	rect	the bounding rectangle of the note relative to ???; in raster units (read-only).
color	QColor	the colour of the note head.
name	string	the name of the note as a string (read-only).
noteHead	integer	the note head group (see table below).
pitch	integer	the MIDI pitch of the note (in the range 0-127).
pos	pos	the position of the note relative to the page; in raster unit (read-only).
tied	integer	0: not tied 1: tied to next note 2: tied to previous note 3: tied to both previous and next note.
tpc	integer	the Tonal Pitch Class enum of the note.
tuning	integer	the tuning adjustment of the note, in +/-cent with respect to default tuning.
visible	bool	whether the note is visible or not.
userAccidental	integer	the user-added accidental (see table below), if any; only affected by accidentals which do not change the MIDI pitch, like courtesy accidentals or micro-interval accidentals; if a note only has an accidental which can be deducted from the `tpc` property, returns 0.
velocity	integer	the MIDI velocity (loudness) of the note (in the range 0-127).

None.

These are the values returned by the userAccidental property.

These are the values used when reading from or writing to the noteHead property.