hpux psfontpf man page on unix.com

psfontpf(1M) psfontpf(1M)

NAME
psfontpf - internationalized PostScript print filter

SYNOPSIS
config-file]
logfile]
number] keyword] option-lists]
[keyword:]ppd-file]
interface-script] title] user]

Remarks
The command should only be called from the printer model script or its derivatives. Only the and options are user-accessible through the
corresponding options in the command. Only the sub-options available under the user-accessible option are explained in more detail. See
the section in this manpage. The other options are not directly user-accessible and are only briefly described. See psmsgen(1M) on how to
create a customized version of the printer model script by adjusting the various options supported by the print filter.

DESCRIPTION
The filter is a generic text-to-PostScript converter that converts the various single byte and multibyte characters used in an interna-
tional environment to printable PostScript file. The filter embeds all required PostScript font data within the PostScript program, if
necessary. Therefore, print jobs that include local language characters can be printed on printers where local language fonts are not
present.

The filter supports the printing of characters in the following languages or scripts:

1. Latin-based and Cyrillic-based European languages.

2. East Asian ideographic character based languages (Chinese, Japanese and Korean).

3. Arabic and Hebrew with bidirectional printing support.

4. Devanagari (Hindi) and Thai. A little extra line spacing is recommended for both of them to avoid possible overlap of characters
between adjacent lines.

There are two ways to notify on what character set encoding (codeset) is used in the input file: by specifying the locale or the codeset
name. For codesets that are supported by locales, the specification of locale names are preferred over the direct specification of codeset
names because the locale names are also associated with fonts and proper character display width information. Because converts all charac-
ters internally to Unicode, codesets or locales whose codesets cannot be converted to Unicode directly are not supported.

To use the filter with a printer, the printer has to support PostScript Level 2 or higher. Some features are supported only on printers
that support PostScript Level 3.

The filter also supports embedding font data to PostScript files generated by the Mozilla web browser. For example, by making the Mozilla
web browser print to an LP destination that uses the print filter, web pages containing non-Latin 1 characters can be printed correctly on
a PostScript printer.

The filter supports the parsing of Adobe PostScript printer description file (PPD) to retrieve information on using diverse features of
various PostScript printers. Without specifying a PPD file, many of the advanced printing features, like duplex printing, will not be
available for use.

Options
The filter recognizes the following options:
Print control characters and suppress page break.

Specify additional configuration file to override entries from the default
configuration files.

Set the specified
option key as the default value for the given PPD main keyword.

Specify the request id to be printed on the banner page.

Set the specified
option key as the value of the given PPD installable option keyword.

Specify a set of comma-separated aliases for the given PPD main
keyword.

Specify a log file to log error and informational message.
By default, the log file is

Specify a set of comma-separated aliases for the given
locale name, such as, for ja_JP.eucJP.

Print the specified
number of copies.

Disable the given non-PPD
keyword from the configuration file.

Specify options related to page orientation, formatting and other
PPD file enabled device control operations. The option-lists value can include one option or multiple options separated by
spaces. See the section in this manpage.

Specify a set of comma-separated aliases for the given PPD
option key of the given keyword, if specified. If a keyword is not specified, the aliases will apply to all available
options of that name.

Make PPD processing and keyword matching case sensitive.
By default, PPD processing and keyword matching is case insensitive.

Specify the PostScript printer description (PPD) file to be used. By
default, looks for the PPD file in the directory unless a full path is specified.

Specify the name of the current interface script to be printed in the
banner page.

Define the macro name
macro as shorthand for specifying the set of comma-separated list of options in option-lists. The macro name can be of the
form where the character indicates an arbitrary string that can be used at the right side of the in the option-lists. The
option desc description string provides an informational message of what the macro name does. White spaces in the descrip-
tion string should be replaced by or to avoid problem with command line parsing.

Print the specified
title in the banner page.

Specify the
paper size used in each input tray. This mapping enables the print filter to select a tray with the proper paper size auto-
matically when only the paper size is specified. The print filter will also know the paper size to use if only an input tray
is specified. This default mapping can be overridden by specifying both the paper size and input tray.

Print the specified
user name in the banner page.

Enable the printing of warning and information messages to the log file
in additional to error messages. By default, only error messages will be printed to the log file. One option enables warn-
ing messages to be printed to the log file. Two options enable both warning messages and informational messages to be
printed to the log file.

User Specified -o Option Lists
An end user can pass options to the filter via the option of the command. For passing more than one option, enclose those user options
within quotation marks. Some of the supported options are for text file printing only (mostly formatting options) and such options do not
have effect on PostScript file printing. Other options apply to both text and PostScript file printing.

The list of supported options are:
Enable the printing of the banner page.

Specify that Unicode bidirectional algorithm should be explicitly turned
or irrespective of the current setting (text printing only). Another possible value is which forces right-to-left rendering
of all input lines even if they do not contain any right-to-left character.

Specify the bottom margin of the page for text printing.
The unit can be for inch (default), for point, or

Select the input paper tray to be used for printing the banner page.
The input-tray name is dependent on what is specified in the PPD file. By default, the banner tray is the same as the input
tray for printing the content of the file.

Specify the number of characters per inch in width for text printing.

Print only the even pages (text printing only) and
override a previous option.

Specify that the font or fonts associated with the given
fontname name should be selected for printing, if available. The fontname can be an actual printer font name, an XLFD name
for bitmap font, path to an external TrueType or PCF bitmap font, or a predefined typeface name specified in the configura-
tion files.

Specify the data format of the input file.
Valid values are or (for a text file) or or (for a PostScript file). By default, the print filter will detect automatically
the input file format if this option is not specified.

Specify the horizontal motion index of a character for text printing.
The unit of the index is 1/120 inch. The value can be wider or narrower than the value indicated by the parameter. In that
case, the character will be printed further apart or closer together than the default case. Its default value is the same as
the value in 1/120 inch unit.

Specify the amount of indentation in columns for text printing.
The default value is 0 (no indentation).

Print underlined characters with italic fonts, if available (for text printing).
If no italic font is available, the characters will remained underlined.

Select the input tray that supplies paper for the print job.

Specify that the printer requires the use of HP's Job Control Language.
This option is ony needed when using the generic model script with no PPD file specified.

Print in landscape mode.

Current PostScript level to be used (default is the PostScript level
specified in the PPD file).

Specify the number of lines per page (text printing only).

specify the left margin of the page for text printing.

Specify the locale for processing input file.

Specify the number of lines per inch for text printing.

Specify the amount of spacing between adjacent lines (default to 1).
The line-spacing value can be a fractional number like 1.5.

Specify the Unicode normalization form to be used for processing Unicode input
text file. The valid values are or

Do not print a banner page.
The printing of banner page is on by default unless a null "banner utility" entry is specified in a configuration file.

Specify that width-to-height aspect ratio of the printed characters is allowed
to change according to the specified and related options. By default, the aspect ration will be kept the same and extra pad-
ding spaces will be added between characters or lines, if necessary.

Specify that escape sequences associated with HP's Job Control Language
should not be sent out even if they are defined in the PPD file.

Specify that non Latin-1 printer resident fonts should not be used for
printing. This option may be useful if the printer resident fonts cover less characters than that are supported by the oper-
ating system fonts and there is a need to print those extra characters with consistent fonts.

Specify that padding spaces should be added around narrow TrueType glyph
that should be displayed as a wide character (default).

Select the output bin where the printed pages will be deposited.
The output-bin name is printer dependent on what is specified in the PPD file, if supplied.

Print only the odd pages (for text printing only).

Select the given PPD
option key as the value of the PPD main keyword.

Specify the range of pages to be printed, starting with page number
m and ending with page number n inclusively (text printing only). The dash (-) character can also be used as the page range
separator. If the initial page number m is not specified, it defaults to the first page. A missing final page number, n,
indicates the last page of the document. A single page number without the page range separator indicates the printing of that
page only.

Specify the paper size.
Valid values are: (the default if no PPD file is specified), and Not all paper sizes are supported by a printer. The printer
can also support paper sizes not listed above. Invalid paper size setting may cause the output to be truncated. If a PPD
file is specified, invalid values will be ignored.

Specify the page margin of the page for text printing; in other words,
and will be set to the same given value.

Print page number in the lower left corner of the page (text printing only).

Print in portrait mode.

Print control characters and suppress page break.
This is the same as the option.

Specify that non-BMP characters in Mozilla PostScript file will be mapped to
private use characters in the BMP so that the characters can be printable. This option may interfere with fonts that have
characters in the private use character range of BMP. Also, if the PostScript file has a lot of non-BMP characters, the BMP
private use area may not be large enough to print them all. This feature is by default.

Cause the use of local Roman character set (JIS Roman for Japanese and
ISO646-KR for Korean) when printing ASCII characters in a Japanese or Korean locale except the UTF-8 ones (text printing
only).

Specify the right margin of the page for text printing.

Specify the use of option lists associated with the given
macro name. The prefix is not really needed.

Print the job in a way specified by the
sides variable. You can specify sides as follows:

Print only on one side of the sheet (default).

Print on both sides of the sheet; the second side is reached by flipping
the sheet about its left edge, as in the binding of a book.

Print on both sides of the sheet, but print the opposite way up on each
side, so that the second side can be read by flipping the sheet along its top axis.

This option is supported only if duplexing support is available in the PPD file.

Specify the top margin of the page for text printing.

Specify the user-defined character raster font as specified in the
udc(4) manpage should be used. The print filter will look for UDC file in the directory if an absolute path is not speci-
fied.

Specify the UDC mapping file to be used for mapping user defined characters to
code points in TrueType fonts.

Specify the list of Unicode ranges (separated by commas without space)
that should be regarded as full width character (width 2) irrespective of the value returned by the function when printing
Unicode characters.

Specify the vertical motion index value which determines the height of a row.
The unit of the index is 1/48 inch. This is equivalent to 48/line-per-inch.

Specify vertical printing mode for Chinese, Japanese, and Korean multibyte
characters. When this option is included, multibyte characters are printed vertically in a rotated orientation; however, any
single byte characters in the text are still printed horizontally (text printing only). If the TrueType fonts used support
vertical variants of some of full width characters, those characters will be used in vertical printing mode.

Specify that narrow TrueType glyphs should be widened (doubled in width) when
they are displayed as a wide character (opposite of

Specify the width of page in columns for text printing.

Wrap or do not wrap long lines when printing a text file (default is

If the given
keyword does not match any of the predefined keyword-option pairs above, it is treated as the selection of the given PPD
option key as the value of the PPD main keyword (equivalent to

option If the option name does not match any of the predefined option names above, it is treated as follows (in descending order):

1. A setup macro name
2. A locale name or locale alias
3. A page size name, for example
4. An input tray name
5. A codeset or Unicode transformation format name
6. A font or typeface name

If it matches none of the above, the option will be ignored.

Additional PPD dependent keyword/option pairs and predefined setup macros and aliases may be available for use. Please run the configured
model script directly without any option to see what additional options are available. Bad or unrecognized options will be listed in the
banner page to alert users of possible typographical errors.

Options Interdependency
Many of the supported options are inter-dependent. In other words, specifying one option will affect the setting of the others. For exam-
ple, the following option values are inter-related by the formulas:

bottom-margin)
right-margin)

A latter option may invalidate a former related option. For example, a letter size page (11in x 8.5in) with a page margin of 0.5in and a
lines-per-inch of 6 will print 60 lines per page. Specifying 66 as the number of lines per page (lines) will then force the lines-per-inch
to 6.6.

The following four groups of character spacing options are inter-related in descending priority order:

1.
2.
3.
4.

When conflicting and options are specified, there are two possibilities:

1. If the option specifies character spacing wider than the option, extra space is padded between characters to satisfy both
options.

2. If the option specifies character spacing narrower than the option, the print filter will try to accommodate or adjust if the
difference is only minor. In this situation, the individual characters will be printed closer together (more packed) than their
natural character-to-character separation. Otherwise, the option overrides the option and the character width will be reduced
accordingly.

Similar results occur for conflicting and options.

Configuration Files
The configuration file is mainly used to specify the name and the locations of the fonts to be used as well as other miscellaneous configu-
ration parameters. This configuration file is a plain text file with a number of key-option-value triplets of the form:

The part is optional.

The character indicates that the rest of the line is a comment. The character at the end of a line acts as a line continuation
character.

The print filter reads in configuration files from the directory. The following configuration files will be read in the order specified:

2. A user configuration file specified in the command line, if specified. The configuration will be assumed to be relative to the
directory unless a full path is given.

3. if available, where locale is the locale the print filter is running in. Assuming a locale name of the form the print filter
will look for the first matching file of the following names:

a.
b.
c.

An entry in the user configuration file will override the same entry in the system common configuration file. Even though the locale spe-
cific system configuration file is read last, the entries in the user configuration file have a higher priority and so will not be overrid-
den by the same entry in the locale specific file. Only font specific entries are valid in the locale specific configuration file, the
other entries will be ignored.

The supported key-option-value triplets are as follows:

Specify the location of a utility command to generate the banner page
instead of the default one created by The same and banner related options will be passed to the banner utility. If no util-
ity is specified or the specified utility is not accessible, banner page printing will be disabled by default unless explic-
itly enabled in the command line.

Specify the state of the Unicode bidirectional algorithm for text printing.
The only valid values are or (default). In mode, bidirectional algorithm will be turned on only for Unicode text. In mode,
right-to-left rendering will be enforced even for input lines that do not contain any right-to-left character.

Specify a list of comma-separated alias names for the given
codeset. The configuration entry is mainly used to map Mozilla codeset names to native HP-UX codeset names.

Specify the galley character used in the Unicode to
converter.

Include another configuration file specified by the pathname
config-path. The pathname will be relative to unless an absolute path is specified. Only a single level of file inclusion
is supported.

Specify a list of comma-separated language names (example,
which can be handle in the same way as the primary language name (lang) from a font selection perspective.

Specify a list of comma-separated codeset names that should be associated with
the given language name from a font selection perspective.

Specify whether the default Latin 1 printer font should be used (font type =
1), or the combination font with both Latin 1 and double width characters (font type = 12) should be used for printing those
Latin 1 characters.

Specify a list of comma-separated alias names for the given
locale.

Assign the pathname
path to the variable var. This variable can only be used in the entries. At most one variable can be used in each font
path name. The definition is local to each configuration file and cannot be reused in a different one.

Specify a list of comma-separated aliases for the given PPD
keyword. This configuration entry is only valid if the current PPD file has a keyword of that name.

Specify a list of comma-separated aliases for the given PPD
option of the specified keyword, if specified. If a keyword is not specified, all the available options of the given name
will take the aliases. This configuration entry is valid only if the current PPD file has an option of that name.

Specify a description string
desc about the keyword to be defined.

Specify the PostScript code to be sent to the printer if the specified
option is selected for the given keyword. Like the PPD file, the ps-invocation code has to be doubled-quoted. New lines
are specified by the escape sequence and by An optional description string desc about the specified option can be added to
describe what this option is doing.

Specify the printer internal fonts to be used for the given language
lang (example, and display width. Additional attributes can also be associated with each specified font.

Associate the given typeface name to the list of printer internal fonts
specified after An optional description string can be specified which will show up in the help message.

Associate a color name with the corresponding RGB (red-green-blue) values
in the PostScript RGB color space, such as, "1 0 0" for red color.

Specify the given setup name as a macro for the corresponding option list.
The optional desc description string provides an informational message of what the setup macro does.

Specify the names of the TrueType fonts for the given language
lang and display width. Additional attributes can be associated with each specified font.

Associate the given typeface name to the list of TrueType fonts specified
after

Specify the names of the XLFD bitmap fonts for the given language
lang and display width. Additional attributes can be associated with each specified font.

Associate the given typeface name to the list of XLFD bitmap fonts specified
after

Specify the comma-separated font paths for searching the XLFD bitmap fonts.
The allowable modes are:

Set font path to the given list, overwriting previous list.

Add the new font paths at the end of the current list.

Add the new font paths to the beginning of the current list.

Specify custom Unicode conversion mappings from the given
codeset to Unicode. These mappings will override those from the conversion tables.

Specify the list of languages, which are associated with different fonts,
which should be mapped when printing Unicode characters.

Specify the display width of the Unicode characters specified in the given
Unicode ranges.

Model Script
The print filter is supported by the model script. This model script is a PostScript only model script and will not support other printing
languages like PCL5. Unlike other HP-UX model scripts, this model script can be configured to support any PostScript printer as long as a
PPD file for that printer is available. See psmsgen(1M) for information on how to use the configuration tool to configure the model
script, and on how to configure the LP spooling system to use the print filter.

EXTERNAL INFLUENCES
Environment Variables
determines the locale to use when neither or the other category variables specify a locale.

determines locale to be used. It overrides any values specified by or any other variables.

AUTHOR
The print filter was developed by HP.

FILES
Model script that uses the print filter.
Directory for holding Adobe PPD files.
Directory for holding various configuration files.

hpux man page for psfontpf