src/tiff/man/tiffsplit.1

.\" $Id: tiffsplit.1,v 1.5 2005/11/02 11:07:19 dron Exp $
.\"
.\" Copyright (c) 1992-1997 Sam Leffler
.\" Copyright (c) 1992-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.
.\"
.if n .po 0
.TH TIFFSPLIT 1 "September 20, 2005" "libtiff"
.SH NAME
tiffsplit \- split a multi-image
.SM TIFF
into single-image
.SM TIFF
files
.SH SYNOPSIS
.B tiffsplit
.I src.tif
[
.I prefix
]
.SH DESCRIPTION
.I tiffsplit
takes a multi-directory (page)
.SM TIFF
file and creates one or more single-directory (page)
.SM TIFF
files from it.
The output files are given names created by concatenating
a prefix, a lexically ordered
suffix in the range [\fIaaa\fP-\fIzzz\fP], the suffix
.I .tif
(e.g.
.IR xaaa.tif ,
.IR xaab.tif ,
\...
.IR xzzz.tif ).
If a prefix is not specified on the command line,
the default prefix of
.I x
is used.
.SH OPTIONS
None.
.SH BUGS
Only a select set of ``known tags'' is copied when splitting.
.SH "SEE ALSO"
.BR tiffcp (1),
.BR tiffinfo (1),
.BR libtiff (3TIFF)
.PP
Libtiff library home page:
.BR http://www.remotesensing.org/libtiff/
Commit	Line	Data
	1	.\" $Id: tiffsplit.1,v 1.5 2005/11/02 11:07:19 dron Exp $
	2	.\"
	3	.\" Copyright (c) 1992-1997 Sam Leffler
	4	.\" Copyright (c) 1992-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	.\"
	25	.if n .po 0
	26	.TH TIFFSPLIT 1 "September 20, 2005" "libtiff"
	27	.SH NAME
	28	tiffsplit \- split a multi-image
	29	.SM TIFF
	30	into single-image
	31	.SM TIFF
	32	files
	33	.SH SYNOPSIS
	34	.B tiffsplit
	35	.I src.tif
	36	[
	37	.I prefix
	38	]
	39	.SH DESCRIPTION
	40	.I tiffsplit
	41	takes a multi-directory (page)
	42	.SM TIFF
	43	file and creates one or more single-directory (page)
	44	.SM TIFF
	45	files from it.
	46	The output files are given names created by concatenating
	47	a prefix, a lexically ordered
	48	suffix in the range [\fIaaa\fP-\fIzzz\fP], the suffix
	49	.I .tif
	50	(e.g.
	51	.IR xaaa.tif ,
	52	.IR xaab.tif ,
	53	\...
	54	.IR xzzz.tif ).
	55	If a prefix is not specified on the command line,
	56	the default prefix of
	57	.I x
	58	is used.
	59	.SH OPTIONS
	60	None.
	61	.SH BUGS
	62	Only a select set of ``known tags'' is copied when splitting.
	63	.SH "SEE ALSO"
	64	.BR tiffcp (1),
	65	.BR tiffinfo (1),
	66	.BR libtiff (3TIFF)
	67	.PP
	68	Libtiff library home page:
	69	.BR http://www.remotesensing.org/libtiff/