Using The Amulet GEM Font Converter

• Fonts and the Amulet GEM Font Converter
• Starting the Amulet GEM Font Converter
• Using the Converter
• Selecting Range of Characters to Convert
• File Menu
• Disclaimer

Fonts and the Amulet GEM Font Converter

Any font that you use in your GUI pages will need to be converted into an Amulet Unicode Font file (.auf) using the Amulet GEM Font Converter and the subsequent .auf file should be placed in one of three acceptable folders. Either the root directory of the project you are compiling, the root\Fonts directory, or the Amulet\Configuration\Fonts folder. The GEM Compiler first looks in the root directory, then the root\Fonts directory, and finally the Amulet\Configuration\Fonts directory.

You will then need to place Arial_4.auf, which is generated by the Amulet GEM Font Converter, into either the Amulet\Configuration\Fonts folder or in the root directory of the file you are compiling. If you save Arial_4.auf  in the Amulet\Configuration\Fonts folder, then you can use Arial size 4 in any other Amulet project. If you save it in your root or root\Fonts folder, Arial size 4 can be used in any page or project used within the root directory.

To use a font generated by the Amulet GEM Font Converter in an Amulet Widget, please restart GEMstudio. If the "font" is missing, the default will be the Amulet Sans Serif size 12pt. If the fontSize is missing, the default is 12pt.

It is HIGHLY recommended in situations which "non-regular" font styles are used, to use the Amulet GEM Font Converter to convert the font in the "Regular" style and let the Amulet software modify the style of the font.

Starting the Amulet GEM Font Converter

The Amulet GEM Font Converter runs on Windows 2000, XP, and Vista. The Converter may be invoked by any standard Windows method:

• From the Main GEMstudio window, click on the "Launch GEM Font Converter" button as highlighted in the figure below.

Using the Converter

To convert a Windows font into an Amulet Unicode Font (*.auf), load and save the font with the Amulet GEM Font Converter. Instructions follow detailing this process:

To load the font, click on "Load Font..." from the File menu and then choose the Font, Font style, and size.

Once you load the font, you'll notice the display of the program now contains the character set of the font you are about to save.

To save the font, click on "Save AmuletFont..." from the File menu. You'll notice that you can only save the file as an Amulet Font file(.auf). You should save the resultant .auf file in the Configuration\Fonts folder in the Amulet sub-directory. If the .auf file is not located in that directory, the compiler will throw a compilation error, stating the required font file cannot be found. Please restart GEMstudio to use the new saved font.

NOTE: The font size that you load must match the font size used in the page you created earlier. The save file name is the font name with _xx appended to the end, where _xx is the corresponding point size. This is the format that must be used for the compiler to compile correctly.

Selecting Range of Characters to Convert

The Amulet GEM Font Converter has the ability to convert all characters from 0x0 to 0xFFFF. By default, the Amulet GEM Font Converter only converts and saves the lower-ASCII characters, 0x21-0x7F. To convert and save either more or less than the default, select File > Options. A pop-up menu will appear similar to this:

The First Character range is 0x0-0xFFFF. The Last Character range is 0x0-0xFFFF. The First Character value should be less than or equal to the Last Character value.

This allows for displaying font characters that are not part of the ASCII range. The characters that can be found in the Unicode section (0x80 and above) are not always going to be the same from font to font, so ensure that the character you are interested in displaying is available in the font you are using.

This option also allows for saving a smaller subset of a font if you are sure that you will only be using a portion of a specific font. For instance, you may want a large number font to be used as part of a numeric field widget. Being it is a large font, if you saved all lower ASCII characters it would result in a very large .auf file which would eat up a large portion of your project's flash space. By setting the First Character to 0x30 and the Last Character to 0x39, you could save just the numbers 0-9, which would obviously result in a much smaller .auf file, thus using much less flash space.

These values are not persistant after closing down the Amulet GEM Font Converter. Each time you start the Amulet GEM Font Converter, the First Character defaults to 0x20 and the Last Character defaults to 0x7F. 

File Menu

Disclaimer

Converting copyrighted TrueType and bitmap fonts for the purposes of resale, copyright infringement or licensing avoidance is strictly prohibited. Refer to the original font's licensing agreement for additional restrictions that may apply. Amulet Technologies will not be held liable for infringements made to a font's licensing agreement, nor will it take responsibility for the user's actions involving the use of the Amulet GEM Font Converter.