Add explanation about trailing comma in image indicies.

This commit is contained in:
Andrey Kiselev 2006-08-03 17:51:32 +00:00
parent d4640743e8
commit 01e076865e

View File

@ -1,4 +1,4 @@
.\" $Id: tiffcp.1,v 1.7 2006-04-20 12:17:19 dron Exp $ .\" $Id: tiffcp.1,v 1.8 2006-08-03 17:51:32 dron Exp $
.\" .\"
.\" Copyright (c) 1988-1997 Sam Leffler .\" Copyright (c) 1988-1997 Sam Leffler
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc. .\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@ -23,7 +23,7 @@
.\" OF THIS SOFTWARE. .\" OF THIS SOFTWARE.
.\" .\"
.if n .po 0 .if n .po 0
.TH TIFFCP 1 "September 20, 2005" "libtiff" .TH TIFFCP 1 "August 03, 2006" "libtiff"
.SH NAME .SH NAME
tiffcp \- copy (and possibly convert) a tiffcp \- copy (and possibly convert) a
.SM TIFF .SM TIFF
@ -238,17 +238,24 @@ tiffcp \-c g4 \-r 10000 g3.tif g4.tif
(1000 is just a number that is larger than the number of rows in (1000 is just a number that is larger than the number of rows in
the source file.) the source file.)
To extract a selected set of images from a multi-image To extract a selected set of images from a multi-image TIFF file, the file
TIFF file, the file name may be immediately followed by a `,' name may be immediately followed by a `,' separated list of image directory
separated list of image directory indices. The first image indices. The first image is always in directory 0. Thus, to copy the 1st and
is always in directory 0. Thus, to copy the 1st and 3rd 3rd images of image file ``album.tif'' to ``result.tif'':
images of image file ``album.tif'' to ``result.tif'':
.RS .RS
.nf .nf
tiffcp album.tif,0,2 result.tif tiffcp album.tif,0,2 result.tif
.fi .fi
.RE .RE
A trailing comma denotes remaining images in sequence. The following command
will copy all image with except the first one:
.RS
.nf
tiffcp album.tif,1, 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, followed by images which include that bias,
subtract the noise from all those images following it subtract the noise from all those images following it