| Both sides previous revision
Previous revision
Next revision
|
Previous revision
Next revision
Both sides next revision
|
doc:customising-en [2010/01/18 23:49]
shelagh updated internal link & formatting |
doc:customising-en [2010/10/04 10:35]
127.0.0.1 external edit |
| Most of the symbols Rosegarden expects to find are in the standard; one exception is that many fonts have a special version of the flag symbol that is intended to be used when composing multiple flags from individual single flags. Rosegarden refers to this as “MUSICAL SYMBOL COMBINING FLAG-0”, a name not used in the Unicode standard (which has flags 1-5 only). | Most of the symbols Rosegarden expects to find are in the standard; one exception is that many fonts have a special version of the flag symbol that is intended to be used when composing multiple flags from individual single flags. Rosegarden refers to this as “MUSICAL SYMBOL COMBINING FLAG-0”, a name not used in the Unicode standard (which has flags 1-5 only). |
| |
| For a definitive set of the symbol names Rosegarden knows about, see the file “gui/notecharname.cpp” in the Rosegarden source distribution. Note however that it is possible to use additional symbol names by introducing them in a [[/#developers-note-styles|notation style]]. | For a definitive set of the symbol names Rosegarden knows about, see the file “gui/notecharname.cpp” in the Rosegarden source distribution. Note however that it is possible to use additional symbol names by introducing them in a [[doc:customising-en#rosegarden-note-style|notation style]]. |
| |
| **src** | **src** |
| **font-id** | **font-id** |
| |
| The id of the system font from which this symbol should be loaded, as defined in the [[/#developers-note-fonts-mapping-format-font-requirements|font-requirements]] element. The default is 0. | The id of the system font from which this symbol should be loaded, as defined in the [[doc:customising-en#font-requirements|font-requirements]] element. The default is 0. |
| |
| **codebase** | **codebase** |
| The attributes for these elements are as follows. All of these are optional except as described: | The attributes for these elements are as follows. All of these are optional except as described: |
| |
| type | **type** |
| |
| Only relevant to the “note” element, and mandatory for that element. This attribute specifies which sort of note is being styled. Legal values are textual American or British note names (from “64th”, “sixth-fourth note”, “hemidemisemiquaver” etc to “double whole note”). | Only relevant to the “note” element, and mandatory for that element. This attribute specifies which sort of note is being styled. Legal values are textual American or British note names (from “64th”, “sixth-fourth note”, “hemidemisemiquaver” etc to “double whole note”). |
| |
| shape | **shape** |
| |
| Defines a note head shape for this style. Any string is a legal value, but the only values implemented so far are “angled oval”, “level oval”, “breve”, “cross”, “triangle up”, “triangle down”, “diamond” and “rectangle”. The value “number” is also recognised but not yet implemented. | Defines a note head shape for this style. Any string is a legal value, but the only values implemented so far are “angled oval”, “level oval”, “breve”, “cross”, “triangle up”, “triangle down”, “diamond” and “rectangle”. The value “number” is also recognised but not yet implemented. |
| |
| charname | **charname** |
| |
| Defines a note font character name to be used as the note head for this style. An element may supply a “shape” or “charname” attribute, but not both. The name should be one of those defined in the current notation font's [[/#developers-note-fonts-mapping-format-font-symbol-map|symbol map]] (in a “name” attribute). | Defines a note font character name to be used as the note head for this style. An element may supply a “shape” or “charname” attribute, but not both. The name should be one of those defined in the current notation font's [[/#developers-note-fonts-mapping-format-font-symbol-map|symbol map]] (in a “name” attribute). |
| |
| filled | **filled** |
| |
| Specifies whether this note should have a filled head (where applicable, i.e. where the shape attribute supplies a shape that is available both filled and unfilled). Must be “true” or “false”. | Specifies whether this note should have a filled head (where applicable, i.e. where the shape attribute supplies a shape that is available both filled and unfilled). Must be “true” or “false”. |
| |
| stem | **stem** |
| |
| Specifies whether this note should have a stem. Must be “true” or “false”. | Specifies whether this note should have a stem. Must be “true” or “false”. |
| |
| flags | **flags** |
| |
| Defines how many flags or beams this note should have. The valid range is 0 to 4. | Defines how many flags or beams this note should have. The valid range is 0 to 4. |
| |
| slashes | **slashes** |
| |
| Defines how many slashes this note should have across its stem. | Defines how many slashes this note should have across its stem. |
| |
| hfixpoint | **hfixpoint** |
| |
| Specifies in which x position the stem fixes to the note head. Acceptable values are “normal” (the right side when the stem points up, the left when it points down), “central”, and “reversed” (left side when the stem points up, right when it points down). | Specifies in which x position the stem fixes to the note head. Acceptable values are “normal” (the right side when the stem points up, the left when it points down), “central”, and “reversed” (left side when the stem points up, right when it points down). |
| |
| vfixpoint | **vfixpoint** |
| |
| Specifies in which y position the stem fixes to the note head. Acceptable values are “near” (the stem fixes to the top when pointing up, the bottom when pointing down), “middle”, or “far”. | Specifies in which y position the stem fixes to the note head. Acceptable values are “near” (the stem fixes to the top when pointing up, the bottom when pointing down), “middle”, or “far”. |
