Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help

       pagesizes - HylaFAX page	size definitions

       The  pagesizes  database	defines	the page dimensions and	guaranteed re-
       producible 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	infor-
       mation  from this database using	a page size name.  Documents should be
       prepared	such that the full page	dimensions are employed	with  the  im-
       aged 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 faxs-

       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.	  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 ig-
       nored.  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 sub-
       string 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.

       hylafax-client(1),   faxmail(1),	 faxstat(1),  sendfax(1),  sgi2fax(1),

			       December	5, 1994			 PAGESIZES(5F)


Want to link to this manual page? Use this URL:

home | help