fax2ps(1)

1FAX2PS(1)                   General Commands Manual                  FAX2PS(1)
2
3
4

NAME

6       fax2ps - convert a TIFF facsimile to compressed ™
7

SYNOPSIS

9       fax2ps [ options ] [ file...  ]
10

DESCRIPTION

12       fax2ps  reads  one or more TIFF facsimile image files and prints a com‐
13       pressed form of
14        on the standard output that is suitable for printing.
15
16       By default, each page is scaled to reflect  the  image  dimensions  and
17       resolutions  stored  in the file.  The -x and -y options can be used to
18       specify the horizontal and  vertical  image  resolutions  (lines/inch),
19       respectively.   If  the  -S option is specified, each page is scaled to
20       fill an output page.  The default output page  is  8.5  by  11  inches.
21       Alternate page dimensions can be specified in inches with the -W and -H
22       options.
23
24       By default fax2ps generates  for all pages in the file.  The -p  option
25       can be used to select one or more pages from a multi-page document.
26
27       fax2ps  generates  a  compressed form of  that is optimized for sending
28       pages of text to a printer attached to a host through a low-speed  link
29       (such  as  a  serial  line).  Each output page is filled with white and
30       then only the black areas are drawn.  The  specification of  the  black
31       drawing  operations  is  optimized by using a special font that encodes
32       the move-draw operations required to fill  the  black  regions  on  the
33       page.   This  compression  scheme  typically results in a substantially
34       reduced  description, relative to the straightforward  imaging  of  the
35       page  with  a image operator.  This algorithm can, however, be ineffec‐
36       tive for continuous-tone and white-on-black images.  For these  images,
37       it  sometimes  is  more  efficient  to  send  the  raster  bitmap image
38       directly; see tiff2ps(1).
39

OPTIONS

41       -p number Print only the indicated page.  Multiple pages may be printed
42                 by specifying this option more than once.
43
44       -x resolution
45                 Use resolution as the horizontal resolution, in dots/inch, of
46                 the image data.  By default this  value  is  taken  from  the
47                 file.
48
49       -y resolution
50                 Use  resolution as the vertical resolution, in lines/inch, of
51                 the image data.  By default this  value  is  taken  from  the
52                 file.
53
54       -S        Scale  each page of image data to fill the output page dimen‐
55                 sions.  By default images  are  presented  according  to  the
56                 dimension information recorded in the TIFF file.
57
58       -W width  Use width as the width, in inches, of the output page.
59
60       -H height Use height as the height, in inches, of the output page.
61

DIAGNOSTICS

63       Some messages about malformed TIFF images come from the TIFF library.
64
65       Various  messages  about badly formatted facsimile images may be gener‐
66       ated due to transmission errors in received facsimile.  fax2ps attempts
67       to recover from such data errors by resynchronizing decoding at the end
68       of the current scanline.  This can  result  in  long  horizontal  black
69       lines in the resultant
70        image.
71

NOTES

73       If  the destination printer supports  Level II then it is always faster
74       to just send the encoded bitmap generated by the tiff2ps(1) program.
75

BUGS

77       fax2ps should probably figure out when it is doing a poor job  of  com‐
78       pressing the output and just generate
79        to image the bitmap raster instead.
80