1PAGESIZES(5F) PAGESIZES(5F)
2
6 pagesizes - HylaFAX page size definitions
7
9 The pagesizes database defines the page dimensions and guaranteed
10 reproducible areas (GRA) for well-known page sizes. The GRA is the
11 portion of the page that is guaranteed to be imaged during facsimile
12 transmission. This region is typically less than the full page dimen‐
13 sions because of paper roller contacts and other mechanical aspects of
14 the printing process in a facsimile machine.
15 All HylaFAX programs that require page size information read the infor‐
17 mation from this database using a page size name. Documents should be
18 prepared such that the full page dimensions are employed with the
19 imaged area contained within the GRA.
20 The system-wide default page size to use in preparing documents for
22 transmission is given by the ``default'' entry in the database. (NB:
23 the default entry should be placed last so that inverse matches find
24 the real page size name and not the default entry.)
25 The page size database is an ASCII file with the following format.
27 Each entry consists of whitespace-separated fields:
28 name abbrev width height gra-width gra-height top-margin left-margin
29 Fields have the following interpretation:
30 name the full name for the page size; e.g. ISO A4;
32 abbrev an abbreviated version of the full name for use in compact
34 listings such as the receive queue listing printed by faxs‐
35 tat(1);
36 width the full width of the page;
38 height the full height of the page;
40 gra-width the width of the GRA;
42 gra-height the height of the GRA;
44 top-margin the margin between the top of the full page and the top of
46 the GRA;
47 left-margin the margin between the left side of the full page the left
49 side of the GRA.
50 The first two fields must be separated from the subsequent fields by a
52 tab character (possibly followed by more whitespace); this is done to
53 easily permit blank characters to be included in names. Otherwise
54 fields can be separated by any amount of any kind of whitespace. Num‐
55 bers are all base 10 and in basic measurement units (BMU); defined as
56 1/1200 x 25.4 millimeters for paper output with a scale factor of one.
57 All fields must be present on a single line; otherwise the entry is
58 ignored. Comments are introduced by the ``#'' character and continue
59 to the end the line.
60 Page size database lookups are either by name or by page dimensions.
62 Lookups by name are done by sequentially scanning the entries in the
63 database for the first entry that has a matching abbreviation or sub‐
64 string of the page size name field. The string comparisons ignore case
65 so, for example, ``a4'' would match a full name of ``ISO A4''. Lookups
66 by dimension scan the entire database and return the page with the
67 closest dimensions using a straightforward distance metric. If the
68 difference in dimensions of the closest match is greater than 1/2 inch
69 on each side, then no page entry is returned for a lookup by dimension.
70
72 hylafax-client(1), faxmail(1), faxstat(1), sendfax(1), sgi2fax(1),
73 textfmt(1).
74 December 5, 1994 PAGESIZES(5F)