Contents
- Index
- Previous
- Next
F Record - Full-Specification
The "Full-specification" F record is the primary type of F record. It contains a complete description of the fingering, describing which fingers are open, closed, trilled, etc. Character 5 is a comma (","), which indicates that this is a full-specification fingering record.
Format:

where:
nn = version number (00-99). Number 00 is standard fingering
d = Display Indicator (d, h, r, s, t, w)
d = display
h = hide
r = report-only (text and wordprocessor)
s = screen-only
t = text (.txt) report only
w = wordprocessor (.rtf) report only
f = fingering (c,o,p,5)
c = closed
o = open
p = pinched (used for thumbhole only)
5 = half closed
t = trill indicator (-,1,2)
- = not trilled
1 = trill is full step above
2 = trill is half step above
r = reverse trill position indicator
0 = do not reverse
1 = reverse
2 = no trill position indicators
x = 0 (reserved for future use)
fname = optional external bitmap to load (see Using Bitmaps on F Records.)
The total length of the record should not exceed 200 characters. Otherwise it will truncate without a warning or error condition (see Remarks & Hints).
Example:
F00d,c-,c-c-c-,o-o-,o-o-o-o-,o-,00
F00d,c-,c-c-c-,o-o-,o-o-o-o-,o-,00;bmp=border1.bmp
Detailed Specs
nn (version number):
This field is any 2-character number you want to assign to a particular fingering for that note. The standard fingering is always 00 (if you don't include a 00 fingering, the standard position on the display will remain empty).
Thus, you can have up to 100 fingerings for a given note. If you have more than 8 alternates, the rest will be displayed on subsequent "pages." Each fingering that is to be displayed is placed into the next available position on the screen. The sequence is determined by the number of the fingering - e.g. fingering 20 comes before fingering number 21, regardless of their position in the file. If you want to leave a screen position blank, you can create a blank "message" fingering record (see F Record - Message below).
d (Display Indicator):
This enables you to establish a fingering without having it displayed (via the "h" value).
The most common use for this feature is to set up a trill where the note itself is not an alternate, but the note above it is an alternate. You set it up as a hidden trill, and then use a trill reference (see Trill References to it in an alternate fingering for the note above it. For example, the standard Octave 1 Bb to A trill has a regular A, but an alternate Bb. The correct way to describe this trill is as an A (a trill's fingering is named by the lower note). However, you do not want it displayed in the A alternate display, because the A fingering is standard. You do want it displayed as an alternate in the Bb alternate display. So, you set up a hidden fingering for it under A, and use a trill reference for it in Bb.
Another use for this is to get rid of fingerings from the display without really removing them. This is safer than commenting them out - commenting out will break a trill reference or a relative fingering to a note, if such a reference exists.
You can also create a fingering record that will not appear on the screen, but will only appear on a Report by using an "r" in this indicator. For more information, see Report-only Records. Similarly, you can create a fingering record that will appear on the screen but not appear on a report by using an "s". See Screen-only Records for more info.
f and t - how to indicate single holes for righthand fingers 3 and 4
These indicators are normally used to specify the fingering for the hole (open, closed, etc) and whether it is trilled. The right hand fingers 3 and 4 have an alternate specification used to display a recorder with only single holes (instead of the double holes). A single hole is specified by using the code "s-" instead of the first ft fingering and trill indicator for the finger. The 2nd ft pair is used in the normal fashion.
For example, a normal fingering might read:
F00d,c-,c-c-c-,o-o-,c-c-o-o-,o-,00
giving a pair of closed holes for finger 3 and a pair of open holes for finger 4
while a single-hole fingering would be:
F00d,c-,c-c-c-,o-o-,s-c-s-o-,o-,00
giving a single closed hole for finger 3 and a single open hole for finger 4.
r (reverse trill position indicator - 0, 1, or 2)
This indicator is primarily used for those few fingerings where putting the trill fingers down yields a HIGHER note. If this is the case, this should be a 1, which causes the program to reverse the regular direction it would assign to a Trill Postion indicator (see Fingerings).
This can also be used if you have decided to not use trill references - i.e. you are going to specify full-specification trill fingerings for all notes, even when the note is the upper note in a trill. When the program sees a full-specification trill fingering, it will normally assign a "v" Trill Position Indicator (i.e. the note in question is obtained with the fingers DOWN). To get it to reverse this, specify a 1.
The 2 means to not display a Trill Position indicator for this fingering. The drawback to this is that the program will then be unable to display the fingering without the trilling fingers (picked by the user by unchecking the Display Trill Fingers Checkbox), because it will not know whether the note is obtained with the trilling fingers up or down.
A 2 in this field in any record in the whole external file (even a hidden fingering record) will grey the Display Trill Fingers checkbox (in the checked position) for all fingerings. Although the program could just grey it for those notes that have a 2 in a fingering, it would look like a bug if the checkbox gets activated and deactivated for different notes.
Notes
1) A finger hole must be closed (have a "c") in order to have a trill indicator (a 1 or 2 following the c). Therefore an open hole ("o") must always be designated with "o-".
2) The program currently makes no distinction between a 1 in the trill indicator (meaning a trill from a full step above) and a 2 ( indicating a trill from a 1/2 step above). Both just cause a red hole to be displayed. However, you are advised to always specify them correctly, since a use may be made of this information in the future (for example, some indicator on the display).
3) One question - why bother having 2 characters for a fingering (e.g. c1 or c2)? Why not just have one character (say a c for closed, an o for open, an h for a half-above trill, an f for a full-above trill)? The answer is that I wanted to have a percent closed ability (e.g. "5-" meaning a 50% closed hole that isn't trilled; "2-" meaning 20% closed, etc). But couldn't this be handled by just having a single number? (i.e. c= close; o=open, h=half-above trill; f=full-above trill; a number = percent closed, non-trilled)? No. Because I might want to have a semi-closed finger be a trill finger. This almost never happens, but I wanted to have the flexibility. I could not think of a way to indicate such a thing with only 1 character. Also, the more flexibility in such things, the better.
In practice, the program only displays a 50% closed hole no matter what number you have, so the spec above says to use a 5 for a partially-opened hole. However, the program will accept any number. I didn't want to load the program up with bitmaps of 10%, 20%, 30%, etc closed holes, since it wouldn't be very distinguishable anyway. If someone thinks this would be desireable, let me know.
4) The program will not accept "o-c-" as the fingering for right hand fingers 3 or 4 - i.e. having the first hole open and the second closed. This position is so awkward that I'm not even sure it should be considered. If someone wants to use it, let me know and I'll consider adding the code for it (it will also require additional bitmaps in the program, which will increase the executable's size).