Omni Systems, Inc. Mif2Go User's Guide, Version 55

<< Prev | Next >>

> 8 Generating WinHelp > 8.3 Converting text > 8.3.2 Converting special characters > 8.3.2.3 Embedding bitmaps in a font

#### 8.3.2.3 Embedding bitmaps in a font

You can specify a font for which you want certain characters changed to in-line bitmaps in the WinHelp file. You embed bitmaps in the font as follows:

1. Choose a font to represent bitmaps.

2. Assign a different character in that font to each bitmap.

3. Place the assigned characters—in that font—in your FrameMaker document, wherever you want the bitmaps to appear in WinHelp.

In the configuration file you identify the font (BitmapFont=fontname), then map the characters. You can represent a character either as itself or as its decimal numeric value. For example:

[BitmapChars]

; BitmapFont = name of font to check for chars to map here

BitmapFont=Algerian

; following chars are remapped when in BitmapFont in WinHelp only

; sample mappings are all to bitmaps supplied in Help Workshop

; * = bullet, using the decimal numeric value of the character

40=bullet.bmp

; A = arrow, using the character itself (printable, not ";" or "[")

A=prcarrow.bmp

; C = closed book

C=closed.bmp

; D = document

68=document.bmp

; O = open book

79=open.bmp

; S = step

S=onestep.bmp

Add a line for each character you want to map, such as:

40=bullet.bmp

to make all asterisks in that font turn into in-line calls for a bullet image. Any characters you do not map remain themselves. To use the semicolon “;” or the left bracket “[”, you must precede the character with a backslash to avoid conflict with configuration-file conventions.

Make sure you tag only one character at a time with the bitmap font, and watch out for preceding or following spaces in the same font, which would disable the bitmap usage.

When you use actual letters as [BitmapChars] keys, they are case insensitive; “A” is mapped the same as “a”. Using the decimal numeric value of a character as the key instead has two advantages:

• You can map high-bit-set characters, which are often used for symbols.

• You can assign different bitmaps to uppercase and lowercase characters.