Editing the character set definition file

You might have to edit the character set definition file if you created or modified a character set.

The character set definition file specifies the character set attributes and the font global identifier (FGID) of the font. There are two sections of the file, one for the character set ([CHARSET]) and one for the FGID ([FGID]). The lines in each section define different mappings.

In the [CHARSET] section, the lines use this syntax:

charset=fgid,height,width,strikeover,underline
charset
The 8-character identifier for the character set.
fgid
The font global identifier for the character set. The value of the FGID must be a value between 3840 and 4096 or 65260 and 65534.
height
The vertical size of the character set, expressed in tenths of a point. For example, a 9-point font has a height of 90.
  • For raster fonts, valid values for the height are whole numbers from 1 through 990.
  • For outline fonts, the value is 0 because the height is specified in the AFP data stream.
width
The average horizontal size of the characters in the set, expressed in 1440ths of an inch. Use 0 (zero) to let the browser determine the width based on the value that you entered for height. This value is optional.
strikeover
A font whose characters all have a line, parallel to the character baseline, placed over the middle of the character. If the character set refers to a strikethrough font, set this value to 1; if not, set it to 0. This value is optional.
underline
A font whose characters all have a line, parallel to the character baseline, placed under the character. If the character set refers to an underline font, set this value to 1; if not, set it to 0. This value is optional.

For example, the [CHARSET] section of the character set definition file might contain these entries:

[CHARSET]
C?H200A0=2304,110,73,0,0
C?D0GT15=230,80,96,0,0
DEFAULT=2308,80,0

In the [FGID] section, the lines use this syntax:

fgid=familyname,style,weight,italic
fgid
The numerical FGID value.
familyname
The name of a typeface or type family, such as TimesNewRoman or Courier.
    Note:
  • To determine the family name of a Type 0 or Type 1 font, open the .pfa or .pfb file with a text editor and search for /FamilyName. This family name must also be mapped to the file name of the .pfb file in the fontmap.lst file.
  • For a TrueType or OpenType font, use the family name of the Type 0 or Type 1 font that it is mapped to in the ttdef.fnt file.
  • Family names must not contain spaces.
style
A generic description of some aspects of a font. Valid values are:
SWISS
A proportionally spaced sans serif font.
ROMAN
A proportionally spaced serif font.
SCRIPT
A fixed-pitch font that is designed to look like handwriting.
MODERN
A fixed-pitch font that can be serif or sans serif.
DISPLAY
A decorative font.
weight
The degree of boldness of a typeface, caused by changing the thickness of the strokes used to create the character. Valid values are: LIGHT, MED, and BOLD. This value is optional.
italic
A font whose characters slant to the right. If the character set refers to an italic font, set this value to 1; if not, set it to 0. This value is optional.

For example, the [FGID] section of the character set definition file might contain these entries:

[FGID]
230=Gothic,MODERN,MED,0
2304=SWISS,MODERN,MED,0
2308=TimesNewRoman,ROMAN,MED,0

To edit the character set definition file:

  1. On AIX and Linux, log in to the primary computer using a user ID that is a member of the RICOH ProcessDirector group (aiwgrp1 is the default).
  2. Navigate to /opt/infoprint/ippd/afpviewer/font (AIX and Linux) or C:\Program Files\Ricoh\ProcessDirector\afpviewer\font (Windows) and find the file csdef.fnt.
  3. Copy the file csdef.fnt and save it as a backup.
    For example, you can save the copy as csdef.fnt.bak.
  4. Open csdef.fnt in a file editor.
  5. Insert new lines for the character sets that your files require in both sections of the file, using the syntax above.
      Note:
    • You can use a question mark (?) as a wildcard character for any single character in the character set name. You can enter more than one ? character.
    • The DEFAULT line of the [CHARSET] section must be the last one in the list. Add your lines above it.
    • If you add your own AFP font character set to the [CHARSET] section, you must assign it an FGID. If the new character set has the same family name, style, weight, and italic attributes as an existing character set, you can use the same FGID; otherwise, you must add a unique FGID to the [FGID] section.
    • A semicolon (;) in the first column causes that line to be treated as a comment.
    • Section headers within files are enclosed in square brackets ([]) and must not be removed or changed.
    • All values are case-sensitive.
    • If a parameter value is not valid and a default value exists, the default value is used.
    • All parameters are positional.
    • Blanks are allowed between parameters.
  6. Save and close the file.