psfontpf(1M)psfontpf(1M)NAMEpsfontpf - 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 cor‐
responding 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 international
environment to printable PostScript file. The filter embeds all
required PostScript font data within the PostScript program, if neces‐
sary. 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 lan‐
guages 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 char‐
acters 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 gener‐
ated 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 key‐
word 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-sepa‐
rated list of options in option-lists. The macro name
can be of the form where the character indicates an arbi‐
trary 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 description string should be
replaced by or to avoid problem with command line pars‐
ing.
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 automatically 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 warning messages to be printed to the log file.
Two options enable both warning messages and informa‐
tional 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 com‐
mand. 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 explic‐
itly 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 avail‐
able. The fontname can be an actual printer font name,
an XLFD name for bitmap font, path to an external True‐
Type or PCF bitmap font, or a predefined typeface name
specified in the configuration files.
Specify the data format of the input file.
Valid values are or (for a text file) or or (for a Post‐
Script 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 parame‐
ter. 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 configura‐
tion file.
Specify that width-to-height aspect ratio of the printed charac‐
ters is allowed
to change according to the specified and related options.
By default, the aspect ration will be kept the same and
extra padding 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 resi‐
dent fonts cover less characters than that are supported
by the operating system fonts and there is a need to
print those extra characters with consistent fonts.
Specify that padding spaces should be added around narrow True‐
Type 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 spec‐
ified 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 print‐
ing 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 speci‐
fied), 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 Japa‐
nese 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 flip‐
ping 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 specified.
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 orienta‐
tion; 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 descend‐
ing 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 ban‐
ner 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 possibili‐
ties:
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 indi‐
vidual 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 loca‐
tions of the fonts to be used as well as other miscellaneous configura‐
tion 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:
1.
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 specific
system configuration file is read last, the entries in the user config‐
uration file have a higher priority and so will not be overridden 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 ban‐
ner related options will be passed to the banner util‐
ity. If no utility is specified or the specified util‐
ity is not accessible, banner page printing will be dis‐
abled by default unless explicitly enabled in the com‐
mand line.
Specify the state of the Unicode bidirectional algorithm for
text printing.
The only valid values are or (default). In mode, bidi‐
rectional 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 lan‐
guage 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 perspec‐
tive.
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 configura‐
tion 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 lan‐
guage
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 inter‐
nal 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 infor‐
mational 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 lan‐
guage
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 differ‐
ent 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 informa‐
tion 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 vari‐
ables 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.
SEE ALSOlp(1), psmsgen(1M).
psfontpf(1M)