PAGESIZES(5) File Formats Manual PAGESIZES(5)NAME
pagesizes - HylaFAX page size definitions
DESCRIPTION
The pagesizes database defines the page dimensions and guaranteed reproducible areas (GRA) for well-known page sizes. The GRA is the por-
tion of the page that is guaranteed to be imaged during facsimile transmission. This region is typically less than the full page dimen-
sions because of paper roller contacts and other mechanical aspects of the printing process in a facsimile machine.
All HylaFAX programs that require page size information read the information from this database using a page size name. Documents should
be prepared such that the full page dimensions are employed with the imaged area contained within the GRA.
The system-wide default page size to use in preparing documents for transmission is given by the ``default'' entry in the database. (NB:
the default entry should be placed last so that inverse matches find the real page size name and not the default entry.)
The page size database is an ASCII file with the following format. Each entry consists of whitespace-separated fields:
name abbrev width height gra-width gra-height top-margin left-margin
Fields have the following interpretation:
name the full name for the page size; e.g. ISO A4;
abbrev an abbreviated version of the full name for use in compact listings such as the receive queue listing printed by faxstat(1);
width the full width of the page;
height the full height of the page;
gra-width the width of the GRA;
gra-height the height of the GRA;
top-margin the margin between the top of the full page and the top of the GRA;
left-margin the margin between the left side of the full page the left side of the GRA.
The first two fields must be separated from the subsequent fields by a tab character (possibly followed by more whitespace); this is done
to easily permit blank characters to be included in names. Otherwise fields can be separated by any amount of any kind of whitespace.
Numbers are all base 10 and in basic measurement units (BMU); defined as 1/1200 x 25.4 millimeters for paper output with a scale factor of
one. All fields must be present on a single line; otherwise the entry is ignored. Comments are introduced by the ``#'' character and con-
tinue to the end the line.
Page size database lookups are either by name or by page dimensions. Lookups by name are done by sequentially scanning the entries in the
database for the first entry that has a matching abbreviation or substring of the page size name field. The string comparisons ignore case
so, for example, ``a4'' would match a full name of ``ISO A4''. Lookups by dimension scan the entire database and return the page with the
closest dimensions using a straightforward distance metric. If the difference in dimensions of the closest match is greater than 1/2 inch
on each side, then no page entry is returned for a lookup by dimension.
SEE ALSO hylafax-client(1), faxmail(1), faxstat(1), sendfax(1), sgi2fax(1), textfmt(1).
December 5, 1994 PAGESIZES(5)
Check Out this Related Man Page
TEXTFMT(1) General Commands Manual TEXTFMT(1)NAME
textfmt - convert text to POSTSCRIPT(R) for facsimile transmission
SYNOPSIS
/usr/sbin/textfmt [ options ] [ files... ]
DESCRIPTION
textfmt takes ASCII text and generates formatted POSTSCRIPT(R) suitable for facsimile transmission. It is usually invoked as a filter pro-
gram by the sendfax(1) program. Input files may be specified on the command line. If none are given, then textfmt will read from standard
input.
By default, textfmt will generate an output document that is formatted with a single vertical column of text, set in a 10 point fixed width
font, and with a simple page header that consists of the file name, last modification date, and the page number. Pages are generated
according to the default page dimensions (see pagesizes(5)). When multi-column output is requested, text is set by default with a 7 point
fixed width font.
OPTIONS
Many of the options to textfmt have been chosen for compatibility with the Adobe Systems' enscript program; other options are for features
that are not provided by enscript.
-1 Set text in one column.
-2 Set text two columns.
-B Suppress page headers.
-c Clip long text lines instead of wrapping them at page margins.
-D Do not use ISO 8859-1 encoding in the generated POSTSCRIPT.
-f font
Set text using the POSTSCRIPT font named font.
-F fontdir(s)
Path(s) to afm font files.
-G Use a gaudy-style page header.
-m cols
Set text in cols columns.
-Ml=#,r=#,t=#,b=#
Set the page margins; the default margins are: left and right .25 inch, top .85 inch, bottom .5 inch.
-o Draw an outline around each column of text; the specified number defines the width of the line that is drawn.
-p pts Set text using fonts with pts point size (integer only).
-r Set pages rotated by 90 degrees (in ``Landscape mode'').
-R Set pages unrotated (in ``Portrait mode'').
-s size
Set the output size according to the named page size. Images are normally created with a system-default page size (usually letter-
size pages, 8.5" by 11", for sites in North America). Alternate page sizes are specified symbolically using either the name or
abbreviation of an entry in the pagesizes(5) database; e.g. a3 (ISO A3), a4 (ISO A4), a5 (ISO A5), a6 (ISO A6), b4 (ISO B4), na-let
(North American Letter), us-leg (American Legal), us-led (American Ledger), us-exe (American Executive), jp-let (Japanese Letter),
and jp-leg (Japanese Legal). Comparisons are case-insensitive and any match of a substring of the full page-size name is suffi-
cient; e.g. ``legal'' would match ``American Legal''.
-U Reverse collate pages; that is the last page will appear first in the resultant POSTSCRIPT, then the next-to-last page, etc.
-V spacing
Set the line height; the default height is 1.2 x point size.
CONFIGURATION PARAMETERS
textfmt reads configuration information from the files /etc/hylafax/hyla.conf, and ~/.hylarc; in that order. Configuration files follow
the conventions described in hylafax-client(1). The following configuration parameters are recognized:
Tag Type Default Description
Columns integer 1 number of columns in formatted output
GaudyHeaders boolean No enable/disable guady page headers
FontMap string see below location of ghostscript Fontmap file
FontPath string see below directory for font metric files
ISO8859 boolean Yes use ISO 8859-1 character encoding
LineWrap boolean Yes wrap/truncate text lines
Orientation string portrait orientation of text on page
OutlineMargin inches 0 width of outline line
PageCollation string forward collate pages in forward or reverse direction
PageHeaders boolean Yes enable/disable page headers
PageHeight float - output page height
PageMargins string see below margins for formatted page
PageSize string default output page size from database
PageWidth float - output page width
TabStop integer 8 inter-stop setting in characters
TextFont string Courier name of font for setting text
TextLineHeight inches - text formatting line height control
TextPointSize inches see below size to use in setting text
The configuration parameters are explained below. Most parameters correspond to a command line option. Parameter values identified above
as inches are converted according to the following conventions (where ``#.##'' is a decimal number):
#.##bp big point (1in = 72bp)
#.##cc cicero (1cc = 12dd)
#.##cm centimeter
#.##dd didot point (1157dd = 1238pt)
#.##in inch
#.##mm millimeter (10mm = 1cm)
#.##pc pica (1pc = 12pt)
#.##pt point (72.27pt = 1in)
#.##sp scaled point (65536sp = 1pt)
Unit names can be upper or lower case but no white space is permitted between the number and the unit. Values specified with no unit are
interpreted as big points.
Columns The number of columns to set text in. (Equivalent to the -m option.)
FontMap The directory or directories where the ghostscript Fontmap file(s) are located; multiple paths are separated by a colon
(":"). The Fontmap table allows the translation of the descriptive name of the font (as used by the TextFont parameter) to
the ghostscript font filenames. Setting the value to "" (zero length string) disables this translation and provides func-
tionality with RIPs other than ghostscript.
FontPath The path where Adobe Font Metric (AFM) files are located; by default /usr/share/fonts/type1/gsfonts. (Equivalent to the -F
option.)
GaudyHeaders Control whether or not to use a gaudy-style page header. (Equivalent to the -G option.)
ISO8859 Control the use of ISO 8859-1 encoding in the generated POSTSCRIPT (Equivalent to the -D option.)
LineWrap Control whether long text lines are wrapper or truncated at the right hand margin. (Equivalent to the -c option.)
Orientation Control whether pages are oriented horizontally (``landscape'') or vertically (``portrait''). (Equivalent to the -r and -R
options.)
OutlineMargin Control whether columns of text have a line drawn around them and the width of the line. Setting this parameter to 0 dis-
ables outlines. (Equivalent to the -o option.)
PageCollation Control whether the output file has pages collated in the same order as the input file (``forward'') or in reverse order
(``reverse). (Equivalent to the -U option.)
PageHeaders Control whether page headers are generated. (Equivalent to the -B option.)
PageHeight Set the output page height in inches (in inches).
PageMargins Set the output page dimensions. Dimensions are specified as string of the form: ``l=#,r=#,t=#,b=#'' where l indicates the
left margin, r indicates the right margin, t indicates the top margin, b indicates the bottom margin, and numbers are inter-
preted as inches. (Equivalent to the -M option.)
PageSize Set the output page dimensions by name. (Equivalent to the -s option.)
PageWidth Set the output page width in inches (in inches).
TabStop Set the tab stop distance; in characters.
TextFont Set the descriptive name of font to use for setting text. (Equivalent to the -f option.)
TextLineHeight Set the vertical text line height and spacing. (Equivalent to the -V option.)
TextPointSize Set the point size to use in setting text. (Equivalent to the -p option.)
NOTES
If textfmt is unable to locate font metric information for a font, then it will use a fixed-width metric that is 60% of the text point
size; this metric will almost certainly result in incorrectly formatted POSTSCRIPT.
textfmt is distantly related to the lptops program written by Don Beebe.
FILES
/etc/hylafax/hyla.conf system-wide configuration file
~/.hylarc per-user configuration file
/etc/hylafax/pagesizes page size database
/usr/share/fonts/type1/gsfonts font metric files
SEE ALSO hylafax-client(1), sendfax(1), pagesizes(5)
May 17, 1996 TEXTFMT(1)