Carbon


Font Name Code Constants

Header: SFNTTypes.h

enum {
    kFontCopyrightName = 0,
    kFontFamilyName = 1,
    kFontStyleName = 2,
    kFontUniqueName = 3,
    kFontFullName = 4,
    kFontVersionName = 5,
    kFontPostscriptName = 6,
    kFontTrademarkName = 7,
    kFontManufacturerName = 8,
    kFontDesignerName = 9,
    kFontDescriptionName = 10,
    kFontVendorURLName = 11,
    kFontDesignerURLName = 12,
    kFontLicenseDescriptionName = 13,
    kFontLicenseInfoURLName = 14,
    kFontLastReservedName = 255
};

Constant descriptions

kFontCopyrightName

Identifies the font manufacturer’s copyright notice name. An example of a font name string with this font name code and a platform and script of Mac Roman English is “© Apple Computer, Inc. 1993”.

kFontFamilyName

Identifies the font family name, which is shared by all styles in a font family.An example of a font name string with this font name code and a platform and script of Mac Roman English is “Times”.

kFontStyleName

Identifies the font style. An example of a font name string with this font name code and a platform and script of Mac Roman English is “© Apple Computer, Inc. 1993”. Mac Roman English is “Regular”, “Italic”, “Bold”, or “Black”.

kFontUniqueName

Identifies the manufacturer’s name for the font. Because the name identified by this constant can be used to uniquely identify the font, you should use it in stored documents and in program interchange to identify fonts. The unique name is used in the standard clipboard format. An example of a font name string with this font name code and a platform and script of Mac Roman English is “Apple Computer Times Black 3.0 8/10/92”.

kFontFullName

Identifies the full font name. An example of a font name string with this font name code and a platform and script of Mac Roman English is “Times Black”.

kFontVersionName

Identifies the font manufacturer’s version number for the font. An example of a font name string with this font name code and a platform and script of Mac Roman English is “3.0.” (The name does not need to include the word “version”).

kFontPostscriptName

Identifies the PostScript-legible name of the font. This type of font name can be used to uniquely identify the font. An example of a font name string with this font name code and a platform and script of Mac Roman English is “Times-Black”.

kFontTrademarkName

Identifies the font trademark name. An example of a font name string with this font name code and a platform and script of Mac Roman English is “Palatino is a registered trademark of Linotype AG”.

kFontManufacturerName

Identifies the font manufacturer’s name. An example of a font name string with this font name code and a platform and script of Mac Roman English is “Apple Computer, Inc.”

kFontDesignerName

Identifies the font family designer’s name.

kFontDescriptionName

Identifies the description of the font family.

kFontVendorURLName

Identifies the uniform resource locator of the font vendor. If a unique serial number is embedded in the URL, it can be used to register the font.

kFontDesignerURLName

Identifies the uniform resource locator of the font family designer.

kFontLicenseDescriptionName

Identifies the uniform resource locator of the font vendor. If a unique serial number is embedded in the URL, it can be used to register the font.

kFontLicenseInfoURLName

Identifies the uniform resource locator of the font vendor. If a unique serial number is embedded in the URL, it can be used to register the font.

kFontLastReservedName

Identifies the maximum value for Apple-defined font name codes. You can pass values between kFontLicenseInfoURLName and kFontLastReservedName to find the name of a font variation axis, font feature, font tracking setting, or font instance.

ATSUI identifies the type of a particular font name string by a constant of type FontNameCode. You can use one of these constants as part of your search criteria in the functions ATSUFindFontFromName and ATSUFindFontName. The function ATSUGetIndFontName passes back a constant of this type to represent the type of font name string.

The font name code identifies the type of name string that provides various kinds of information about the font, including its unique name, font family name, style, version number, and Postscript-legible name. The actual font name string varies based on the platform, script, and language of the font name. For example, the name code constant kFontCopyrightName might identify three different strings of the font manufacturer’s copyright notice name, one in Unicode French, one in Macintosh English, and one in Microsoft German.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)