Character Set Definition File

The character set definition file (csdef.fnt) specifies the character set attributes and font global identifier of the font. It is split into two sections, one for character sets (CHARSET) and one for font global identifiers (FGID).

The CHARSET section lists each AFP font character set and its corresponding attributes. CHARSET Section of the csdef.fnt File shows an example of the CHARSET section in the csdef.fnt file.

CHARSET Section of the csdef.fnt File

[CHARSET]
;charset = fgid, height, width, strikeover, underline
C?H200A0=2304,110,73,0,0
C?H200D0=2304,140,93,0,0
C?N200B0=2308,120,80,0,0
C?4200B0=416,120,144,0,0
C?D0GT15=230,80,96,0,0
C?A155A0=33207,110,73,0,0
C?A175A0=33227,110,73,0,0
C?T055D0=4407,140,93,0,0
C?T17500=4555,100,67,0,0
C?T17560=4555,60,40,0,0
DEFAULT=2308,80,0,0

Attribute Values for CHARSET describes the attributes and values for CHARSET.

Attribute Values for CHARSET

Attribute Values Shipped Default Description
fgid An FGID in one of these ranges:
  • 3840 to 4096
  • 65260 to 65534
2308 A unique font global identifier (FGID) value, which identifies the type family, typeface, and sometimes the point size of the character set. This can be a predefined FGID or your own FGID.
height 1 to 990 80 The vertical size of the character set (minimal baseline-to-baseline value) expressed in tenths of a point. For example, a 9-point font would have a height of 90.
width 0 to 99 (currently ignored) 0 The average horizontal size of the characters in 1440th of an inch. Currently, 0 is always used because an appropriate font width is based on the height of the font.
strikeover 1 = YES0 = NO 0 A font whose characters all have a line, parallel to the character baseline, placed over the middle of the character.
underline 1 = YES0 = NO 0 A font whose characters all have a line underneath the character.

The FGID section lists each font global identifier and its corresponding attributes. FGID Section of the csdef.fnt File shows an example of the FGID section in the csdef.fnt file.

FGID Section of the csdef.fnt File

[FGID]
;fgid = familyname, style, weight, italic 230=Gothic, MODERN,MED,0
416=Courier,MODERN,MED,0
2304=Helvetica,SWISS,MED,0
2308=TimesNewRoman,ROMAN,MED,0
4407=SonoranSerif,ROMAN,MED,0
4555=SonoranSerif,ROMAN,BOLD,1
33207=SonoranSansSerif,SWISS,MED,1
33227=SonoranSansSerif,SWISS,BOLD,1

Attributes and Values for FGID describes the attributes and values for FGID.

Attributes and Values for FGID

Attribute Values Shipped Default Description
familyname Font family name reference Times New Roman An outline font family name or an AFP family name. Family name is the same as type family in AFP fonts and typeface name in the PDF environment.
style SWISS, ROMAN, SCRIPT, MODERN, DISPLAY ROMAN A type of character face or specific characteristics of the font.
    Note:
  • SWISS is a proportionally spaced, sans serif font.

  • ROMAN is a proportionally spaced, serif font.

  • SCRIPT is a fixed-pitch font designed to look like handwriting.

  • MODERN is a fixed-pitch, sans serif or serif font.

weight LIGHT, MED, BOLD MED The degree of boldness of a typeface caused by different thickness of the strokes that form a graphic character.
italic 1 = YES0 = NO 0 A font with right-slanting characters.

Syntax rules

  • A comma must separate attributes

  • A question mark (?) can be used only as the wildcard character for the second character in the character set name. This allows all the character rotations of the coded fonts to be handled with one entry while searching.

    Note: A sequential search is performed for the character set, and the first match (including the wildcard character) is used.
  • The CHARSET section must come before the FGID section in the file.

  • In the CHARSET section of the file, only the fgid and height attributes are required.

  • In the FGID section of the file, only the familyname and style attributes are required.

  • If you define a default character set in the file, it must be the last entry in the CHARSET section.

  • If you add your own AFP font character set to the CHARSET section, you must assign it a font global identifier. If the new character set has the same familyname, style, weight, and italic attributes as an existing character set, you can use the same font global identifier; otherwise, you must add a unique font global identifier to the FGID section.