Structure PERC

Constructor: (MAKE-PERC &key :SYM sym :STAFF staff :VOICE voice :NOTE note :AUTODUR autodur :MARKS marks :MIDINOTE-IM midinote-im :MIDINOTE-EX midinote-ex)

Copy Function: (COPY-PERC perc &key :SYM sym :STAFF staff :VOICE voice :NOTE note :AUTODUR autodur :MARKS marks :MIDINOTE-IM midinote-im :MIDINOTE-EX midinote-ex)

Accessors:

PERC-SYM

This is a unique symbol identifying the percussion instrument. It is used as a lookup value so that it may easily be specified in INSTR structures.

PERC-STAFF

This is an integer of 1 or greater specifying on which staff the instrument appears on.

PERC-VOICE

This is an integer of 1 or greater specifying a voice that this instrument belongs to. Specifying different voices prevents notes belonging to different instruments from being beamed together.

PERC-NOTE

This is an integer or symbol designating where the instrument's notes are to appear on the staff. The value is interpreted with middle C in the center as if notated with an alto clef signature. See EVENT-NOTE in the NOTE class for information on specifying notes with symbols. Percussion notes should not require flats or sharps.

PERC-AUTODUR

If set to T, indicates that FOMUS should determine durations for this instrument. This is appropriate for percussion instruments that don't have long sustain times and can therefore be notated with durations that are simpler to read. Notes containing certain marks such as trills and tremolos are left unchanged. This slot is T by default.

PERC-MARKS

Contains a list of MARKS to be added to NOTE objects that specify this percussion instrument. An example value to put here might be ((:text "R.S." :up)) for a "rim shot" percussion instrument.

PERC-MIDINOTE-IM

Represents the MIDI note or notes used to import MIDI data. This can either be an integer from 0 to 127 or a list of such integers.

PERC-MIDINOTE-EX

An integer value from 0 to 127 representing the MIDI note used when exporting MIDI data.