Fomus

Accessors

obj-id

this slot isn't used by fomus.

event-partid

this slot is equivalent to the slot in the note or rest class.

event-voice

this slot is equivalent to the slot in the rest class, with the exception that a staff or list of staves can be specified instead of voices. staves are indicated with a list beginning with the symbol :staff followed by one or more integer values. the integers represent staff choices and can either be negative or positive, negative indicating that the mark be placed in the uppermost voice of the staff (the staff number is the absolute value of the number given in this case) and positive indicating that the mark be placed in the lowermost voice of the staff. fomus chooses the option from the list that places the mark the closest to the specified offset. following is an example of how to specify staves:

'(:staff 1 -2)

specifying a choice of staves like this allows the user to place marks like dynamics that apply to all voices but only need to appear in one place. in the case of the example above, a mark with this value in its slot that is applied to a grand staff is attached to a note in a voice on the inside of the staff.

as in the case of the rest class, when set to a list of voices, the mark object is distributed to all of them.

event-off

this slot is equivalent to the slot in the note or rest class, with the exception that offsets may also be wrapped inside a list and given a positive or negative value (for example, '(3), '(11.5) or '(-11.5)). when this list is used, it indicates that the marks in the slot are applied to events just before or after the given offset depending on its sign. positive offset values indicate the mark is to applied to the event just following the offset and negative values indicate the mark is to be applied just before it (the absolute value of it). this makes it easier in some cases to place marks that indicate ends of spanners such as slurs, since marks that indicate the end of the spanner can actually be given the offset where the next spanner begins. fomus will place the end mark in the proper place (the event that immediately precedes the one at the indicated offset).

event-marks

slots contain lists of marks. (in a note or rest object, these marks are "attached" to that event.) marks are specified as either symbols or lists of symbols and numbers. if it is a list, then the first element is the mark symbol followed by one or more arguments. following is an example of what may appear in the slot:

'(:accent :startslur- (:startslur- 2 :dotted) (:texttempo "accelerando"))

the mark class can contain one extra mark that note or rest objects can't contain. the symbol itself is :mark and actually specifies another mark that is to be placed in the same voice at a different offset. it has the following format: '(:mark off mark ...), specifying that another mark is to be placed in the same voice at the offset given. this special mark is necessary if the user specifies a staff instead of a voice and the mark is a symbol indicating the start of a spanner. it can also be used as a convenience, since only one mark object needs to be instantiated to specify several marks that belong together. by specifying the end symbol here as part of a mark mark, fomus recognizes the start and end marks as belonging to each other and will place them in the same voice. (starting and ending marks that aren't paired in the same voice cause errors.) the offset argument that is the second element in this list uses the same extended syntax as the slot in this class. the rest of the list after the second element is the mark symbol and the arguments that apply to that symbol. following is an example:

'(:accent (:startslur- 2) (:mark (-101) :endslur- 2))

the contents of the slots of mark objects are dumped into the slots of note and rest objects once voices and staves have been decided. see Marks for a more detailed explanation of marks and their usage.