Thename table(tag name:
'name') allows you to include human-readable names for features and settings, copyright notices, font names, style names, and other information related to your font. These name character strings containing font-related information can be provided in any language. Entries in the name Table are referenced by other TrueType font tables and can be used by applications and utilities to provide useful information to the user. Name table entries can be added by the font designer in any language at any time to provide information to world-wide users of the font.
The name table is the vehicle by which you convey information about your font to applications and users. You should assume that your font may be used in virtually every part of the globe. As a result, your font should be localized for other languages and cultural environments. This allow your font to be used by many users around the world. For more information concerning localization and Worldwide software, see the Guide to Macintosh Software Localization, available from Addison-Wesley (ISBN 0-201-60856-1).
The information included for each name record in the name table follows:
The platform identifier code designates the computer on which the font is to be used. The specific identifier code designates the script system supported. The language identifier code is the language of the text used in the name fields. The name identifier code is a single word or number descriptor. The name information character strings provide information associated with the font. The name strings are raw character string data. The character set encoding used for the raw name data is determined by the platform and specific identifier codes. For example, if the platform identifier is for the MacOS and the specific identifier is Roman, then the raw string data is MacRoman. If the platform identifier is Unicode, then the raw string data is Unicode text in the UTF-16 encoding format. The character strings can thus be localized to any language and script.
The name table header gives the format of the table, the number of name records (rows) in the table, and the offset in bytes to the multilingual character name strings. The format of the name table header is as follows:
|UInt16||format||Format selector. Set to 0.|
|UInt16||count||The number of nameRecords in this name table.|
|UInt16||stringOffset||Offset in bytes to the beginning of the name character strings.|
|NameRecord||nameRecord[count]||The name records array.|
|variable||name||character strings The character strings of the names. Note that these are not necessarily ASCII!|
The name records array follows the name table header. Six entries are provided for each name record. Here is the format of a
Table 37: Name records
|UInt16||platformID||Platform identifier code.|
|UInt16||platformSpecificID||Platform-specific encoding identifier.|
|UInt16||length||Name string length in bytes.|
|UInt16||offset||Name string offset in bytes from stringOffset.|
The supported platform identifier (
platformID) codes are given in the following table. PlatformID codes have been assigned for Unicode, Macintosh, and Microsoft. PlatformID codes 240 through 255 have been reserved for user-defined platforms and are not available for registration.
Table 38: Name records
|0||Unicode||Indicates Unicode version.|
|1||Macintosh||Script Manager code.|
|2||(reserved; do not use)|
The platform ID 2 was originally to use with ISO/IEC 10646, but that use is now deprecated, as ISO/IEC 10646 and Unicode have identical character code assignments.
To fully specify an encoding, it is necessary to state not only the platform identifier code,
platformID, but also the platform-specific encoding,
platformSpecificID, among all of the possible encodings for the specified platform. The Macintosh script manager codes (
platformID = 1 for Macintosh) are given in the following table.
Table 39: Macintosh platform-specific encoding identifiers
The Unicode platform-specific codes are as follows:
Table 40 : Unicode platform-specific encoding identifiers
|1||Version 1.1 semantics|
|2||ISO 10646 1993 semantics (deprecated)|
|3||Unicode 2.0 or later semantics|
The preferred platform-specific code for Unicode would be 0 or 3. The main distinction between Unicode 1.1 and later versions (most notably 3.0) is that there is a block of some 6600 precomposed Hangul syllables in Unicode 1.1 starting at
U+3400 that was removed in Unicode 2.0 and replaced by a block of ideographs in Unicode 3.0. Use of the platform-specific code 1 for Unicode implies that characters from
U+4DFF are to be interpreted as Hangul syllables. Because ISO/IEC 10646 is code-point identical with the Unicode Standard and any valid text encoded in 10646 is also valid as Unicode, there is no need to use the platform-specific code of 2 for Unicode text, and its use is now deprecated.
All Unicode-based names must be in UTF-16 (two-byte encoding). UTF-8 and UTF-32 (one- and four-byte encodings) are not allowed.
For information on Microsoft platform-specific encoding identifiers, consult Microsoft.
The language identifier (
languageID) code uniquely defines the language in which the name character string is written for the name record. The language identifier codes are given in the following table:
Table 41: Macintosh language codes
|24||Lithuanian||83||Malay (Roman script)|
|25||Polish||84||Malay (Arabic script)|
|46||Byelorussian||138||Javanese (Roman script)|
|47||Uzbek||139||Sundanese (Roman script)|
|49||Azerbaijani (Cyrillic script)||141||Afrikaans|
|50||Azerbaijani (Arabic script)||142||Breton|
|54||Kirghiz||146||Irish Gaelic (with dot above)|
|57||Mongolian (Mongolian script)||149||Greenlandic|
|58||Mongolian (Cyrillic script)||150||Azerbaijani (Roman script)|
The name identifier (
nameID) codes provide a single word or number description relating to the name character string. Codes 0 through 19 are predefined. Codes 20 through 255 are reserved. Codes 256 through 32767 are reserved for font-specific names for variations, layout features and settings, and track names. The predefined name identifier codes are given in the following table:
Table 42: Name Identifiers
|1||Font Family. This string is the font family name the user sees on Macintosh platforms.|
|2||Font Subfamily. This string is the font family the user sees on Macintosh platforms.|
|3||Unique subfamily identification.|
|4||Full name of the font.|
|5||Version of the name table.|
|6||PostScript name of the font. Note: A font may have only one PostScript name and that name must be ASCII.|
|9||Designer; name of the designer of the typeface.|
|10||Description; description of the typeface. Can contain revision information, usage recommendations, history, features, and so on.|
|11||URL of the font vendor (with procotol, e.g., http://, ftp://). If a unique serial number is embedded in the URL, it can be used to register the font.|
|12||URL of the font designer (with protocol, e.g., http://, ftp://)|
|13||License description; description of how the font may be legally used, or different example scenarios for licensed use. This field should be written in plain language, not legalese.|
|14||License information URL, where additional licensing information can be found.|
|16||Preferred Family (Windows only); In Windows, the Family name is displayed in the font menu; the Subfamily name is presented as the Style name. For historical reasons, font families have contained a maximum of four styles, but font designers may group more than four fonts to a single family. The Preferred Family and Preferred Subfamily IDs allow font designers to include the preferred family/subfamily groupings. These IDs are only present if they are different from IDs 1 and 2.|
|17||Preferred Subfamily (Windows only); In Windows, the Family name is displayed in the font menu; the Subfamily name is presented as the Style name. For historical reasons, font families have contained a maximum of four styles, but font designers may group more than four fonts to a single family. The Preferred Family and Preferred Subfamily IDs allow font designers to include the preferred family/subfamily groupings. These IDs are only present if they are different from IDs 1 and 2.|
|18||Compatible Full (Macintosh only); On the Macintosh, the menu name is constructed using the FOND resource. This usually matches the Full Name. If you want the name of the font to appear differently than the Full Name, you can insert the Compatible Full Name in ID 18. This name is not used by the Mac OS itself, but may be used by application developers (e.g., Adobe).|
|19||Sample text. This can be the font name, or any other text that the designer thinks is the best sample text to show what the font looks like.|
|20 - 255||Reserved for future expansion.|
|256 - 32767||Font-specific names (layout features and settings, variations, track names, etc.)|
The name character strings follow the last name record. Their length and offset location in bytes are defined in their corresponding name record. It is important to remember that each name character string appears in the name table in the format relevant to its specified platform and platform-specific ID. For example, if the platform and platform-specific ID were Unicode 1.1, then the text strings would be encoded according to that standard.
In particular, Unicode names should be in UTF-16 (i.e., two-byte characters). UTF-8 and UTF-32 should not be used. (For more information on Unicode encoding forms, see http://www.unicode.org/unicode/standard/principles.html.
Examples of name strings on Macintosh platforms are shown in the following table:
The following example shows how the strings might be used on the Macintosh. The first column has four numbers: the platform, the platform-specific ID (which on the Macintosh is the script), the language, and the name ID code.
|1,0,0,0||"© 1990-91 Apple Computer Inc. ©1981 Linotype AG"||Macintosh platform, Roman script, English language, Copyright notice is "© 1990-91 Apple Computer Inc. ©1981 Linotype AG"|
|1,0,0,1||"Helvetica"||Macintosh platform, Roman script, English language, Family Name is "Helvetica"|
|1,0,0,2||"Bold"||Macintosh platform, Roman script, English language, Style is "Bold"|
|1,0,0,3||"Apple Computer Helvetica Bold"||Macintosh platform, Roman script, English Language, Unique name is "Apple Computer Helvetica Bold"|
|1,0,0,4||"Helvetica Bold"||Macintosh platform, Roman script, English language, Full name is "Helvetica-Bold"|
|1,0,0,5||"1.0"||Macintosh platform, Roman script, English language, Version is "1.0"|
|1,0,0,6||"Helvetica-Bold"||Macintosh platform, Roman script, English language, PostScript Name is "Helvetica-Bold"|
|1,0,0,7||"Helvetica is a registered trademark of Linotype AG"||Macintosh platform, Roman script, English language, Trademark is "Helvetica is a registered trademark of Linotype AG"|
|1,0,1,2||"Gras"||Macintosh platform, Roman script, French language, Style is "Bold"|
|1,0,1,4||"Helvetica Gras"||Macintosh platform, Roman script, French language, Full name is "Helvetica Gras"|
|1,0,1,7||"Helvetica est une marque déposée de Linotype AG"||Macintosh platform, Roman script, French language, Trademark is "Helvetica est une marque déposée de Linotype AG"|
The contents of the '
name' table are ignored by QuickDraw Text and the old Font Manager. ATSUI and MLTE use the '
name' table, however, and MLTE will generate a hierarchical font menu for the user using the font's family name together with style and instance names defined for the font. Note that MLTE does not currently use the Compatible Full name (identifier 18).
The PostScript name is used by the LaserWriter print driver. It cannot be localized; there can be at most one PostScript name for the font and that name must be in ASCII (one-byte, characters 0x20 through 0x7E only). It is recommended that the PostScript name have the Macintosh platform and MacRoman platform-specirfic ID.
Names for the Unicode platform must be valid Unicode using the UTF-16 encoding.
'name' table is not used by the Newton OS.
name' table itself does not depend on other tables in the font. However, other tables (such as the '
feat' [Feature Name] table or the '
fvar' [Font Variations] table) contain name identifiers which are to be used for UI elements providing control of font features or variations. Any name identifier found in one of these other tables must have at least one isntance in the '
Limited editing of the
'name' table is possible using TrueEdit. Note that TrueEdit does not correctly edit names for platforms other than the Mac OS. It is also possible to dump and fuse font names using TypeWriter. The AAT Font Tool can be used to add new names to a font as it adds new features.
[Table of Contents]