Contents
- Index
- Previous
- Next
Using Bitmaps on F Records
All F records allow the use of a bitmap image, not just the F record specifically designed for bitmap display (see F Record - Bitmap). The format is to add ;bmp=fname to the end of the F record (see individual descriptions for specifics). The ";bmp=" must be in lowercase letters.
The image file must be in the same directory as the external fingering file that uses it. Therefore, it is not necessary to specify a path for it. It must be a .bmp filetype.
The point of this is mainly to allow a border or line to be drawn at the edge of the position where the F record will appear. For example, to draw a border, you could use an image file that looks like this:

This image is 111x146 (including the border). The inside color is R=192,G=192,B=192. The yellow border is 4 pixels in width.
For example, it allows you to put a border around the fingering displays of recorders and messages, using this code:
Nfn1
F00d,c-,c-c-c-,c-c-,c-c-c-o-,o-,00;bmp=slotbrd1.bmp
F01dmBox 1;bmp=slotbrd1.bmp
F02d,c-,c-c-c-,c-c-,c-c-c-o-,o-,00;bmp=slotbrd1.bmp
F03dmBox 3;bmp=slotbrd1.bmp
F04d,c-,c-c-c-,c-c-,c-c-c-o-,o-,00;bmp=slotbrd1.bmp
F05dmBox 5;bmp=slotbrd1.bmp
F06d,c-,c-c-c-,c-c-,c-c-c-o-,o-,00;bmp=slotbrd1.bmp
F07dmBox 7;bmp=slotbrd1.bmp
F08d,c-,c-c-c-,c-c-,c-c-c-o-,o-,00;bmp=slotbrd1.bmp
which displays as:

The way it works is that the external image bmp file (specified via ;bmp=fname) is displayed first, then the fingering record is displayed on top of it. The reason it works is that regular fingering displays and messages do not fill an entire display position. There is at least 5 pixels on each side.
You can use a thin image file to draw a line. An example can be seen on all screens of the Supplied file - NORMTRIL.TXT, between the FULL-STEP ABOVE and HALF-STEP ABOVE fingerings.
The F Record - Bitmap, which is used to display a bitmap by itself at a screen position, provides for specifying "alternate" text which will be displayed if the bitmap fails to load. The ;bmp=fname format used on other F records does not provide for this. If the bitmap fails to load, it just doesn't get displayed. It won't hurt anything.