From 94212b3d8171804da66d475a7a7031b353a04bdb Mon Sep 17 00:00:00 2001 From: Andrey Kiselev Date: Thu, 20 Apr 2006 12:17:19 +0000 Subject: [PATCH] Improvements in page formatting as per bug http://bugzilla.remotesensing.org/show_bug.cgi?id=114 --- man/bmp2tiff.1 | 17 ++++--- man/fax2ps.1 | 7 +-- man/fax2tiff.1 | 4 +- man/gif2tiff.1 | 6 +-- man/ras2tiff.1 | 8 ++-- man/raw2tiff.1 | 77 ++++++++++++++++-------------- man/rgb2ycbcr.1 | 8 ++-- man/sgi2tiff.1 | 8 ++-- man/tiff2bw.1 | 12 ++--- man/tiff2pdf.1 | 122 ++++++++++++++++++++++++----------------------- man/tiff2ps.1 | 45 ++++++++++------- man/tiff2rgba.1 | 18 ++++--- man/tiffcmp.1 | 9 ++-- man/tiffcp.1 | 36 ++++++++------ man/tiffdither.1 | 10 ++-- man/tiffdump.1 | 6 +-- man/tiffgt.1 | 28 +++++------ man/tiffset.1 | 20 ++++---- 18 files changed, 239 insertions(+), 202 deletions(-) diff --git a/man/bmp2tiff.1 b/man/bmp2tiff.1 index ea576dee..f5d68ce0 100644 --- a/man/bmp2tiff.1 +++ b/man/bmp2tiff.1 @@ -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 .\" @@ -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 +.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. diff --git a/man/fax2ps.1 b/man/fax2ps.1 index 0eb636db..9525f20b 100644 --- a/man/fax2ps.1 +++ b/man/fax2ps.1 @@ -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" diff --git a/man/fax2tiff.1 b/man/fax2tiff.1 index 89dd9703..873cab17 100644 --- a/man/fax2tiff.1 +++ b/man/fax2tiff.1 @@ -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. diff --git a/man/gif2tiff.1 b/man/gif2tiff.1 index 42d524ba..5f01d8dc 100644 --- a/man/gif2tiff.1 +++ b/man/gif2tiff.1 @@ -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" diff --git a/man/ras2tiff.1 b/man/ras2tiff.1 index 30ee5949..0c78ddb6 100644 --- a/man/ras2tiff.1 +++ b/man/ras2tiff.1 @@ -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" diff --git a/man/raw2tiff.1 b/man/raw2tiff.1 index dca4b84c..04063687 100644 --- a/man/raw2tiff.1 +++ b/man/raw2tiff.1 @@ -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 +.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 +.BI \-w " number" width of input image in pixels (can be guessed, see .SM .B "GUESSING THE IMAGE GEOMETRY" below). .TP -.B \-l -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 +.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 +.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. diff --git a/man/rgb2ycbcr.1 b/man/rgb2ycbcr.1 index e547d427..01a332ca 100644 --- a/man/rgb2ycbcr.1 +++ b/man/rgb2ycbcr.1 @@ -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" diff --git a/man/sgi2tiff.1 b/man/sgi2tiff.1 index 43d29c36..650adb3c 100644 --- a/man/sgi2tiff.1 +++ b/man/sgi2tiff.1 @@ -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" diff --git a/man/tiff2bw.1 b/man/tiff2bw.1 index 93eb8521..ccbe7e8f 100644 --- a/man/tiff2bw.1 +++ b/man/tiff2bw.1 @@ -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" diff --git a/man/tiff2pdf.1 b/man/tiff2pdf.1 index a68facd0..fe4baa17 100644 --- a/man/tiff2pdf.1 +++ b/man/tiff2pdf.1 @@ -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: diff --git a/man/tiff2ps.1 b/man/tiff2ps.1 index ab4034ba..71eddd7e 100644 --- a/man/tiff2ps.1 +++ b/man/tiff2ps.1 @@ -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), diff --git a/man/tiff2rgba.1 b/man/tiff2rgba.1 index fc85ced5..c5516563 100644 --- a/man/tiff2rgba.1 +++ b/man/tiff2rgba.1 @@ -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), diff --git a/man/tiffcmp.1 b/man/tiffcmp.1 index c2e27600..b68cb34f 100644 --- a/man/tiffcmp.1 +++ b/man/tiffcmp.1 @@ -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. diff --git a/man/tiffcp.1 b/man/tiffcp.1 index 3b001146..a3767db5 100644 --- a/man/tiffcp.1 +++ b/man/tiffcp.1 @@ -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), diff --git a/man/tiffdither.1 b/man/tiffdither.1 index 6c3efba3..ab0d32a7 100644 --- a/man/tiffdither.1 +++ b/man/tiffdither.1 @@ -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 diff --git a/man/tiffdump.1 b/man/tiffdump.1 index 0dbb8b00..076f9ffe 100644 --- a/man/tiffdump.1 +++ b/man/tiffdump.1 @@ -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. diff --git a/man/tiffgt.1 b/man/tiffgt.1 index b41eb205..680a49a0 100644 --- a/man/tiffgt.1 +++ b/man/tiffgt.1 @@ -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. diff --git a/man/tiffset.1 b/man/tiffset.1 index 2439e85c..189b5b5d 100644 --- a/man/tiffset.1 +++ b/man/tiffset.1 @@ -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"