cheng/libtiff
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Added descritpion for the TIFFGetBitRevTable, as per bug

Browse Source 
http://bugzilla.remotesensing.org/show_bug.cgi?id=547
This commit is contained in:
Andrey Kiselev 2004-11-04 14:34:24 +00:00
parent c45c87dc41
commit 018c3d1662
1 changed files with 22 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
man/TIFFswab.3t
View File

@ -1,4 +1,4 @@
.\" $Header: /cvs/maptools/cvsroot/libtiff/man/Attic/TIFFswab.3t,v 1.1 1999-07-27 21:50:27 mike Exp $ .\" $Id: TIFFswab.3t,v 1.2 2004-11-04 14:34:24 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,23 +23,24 @@
.\" OF THIS SOFTWARE. .\" OF THIS SOFTWARE.
.\" .\"
.if n .po 0 .if n .po 0
.TH SWAB 3T "December 16, 1991" .TH SWAB 3T "November 04, 2004" "libtiff"
.SH NAME .SH NAME
TIFFReverseBits, TIFFSwabShort, TIFFSwabLong, TIFFSwabArrayOfShort, TIFFSwabArrayOfLong \- byte- and bit-swapping routines TIFFGetBitRevTable, TIFFReverseBits, TIFFSwabShort, TIFFSwabLong,
TIFFSwabArrayOfShort, TIFFSwabArrayOfLong \- byte- and bit-swapping routines
.SH SYNOPSIS .SH SYNOPSIS
.B "#include <tiffio.h>" .B "#include <tiffio.h>"
.sp
.BI "const unsigned char* TIFFGetBitRevTable(int " reversed ")"
.br .br
.B "const unsigned char* TIFFGetBitRevTable(int reversed);" .BI "void TIFFReverseBits(u_char *" data ", unsigned long " nbytes ")"
.br .br
.B "void TIFFReverseBits(u_char* data, unsigned long nbytes)" .BI "void TIFFSwabShort(uint16 *" data ")"
.br .br
.B "void TIFFSwabShort(uint16* data)" .BI "void TIFFSwabLong(uint32 *" data ")"
.br .br
.B "void TIFFSwabLong(uint32* data)" .BI "void TIFFSwabArrayOfShort(uint16 *" data ", unsigned long " nshorts ")"
.br .br
.B "void TIFFSwabArrayOfShort(uint16* data, unsigned long nshorts)" .BI "void TIFFSwabArrayOfLong(uint32 *" data ", unsigned long " nlongs ")"
.br
.B "void TIFFSwabArrayOfLong(uint32* data, unsigned long nlongs)"
.SH DESCRIPTION .SH DESCRIPTION
The following routines are used by the library to swap The following routines are used by the library to swap
16- and 32-bit data and to reverse the order of bits in bytes. 16- and 32-bit data and to reverse the order of bits in bytes.
@ -56,14 +57,17 @@ swap the bytes in an array of 16-bit and 32-bit items, respectively.
.IR TIFFReverseBits .IR TIFFReverseBits
replaces each byte in replaces each byte in
.I data .I data
with the equivalent bit-reversed value. with the equivalent bit-reversed value. This operation is performed with a
This operation is done with a lookup table, lookup table, which is returned using the
.I TIFFBitRevTable .IR TIFFGetBitRevTable
which is declared public. function.
A second table, .I reversed
.I TIFFNoBitRevTable parameter specifies which table should be returned. Supply
is also declared public; it is a lookup table that .I 1
can be used as an if you want bit reversal table. Supply
.I 0
to get the table that do not reverse bit values. It is a lookup table that can
be used as an
.IR "identity function" ; .IR "identity function" ;
i.e. i.e.
.IR "TIFFNoBitRevTable[n] == n" . .IR "TIFFNoBitRevTable[n] == n" .