MNX specification >
MNX reference >
Objects >
clef
The clef object
Type: Dictionary
Keys:
Name |
Type |
Required? |
Description |
"class" |
style class object
|
No |
An optional style class to use for this element and all child elements. |
"color" |
simple color object
|
No |
An optional color to be used when rendering this element and all child elements. |
"glyph" |
smufl glyph object
|
No |
A specific SMuFL glyph name to be used when rendering this clef, e.g. gClefArrowUp . See SMuFL clef glyphs. |
"octave" |
integer (signed) object
|
No |
The number of octaves by which the pitches normally indicated by the given clef sign should be transposed. Default is zero. |
"sign" |
clef sign object
|
Yes |
The clef sign. |
"staffPosition" |
staff position object
|
Yes |
The staff position at which the clef is drawn. For example, a standard G glef is drawn at position -2. |
Examples
This object is used in the following examples:
Accidentals, Articulations, Beams, Beams (across barlines), Beams (hooks), Beams (secondary beam breaks), Beams (with inner grace notes), Clef changes, Dotted notes (augmentation dots), Grace note, Grace notes (beamed), Grand staff piano music, Jumps (D.S. al Fine), Jumps (Dal Segno), Key signatures, Lyrics (basic), Lyrics (multi-line), Multimeasure rests, Multiple layouts, Multiple voices, Organ layout, Ottavas (8va), Parts, Repeats, Repeats (more than once repeated), Repeats (with alternate endings, advanced), Repeats (with alternate endings, simple), Repeats (with implied start repeat), Rest positions, Slurs, Slurs (for chords), Slurs (incomplete slurs), Slurs (targeting specific notes), Styling elements (basic), Styling via a class (basic), Tempo markings, Three-note chord and half rest, Ties, Time signatures, Tremolos (single-note), Tuplets, Two-bar C major scale, “Hello world”