You are here: Reference > Appendix > Configuring Instrument.txt

Configuring Instrument.txt

The Setup and Exercise Wizards use the instrument.txt file to determine what instruments to offer, what order from top to bottom to place the instruments and more.

To include musical characters from the default font, use ^flat() for a flat, ^sharp() for a sharp and ^natural() for a natural. For example, to get a B flat Clarinet, you’d type B^flat() Clarinet.

Finale 2010 allows the Patch value to go to different banks by adding 128 for each bank starting with bank 0, then adding the program change number. For example, Bank 1 Program Change 2 would equal 258 for the Patch Setting: 128 (Bank 0) + 128 (Bank 1) + 2 (Program Change 2).

 

[INS:Intrument]

These sections contain the detailed information for the particular instrument such as [INS:Flute].

DisplayName =   Name as it appears on Page 2 of the Setup Wizard

Name =    Staff Name

Abbr =    Abbreviated Staff Name

useKeySigs =   Use Key Signature for staff and staff transposition (1= Use, 0= Don’t Use)

Transposition =    Set the transposition with the number of half steps up or down

   (Examples: 12=octave up, 0 = none, -12 octave down)

TransClef =   Type of clef for transposing instrument

   (treble, bass, alto, treble8vb, percussion, tenor, baritone, bass8vb, frenchviolin, cbaritone, mezzosoprano, soprano, altpercussion, treble8va, bass8va, tab1, tab2, blank)

StaffType =   Type of Staff (standard, percussion, single, grand, organ)

Clef =   Type of Clef

   (treble, bass, alto, treble8vb, percussion, tenor, baritone, bass8vb, frenchviolin, cbaritone, mezzosoprano, soprano, altpercussion, treble8va, bass8va, tab1, tab2, blank)

ShowStems =   0=No stems (stems unchecked in Staff Attributes), 1=Show stems above

   staff. Used primarily for TAB staves.

FretInst =   Name of fretboard instrument. Used for TAB staves.

Patch =   Patch Number for General MIDI based from 0-127.

PercMap =   General MIDI note number.

ExWizDisp =   1=Instrument will appear in the Exercise Wizard, 0=Instrument does not appear in the Exercise Wizard, but does appear in the Setup Wizard

RangeLow =   Lowest note allowed in the Exercise Wizard in various skill levels: Basic, Intermediate, Advanced. (Values expressed as MIDI note numbers)

RangeHigh =   Highest note allowed in the Exercise Wizard in various skill levels: Basic, Intermediate, Advanced. (Values expressed as MIDI note numbers)

PercMIDIMapFile = The Percussion MIDI Map XML file used for playback and/or entry. See Percussion MIDI Maps.

PercMIDIMapName = The Percussion MIDI Map name displayed in the Percussion MIDI Map Editor dialog box.

PercNote = The Note Type for the instrument as defined in the PercNoteTypes.txt. This file is located in the application package > Contents\Resources\Englishlproj.

 

[GRP:Group]

These sections define the group or family names. These items will be grouped together using a bracket.

Name =    Group Name

Abbr =   Abbreviated Group Name

Instrument = x   Instrument name (x = include in list, no x does not include in list)

ExWizDisp =   1=Group will appear in the Exercise Wizard, 0=Group does not appear in the Exercise Wizard, but does appear in the Setup Wizard

 

[ORD:Order]

This list contains the default order of the instruments in the wizard. As in the Group section, x means include the instrument; no x means do not include the instrument. If an instrument is not listed in the Order, it will be added to the bottom of the list.

 

 

User Manual Home