page(1) [plan9 man page]

PAGE(1) 						      General Commands Manual							   PAGE(1)

NAME

       page - view FAX, bitmap, and PostScript files

SYNOPSIS

       page file ...

DESCRIPTION

       Page  reads  each  file,  either  a  CCITT  Group 3 encoded file (such as a FAX page), Plan 9 bitmap file (see bitmap(6)), or PostScript in
       sequence and displays it in its window.	Pressing and holding button 1 permits panning about the page.  Typing a q or control-D	exits  the
       program.   Typing  any other character or clicking button 2 advances to the next file.  Button 3 has a menu of the files to be selected for
       viewing in any order.

       When possible, page overlaps the read of the next page with the display of the current one.

       Page calls gs(1) to convert PostScript files to Group 3 encoded files.  All are converted before any pages are displayed.   The	menu  then
       displays one line for each page of the documents.

FILES

       /lib/nyt/*
	      New York Times FAX files, updated daily.

SEE ALSO

       gs(1)

SOURCE

       /sys/src/cmd/page

DIAGNOSTICS

       The mouse cursor changes to an arrow and ellipsis when page is reading a file.

BUGS

       Page is written in ALEF and therefore has binaries only for MIPS, SPARC, and i386 machines.
       If any of the files are PostScript, they all must be.

																	   PAGE(1)

FAX2PS(1)						      General Commands Manual							 FAX2PS(1)

NAME

       fax2ps - convert a TIFF facsimile to compressed PostScripttm

SYNOPSIS

       fax2ps [ options ] [ file ... ]

DESCRIPTION

       fax2ps  reads one or more TIFF facsimile image files and prints a compressed form of PostScript on the standard output that is suitable for
       printing.

       By default, each page is scaled to reflect the image dimensions and resolutions stored in the file.  The -x and -y options can be  used	to
       specify	the  horizontal  and vertical image resolutions (lines/inch), respectively.  If the -S option is specified, each page is scaled to
       fill an output page.  The default output page is 8.5 by 11 inches.  Alternate page dimensions can be specified in inches with the -W and -H
       options.

       By  default fax2ps generates PostScript for all pages in the file.  The -p option can be used to select one or more pages from a multi-page
       document.

       fax2ps generates a compressed form of PostScript that is optimized for sending pages of text to a PostScript printer  attached  to  a  host
       through	a  low-speed  link  (such  as a serial line).  Each output page is filled with white and then only the black areas are drawn.  The
       PostScript specification of the black drawing operations is optimized by using  a  special  font  that  encodes	the  move-draw	operations
       required  to  fill the black regions on the page.  This compression scheme typically results in a substantially reduced PostScript descrip-
       tion, relative to the straightforward imaging of the page with a PostScript image operator.  This algorithm can,  however,  be  ineffective
       for  continuous-tone and white-on-black images.	For these images, it sometimes is more efficient to send the raster bitmap image directly;
       see tiff2ps(1).

OPTIONS

       -p number Print only the indicated page.  Multiple pages may be printed by specifying this option more than once.

       -x resolution
		 Use resolution as the horizontal resolution, in dots/inch, of the image data.	By default this value is taken from the file.

       -y resolution
		 Use resolution as the vertical resolution, in lines/inch, of the image data.  By default this value is taken from the file.

       -S	 Scale each page of image data to fill the output page dimensions.  By default images are presented  according	to  the  dimension
		 information recorded in the TIFF file.

       -W width  Use width as the width, in inches, of the output page.

       -H height Use height as the height, in inches, of the output page.

DIAGNOSTICS

       Some messages about malformed TIFF images come from the TIFF library.

       Various messages about badly formatted facsimile images may be generated due to transmission errors in received facsimile.  fax2ps attempts
       to recover from such data errors by resynchronizing decoding at the end of the current scanline.  This can result in long horizontal  black
       lines in the resultant PostScript image.

NOTES

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

BUGS

       fax2ps should probably figure out when it is doing a poor job of compressing the output and just generate PostScript to	image  the  bitmap
       raster instead.

SEE ALSO

       tiff2ps(1), libtiff(3)

       Libtiff library home page: http://www.remotesensing.org/libtiff/

libtiff 							 November 2, 2005							 FAX2PS(1)