Contents
- Index
- Previous
- Next
F Record - Relative Reference
RCDIGITS originally started out as a program to show standard fingerings and alternates. However, with its new external file capabilities, it can also be used to show things like full 4-note turns, full 2-note trills (showing both the starting fingering position and the trill fingering), etc.
To facilitate building additional fingering groups, a new F record type has been added - a "relative reference" record. It is easiest to understand by showing an example. To quickly build a 4-fingering turn for most notes, you would specify 4 relative reference F cards:
1) F50d+02,00
2) F51d+00,00
3) F52d-02,00
4) F53d+00,00
Record 1 says show the fingering that is +2 half steps away from the current note, and use version 00 (the standard fingering for that note). Record 2 says show the fingering that is 0 steps away (i.e. the note we are on), and use version 00. Record 3 shows the note that is 2 half steps below, and then record 4 shows 0 steps away, thus returning to the note we are on.
As you can see, this is a turn - 2 steps up, back to the note, 2 steps down, back to the note.
Character 5 is a plus or minus sign ("+" or "-"), indicating that this is a Relative Reference fingering record.
Format:
Fnndsxx,yy[;bmp=fname]
where
nn = version number (00-99).
d = Display Indicator (d, h, r, s, t, w)
d = display
h = hide
r = report-only
s = screen-only
t = text (.txt) report only
w = wordprocessor (.rtf) report only
s = + or - to go up or down half steps from the current note
xx = how many half steps to go (00-99)
yy = the version (alternate) of the relative note to use (00-99). This can be any type of Fingering record, except it cannot be another Relative Reference record or an Absolute Reference record.
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).
If the record being referenced has a ";bmp=" spec (used to draw a border - see Using Bitmaps on F Records), the bitmap will not be used when the Relative Reference record is displayed. Similarly, if the record being referenced has an Info button associated with it (see I (Information) Record), the Relative Reference record will not have the Info button when it is displayed. In other words, when you use a Relative reference, you only pick up the data contained in the record you are referencing (e.g. the recorder fingering, the message, etc.), not added data like bitmaps and Info. If you want the Relative Reference record to have a bitmap border or an Info button, you should specify it. For example:
F50d+02,00;bmp=border.bmp
IThis is info for this relative reference record.
If the record being referenced contains Text Variables, the variables will resolve using the note names of the Relative Reference Record, not the record being referenced. For example:
1) *Note: F, Octave 1
2) Nfn1
3) F00dmThis is note %%+00
...
4) *Note: F#, Octave 1
5) Ngf1
6) F00d-01,00
In the above example, line 3 is a message record that would display "This is note F" when note F was picked with the Note Buttons. Line 6 is a Relative Reference record in F#, referring back to the message record in F. When note F# is picked with the Note Buttons, the message that is displayed will be "This is note F#/Gb".