Score Object
This documentation applies to plugins for 1.x only!
Documentation for 2.x+ is built into the Plugin Creator of Musescore.
( ⇒ In Musescore press Ctrl+Shift+P, then F1 to bring it up. )
Click here for Documentation for 3.x
Represents a complete score.
A new score can be created with:var a = new Score();
The new score is appended to MuseScore's list of scores.
The current score can be obtained with:var b = curScore;
Properties
Name | Type | Description |
---|---|---|
composer | string | name of the composer |
duration | integer | total score duration in seconds (read-only) |
fileName | string | the name of the file without the path, "Untitled" for unsaved scores (read-only). (MuseScore 2.0+ as of r5033 ) |
fileVersion | string | the version of the version information (MuseScore 1.2+) |
hasHarmonies | bool | true if a valid chordname is found |
hasLyrics | bool | true if a lyric element is found in the score |
keysig | integer | Key signature at the beginning: -7 (= 7 flats) to 7 (= 7 sharps) or undefined for custom signature |
measures | integer | Number of actual measures (read only) |
pageFormat | PageFormat Object | the format of pages in the score (currently disabled) |
pages | integer | Number of pages (read only) |
parts | integer | Number of parts (read only) |
path | string | the path of the score without the filename, an empty string if the file is not saved (read-only). (MuseScore 2.0+ as of r5033 ) |
poet | string | name of the poet/lyricist |
staves | integer | number of staves (read-only) |
subtitle | string | subtitle of the score |
title | string | title of the score |
timesig | TimeSig Object | the time signature of the score (MuseScore 1.1+) |
version | string | the version of MuseScore that the score was last saved with (MuseScore 1.2+) |
Methods
appendMeasures(integer n)
Append n measures to the score.
appendPart(string partname)
Append a new part to the score.
partname refers to an instrument name in the file instruments.xml.
The part will be initialized from the named instrument in this file.
If partname is empty, a default part will be appended.
close()
Close score. (MuseScore 1.2+)
endUndo()
End undoable operations.
bool load(string path)
Load the score file located at path. Can be any format supported by MuseScore, the extension is used to find out the type of file.
int metatag(string tag)
Sets metatag tag to tag. (Version 2.0+)
int metatag(string tag, string value)
Sets metatag tag to value. (Version 2.0+)
Part part(int i)
Part object at index i.
bool save(string path, string type)
Write score into file path. The file extension type determines the type of file:
"mscz", "mscx", "xml", "mxl", "mid", "pdf","ps", "png", "svg", "ly", "wav", "flac", "ogg".
Not all types may be available.
bool save(string path, string type, string soundfontPath)
For soundfile output (type being one of "wav", "flac", "ogg"), the soundfont to be used can be specified as an additional parameter. (Not available anymore in MuseScore 2.x as of r5011 ).
bool save(string path, "png", boolean screenshot, boolean transparent, double dpi, boolean grayscale)
When saving into a PNG file, additional parameters can be specified.
setExpandRepeat(bool)
Turns on or off the repetitions of ritornellos.
setStyle(string key, string value)
Set the style element with name key to the given value. Known to work for the given keys:
- chordDescriptionFile
- lastSystemFillLimit
startUndo()
Starts undoable operations.