Contents
- Index
- Previous
- Next
F Record - Label
Like the F Record - Message, the Label record places text in the display position. However, the Label record only puts one line of text into the position. The line is a little above the center of the position. Character 5 is an L, indicating that this is a label fingering record.
The real purpose of the Label record is to allow placement of text (and especially text using Text Variables) at the center of the display position, and also to allow a bitmap image to share part of the display position. A normal message record takes up almost all the position. The only portion of a bitmap that will show is around the edge (see Using Bitmaps on F Records for a complete description). However, since the label record's text only takes up one line of the position, it will only cover up 1 line of any bitmap also displayed in that position, using the ;bmp= format. See below for a description and screen snapshot, which should make it clearer.
Format:
FnndLa...a[;bmp=fname]
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
s = screen-only
t = text (.txt) report only
w = wordprocessor (.rtf) report only
a...a = any alphanumeric characters
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). Note that only about 18 characters will fit into the label's text area on the screen. If you exceed this, the rest of the text will be hidden and the user will have no way to see it.
Example:
Ngf1
F00dlLabel0 for %%+00;bmp=slot0.bmp
F05dlLabel1 for %%+00;bmp=slot1.bmp
F10dlLabel2 for %%+00;bmp=slot2.bmp
F15dlLabel3 for %%+00;bmp=slot3.bmp
F20dlLabel4 for %%+00;bmp=slot4.bmp
F25dlLabel5 for %%+00;bmp=slot5.bmp
F30dlLabel6 for %%+00;bmp=slot6.bmp
F35dlLabel7 for %%+00;bmp=slot7.bmp
F40dlLabel8 for %%+00;bmp=slot8.bmp
The above code results in the following display:

This shows the position of the label text in each screen position and how a bitmap will display "around" it. It also demonstrates how Text Variables can be used to supply smart text that would not be possible if the text were just part of the bitmap image itself.
The best example of the use of label records is in the Supplied file - NORMTRIL.TXT, where the words "Full Step Above" and "Half Step Above" are supplied with a colorful bitmap, but the note name below it is supplied with a text variable.