TIFFReadRGBAImageOriented() added.

2 files changed, 40 insertions, 6 deletions

diff --git a/man/Makefile.in b/man/Makefile.in
index 00e87f35..b4333686 100644
--- a/man/Makefile.in
+++ b/man/Makefile.in
@@ -1,5 +1,5 @@
 #! smake
-#	$Header: /cvs/maptools/cvsroot/libtiff/man/Makefile.in,v 1.15 2002-10-11 10:04:32 dron Exp $
+#	$Header: /cvs/maptools/cvsroot/libtiff/man/Makefile.in,v 1.16 2003-10-03 11:23:02 dron Exp $
 #
 # @WARNING@
 #
@@ -185,6 +185,7 @@ MANDEVLINKS=\
 	lib/TIFFRGBAImageBegin.3t \
 	lib/TIFFRGBAImageGet.3t \
 	lib/TIFFRGBAImageEnd.3t \
+	lib/TIFFReadRGBAImageOriented.3t \
 	lib/TIFFSetErrorHandler.3t \
 	lib/TIFFSetSubDirectory.3t \
 	lib/TIFFSetWarningHandler.3t \
@@ -312,6 +313,7 @@ lib/TIFFRGBAImageOK.3t:;	${ECHO} ".so ${MANDIR}TIFFRGBAImage.3t" > $@
 lib/TIFFRGBAImageBegin.3t:;	${ECHO} ".so ${MANDIR}TIFFRGBAImage.3t" > $@
 lib/TIFFRGBAImageGet.3t:;	${ECHO} ".so ${MANDIR}TIFFRGBAImage.3t" > $@
 lib/TIFFRGBAImageEnd.3t:;	${ECHO} ".so ${MANDIR}TIFFRGBAImage.3t" > $@
+lib/TIFFReadRGBAImageOriented.3t:;	${ECHO} ".so ${MANDIR}TIFFReadRGBAImage.3t" > $@
 lib/TIFFSetErrorHandler.3t:;	${ECHO} ".so ${MANDIR}TIFFError.3t" > $@
 lib/TIFFSetSubDirectory.3t:;	${ECHO} ".so ${MANDIR}TIFFSetDirectory.3t" > $@
 lib/TIFFSetWarningHandler.3t:;	${ECHO} ".so ${MANDIR}TIFFWarning.3t" > $@
diff --git a/man/TIFFReadRGBAImage.3t b/man/TIFFReadRGBAImage.3t
index bf07e271..49324a9e 100644
--- a/man/TIFFReadRGBAImage.3t
+++ b/man/TIFFReadRGBAImage.3t
@@ -1,4 +1,4 @@
-.\" $Header: /cvs/maptools/cvsroot/libtiff/man/Attic/TIFFReadRGBAImage.3t,v 1.2 1999-08-16 17:29:55 warmerda Exp $
+.\" $Header: /cvs/maptools/cvsroot/libtiff/man/Attic/TIFFReadRGBAImage.3t,v 1.3 2003-10-03 11:18:17 dron Exp $
 .\"
 .\" Copyright (c) 1991-1997 Sam Leffler
 .\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
@@ -23,19 +23,26 @@
 .\" OF THIS SOFTWARE.
 .\"
 .if n .po 0
-.TH TIFFReadRGBAImage 3T "February 14, 1992"
+.TH TIFFReadRGBAImage 3T "October 03, 2003"
 .SH NAME
 TIFFReadRGBAImage \- read and decode an image into a fixed-format raster
 .SH SYNOPSIS
-.nf
 .B "#include <tiffio.h>"
+.sp
 .ta \w'\fB#define \fP'u +\w'\fBTIFFGetR(abgr)   \fP'u
+.br
 .B "#define TIFFGetR(abgr)	((abgr) & 0xff)"
+.br
 .B "#define TIFFGetG(abgr)	(((abgr) >> 8) & 0xff)"
+.br
 .B "#define TIFFGetB(abgr)	(((abgr) >> 16) & 0xff)"
+.br
 .B "#define TIFFGetA(abgr)	(((abgr) >> 24) & 0xff)"
-.sp 5p
-.B "int TIFFReadRGBAImage(TIFF* tif, u_long width, u_long height, u_long* raster, int stopOnError)"
+.sp
+.BI "int TIFFReadRGBAImage(TIFF *" tif ", u_long " width ", u_long " height ", u_long *" raster ", int " stopOnError ")
+.br
+.BI "int TIFFReadRGBAImageOriented(TIFF *" tif ", u_long " width ", u_long " height ", u_long *" raster ", int " orientation ", int " stopOnError ")
+.br
 .SH DESCRIPTION
 .IR TIFFReadRGBAImage
 reads a strip- or tile-based image into memory, storing the
@@ -58,6 +65,31 @@ image data are placed in the lower part of the raster.
 at location (\fIx\fP,\fIy\fP) is \fIraster\fP[\fIy\fP*\fIwidth\fP+\fIx\fP];
 with the raster origin in the lower-left hand corner.)
 .PP
+.IR TIFFReadRGBAImageOriented
+works like
+.IR TIFFReadRGBAImage
+with except of that user can specify the raster origin position with the
+.I orientation
+parameter. Four orientations supported:
+.TP
+.B ORIENTATION_TOPLEFT
+origin in top-left corner,
+.TP
+.B ORIENTATION_TOPRIGHT
+origin in top-right corner,
+.TP
+.B ORIENTATION_BOTLEFT
+origin in bottom-left corner
+and
+.TP
+.B ORIENTATION_BOTRIGHT
+origin in bottom-right corner.
+.LP
+If you choose
+.B ORIENTATION_BOTLEFT
+result will be the same as returned by the
+.IR TIFFReadRGBAImage.
+.PP
 Raster pixels are 8-bit packed red, green, blue, alpha samples.
 The macros
 .IR TIFFGetR ,