Improvements in page formatting as per bug

http://bugzilla.remotesensing.org/show_bug.cgi?id=114
This commit is contained in:
Andrey Kiselev 2006-04-20 12:17:19 +00:00
parent 4b9b4181fb
commit 94212b3d81
18 changed files with 239 additions and 202 deletions

View File

@ -1,4 +1,4 @@
.\" $Id: bmp2tiff.1,v 1.6 2006-03-23 14:54:02 dron Exp $
.\" $Id: bmp2tiff.1,v 1.7 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 2004, Andrey Kiselev <dron@ak4719.spb.edu>
.\"
@ -32,7 +32,10 @@ file from a Microsoft Windows Device Independent Bitmap image file
[
.I options
]
.I input.bmp [input2.bmp ...]
.I input.bmp
[
.I input2.bmp ...\&
]
.I output.tiff
.SH DESCRIPTION
.I bmp2tiff
@ -45,7 +48,7 @@ output file will be created. By default, the
image is created with data samples packed (\c
.IR PlanarConfiguration =1),
compressed with the PackBits algorithm (\c
.IR Compression = 32773),
.IR Compression =32773),
and with each strip no more than 8 kilobytes.
These characteristics can overridden, or explicitly specified
with the options described below.
@ -55,17 +58,17 @@ with the options described below.
Specify a compression scheme to use when writing image data:
.B "\-c none"
for no compression,
.B "-c packbits"
.B "\-c packbits"
for the PackBits compression algorithm (the default),
.B "-c jpeg"
.B "\-c jpeg"
for the baseline JPEG compression algorithm,
.B "-c zip
.B "\-c zip"
for the Deflate compression algorithm,
and
.B "\-c lzw"
for Lempel-Ziv & Welch.
.TP
.B \-r <number>
.BI \-r " number"
Write data with a specified number of rows per strip;
by default the number of rows/strip is selected so that each strip
is approximately 8 kilobytes.

View File

@ -1,4 +1,4 @@
.\" $Id: fax2ps.1,v 1.3 2005-11-02 11:07:19 dron Exp $
.\" $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.
@ -22,6 +22,7 @@
.\" 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
@ -33,7 +34,7 @@ facsimile to compressed \*(Ps\(tm
[
.I options
] [
.IR file ...
.I file ...\&
]
.SH DESCRIPTION
.I fax2ps
@ -88,7 +89,7 @@ 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
.IR tiff2ps (1).
.BR tiff2ps (1).
.SH OPTIONS
.TP 10
.BI \-p " number"

View File

@ -1,4 +1,4 @@
.\" $Id: fax2tiff.1,v 1.6 2005-11-02 11:07:19 dron Exp $
.\" $Id: fax2tiff.1,v 1.7 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1990-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -223,7 +223,7 @@ is specified),
attempts to set the rows/strip
that no more than 8 kilobytes of data appear in a strip (with except of G3/G4
compression schemes). If you specify special value
.B -1
.B \-1
it will results in infinite number of the rows per strip. The entire image
will be the one strip in that case. This is default in case of G3/G4 output
compression schemes.

View File

@ -1,4 +1,4 @@
.\" $Id: gif2tiff.1,v 1.3 2005-11-02 11:07:19 dron Exp $
.\" $Id: gif2tiff.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.
@ -52,9 +52,9 @@ with the options described below.
Specify a compression scheme to use when writing image data:
.B "\-c none"
for no compression,
.B "-c packbits"
.B "\-c packbits"
for the PackBits compression algorithm,
.B "-c zip"
.B "\-c zip"
for the Deflate compression algorithm,
and
.B "\-c lzw"

View File

@ -1,4 +1,4 @@
.\" $Id: ras2tiff.1,v 1.3 2005-11-02 11:07:19 dron Exp $
.\" $Id: ras2tiff.1,v 1.4 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1990-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -65,11 +65,11 @@ is 24 or 1 (min-is-black) if the depth is not 24.
Specify a compression scheme to use when writing image data:
.B "\-c none"
for no compression,
.B "-c packbits"
.B "\-c packbits"
for the PackBits compression algorithm,
.B "-c jpeg"
.B "\-c jpeg"
for the baseline JPEG compression algorithm,
.B "-c zip
.B "\-c zip
for the Deflate compression algorithm,
and
.B "\-c lzw"

View File

@ -1,4 +1,4 @@
.\" $Id: raw2tiff.1,v 1.5 2005-11-02 11:07:19 dron Exp $
.\" $Id: raw2tiff.1,v 1.6 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1990-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -44,99 +44,102 @@ By default, the
image is created with data samples packed (\c
.IR PlanarConfiguration =1),
compressed with the PackBits algorithm (\c
.IR Compression = 32773),
.IR Compression =32773),
and with each strip no more than 8 kilobytes.
These characteristics can overridden, or explicitly specified
with the options described below.
.SH OPTIONS
.TP
.B \-H <number>
.BI \-H " number"
size of input image file header in bytes (0 by default). This amount of data
just will be skipped from the start of file while reading.
.TP
.B \-w <number>
.BI \-w " number"
width of input image in pixels (can be guessed, see
.SM
.B "GUESSING THE IMAGE GEOMETRY"
below).
.TP
.B \-l <number>
length of input image in lines(can be guessed, see
.BI \-l " number"
length of input image in lines (can be guessed, see
.SM
.B "GUESSING THE IMAGE GEOMETRY"
below).
.TP
.B \-b <number>
.BI \-b " number"
number of bands in input image (1 by default).
.TP
.B \-d data_type
.BI \-d " data_type"
type of samples in input image, where
.B data_type
.I data_type
may be:
.ta \w'\fBdouble \fR'u
.br
.I byte\t\t
.B byte\t
8-bit unsigned integer (default),
.br
.I short\t
.B short\t
16-bit unsigned integer,
.br
.I long\t\t
.B long\t
32-bit unsigned integer,
.br
.I sbyte\t
.B sbyte\t
8-bit signed integer,
.br
.I sshort\t
.B sshort\t
16-bit signed integer,
.br
.I slong\t
.B slong\t
32-bit signed integer,
.br
.I float\t
.B float\t
32-bit IEEE floating point,
.br
.I double\t
64-bit IEEE floating point,
.B double\t
64-bit IEEE floating point.
.TP
.B \-i config
.BI \-i " config"
type of samples interleaving in input image, where
.B config
.I config
may be:
.ta \w'\fBpixel \fR'u
.br
.I pixel\t
.B pixel\t
pixel interleaved data (default),
.br
.I band\t\t
.B band\t
band interleaved data.
.TP
.B \-p photo
.BI \-p " photo"
photometric interpretation (color space) of the input image, where
.B photo
.I photo
may be:
.ta \w'\fBminiswhite \fR'u
.br
.I miniswhite
.B miniswhite\t
white color represented with 0 value,
.br
.I minisblack
.B minisblack\t
black color represented with 0 value (default),
.br
.I rgb\t\t
.B rgb\t
image has RGB color model,
.br
.I cmyk\t\t
.B cmyk\t
image has CMYK (separated) color model,
.br
.I ycbcr\t\t
.B ycbcr\t
image has YCbCr color model,
.br
.I cielab\t
.B cielab\t
image has CIE L*a*b color model,
.br
.I icclab\t
.B icclab\t
image has ICC L*a*b color model,
.br
.I itulab\t
image has ITU L*a*b color model,
.B itulab\t
image has ITU L*a*b color model.
.TP
.B \-s
swap bytes fetched from the input file.
@ -151,17 +154,17 @@ input data has MSB2LSB bit order.
Specify a compression scheme to use when writing image data:
.B "\-c none"
for no compression,
.B "-c packbits"
.B "\-c packbits"
for the PackBits compression algorithm (the default),
.B "-c jpeg"
.B "\-c jpeg"
for the baseline JPEG compression algorithm,
.B "-c zip
.B "\-c zip"
for the Deflate compression algorithm,
and
.B "\-c lzw"
for Lempel-Ziv & Welch.
.TP
.B \-r <number>
.BI \-r " number"
Write data with a specified number of rows per strip;
by default the number of rows/strip is selected so that each strip
is approximately 8 kilobytes.

View File

@ -1,4 +1,4 @@
.\" $Header: /cvs/maptools/cvsroot/libtiff/man/rgb2ycbcr.1,v 1.3 2005-11-02 11:07:19 dron Exp $
.\" $Header: /cvs/maptools/cvsroot/libtiff/man/rgb2ycbcr.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.
@ -70,11 +70,11 @@ rows per strip.
Specify a compression scheme to use when writing image data:
.B "\-c none"
for no compression,
.B "-c packbits"
.B "\-c packbits"
for the PackBits compression algorithm (the default),
.B "-c jpeg"
.B "\-c jpeg"
for the JPEG compression algorithm,
.B "-c zip"
.B "\-c zip"
for the deflate compression algorithm,
and
.B "\-c lzw"

View File

@ -1,4 +1,4 @@
.\" $Id: sgi2tiff.1,v 1.3 2005-11-02 11:07:19 dron Exp $
.\" $Id: sgi2tiff.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.
@ -58,11 +58,11 @@ with the options described below.
Specify a compression scheme to use when writing image data:
.B "\-c none"
for no compression,
.B "-c packbits"
.B "\-c packbits"
for the PackBits compression algorithm),
.B "-c jpeg"
.B "\-c jpeg"
for the baseline JPEG compression algorithm,
.B "-c zip
.B "\-c zip
for the Deflate compression algorithm,
and
.B "\-c lzw"

View File

@ -1,4 +1,4 @@
.\" $Id: tiff2bw.1,v 1.2 2005-11-02 11:07:19 dron Exp $
.\" $Id: tiff2bw.1,v 1.3 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1988-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -31,7 +31,7 @@ image to greyscale
.SH SYNOPSIS
.B tiff2bw
[
options
.I options
]
.I input.tif
.I output.tif
@ -58,13 +58,13 @@ options may be used.
Specify a compression scheme to use when writing image data:
.B "\-c none"
for no compression,
.B "-c packbits"
.B "\-c packbits"
for the PackBits compression algorithm,
.B "-c zip
.B "\-c zip
for the Deflate compression algorithm,
.B "-c g3
.B "\-c g3
for the CCITT Group 3 compression algorithm,
.B "-c g4
.B "\-c g4
for the CCITT Group 4 compression algorithm,
and
.B "\-c lzw"

View File

@ -1,4 +1,4 @@
.\" $Id: tiff2pdf.1,v 1.5 2006-04-20 12:07:41 dron Exp $
.\" $Id: tiff2pdf.1,v 1.6 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 2003 Ross Finlayson
.\"
@ -24,16 +24,17 @@
.\" Process this file with
.\" groff -man -Tascii tiff2pdf.1
.\"
.TH TIFF2PDF 1 "November 2, 2005" "libtiff"
.TH TIFF2PDF 1 "April 20, 2006" "libtiff"
.SH NAME
tiff2pdf - convert a TIFF image to a PDF document
tiff2pdf \- convert a TIFF image to a PDF document
.SH SYNOPSIS
.B tiff2pdf [
.B tiff2pdf
[
.I options
.B ]
]
.I input.tiff
.SH DESCRIPTION
.B tiff2pdf
.I tiff2pdf
opens a TIFF image and writes a PDF document to standard output.
.PP
The program converts one TIFF file to one PDF file, including multiple page
@ -50,7 +51,7 @@ If the input TIFF file is of huge dimensions (greater than 10000 pixels height
or width) convert the input image to a tiled TIFF if it is not already.
.PP
The standard output is standard output. Set the output file name with the
.BI -o output.pdf
.BI \-o " output.pdf"
option.
.PP
All black and white files are compressed into a single strip CCITT G4 Fax
@ -107,11 +108,11 @@ length can be set by the
option, the default unit is inch.
.PP
Various items of the output document information can be set with the
.B \-e,
.B \-c,
.B \-a,
.B \-t,
.B \-s,
.BR \-e ,
.BR \-c ,
.BR \-a ,
.BR \-t ,
.BR \-s ,
and
.B \-k
options. Setting the argument of the option to "" for these
@ -123,17 +124,23 @@ The Portable Document Format (PDF) specification is copyrighted by Adobe
Systems, Incorporated.
.SH OPTIONS
.TP
.BI \-o output-file
Set the output to go to file
.BI \-o " output-file"
Set the output to go to file.
.I output-file
.TP
.B \-j
Compress with JPEG (requires libjpeg configured with libtiff).
Compress with JPEG (requires
.I libjpeg
configured with
.IR libtiff ).
.TP
.B \-z
Compress with Zip/Deflate (requires zlib configured with libtiff).
Compress with Zip/Deflate (requires
.I zlib
configured with
.IR libtiff ).
.TP
.BI \-q quality
.BI \-q " quality"
Set the compression quality, 1-100 for JPEG.
.TP
.B \-n
@ -141,7 +148,7 @@ Do not allow data to be converted without uncompressing, no compressed
data passthrough.
.TP
.BI \-b
Set PDF "Interpolate" user preference.
Set PDF ``Interpolate'' user preference.
.TP
.B \-d
Do not compress (decompress).
@ -149,98 +156,95 @@ Do not compress (decompress).
.B \-i
Invert colors.
.TP
.BI \-p paper-size
Set paper size, eg "letter", "legal", "A4".
.BI \-p " paper-size"
Set paper size, e.g.,
.BR letter ,
.BR legal ,
.BR A4 .
.TP
.BI \-u [i|m]
.BR \-u " [" i | m ]
Set distance unit,
.I i
.B i
for inch,
.I m
.B m
for centimeter.
.TP
.BI \-w width
.BI \-w " width"
Set width in units.
.TP
.BI \-l length
.BI \-l " length"
Set length in units.
.TP
.BI \-x xres
.BI \-x " xres"
Set x/width resolution default.
.TP
.BI \-y yres
.BI \-y " yres"
Set y/length resolution default.
.TP
.BI \-r [d|o]
.BR \-r " [" d | o ]
Set
.I d
.B d
for resolution default for images without resolution,
.I o for resolution override for all images.
.B o
for resolution override for all images.
.TP
.BI \-f
Set PDF "Fit Window" user preference.
Set PDF ``Fit Window'' user preference.
.TP
.BI \-e YYYYMMDDHHMMSS
.BI \-e " YYYYMMDDHHMMSS"
Set document information date, overrides image or current date/time default,
.I YYYYMMDDHHMMSS.
.TP
.BI \-c creator
.BI \-c " creator"
Set document information creator, overrides image software default.
.TP
.BI \-a author
Set document information author, overrides image artist default
.BI \-a " author"
Set document information author, overrides image artist default.
.TP
.BI \-t title
Set document information title, overrides image document name default
.BI \-t " title"
Set document information title, overrides image document name default.
.TP
.BI \-s subject
Set document information subject, overrides image image description default
.BI \-s " subject"
Set document information subject, overrides image image description default.
.TP
.BI \-k keywords
.BI \-k " keywords"
Set document information keywords.
.TP
.BI \-b
Set PDF "Interpolate" user preference.
.TP
.B \-h
List usage reminder to stderr and exit.
.TP
.SH EXAMPLES
.TP
The following example would generate the file output.pdf from input.tiff.
.PP
.RS
.NF
tiff2pdf -o output.pdf input.tiff
.FI
.nf
tiff2pdf \-o output.pdf input.tiff
.fi
.RE
.PP
The following example would generate PDF output from input.tiff and write it
to standard output.
.PP
.RS
.NF
.nf
tiff2pdf input.tiff
.FI
.fi
.RE
.PP
The following example would generate the file output.pdf from input.tiff,
putting the image pages on a letter sized page, compressing the output
with JPEG, with JPEG quality 75, setting the title to "Document", and setting
the "Fit Window" option.
.PP
with JPEG, with JPEG quality 75, setting the title to ``Document'', and setting
the ``Fit Window'' option.
.RS
.NF
tiff2pdf -p letter -j -q 75 -t "Document" -f -o output.pdf input.tiff
.FI
.nf
tiff2pdf \-p letter \-j \-q 75 \-t "Document" \-f \-o output.pdf input.tiff
.fi
.RE
.SH BUGS
Please report bugs via the web interface at
.IP
\%http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff
.SH "SEE ALSO"
.BR libtiff (3) ,
.BR tiffcp (1) ,
.BR libtiff (3),
.BR tiffcp (1),
.BR tiff2ps (1)
.PP
Libtiff library home page:

View File

@ -1,4 +1,4 @@
.\" $Id: tiff2ps.1,v 1.8 2005-11-02 11:07:19 dron Exp $
.\" $Id: tiff2ps.1,v 1.9 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1988-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -22,12 +22,13 @@
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
.\" OF THIS SOFTWARE.
.\"
.ds Ps PostScript
.if n .po 0
.TH TIFF2PS 1 "November 2, 2005" "libtiff"
.SH NAME
tiff2ps \- convert a
.SM TIFF
image to \*(Ps\(tm
image to \*(Ps\*(Tm
.SH SYNOPSIS
.B tiff2ps
[
@ -108,18 +109,23 @@ the height of the printed image.
.TP
.B \-c
Center the image in the output. This option only shows an effect if both
the -w and the -h option are given.
the
.B \-w
and the
.B \-h
option are given.
.TP
.B \-d
Set the initial
.SM TIFF
directory to the specified directory number.
(NB: directories are numbered starting at zero.)
(NB: Directories are numbered starting at zero.)
This option is useful for selecting individual pages in a
multi-page (e.g. facsimile) file.
.TP
.B \-e
Force the generation of Encapsulated \*(Ps (implies -z).
Force the generation of Encapsulated \*(Ps (implies
.BR \-z ).
.TP
.B \-h
Specify the vertical size of the printed area (in inches).
@ -147,14 +153,17 @@ the width of the printed image.
.TP
.B \-m
Where possible render using the
.B imagemask
\*(Ps operator instead of the image operator. When this option is specified
.I imagemask
\*(Ps operator instead of the
.I image
operator. When this option is specified
.I tiff2ps
will use
.B imagemask
.I imagemask
for rendering 1 bit deep images. If this option is not specified
or if the image depth is greater than 1 then the image operator
is used.
or if the image depth is greater than 1 then the
.I image
operator is used.
.TP
.B \-o
Set the initial
@ -163,7 +172,9 @@ directory to the
.SM IFD
at the specified file offset.
This option is useful for selecting thumbnail images and the
like which are hidden using the SubIFD tag.
like which are hidden using the
.I SubIFD
tag.
.TP
.B \-p
Force the generation of (non-Encapsulated) \*(Ps.
@ -195,7 +206,7 @@ page and this option has no affect.
The following generates \*(Ps Level 2 for all pages of a facsimile:
.RS
.nf
tiff2ps -a2 fax.tif | lpr
tiff2ps \-a2 fax.tif | lpr
.fi
.RE
Note also that if you have version 2.6.1 or newer of Ghostscript then you
@ -205,15 +216,15 @@ To generate Encapsulated \*(Ps for a the image at directory 2
of an image use:
.RS
.nf
tiff2ps -d 1 foo.tif
tiff2ps \-d 1 foo.tif
.fi
.RE
(notice that directories are numbered starting at zero.)
(Notice that directories are numbered starting at zero.)
.PP
If you have a long image, it may be split in several pages:
.RS
.nf
tiff2ps -h11 -w8.5 -H14 -L.5 foo.tif > foo.ps
tiff2ps \-h11 \-w8.5 \-H14 \-L.5 foo.tif > foo.ps
.fi
.RE
The page size is set to 8.5x11 by
@ -234,8 +245,8 @@ This conversion results in output that is six times
bigger than the original image and which takes a long time
to send to a printer over a serial line.
Matters are even worse for 4-, 2-, and 1-bit palette images.
.SH BUGS
Does not handle tiled images when generating PS Level I output.
.PP
Does not handle tiled images when generating \*(Ps Level I output.
.SH "SEE ALSO"
.BR pal2rgb (1),
.BR tiffinfo (1),

View File

@ -1,4 +1,4 @@
.\" $Id: tiff2rgba.1,v 1.3 2005-11-02 11:07:19 dron Exp $
.\" $Id: tiff2rgba.1,v 1.4 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1988-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -31,7 +31,7 @@ image to RGBA color space
.SH SYNOPSIS
.B tiff2rgba
[
options
.I options
]
.I input.tif
.I output.tif
@ -50,7 +50,9 @@ esoteric combinations of BitsPerSample, photometric interpretation,
block organization and planar configuration.
.P
The generated images are stripped images with four samples per pixel
(red, green, blue and alpha) or if the -n flag is used, three samples
(red, green, blue and alpha) or if the
.B \-n
flag is used, three samples
per pixel (red, green, and blue). The resulting images are always planar
configuration contiguous. For this reason, this program is a useful utility
for transform exotic TIFF files into a form ingestible by almost any TIFF
@ -61,11 +63,11 @@ supporting software.
Specify a compression scheme to use when writing image data:
.B "\-c none"
for no compression (the default),
.B "-c packbits"
.B "\-c packbits"
for the PackBits compression algorithm,
.B "-c zip
.B "\-c zip"
for the Deflate compression algorithm,
.B "-c jpeg
.B "\-c jpeg"
for the JPEG compression algorithm,
and
.B "\-c lzw"
@ -83,7 +85,9 @@ images on systems with limited RAM.
.TP
.B \-n
Drop the alpha component from the output file, producing a pure RGB file.
Currently this does not work if the -b flag is also in effect.
Currently this does not work if the
.B \-b
flag is also in effect.
.SH "SEE ALSO"
.BR tiff2bw (1),
.BR TIFFReadRGBAImage (3t),

View File

@ -1,4 +1,4 @@
.\" $Id: tiffcmp.1,v 1.4 2005-11-02 11:07:19 dron Exp $
.\" $Id: tiffcmp.1,v 1.5 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1988-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -61,7 +61,7 @@ will terminate if it encounters any difference.
.B \-l
List each byte of image data that differs between the files.
.TP
.B \-z number
.BI \-z " number"
List specified number of image data bytes that differs between the files.
.TP
.B \-t
@ -70,8 +70,9 @@ Ignore any differences in directory tags.
Tags that are not recognized by the library are not
compared; they may also generate spurious diagnostics.
.PP
The image data of tiled files is not compared, since the TIFFReadScanline()
function is used. A error will be reported for tiled files.
The image data of tiled files is not compared, since the
.I TIFFReadScanline()
function is used. An error will be reported for tiled files.
.PP
The pixel and/or sample number reported in differences may be off
in some exotic cases.

View File

@ -1,4 +1,4 @@
.\" $Id: tiffcp.1,v 1.6 2005-11-02 11:07:19 dron Exp $
.\" $Id: tiffcp.1,v 1.7 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1988-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -60,7 +60,7 @@ in a file, but it is explicitly intended to not alter or convert
the image data content in any way.
.SH OPTIONS
.TP
.B \-b image
.BI \-b " image"
subtract the following monochrome image from all others
processed. This can be used to remove a noise bias
from a set of images. This bias image is typically an
@ -185,7 +185,7 @@ is specified),
attempts to set the rows/strip
that no more than 8 kilobytes of data appear in a strip. If you specify
special value
.B -1
.B \-1
it will results in infinite number of the rows per strip. The entire image
will be the one strip in that case.
.TP
@ -208,18 +208,22 @@ that no more than 8 kilobytes of data appear in a tile.
attempts to set the tile dimensions so
that no more than 8 kilobytes of data appear in a tile.
.TP
.B \-,={character}
substitute {character} for ',' in parsing image directory indices
.BI \-,= character
substitute
.I character
for `,' in parsing image directory indices
in files. This is necessary if filenames contain commas.
Note that ',=' with whitespace immediately following will disable
the special meaning of the ',' entirely. See examples.
Note that
.B \-,=
with whitespace immediately following will disable
the special meaning of the `,' entirely. See examples.
.SH EXAMPLES
The following concatenates two files and writes the result using
.SM LZW
encoding:
.RS
.nf
tiffcp -c lzw a.tif b.tif result.tif
tiffcp \-c lzw a.tif b.tif result.tif
.fi
.RE
.PP
@ -228,39 +232,41 @@ To convert a G3 1d-encoded
to a single strip of G4-encoded data the following might be used:
.RS
.nf
tiffcp -c g4 -r 10000 g3.tif g4.tif
tiffcp \-c g4 \-r 10000 g3.tif g4.tif
.fi
.RE
(1000 is just a number that is larger than the number of rows in
the source file.)
To extract a selected set of images from a multi-image
TIFF file, the file name may be immediately followed by a ','
TIFF file, the file name may be immediately followed by a `,'
separated list of image directory indices. The first image
is always in directory 0. Thus, to copy the 1st and 3rd
images of image file "album.tif" to "result.tif":
images of image file ``album.tif'' to ``result.tif'':
.RS
.nf
tiffcp album.tif,0,2 result.tif
.fi
.RE
Given file "CCD.tif" whose first image is a noise bias
Given file ``CCD.tif'' whose first image is a noise bias
followed by images which include that bias,
subtract the noise from all those images following it
(while decompressing) with the command:
.RS
.nf
tiffcp -c none -b CCD.tif CCD.tif,1, result.tif
tiffcp \-c none \-b CCD.tif CCD.tif,1, result.tif
.fi
.RE
If the file above were named "CCD,X.tif", the "-,=" option would
If the file above were named ``CCD,X.tif'', the
.B \-,=
option would
be required to correctly parse this filename with image numbers,
as follows:
.RS
.nf
tiffcp -c none -,=% -b CCD,X.tif CCD,X%1%.tif result.tif
tiffcp \-c none \-,=% \-b CCD,X.tif CCD,X%1%.tif result.tif
.SH "SEE ALSO"
.BR pal2rgb (1),
.BR tiffinfo (1),

View File

@ -1,4 +1,4 @@
.\" $Id: tiffdither.1,v 1.3 2005-11-02 11:07:19 dron Exp $
.\" $Id: tiffdither.1,v 1.4 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1990-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -102,11 +102,15 @@ By default,
will create a new file with the same fill order as the original.
Specifying
.B "\-f lsb2msb"
will force data to be written with the FillOrder tag set to
will force data to be written with the
.I Fill\%Order
tag set to
.SM LSB2MSB ,
while
.B "\-f msb2lsb"
will force data to be written with the FillOrder tag set to
will force data to be written with the
.I Fill\%Order
tag set to
.SM MSB2LSB .
.TP
.B \-t

View File

@ -1,4 +1,4 @@
.\" $Id: tiffdump.1,v 1.4 2005-11-02 11:07:19 dron Exp $
.\" $Id: tiffdump.1,v 1.5 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1988-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -63,11 +63,11 @@ does not understand.
Force numeric data to be printed in hexadecimal rather than the
default decimal.
.TP
.B \-m " items"
.BI \-m " items"
Change the number of indirect data items that are printed. By default, this
will be 24.
.TP
.B \-o " offset"
.BI \-o " offset"
Dump the contents of the
.SM IFD
at the a particular file offset.

View File

@ -1,4 +1,4 @@
.\" $Id: tiffgt.1,v 1.3 2005-11-02 11:07:19 dron Exp $
.\" $Id: tiffgt.1,v 1.4 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1988-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -56,11 +56,11 @@ correctly handles files with any of the following characteristics:
.in +0.5i
.ta \w'\fIPhotometricInterpretation\fP 'u
.nf
BitsPerSample 1, 2, 4, 8, 16
SamplesPerPixel 1, 3, 4 (the 4th sample is ignored)
PhotometricInterpretation 0 (min-is-white), 1 (min-is-black), 2 (RGB), 3 (palette), 6 (YCbCr)
PlanarConfiguration 1 (contiguous), 2 (separate)
Orientation 1 (top-left), 4 (bottom-left)
\fIBitsPerSample\fP 1, 2, 4, 8, 16
\fISamplesPerPixel\fP 1, 3, 4 (the 4th sample is ignored)
\fIPhotometricInterpretation\fP 0 (min-is-white), 1 (min-is-black), 2 (RGB), 3 (palette), 6 (YCbCr)
\fIPlanarConfiguration\fP 1 (contiguous), 2 (separate)
\fIOrientation\fP 1 (top-left), 4 (bottom-left)
.fi
.in -0.5i
.sp .5
@ -199,15 +199,15 @@ i.e. a leading ``0x'' for hexadecimal and a leading ``0'' for octal.
Override the value of the
.I PhotometricInterpretation
tag; the parameter may be one of:
.IR miniswhite ,
.IR minisblack ,
.IR rgb ,
.IR palette ,
.IR mask ,
.IR separated ,
.IR ycbcr ,
.BR miniswhite ,
.BR minisblack ,
.BR rgb ,
.BR palette ,
.BR mask ,
.BR separated ,
.BR ycbcr ,
and
.IR cielab .
.BR cielab .
.TP
.B \-r
Force image display in a full color window.

View File

@ -1,4 +1,4 @@
.\" $Id: tiffset.1,v 1.2 2005-11-02 11:07:19 dron Exp $
.\" $Id: tiffset.1,v 1.3 2006-04-20 12:17:19 dron Exp $
.\"
.\" Copyright (c) 1988-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -31,7 +31,7 @@ header
.SH SYNOPSIS
.B tiffset
[
options
.I options
]
.I filename.tif
.SH DESCRIPTION
@ -41,10 +41,10 @@ sets the value of a
header to a specified value.
.SH OPTIONS
.TP
.B \-s tagnumber [count] value ...
.BI \-s " tagnumber" "\fR [\fP" " count" "\fR ]\fP" " value ..."
Set the value of the named tag to the value or values specified.
.TP
.B \-sf tagnumber filename
.BI \-sf " tagnumber filename"
Set the value of the tag to the contents of filename. This option is
supported for ASCII tags only.
.SH EXAMPLES
@ -52,24 +52,24 @@ The following example sets the image description tag (270) of a.tif to
the contents of the file descrip:
.RS
.nf
tiffset -sf 270 descrip a.tif
tiffset \-sf 270 descrip a.tif
.fi
.RE
.PP
The following example sets the artist tag (315) of a.tif to the string
"Anonymous":
``Anonymous'':
.RS
.nf
tiffset -s 305 Anonymous a.tif
tiffset \-s 305 Anonymous a.tif
.fi
.RE
.PP
This example sets the resolution of the file a.tif to 300 dpi:
.RS
.nf
tiffset -s 296 2 a.tif
tiffset -s 282 300.0 a.tif
tiffset -s 283 300.0 a.tif
tiffset \-s 296 2 a.tif
tiffset \-s 282 300.0 a.tif
tiffset \-s 283 300.0 a.tif
.fi
.RE
.SH "SEE ALSO"