1PAGESIZES(5F)                                                    PAGESIZES(5F)


6       pagesizes - HylaFAX page size definitions


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.
16       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.
21       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.)
26       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:
31       name        the full name for the page size; e.g. ISO A4;
33       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);
37       width       the full width of the page;
39       height      the full height of the page;
41       gra-width   the width of the GRA;
43       gra-height  the height of the GRA;
45       top-margin  the  margin between the top of the full page and the top of
46                   the GRA;
48       left-margin the margin between the left side of the full page the  left
49                   side of the GRA.
51       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.
61       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.


72       hylafax-client(1),   faxmail(1),  faxstat(1),  sendfax(1),  sgi2fax(1),
73       textfmt(1).
77                               December 5, 1994                  PAGESIZES(5F)