diff -r 000000000000 -r 1918ee327afb src/3rdparty/libtiff/html/man/fax2ps.1.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/3rdparty/libtiff/html/man/fax2ps.1.html Mon Jan 11 14:00:40 2010 +0000 @@ -0,0 +1,254 @@ + + + +
+ + ++ |
+ fax2ps − convert a TIFF facsimile to +compressed ™ + |
+
+ |
+ fax2ps [ options ] [ file... ] + |
+
+ |
+ fax2ps reads one or more TIFF +facsimile image files and prints a compressed form of 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 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 that is +optimized for sending pages of text to a 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 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 description, relative to +the straightforward imaging of the page with a 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). + |
+
+ |
+
+ −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. + |
++ | +
+ |
+ 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 image. + |
+
+ |
+ If the destination printer supports Level II then it is +always faster to just send the encoded bitmap generated by +the tiff2ps(1) program. + |
+
+ |
+ fax2ps should probably figure out when it is doing +a poor job of compressing the output and just generate to +image the bitmap raster instead. + |
+
+ |
+ tiff2ps(1), libtiff(3) + +Libtiff library home page: +http://www.remotesensing.org/libtiff/ + |
+