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 portion of the  page  that  is  guaranteed  to  be  imaged  during  facsimile
       transmission.   This  region  is  typically  less  than  the full page dimensions 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 continue 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)