Home Page The Club Computers News Links Glossary EYAWTK
Before Amiga Background ICS OCS ECS AGA ??? PPC
U-Boot SLB Linux Amiga OS Dual Boot Motherboards Peripherals Other
Initialisation Installation OS4 Updates About OS4 File Systems Networking Printing Other
Introduction File System Workbench Preferences Commands Error Msgs Miscellaneous

AmigaOS 4.0 - About OS4 - Commands

Purpose: Adds charset tag and version string to a FontContentsHeader file.
Format: SETFONTCHARSET <bitmap font file name> <character set> [VERSTRING <ver string>]
SETFONTCHARSET sets the appropriate Charset tags for a specified font to indicate that the font is compatible with the specified Character Set if someone should attempt to use it.

SETFONTCHARSET lets you change the charset tag and version string stored in a FontContentsHeader file (bitmap font file). This is only necessary for bitmap font files that are not in ISO-8859-1 Latin 1 that were created with charset unaware software (e.g. an old bitmap font editor).

You must specify a <bitmap font file name> argument which specifies the complete path to the font where the Charset tag is to be set, and a <character set> argument that specifies the character set whose Charset flag is to be set.

The VERSTRING <ver string> argument specifies a version string to be stored in the bitmap font file. The maximum allowed length of the string is currently 44 bytes. Please note that the command does not check if the string is a valid version string, you should ensure it starts with "$VER: ".

SETFONTCHARSET will save a modified copy of the bitmap font file that has _MIME-NAME added to the file name (exception: _ISO-8859-1 is omitted). It does not delete the source file (but may overwrite it when old and new name are the same), you will normally want to delete the source file and call FixFonts afterwards.

The allowed charset names are taken from diskfont.library which scans the files L:Charsets/character/sets and L:Charsets/custom-character-sets during startup. Use the special charset name X-Custom for bitmap fonts that do not have characters but special symbols, musical notes etc.

Valid options are:

Description Script Character Set
A custom character set including Latin and Cyrillic characters for the Russian language. Cyrillic Amiga-1251
IBM PC Code Page 437 for Western European languages. Latin IBM437
IBM PC Code Page 850 for Western European languages. Latin IBM850
IBM PC Code Page 852 for Eastern European Latin-Alphabet languages. Latin IBM852
Latin Alphabet 1 for Western European languages. Latin ISO-8859-1
Latin Alphabet 2 for Eastern European Latin-Alphabet languages. Latin ISO-8859-2
Latin Alphabet 3 for Afrikaans, Catalan, Dutch, English, Esperanto, French, Galician, German, Italian, Maltese, Spanish, and Turkish languages. Latin ISO-8859-3
Latin Alphabet 4 for Danish, English, Estonian, Finnish, German, Greenlandic, Lappish (Sami), Latvian, Lithuanian, Norwegian, and Swedish languages. Latin ISO-8859-4
Latin/Cyrillic Alphabet for Russian and certain other languages written in the Cyrillic alphabet. Cyrillic ISO-8859-5
Latin/Arabic Alphabet. Arabic ISO-8859-6
Latin/Greek Alphabet. Greek ISO-8859-7
Latin/Hebrew Alphabet. Hebrew ISO-8859-8
Latin Alphabet 9 for Western European languages. Latin ISO-8859-9
Latin Alphabet 10 for Nordic languages. Latin ISO-8859-10
Latin Alphabet 11 for the Thai language. Thai ISO-8859-13
Latin Alphabet 14 for Celtic (Gaelic, Welsh, Breton) languages. Latin ISO-8859-14
A common Alphabet for English, French, German, Spanish and Portuguese (among other western European languages). Latin ISO-8859-15
A common Alphabet for Albanian, Croatian, Hungarian, Italian, Polish, Romanian and Slovenian, and also used for Finnish, French, German and Irish Gaelic. Latin ISO-8859-16
Used to encode both the Latin and Cyrillic (Russian) alphabets in the 8-bit ASCII G0 space. Cyrillic KOI8-R
Microsoft Windows Code Page 1250 for Eastern European Latin-Alphabet languages. Latin windows-1250
Microsoft Windows Code Page 1251 for Russian and certain other languages written in the Cyrillic alphabet. Cyrillic windows-1251
Microsoft Windows Code Page 1252 for Western European languages. Latin windows-1252
Microsoft Windows Code Page 1253 for the Greek language. Greek window-1253
Microsoft Windows Code Page 1254 for the Turkish language. Latin windows-1254
Microsoft Windows Code Page 1255 for the Hebrew language. Hebrew windows-1255
Microsoft Windows Code Page 1256 for the Arabic language. Arabic windows-1256
Microsoft Windows Code Page 1257 for the Estonian, Latvian and Lithuanian languages. Latin windows-1257
Microsoft Windows Code Page 1258 for the Vietnamese language. Vietnam windows-1258
IANA charset name for the character encoding TIS 620 used together with the control codes from ISO/IEC 6429 for the C0 (0x00-0x1F) and C1 (0x80-0x9F) parts. Latin TIS-620
An extension of the custom character set including Latin and Cyrillic characters for the Russian language. Cyrillic X-Amiga-1251
Alphabet for the Slovakian language. Latin X-ATO-E2
Alphabet for the Polish language. Latin X-ATO-PL
Alphabet for the Serbian language. Latin X-ATO-srpski
US ASCII, ANSI X3.4-1986 (ISO 646 International Reference Version) Latin US-ASCII

Example 1:

3.OS4:> SETFONTCHARSET SYS:Fonts/myfont/11 ISO-8859-2 will create the file SYS:Fonts/myfont/11_ISO-8859-2 which is a copy of the input file but with a TA_CharSet tag specifying ISO-8859-2.

Example 2:

3.OS4:> SETFONTCHARSET Fonts:Modern_Greek/9_ISO-8859-7 ISO-8859-7 will set the Charset flag for ISO-8859-7 (Greek) in a font called Modern_Greek with a size of '9'.

Example 2:

3.OS4:> SETFONTCHARSET SYS:Fonts/Symbol/24 X-Custom \
        VERSTRING "$VER: Symbol/24 51.1 (11.5.2004)"
will create the file SYS:Fonts/Symbol/24_X-Custom which is a copy of the input file but with a TA_CharSet tag specifying X-Custom (so you are able to load it regardless of the current system default charset) and a version string specifying V51.1.

Return to Commands Selection

Disclaimer: Amiga Auckland have prepared the above information for the use of its members based on our experiences and as such is subject to revision at any time. Amiga Auckland cannot guarantee any of the information and cannot be held accountable for any issues that may result from using it.

Copyright © 2006 Amiga Auckland Inc. All rights reserved.
Revised: February 9, 2006.