[wxWidgets.git] / src / tiff / man / fax2ps.1

.\"	$Id: fax2ps.1,v 1.4 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1991-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and 
.\" its documentation for any purpose is hereby granted without fee, provided
.\" that (i) the above copyright notices and this permission notice appear in
.\" all copies of the software and related documentation, and (ii) the names of
.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
.\" publicity relating to the software without the specific, prior written
.\" permission of Sam Leffler and Silicon Graphics.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
.\" 
.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
.\" OF THIS SOFTWARE.
.\"
.ds Ps PostScript
.if n .po 0
.TH FAX2PS 1 "November 2, 2005" "libtiff"
.SH NAME
fax2ps \- convert a
.SM TIFF
facsimile to compressed \*(Ps\(tm
.SH SYNOPSIS
.B fax2ps
[
.I options
] [
.I file ...\&
]
.SH DESCRIPTION
.I fax2ps
reads one or more
.SM TIFF
facsimile image files and prints a compressed form of
\*(Ps on the standard output that is suitable for printing.
.PP
By default, each page is scaled to reflect the
image dimensions and resolutions stored in the file.
The
.B \-x
and
.B \-y
options can be used to specify the horizontal and vertical
image resolutions (lines/inch), respectively.
If the
.B \-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
.B \-W
and
.B \-H
options.
.PP
By default
.I fax2ps
generates \*(Ps for all pages in the file.
The
.B \-p
option can be used to select one or more pages from
a multi-page document.
.PP
.I fax2ps
generates a compressed form of \*(Ps that is
optimized for sending pages of text to a \*(Ps
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 \*(Ps 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 \*(Ps description, relative to the straightforward
imaging of the page with a \*(Ps
.I 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
.BR tiff2ps (1).
.SH OPTIONS
.TP 10
.BI \-p " number"
Print only the indicated page.
Multiple pages may be printed by specifying
this option more than once.
.TP 10
.BI \-x " resolution"
Use
.I resolution
as the horizontal resolution, in dots/inch, of the image data.
By default this value is taken from the file.
.TP 10
.BI \-y " resolution"
Use
.I resolution
as the vertical resolution, in lines/inch, of the image data.
By default this value is taken from the file.
.TP 10
.B \-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 
.SM TIFF
file.
.TP 10
.BI \-W " width"
Use
.I width
as the width, in inches, of the output page.
.TP 10
.BI \-H " height"
Use
.I height
as the height, in inches, of the output page.
.SH DIAGNOSTICS
Some messages about malformed 
.SM TIFF
images come from the
.SM TIFF
library.
.PP
Various messages about badly formatted facsimile images
may be generated due to transmission errors in received
facsimile.
.I 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
\*(Ps image.
.SH NOTES
If the destination printer supports \*(Ps Level II then
it is always faster to just send the encoded bitmap generated
by the
.BR tiff2ps (1)
program.
.SH BUGS
.I fax2ps
should probably figure out when it is doing a poor
job of compressing the output and just generate 
\*(Ps to image the bitmap raster instead.
.SH "SEE ALSO"
.BR tiff2ps (1),
.BR libtiff (3)
.PP
Libtiff library home page:
.BR http://www.remotesensing.org/libtiff/
Commit	Line	Data
80ed523f	1	.\" $Id: fax2ps.1,v 1.4 2006-04-20 12:17:19 dron Exp $
8414a40c VZ	2	.\"
	3	.\" Copyright (c) 1991-1997 Sam Leffler
	4	.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
	5	.\"
	6	.\" Permission to use, copy, modify, distribute, and sell this software and
	7	.\" its documentation for any purpose is hereby granted without fee, provided
	8	.\" that (i) the above copyright notices and this permission notice appear in
	9	.\" all copies of the software and related documentation, and (ii) the names of
	10	.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
	11	.\" publicity relating to the software without the specific, prior written
	12	.\" permission of Sam Leffler and Silicon Graphics.
	13	.\"
	14	.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
	15	.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
	16	.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
	17	.\"
	18	.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
	19	.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
	20	.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
	21	.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
	22	.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
	23	.\" OF THIS SOFTWARE.
	24	.\"
80ed523f	25	.ds Ps PostScript
8414a40c VZ	26	.if n .po 0
	27	.TH FAX2PS 1 "November 2, 2005" "libtiff"
	28	.SH NAME
	29	fax2ps \- convert a
	30	.SM TIFF
	31	facsimile to compressed \*(Ps\(tm
	32	.SH SYNOPSIS
	33	.B fax2ps
	34	[
	35	.I options
	36	] [
80ed523f	37	.I file ...\&
8414a40c VZ	38	]
	39	.SH DESCRIPTION
	40	.I fax2ps
	41	reads one or more
	42	.SM TIFF
	43	facsimile image files and prints a compressed form of
	44	\*(Ps on the standard output that is suitable for printing.
	45	.PP
	46	By default, each page is scaled to reflect the
	47	image dimensions and resolutions stored in the file.
	48	The
	49	.B \-x
	50	and
	51	.B \-y
	52	options can be used to specify the horizontal and vertical
	53	image resolutions (lines/inch), respectively.
	54	If the
	55	.B \-S
	56	option is specified, each page is scaled to fill an output page.
	57	The default output page is 8.5 by 11 inches.
	58	Alternate page dimensions can be specified in inches with the
	59	.B \-W
	60	and
	61	.B \-H
	62	options.
	63	.PP
	64	By default
	65	.I fax2ps
	66	generates \*(Ps for all pages in the file.
	67	The
	68	.B \-p
	69	option can be used to select one or more pages from
	70	a multi-page document.
	71	.PP
	72	.I fax2ps
	73	generates a compressed form of \*(Ps that is
	74	optimized for sending pages of text to a \*(Ps
	75	printer attached to a host through a low-speed link (such
	76	as a serial line).
	77	Each output page is filled with white and then only
	78	the black areas are drawn.
	79	The \*(Ps specification of the black drawing operations
	80	is optimized by using a special font that encodes the
	81	move-draw operations required to fill
	82	the black regions on the page.
	83	This compression scheme typically results in a substantially
	84	reduced \*(Ps description, relative to the straightforward
	85	imaging of the page with a \*(Ps
	86	.I image
	87	operator.
	88	This algorithm can, however, be ineffective
	89	for continuous-tone and white-on-black images.
	90	For these images, it sometimes is more efficient to send
	91	the raster bitmap image directly; see
80ed523f	92	.BR tiff2ps (1).
8414a40c VZ	93	.SH OPTIONS
	94	.TP 10
	95	.BI \-p " number"
	96	Print only the indicated page.
	97	Multiple pages may be printed by specifying
	98	this option more than once.
	99	.TP 10
	100	.BI \-x " resolution"
	101	Use
	102	.I resolution
	103	as the horizontal resolution, in dots/inch, of the image data.
	104	By default this value is taken from the file.
	105	.TP 10
	106	.BI \-y " resolution"
	107	Use
	108	.I resolution
	109	as the vertical resolution, in lines/inch, of the image data.
	110	By default this value is taken from the file.
	111	.TP 10
	112	.B \-S
	113	Scale each page of image data to fill the output page dimensions.
	114	By default images are presented according to the dimension
	115	information recorded in the
	116	.SM TIFF
	117	file.
	118	.TP 10
	119	.BI \-W " width"
	120	Use
	121	.I width
	122	as the width, in inches, of the output page.
	123	.TP 10
	124	.BI \-H " height"
	125	Use
	126	.I height
	127	as the height, in inches, of the output page.
	128	.SH DIAGNOSTICS
	129	Some messages about malformed
	130	.SM TIFF
	131	images come from the
	132	.SM TIFF
	133	library.
	134	.PP
	135	Various messages about badly formatted facsimile images
	136	may be generated due to transmission errors in received
	137	facsimile.
	138	.I fax2ps
	139	attempts to recover from such data errors by resynchronizing
	140	decoding at the end of the current scanline.
	141	This can result in long horizontal black lines in the resultant
	142	\*(Ps image.
	143	.SH NOTES
	144	If the destination printer supports \*(Ps Level II then
	145	it is always faster to just send the encoded bitmap generated
	146	by the
	147	.BR tiff2ps (1)
	148	program.
	149	.SH BUGS
	150	.I fax2ps
	151	should probably figure out when it is doing a poor
	152	job of compressing the output and just generate
	153	\*(Ps to image the bitmap raster instead.
	154	.SH "SEE ALSO"
	155	.BR tiff2ps (1),
	156	.BR libtiff (3)
157	.PP
158	Libtiff library home page:
159	.BR http://www.remotesensing.org/libtiff/