DOFONT Command


>>-DOFONT--lname--+-'ttfname'--------+-------------------------->
                  '-X16'uuuuuuuu...'-'   

   .-HEIGHT--10--POINTS----.                       
>--+-----------------------+--+----------------+---------------->
   |            .-POINTS-. |  '-RATIO--percent-'   
   '-HEIGHT--n--+--------+-'                       
                +-IN-----+                         
                +-CM-----+                         
                +-MM-----+                         
                '-PELS---'                         

   .-ROTATION--0-------.                
>--+-------------------+--+---------+--------------------------->
   '-ROTATION--+-0---+-'  '-PRELOAD-'   
               +-90--+                  
               +-180-+                  
               '-270-'                  

   .-UDType of the PAGEDEF----------------------.             
>--+--------------------------------------------+--+------+----->
   |                   .-CP--'T1V10500'-----.   |  '-MICR-'   
   '-UDType--+-EBCDIC--+--------------------+-+-'             
             |         '-CP--code-page-name-' |               
             +-EBCDIC2--CP--code-page-name----+               
             |        .-CP--'T1000819'-----.  |               
             +-ASCII--+--------------------+--+               
             |        '-CP--code-page-name-'  |               
             +-UTF8---------------------------+               
             '-UTF16--------------------------'               

>--+--------+--;-----------------------------------------------><
   '-INLINE-'

The DOFONT command defines a Data Object font and specifies its attributes. Data Object fonts include TrueType and OpenType fonts. A font installer is used to install Data Object fonts and a Resource Access Table (RAT). The RAT contains a table which, when accessed with the full font name that is provided by the user, gives the file access name for the font. All names in the RAT are encoded in UTF-16. For more information, see Using OpenType Fonts in an AFP System.

To use Data Object fonts, do these:

Non-PPFA requirements:
- You need a printer and a print server (PSF or IPM) that supports Data Object fonts.
- You must install a Resource Access Table (RAT) and the Data Object fonts that are used. For more information, see Using OpenType Fonts in an AFP System.
PPFA requirements:
- Define the font by using a DOFONT command.
- Reference the font in one of the following two ways:
  - Reference the font with the PRINTLINE, LAYOUT, XLAYOUT, FIELD, or FIELD BARCODE commands by using the local name.
  - Use the EXTREF command in the appropriate PAGEFORMAT to create an external reference to any font that must be mapped but is not referenced in the first manner. For example, a BCOCA object can be presented in the page definition and that object can use a font that is not referenced by the page definition. The EXTREF command would allow the font to be mapped.

DOFONT

Defines a Data Object Font.

lname

Local name for the font. Specifies an unquoted alphanumeric name of 1 - 16 characters. The name must be unique within the page definition. lname is the name that is used in the EXTREF, PRINTLINE, LAYOUT, XLAYOUT, FIELD, or FIELD BARCODE commands by using FONT or DOFONT commands that reference the font.

full font name

The full font name of the Data Object font; for example, Times New Roman Bold.

'ttfname'

Specifies a quoted, case-sensitive name of the Data Object font to be used in the page definition. Names entered in this form are translated to UTF-16 for matching in the RAT. The name is 1 - 125 characters long and can contain blanks. It is entered in the operating system encoding (for example, ASCII or EBCDIC). The full font name is case-sensitive and must match exactly the full font name in the Data Object font, including blanks. Long font names must be entered as follows:

 DOFONT Font1 'A very long named Helvetica Font whose name'
              ' will not fit on one line, and maybe '
              'not even on two lines'
        Height 12 points;

Be sure that the blanks are not left out and the case (Upper or Lower) of the characters are correct.

X'16'uuuuuuuu...'

The full font name of the Data Object font in Unicode UTF-16BE (Big Endian) encoding. Enter the full Unicode font name in hex digits. Four hex digits represent one Unicode code point if it isn't a surrogate. It takes eight if it is a surrogate. PPFA only checks that the entered digits are a multiple of four. The total number of hex digits that are entered is restricted to 500. This allows a font name of up to 125 characters (if no surrogates exist). No translation is done on the name when entered in this format. The Unicode UTF-16BE is case-sensitive and must match exactly the full font name in the Data Object font, including blanks. Long font names must be entered as follows:

DOFONT Font1 X16'0041002000760065007200790020006C006F006E0067'
                '00200066006F006E00740020006E0061006D00650064'
                '002000480065006C007600650074006900630061'
       Height 12 points;

Be sure that the blanks are included and the case (Upper or Lower) of the characters are correctly encoded.