PAGESIZES(5F)

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 guaran-
       teed 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  con-
       tained within the GRA.

       The system-wide default page size to use in preparing doc-
       uments 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 charac-
       ters to be included in names.   Otherwise  fields  can  be

       separated  by  any amount of any kind of whitespace.  Num-
       bers 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  straightfor-
       ward  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(1) faxmail(1) faxstat(1) sendfax(1) 
       sgi2fax(1) textfmt(1).