diff options
| author | Qt by Nokia <qt-info@nokia.com> | 2011-04-27 12:05:43 +0200 |
|---|---|---|
| committer | axis <qt-info@nokia.com> | 2011-04-27 12:05:43 +0200 |
| commit | 38be0d13830efd2d98281c645c3a60afe05ffece (patch) | |
| tree | 6ea73f3ec77f7d153333779883e8120f82820abe /src/3rdparty/libtiff/html/man | |
Initial import from the monolithic Qt.
This is the beginning of revision history for this module. If you
want to look at revision history older than this, please refer to the
Qt Git wiki for how to use Git history grafting. At the time of
writing, this wiki is located here:
http://qt.gitorious.org/qt/pages/GitIntroductionWithQt
If you have already performed the grafting and you don't see any
history beyond this commit, try running "git log" with the "--follow"
argument.
Branched from the monolithic repo, Qt master branch, at commit
896db169ea224deb96c59ce8af800d019de63f12
Diffstat (limited to 'src/3rdparty/libtiff/html/man')
64 files changed, 19543 insertions, 0 deletions
diff --git a/src/3rdparty/libtiff/html/man/TIFFClose.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFClose.3tiff.html new file mode 100644 index 0000000000..42e3ba8970 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFClose.3tiff.html @@ -0,0 +1,87 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:15 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFClose</title> +</head> +<body> + +<h1 align=center>TIFFClose</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFClose − close a previously opened +<small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>void TIFFClose(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFClose</i> closes a file that was previously opened +with <b>TIFFOpen</b>(3TIFF). Any buffered data are flushed +to the file, including the contents of the current directory +(if modified); and all resources are reclaimed.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the routine. Likewise, +warning messages are directed to the +<b>TIFFWarning</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>libtiff</b>(3TIFF), <b>TIFFOpen</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFDataWidth.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFDataWidth.3tiff.html new file mode 100644 index 0000000000..237296e18d --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFDataWidth.3tiff.html @@ -0,0 +1,98 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:15 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFDataWidth</title> +</head> +<body> + +<h1 align=center>TIFFDataWidth</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFDataWidth − Get the size of TIFF data types</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFDataWidth(TIFFDataType</b> +<i>type</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFDataWidth</i> returns a size of <i>type</i> in +bytes. Currently following data types are supported:<i><br> +TIFF_BYTE<br> +TIFF_ASCII<br> +TIFF_SBYTE<br> +TIFF_UNDEFINED<br> +TIFF_SHORT<br> +TIFF_SSHORT<br> +TIFF_LONG<br> +TIFF_SLONG<br> +TIFF_FLOAT<br> +TIFF_IFD<br> +TIFF_RATIONAL<br> +TIFF_SRATIONAL<br> +TIFF_DOUBLE</i></p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFDataWidth</i> returns a number of bytes occupied +by the item of given type. 0 returned when uknown data type +supplied.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>libtiff</b>(3TIFF),</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFError.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFError.3tiff.html new file mode 100644 index 0000000000..5d39a139ec --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFError.3tiff.html @@ -0,0 +1,106 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:15 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFError</title> +</head> +<body> + +<h1 align=center>TIFFError</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFError, TIFFSetErrorHandler − library error +handling interface</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>void TIFFError(const char *</b><i>module</i><b>, const +char *</b><i>fmt</i><b>,</b> <i>...</i><b>)</b></p> +<!-- INDENTATION --> +<p><b>#include <stdarg.h></b></p> +<!-- INDENTATION --> +<p><b>typedef void (*TIFFErrorHandler)(const char +*</b><i>module</i><b>, const char *</b><i>fmt</i><b>, +va_list</b> <i>ap</i><b>);<br> +TIFFErrorHandler TIFFSetErrorHandler(TIFFErrorHandler +handler);</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFError</i> invokes the library-wide error handling +function to (normally) write an error message to the +<b>stderr</b>. The <i>fmt</i> parameter is a +<i>printf</i>(3S) format string, and any number arguments +can be supplied. The <i>module</i> parameter, if non-zero, +is printed before the message; it typically is used to +identify the software module in which an error is +detected.</p> +<!-- INDENTATION --> +<p>Applications that desire to capture control in the event +of an error should use <i>TIFFSetErrorHandler</i> to +override the default error handler. A <small>NULL</small> +(0) error handling function may be installed to suppress +error messages.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFSetErrorHandler</i> returns a reference to the +previous error handling function.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFWarning</b>(3TIFF), <b>libtiff</b>(3TIFF), +<b>printf</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFFlush.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFFlush.3tiff.html new file mode 100644 index 0000000000..f32ccd3da7 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFFlush.3tiff.html @@ -0,0 +1,113 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:15 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFFlush</title> +</head> +<body> + +<h1 align=center>TIFFFlush</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFFlush, TIFFFlushData − flush pending writes to +an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFFlush(TIFF *</b><i>tif</i><b>)<br> +int TIFFFlushData(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFFlush</i> causes any pending writes for the +specified file (including writes for the current directory) +to be done. In normal operation this call is never needed +− the library automatically does any flushing +required.</p> +<!-- INDENTATION --> +<p><i>TIFFFlushData</i> flushes any pending image data for +the specified file to be written out; directory-related data +are not flushed. In normal operation this call is never +needed − the library automatically does any flushing +required.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>0 is returned if an error is encountered, otherwise 1 is +returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteEncodedStrip</b>(3TIFF), +<b>TIFFWriteEncodedTile</b>(3TIFF), +<b>TIFFWriteRawStrip</b>(3TIFF), +<b>TIFFWriteRawTile</b>(3TIFF), +<b>TIFFWriteScanline</b>(3TIFF), <b>TIFFWriteTile</b>(3TIFF) +<b>libtiff</b>(3TIFF),</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFGetField.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFGetField.3tiff.html new file mode 100644 index 0000000000..e644b1d412 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFGetField.3tiff.html @@ -0,0 +1,1446 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:15 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFGetField</title> +</head> +<body> + +<h1 align=center>TIFFGetField</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#AUTOREGISTERED TAGS">AUTOREGISTERED TAGS</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFGetField, TIFFVGetField − get the value(s) of a +tag in an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFGetField(TIFF *</b><i>tif</i><b>, ttag_t</b> +<i>tag</i><b>,</b> <i>...</i><b>)</b></p> +<!-- INDENTATION --> +<p><b>#include <stdarg.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFVGetField(TIFF *</b><i>tif</i><b>, ttag_t</b> +<i>tag</i><b>, va_list</b> <i>ap</i><b>)<br> +int TIFFGetFieldDefaulted(TIFF *</b><i>tif</i><b>, +ttag_t</b> <i>tag</i><b>,</b> <i>...</i><b>)<br> +int TIFFVGetFieldDefaulted(TIFF *</b><i>tif</i><b>, +ttag_t</b> <i>tag</i><b>, va_list</b> <i>ap</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFGetField</i> returns the value of a tag or +pseudo-tag associated with the the current directory of the +opened <small>TIFF</small> file <i>tif</i>. (A +<i>pseudo-tag</i> is a parameter that is used to control the +operation of the <small>TIFF</small> library but whose value +is not read or written to the underlying file.) The file +must have been previously opened with +<i>TIFFOpen</i>(3TIFF). The tag is identified by <i>tag</i>, +one of the values defined in the include file <b>tiff.h</b> +(see also the table below). The type and number of values +returned is dependent on the tag being requested. The +programming interface uses a variable argument list as +prescribed by the <i>stdarg</i>(3) interface. The returned +values should only be interpreted if <i>TIFFGetField</i> +returns 1.</p> +<!-- INDENTATION --> +<p><i>TIFFVGetField</i> is functionally equivalent to +<i>TIFFGetField</i> except that it takes a pointer to a +variable argument list. <i>TIFFVGetField</i> is useful for +layering interfaces on top of the functionality provided by +<i>TIFFGetField</i>.</p> +<!-- INDENTATION --> +<p><i>TIFFGetFieldDefaulted</i> and +<i>TIFFVGetFieldDefaulted</i> are identical to +<i>TIFFGetField</i> and <i>TIFFVGetField</i>, except that if +a tag is not defined in the current directory and it has a +default value, then the default value is returned.</p> +<!-- INDENTATION --> +<p>The tags understood by <i>libtiff(3TIFF),</i> the number +of parameter values, and the types for the returned values +are shown below. The data types are specified as in C and +correspond to the types used to specify tag values to +<i>TIFFSetField</i>(3TIFF). Remember that +<i>TIFFGetField</i> returns parameter values, so all the +listed data types are pointers to storage where values +should be returned. Consult the <small>TIFF</small> +specification (or relevant industry specification) for +information on the meaning of each tag and their possible +values.</p></td> +</table> +<!-- TABS --> + +<p><i>Tag Name Count Types Notes</i></p> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ARTIST</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_BADFAXLINES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_BITSPERSAMPLE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_CLEANFAXDATA</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COLORMAP</p> +</td> +<td width="8%"> + +<p>3</p> +</td> +<td width="23%"> + +<p>uint16**</p> +</td> +<td width="17%"> + +<p>1<<BitsPerSample arrays</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COMPRESSION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_CONSECUTIVEBADFAXLINES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COPYRIGHT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DATATYPE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DATETIME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DOCUMENTNAME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DOTRANGE</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_EXTRASAMPLES</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*,uint16**</p> +</td> +<td width="17%"> + +<p>count & types array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FAXFILLFUNC</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>TIFFFaxFillFunc*</p> +</td> +<td width="17%"> + +<p>G3/G4 compression pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FAXMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>int*</p> +</td> +<td width="17%"> + +<p>G3/G4 compression pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FILLORDER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_GROUP3OPTIONS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_GROUP4OPTIONS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_HALFTONEHINTS</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_HOSTCOMPUTER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ICCPROFILE</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint32*,void**</p> +</td> +<td width="17%"> + +<p>count, profile data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEDEPTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEDESCRIPTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGELENGTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEWIDTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_INKNAMES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_INKSET</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGCOLORMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>int*</p> +</td> +<td width="17%"> + +<p>JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGQUALITY</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>int*</p> +</td> +<td width="17%"> + +<p>JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGTABLES</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint32*,void**</p> +</td> +<td width="17%"> + +<p>count & tables</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGTABLESMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>int*</p> +</td> +<td width="17%"> + +<p>JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MAKE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MATTEING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MAXSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MINSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MODEL</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ORIENTATION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PAGENAME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PAGENUMBER</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PHOTOMETRIC</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PHOTOSHOP</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint32*,void**</p> +</td> +<td width="17%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PLANARCONFIG</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PREDICTOR</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PRIMARYCHROMATICITIES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float**</p> +</td> +<td width="17%"> + +<p>6-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_REFERENCEBLACKWHITE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float**</p> +</td> +<td width="17%"> + +<p>2*SamplesPerPixel array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_RESOLUTIONUNIT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_RICHTIFFIPTC</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint32*,void**</p> +</td> +<td width="17%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ROWSPERSTRIP</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SAMPLEFORMAT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SAMPLESPERPIXEL</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SMAXSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>double*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SMINSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>double*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SOFTWARE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_STONITS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>double**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_STRIPBYTECOUNTS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_STRIPOFFSETS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SUBFILETYPE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SUBIFD</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*,uint32**</p> +</td> +<td width="17%"> + +<p>count & offsets array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TARGETPRINTER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_THRESHHOLDING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEBYTECOUNTS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEDEPTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILELENGTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEOFFSETS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEWIDTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TRANSFERFUNCTION</p> +</td> +<td width="8%"> + +<p>1 or 3†</p> +</td> +<td width="23%"></td> +<td width="17%"> + +<p>uint16**1<<BitsPerSample entry arrays</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_WHITEPOINT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float**</p> +</td> +<td width="17%"> + +<p>2-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XMLPACKET</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint32*,void**</p> +</td> +<td width="17%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XPOSITION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XRESOLUTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRCOEFFICIENTS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float**</p> +</td> +<td width="17%"> + +<p>3-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRPOSITIONING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRSUBSAMPLING</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YPOSITION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YRESOLUTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float*‡</p> +</td> +<td width="17%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>† If <i>SamplesPerPixel</i> is one, then a single +array is returned; otherwise three arrays are returned.<br> +‡ The contents of this field are quite complex. See +<i>The ICC Profile Format Specification</i>, Annex B.3 +"Embedding ICC Profiles in TIFF Files" (available +at http://www.color.org) for an explanation.</p> +</td> +</table> +<a name="AUTOREGISTERED TAGS"></a> +<h2>AUTOREGISTERED TAGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>If you can’t find the tag in the table above that +means this is unsupported tag. But you still be able to read +it’s value if you know the data type of that tag. For +example, if you want to read the LONG value from the tag +33424 and ASCII string from the tag 36867 you can use the +following code:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>uint16 count; +void *data; + +TIFFGetField(tiff, 33424, &count, &data); +printf("Tag %d: %d, count %d0, 33424, *(uint32 *)data, count); +TIFFGetField(tiff, 36867, &count, &data); +printf("Tag %d: %s, count %d0, 36867, (char *)data, count); +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>is not supported by <b>libtiff(3TIFF),</b> library</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned if the tag is defined in the current +directory; otherwise a 0 is returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Unknown field, tag 0x%x</b>. An unknown tag was +supplied.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFSetField</b>(3TIFF), +<b>TIFFSetDirectory</b>(3TIFF), +<b>TIFFReadDirectory</b>(3TIFF), +<b>TIFFWriteDirectory</b>(3TIFF) <b>libtiff</b>(3TIFF),</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFOpen.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFOpen.3tiff.html new file mode 100644 index 0000000000..6bc85d84e0 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFOpen.3tiff.html @@ -0,0 +1,421 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:15 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFOpen</title> +</head> +<body> + +<h1 align=center>TIFFOpen</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BYTE ORDER">BYTE ORDER</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFOpen, TIFFFdOpen, TIFFClientOpen − open a +<small>TIFF</small> file for reading or writing</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>TIFF* TIFFOpen(const char *</b><i>filename</i><b>, +const char *</b><i>mode</i><b>)<br> +TIFF* TIFFFdOpen(const int</b> <i>fd</i><b>, const char +*</b><i>filename</i><b>, const char +*</b><i>mode</i><b>)</b></p> +<!-- INDENTATION --> +<p><b>typedef tsize_t (*TIFFReadWriteProc)(thandle_t, +tdata_t, tsize_t);<br> +typedef toff_t (*TIFFSeekProc)(thandle_t, toff_t, int);<br> +typedef int (*TIFFCloseProc)(thandle_t);<br> +typedef toff_t (*TIFFSizeProc)(thandle_t);<br> +typedef int (*TIFFMapFileProc)(thandle_t, tdata_t*, +toff_t*);<br> +typedef void (*TIFFUnmapFileProc)(thandle_t, tdata_t, +toff_t);</b></p> +<!-- INDENTATION --> +<p><b>TIFF* TIFFClientOpen(const char +*</b><i>filename</i><b>, const char *</b><i>mode</i><b>, +thandle_t</b> <i>clientdata</i><b>, TIFFReadWriteProc</b> +<i>readproc</i><b>, TIFFReadWriteProc</b> +<i>writeproc</i><b>, TIFFSeekProc</b> <i>seekproc</i><b>, +TIFFCloseProc</b> <i>closeproc</i><b>, TIFFSizeProc</b> +<i>sizeproc</i><b>, TIFFMapFileProc</b> <i>mapproc</i><b>, +TIFFUnmapFileProc</b> <i>unmapproc</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFOpen</i> opens a <small>TIFF</small> file whose +name is <i>filename</i> and returns a handle to be used in +subsequent calls to routines in <i>libtiff</i>. If the open +operation fails, then zero is returned. The <i>mode</i> +parameter specifies if the file is to be opened for reading +(‘‘r’’), writing +(‘‘w’’), or appending +(‘‘a’’) and, optionally, whether to +override certain default aspects of library operation (see +below). When a file is opened for appending, existing data +will not be touched; instead new data will be written as +additional subfiles. If an existing file is opened for +writing, all previous data is overwritten.</p> +<!-- INDENTATION --> +<p>If a file is opened for reading, the first +<small>TIFF</small> directory in the file is automatically +read (also see <i>TIFFSetDirectory</i>(3TIFF) for reading +directories other than the first). If a file is opened for +writing or appending, a default directory is automatically +created for writing subsequent data. This directory has all +the default values specified in <small>TIFF</small> Revision +6.0: <i>BitsPerSample</i>=1, <i>ThreshHolding</i>=bilevel +art scan, <i>FillOrder</i>=1 (most significant bit of each +data byte is filled first), <i>Orientation</i>=1 (the 0th +row represents the visual top of the image, and the 0th +column represents the visual left hand side), +<i>SamplesPerPixel</i>=1, <i>RowsPerStrip</i>=infinity, +<i>ResolutionUnit</i>=2 (inches), and <i>Compression</i>=1 +(no compression). To alter these values, or to define values +for additional fields, <i>TIFFSetField</i>(3TIFF) must be +used.</p> +<!-- INDENTATION --> +<p><i>TIFFFdOpen</i> is like <i>TIFFOpen</i> except that it +opens a <small>TIFF</small> file given an open file +descriptor <i>fd</i>. The file’s name and mode must +reflect that of the open descriptor. The object associated +with the file descriptor <b>must support random +access</b>.</p> +<!-- INDENTATION --> +<p><i>TIFFClientOpen</i> is like <i>TIFFOpen</i> except that +the caller supplies a collection of functions that the +library will use to do <small>UNIX</small> -like I/O +operations. The <i>readproc</i> and <i>writeproc</i> are +called to read and write data at the current file position. +<i>seekproc</i> is called to change the current file +position a la <i>lseek</i>(2). <i>closeproc</i> is invoked +to release any resources associated with an open file. +<i>sizeproc</i> is invoked to obtain the size in bytes of a +file. <i>mapproc</i> and <i>unmapproc</i> are called to map +and unmap a file’s contents in memory; c.f. +<i>mmap</i>(2) and <i>munmap</i>(2). The <i>clientdata</i> +parameter is an opaque ‘‘handle’’ +passed to the client-specified routines passed as parameters +to <i>TIFFClientOpen</i>.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The open mode parameter can include the following flags +in addition to the ‘‘r’’, +‘‘w’’, and +‘‘a’’ flags. Note however that +option flags must follow the read-write-append +specification.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>l</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>When creating a new file force information be written +with Little-Endian byte order (but see below). By default +the library will create new files using the native +<small>CPU</small> byte order.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>b</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>When creating a new file force information be written +with Big-Endian byte order (but see below). By default the +library will create new files using the native +<small>CPU</small> byte order.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>L</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Force image data that is read or written to be treated +with bits filled from Least Significant Bit ( +<small>LSB</small> ) to Most Significant Bit ( +<small>MSB</small> ). Note that this is the opposite to the +way the library has worked from its inception.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>B</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Force image data that is read or written to be treated +with bits filled from Most Significant Bit ( +<small>MSB</small> ) to Least Significant Bit ( +<small>LSB</small> ); this is the default.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>H</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Force image data that is read or written to be treated +with bits filled in the same order as the native +<small>CPU.</small></p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>M</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Enable the use of memory-mapped files for images opened +read-only. If the underlying system does not support +memory-mapped files or if the specific image being opened +cannot be memory-mapped then the library will fallback to +using the normal system interface for reading information. +By default the library will attempt to use memory-mapped +files.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>m</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Disable the use of memory-mapped files.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>C</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Enable the use of ‘‘strip +chopping’’ when reading images that are +comprised of a single strip or tile of uncompressed data. +Strip chopping is a mechanism by which the library will +automatically convert the single-strip image to multiple +strips, each of which has about 8 Kilobytes of data. This +facility can be useful in reducing the amount of memory used +to read an image because the library normally reads each +strip in its entirety. Strip chopping does however alter the +apparent contents of the image because when an image is +divided into multiple strips it looks as though the +underlying file contains multiple separate strips. Finally, +note that default handling of strip chopping is a +compile-time configuration parameter. The default behaviour, +for backwards compatibility, is to enable strip +chopping.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>c</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Disable the use of strip chopping when reading +images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>h</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Read TIFF header only, do not load the first image +directory. That could be useful in case of the broken first +directory. We can open the file and proceed to the other +directories.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BYTE ORDER"></a> +<h2>BYTE ORDER</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The <small>TIFF</small> specification (<b>all +versions</b>) states that compliant readers <i>must be +capable of reading images written in either byte order</i>. +Nonetheless some software that claims to support the reading +of <small>TIFF</small> images is incapable of reading images +in anything but the native <small>CPU</small> byte order on +which the software was written. (Especially notorious are +applications written to run on Intel-based machines.) By +default the library will create new files with the native +byte-order of the <small>CPU</small> on which the +application is run. This ensures optimal performance and is +portable to any application that conforms to the TIFF +specification. To force the library to use a specific +byte-order when creating a new file the +‘‘b’’ and +‘‘l’’ option flags may be included +in the call to open a file; for example, +‘‘wb’’ or +‘‘wl’’.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Upon successful completion <i>TIFFOpen</i>, +<i>TIFFFdOpen</i>, and <i>TIFFClientOpen</i> return a +<small>TIFF</small> pointer. Otherwise, NULL is +returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine. Likewise, warning messages +are directed to the <i>TIFFWarning</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>"%s": Bad mode</b>. The specified +<i>mode</i> parameter was not one of +‘‘r’’ (read), +‘‘w’’ (write), or +‘‘a’’ (append).</p> +<!-- INDENTATION --> +<p><b>%s: Cannot open</b>. <i>TIFFOpen</i>() was unable to +open the specified filename for read/writing.</p> +<!-- INDENTATION --> +<p><b>Cannot read TIFF header</b>. An error occurred while +attempting to read the header information.</p> +<!-- INDENTATION --> +<p><b>Error writing TIFF header</b>. An error occurred while +writing the default header information for a new file.</p> +<!-- INDENTATION --> +<p><b>Not a TIFF file, bad magic number %d (0x%x)</b>. The +magic number in the header was not (hex) 0x4d4d or (hex) +0x4949.</p> +<!-- INDENTATION --> +<p><b>Not a TIFF file, bad version number %d (0x%x)</b>. The +version field in the header was not 42 (decimal).</p> +<!-- INDENTATION --> +<p><b>Cannot append to file that has opposite byte +ordering</b>. A file with a byte ordering opposite to the +native byte ordering of the current machine was opened for +appending (‘‘a’’). This is a +limitation of the library.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>libtiff</i>(3TIFF), <i>TIFFClose</i>(3TIFF)</p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFPrintDirectory.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFPrintDirectory.3tiff.html new file mode 100644 index 0000000000..a5f418a115 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFPrintDirectory.3tiff.html @@ -0,0 +1,225 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:15 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFPrintDirectory</title> +</head> +<body> + +<h1 align=center>TIFFPrintDirectory</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFPrintDirectory − print a description of a +<small>TIFF</small> directory</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>void TIFFPrintDirectory(TIFF *</b><i>tif</i><b>, FILE +*</b><i>fd</i><b>, long</b> <i>flags</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFPrintDirectory</i> prints a description of the +current directory in the specified <small>TIFF</small> file +to the standard I/O output stream <i>fd</i>. The +<i>flags</i> parameter is used to control the <i>level of +detail</i> of the printed information; it is a bit-or of the +flags defined in <b>tiffio.h</b>:</p></td> +</table> +<!-- TABS --> + +<p>#define TIFFPRINT_NONE 0x0 /* no extra info */</p> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_STRIPS</p> +</td> +<td width="10%"> + +<p>0x1</p> +</td> +<td width="48%"> + +<p>/* strips/tiles info */</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_CURVES</p> +</td> +<td width="10%"> + +<p>0x2</p> +</td> +<td width="48%"> + +<p>/* color/gray response curves */</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_COLORMAP</p> +</td> +<td width="10%"> + +<p>0x4</p> +</td> +<td width="48%"> + +<p>/* colormap */</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_JPEGQTABLES</p> +</td> +<td width="10%"> + +<p>0x100</p> +</td> +<td width="48%"> + +<p>/* JPEG Q matrices */</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_JPEGACTABLES</p> +</td> +<td width="10%"> + +<p>0x200</p> +</td> +<td width="48%"> + +<p>/* JPEG AC tables */</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_JPEGDCTABLES</p> +</td> +<td width="10%"> + +<p>0x200</p> +</td> +<td width="48%"> + +<p>/* JPEG DC tables */</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>In C++ the <i>flags</i> parameter defaults to 0.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>libtiff</i>(3TIFF), <i>TIFFOpen</i>(3TIFF), +<i>TIFFReadDirectory</i>(3TIFF), +<i>TIFFSetDirectory</i>(3TIFF)</p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFRGBAImage.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFRGBAImage.3tiff.html new file mode 100644 index 0000000000..7bbee0f25e --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFRGBAImage.3tiff.html @@ -0,0 +1,319 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:16 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFRGBAImage</title> +</head> +<body> + +<h1 align=center>TIFFRGBAImage</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#ALTERNATE RASTER FORMATS">ALTERNATE RASTER FORMATS</a><br> +<a href="#SIMULTANEOUS RASTER STORE AND DISPLAY">SIMULTANEOUS RASTER STORE AND DISPLAY</a><br> +<a href="#SUPPORTING ADDITIONAL TIFF FORMATS">SUPPORTING ADDITIONAL TIFF FORMATS</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFRGBAImageOK, TIFFRGBAImageBegin, TIFFRGBAImageGet, +TIFFRGBAImageEnd − read and decode an image into a +raster</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>typedef unsigned char TIFFRGBValue; typedef struct +_TIFFRGBAImage TIFFRGBAImage;</b></p> +<!-- INDENTATION --> +<p><b>int TIFFRGBAImageOK(TIFF *</b><i>tif</i><b>, char</b> +<i>emsg[1024]</i><b>)<br> +int TIFFRGBAImageBegin(TIFFRGBAImage *</b><i>img</i><b>, +TIFF*</b> <i>tif</i><b>, int</b> <i>stopOnError</i><b>, +char</b> <i>emsg[1024]</i><b>)<br> +int TIFFRGBAImageGet(TIFFRGBAImage *</b><i>img</i><b>, +uint32*</b> <i>raster</i><b>, uint32</b> <i>width</i> <b>, +uint32</b> <i>height</i><b>)<br> +void TIFFRGBAImageEnd(TIFFRGBAImage +*</b><i>img</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The routines described here provide a high-level +interface through which <small>TIFF</small> images may be +read into memory. Images may be strip- or tile-based and +have a variety of different characteristics: bits/sample, +samples/pixel, photometric, etc. Decoding state is +encapsulated in a <i>TIFFRGBAImage</i> structure making it +possible to capture state for multiple images and quickly +switch between them. The target raster format can be +customized to a particular application’s needs by +installing custom routines that manipulate image data +according to application requirements.</p> +<!-- INDENTATION --> +<p>The default usage for these routines is: check if an +image can be processed using <i>TIFFRGBAImageOK</i>, +construct a decoder state block using +<i>TIFFRGBAImageBegin</i>, read and decode an image into a +target raster using <i>TIFFRGBAImageGet</i>, and then +release resources using <i>TIFFRGBAImageEnd</i>. +<i>TIFFRGBAImageGet</i> can be called multiple times to +decode an image using different state parameters. If +multiple images are to be displayed and there is not enough +space for each of the decoded rasters, multiple state blocks +can be managed and then calls can be made to +<i>TIFFRGBAImageGet</i> as needed to display an image.</p> +<!-- INDENTATION --> +<p>The generated raster is assumed to be an array of +<i>width</i> times <i>height</i> 32-bit entries, where +<i>width</i> must be less than or equal to the width of the +image (<i>height</i> may be any non-zero size). If the +raster dimensions are smaller than the image, the image data +is cropped to the raster bounds. If the raster height is +greater than that of the image, then the image data are +placed in the lower part of the raster. (Note that the +raster is assume to be organized such that the pixel at +location (<i>x</i>,<i>y</i>) is +<i>raster</i>[<i>y</i>*<i>width</i>+<i>x</i>]; with the +raster origin in the <b>lower-left</b> hand corner.)</p> +<!-- INDENTATION --> +<p>Raster pixels are 8-bit packed red, green, blue, alpha +samples. The macros <i>TIFFGetR</i>, <i>TIFFGetG</i>, +<i>TIFFGetB</i>, and <i>TIFFGetA</i> should be used to +access individual samples. Images without Associated Alpha +matting information have a constant Alpha of 1.0 (255).</p> +<!-- INDENTATION --> +<p><i>TIFFRGBAImageGet</i> converts non-8-bit images by +scaling sample values. Palette, grayscale, bilevel, +<small>CMYK</small> , and YCbCr images are converted to +<small>RGB</small> transparently. Raster pixels are returned +uncorrected by any colorimetry information present in the +directory.</p> +<!-- INDENTATION --> +<p>The parameter <i>stopOnError</i> specifies how to act if +an error is encountered while reading the image. If +<i>stopOnError</i> is non-zero, then an error will terminate +the operation; otherwise <i>TIFFRGBAImageGet</i> will +continue processing data until all the possible data in the +image have been requested.</p> +</td> +</table> +<a name="ALTERNATE RASTER FORMATS"></a> +<h2>ALTERNATE RASTER FORMATS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>To use the core support for reading and processing +<small>TIFF</small> images, but write the resulting raster +data in a different format one need only override the +‘‘<i>put methods</i>’’ used to store +raster data. These methods are are defined in the +<i>TIFFRGBAImage</i> structure and initially setup by +<i>TIFFRGBAImageBegin</i> to point to routines that pack +raster data in the default <small>ABGR</small> pixel format. +Two different routines are used according to the physical +organization of the image data in the file: +<i>PlanarConfiguration</i>=1 (packed samples), and +<i>PlanarConfiguration</i>=2 (separated samples). Note that +this mechanism can be used to transform the data before +storing it in the raster. For example one can convert data +to colormap indices for display on a colormap display.</p> +</td> +</table> +<a name="SIMULTANEOUS RASTER STORE AND DISPLAY"></a> +<h2>SIMULTANEOUS RASTER STORE AND DISPLAY</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>It is simple to display an image as it is being read into +memory by overriding the put methods as described above for +supporting alternate raster formats. Simply keep a reference +to the default put methods setup by +<i>TIFFRGBAImageBegin</i> and then invoke them before or +after each display operation. For example, the +<i>tiffgt</i>(1) utility uses the following put method to +update the display as the raster is being filled:</p> +<!-- INDENTATION --> +<pre>static void +putContigAndDraw(TIFFRGBAImage* img, uint32* raster, + uint32 x, uint32 y, uint32 w, uint32 h, + int32 fromskew, int32 toskew, + unsigned char* cp) +{ + (*putContig)(img, raster, x, y, w, h, fromskew, toskew, cp); + if (x+w == width) { + w = width; + if (img->orientation == ORIENTATION_TOPLEFT) + lrectwrite(0, y-(h-1), w-1, y, raster-x-(h-1)*w); + else + lrectwrite(0, y, w-1, y+h-1, raster); + } +} +</pre> +<!-- INDENTATION --> +<p>(the original routine provided by the library is saved in +the variable <i>putContig</i>.)</p> +</td> +</table> +<a name="SUPPORTING ADDITIONAL TIFF FORMATS"></a> +<h2>SUPPORTING ADDITIONAL TIFF FORMATS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The <i>TIFFRGBAImage</i> routines support the most +commonly encountered flavors of <small>TIFF.</small> It is +possible to extend this support by overriding the +‘‘<i>get method</i>’’ invoked by +<i>TIFFRGBAImageGet</i> to read <small>TIFF</small> image +data. Details of doing this are a bit involved, it is best +to make a copy of an existing get method and modify it to +suit the needs of an application.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Samples must be either 1, 2, 4, 8, or 16 bits. +Colorimetric samples/pixel must be either 1, 3, or 4 (i.e. +<i>SamplesPerPixel</i> minus <i>ExtraSamples</i>).</p> +<!-- INDENTATION --> +<p>Palette image colormaps that appear to be incorrectly +written as 8-bit values are automatically scaled to +16-bits.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All routines return 1 if the operation was successful. +Otherwise, 0 is returned if an error was encountered and +<i>stopOnError</i> is zero.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-bit pictures</b>. The image +had <i>BitsPerSample</i> other than 1, 2, 4, 8, or 16.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-channel images</b>. The image +had <i>SamplesPerPixel</i> other than 1, 3, or 4.</p> +<!-- INDENTATION --> +<p><b>Missing needed "PhotometricInterpretation" +tag</b>. The image did not have a tag that describes how to +display the data.</p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +RGB</b>. The image was missing a tag that describes how to +display it, but because it has 3 or 4 samples/pixel, it is +assumed to be <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +min-is-black</b>. The image was missing a tag that describes +how to display it, but because it has 1 sample/pixel, it is +assumed to be a grayscale or bilevel image.</p> +<!-- INDENTATION --> +<p><b>No space for photometric conversion table</b>. There +was insufficient memory for a table used to convert image +samples to 8-bit <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>Missing required "Colormap" tag</b>. A +Palette image did not have a required <i>Colormap</i> +tag.</p> +<!-- INDENTATION --> +<p><b>No space for tile buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>No space for strip buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>Can not handle format</b>. The image has a format +(combination of <i>BitsPerSample</i>, +<i>SamplesPerPixel</i>, and +<i>PhotometricInterpretation</i>) that can not be +handled.</p> +<!-- INDENTATION --> +<p><b>No space for B&W mapping table</b>. There was +insufficient memory to allocate a table used to map +grayscale data to <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No space for Palette mapping table</b>. There was +insufficient memory to allocate a table used to map data to +8-bit <small>RGB.</small></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFReadRGBAImage</b>(3TIFF), +<b>TIFFReadRGBAImageOriented</b>(3TIFF), +<b>TIFFReadRGBAStrip</b>(3TIFF), +<b>TIFFReadRGBATile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadDirectory.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadDirectory.3tiff.html new file mode 100644 index 0000000000..5bb828efa7 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadDirectory.3tiff.html @@ -0,0 +1,218 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:16 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadDirectory</title> +</head> +<body> + +<h1 align=center>TIFFReadDirectory</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>TIFFReadDirectory − get the contents of the +next directory in an open</big> TIFF <big>file</big></p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>#include <tiffio.h></b></big></p> +<!-- INDENTATION --> +<p><big><b>int TIFFReadDirectory(TIFF +*</b><i>tif</i><b>)</b></big></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Read the next directory in the specified file and +make it the current directory. Applications only need to +call <i>TIFFReadDirectory</i> to read multiple subfiles in a +single</big> TIFF <big>file— the first directory in a +file is automatically read when <i>TIFFOpen</i> is +called.</big></p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>If the library is compiled with</big> +STRIPCHOP_SUPPORT <big>enabled, then images that have a +single uncompressed strip or tile of data are automatically +treated as if they were made up of multiple strips or tiles +of approximately 8 kilobytes each. This operation is done +only in-memory; it does not alter the contents of the file. +However, the construction of the ‘‘chopped +strips’’ is visible to the application through +the number of strips [tiles] returned by +<i>TIFFNumberOfStrips</i> +[<i>TIFFNumberOfTiles</i>].</big></p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>If the next directory was successfully read, 1 is +returned. Otherwise, 0 is returned if an error was +encountered, or if there are no more directories to be +read.</big></p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine. All warning messages are +directed to the <i>TIFFWarning</i>(3TIFF) routine.</big></p> +<!-- INDENTATION --> +<p><big><b>Seek error accessing TIFF directory</b>. An error +occurred while positioning to the location of the +directory.</big></p> +<!-- INDENTATION --> +<p><big><b>Wrong data type %d for field "%s"</b>. +The tag entry in the directory had an incorrect data type. +For example, an <i>ImageDescription</i> tag with a</big> +SHORT <big>data type.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing required "%s" +field</b>. The specified tag is required to be present by +the</big> TIFF <big>5.0 specification, but is missing. The +directory is (usually) unusable.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: Rational with zero denominator</b>. A +directory tag has a</big> RATIONAL <big>value whose +denominator is zero.</big></p> +<!-- INDENTATION --> +<p><big><b>Incorrect count %d for field "%s" (%lu, +expecting %lu); tag ignored</b>. The specified tag’s +count field is bad. For example, a count other than 1 for a +<i>SubFileType</i> tag.</big></p> +<!-- INDENTATION --> +<p><big><b>Cannot handle different per-sample values for +field "%s"</b>. The tag has <i>SamplesPerPixel</i> +values and they are not all the same; e.g. +<i>BitsPerSample</i>. The library is unable to handle images +of this sort.</big></p> +<!-- INDENTATION --> +<p><big><b>Count mismatch for field "%s"; +expecting %d, got %d</b>. The count field in a tag does not +agree with the number expected by the library. This should +never happen, so if it does, the library refuses to read the +directory.</big></p> +<!-- INDENTATION --> +<p><big><b>Invalid TIFF directory; tags are not sorted in +ascending order</b>. The directory tags are not properly +sorted as specified in the</big> TIFF <big>5.0 +specification. This error is not fatal.</big></p> +<!-- INDENTATION --> +<p><big><b>Ignoring unknown field with tag %d (0x%x)</b>. An +unknown tag was encountered in the directory; the library +ignores all such tags.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing requred +"ImageLength" field</b>. The image violates the +specification by not having a necessary field. There is no +way for the library to recover from this error.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing requred +"PlanarConfig" field</b>. The image violates the +specification by not having a necessary field. There is no +way for the library to recover from this error.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing requred +"StripOffsets" field</b>. The image has multiple +strips, but is missing the tag that specifies the file +offset to each strip of data. There is no way for the +library to recover from this error.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing requred +"TileOffsets" field</b>. The image has multiple +tiles, but is missing the tag that specifies the file offset +to each tile of data. There is no way for the library to +recover from this error.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing required +"StripByteCounts" field</b>. The image has +multiple strips, but is missing the tag that specifies the +size of each strip of data. There is no way for the library +to recover from this error.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing required +"StripByteCounts" field, calculating from +imagelength</b>. The image violates the specification by not +having a necessary field. However, when the image is +comprised of only one strip or tile, the library will +estimate the missing value based on the file size.</big></p> +<!-- INDENTATION --> +<p><big><b>Bogus "StripByteCounts" field, ignoring +and calculating from imagelength</b>. Certain vendors +violate the specification by writing zero for the +StripByteCounts tag when they want to leave the value +unspecified. If the image has a single strip, the library +will estimate the missing value based on the file +size.</big></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteDirectory</b>(3TIFF), +<b>TIFFSetDirectory</b>(3TIFF), +<b>TIFFSetSubDirectory</b>(3TIFF), +<b>libtiff</b>(3TIFF)</big></p> +<!-- INDENTATION --> +<p><big>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></big></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadEncodedStrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadEncodedStrip.3tiff.html new file mode 100644 index 0000000000..39d411d765 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadEncodedStrip.3tiff.html @@ -0,0 +1,133 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:16 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadEncodedStrip</title> +</head> +<body> + +<h1 align=center>TIFFReadEncodedStrip</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>TIFFReadEncodedStrip − read and decode a strip +of data from an open</big> TIFF <big>file</big></p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>#include <tiffio.h></b></big></p> +<!-- INDENTATION --> +<p><big><b>tsize_t TIFFReadEncodedStrip(TIFF +*</b><i>tif</i><b>, tstrip_t</b> <i>strip</i><b>, +tdata_t</b> <i>buf</i><b>, tsize_t</b> +<i>size</i><b>)</b></big></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Read the specified strip of data and place up to +<i>size</i> bytes of decompressed information in the (user +supplied) data buffer.</big></p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The value of <i>strip</i> is a ‘‘raw +strip number.’’ That is, the caller must take +into account whether or not the data are organized in +separate planes (<i>PlanarConfiguration</i>=2). To read a +full strip of data the data buffer should typically be at +least as large as the number returned by +<b>TIFFStripSize</b>(3TIFF). If the -1 passed in <i>size</i> +parameter, the whole strip will be read. You should be sure +you have enough space allocated for the buffer.</big></p> +<!-- INDENTATION --> +<p><big>The library attempts to hide bit- and byte-ordering +differences between the image and the native machine by +converting data to the native machine order. Bit reversal is +done if the <i>FillOrder</i> tag is opposite to the native +machine bit order. 16- and 32-bit samples are automatically +byte-swapped if the file was written with a byte order +opposite to the native machine byte order,</big></p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The actual number of bytes of data that were placed +in <i>buf</i> is returned; <i>TIFFReadEncodedStrip</i> +returns −1 if an error was encountered.</big></p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</big></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFOpen</b>(3TIFF), +<b>TIFFReadRawStrip</b>(3TIFF), +<b>TIFFReadScanline</b>(3TIFF), +<b>libtiff</b>(3TIFF)</big></p> +<!-- INDENTATION --> +<p><big>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></big></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadEncodedTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadEncodedTile.3tiff.html new file mode 100644 index 0000000000..752b1ea3e6 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadEncodedTile.3tiff.html @@ -0,0 +1,130 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:16 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadEncodedTile</title> +</head> +<body> + +<h1 align=center>TIFFReadEncodedTile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadEncodedTile − read and decode a tile of +data from an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFReadEncodedTile(TIFF *</b><i>tif</i><b>, +ttile_t</b> <i>tile</i><b>, tdata_t</b> <i>buf</i><b>, +tsize_t</b> <i>size</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Read the specified tile of data and place up to +<i>size</i> bytes of decompressed information in the (user +supplied) data buffer.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The value of <i>tile</i> is a ‘‘raw tile +number.’’ That is, the caller must take into +account whether or not the data are organized in separate +planes (<i>PlanarConfiguration</i>=2). +<i>TIFFComputeTile</i> automatically does this when +converting an (x,y,z,sample) coordinate quadruple to a tile +number. To read a full tile of data the data buffer should +be at least as large as the value returned by +<i>TIFFTileSize</i>.</p> +<!-- INDENTATION --> +<p>The library attempts to hide bit- and byte-ordering +differences between the image and the native machine by +converting data to the native machine order. Bit reversal is +done if the <i>FillOrder</i> tag is opposite to the native +machine bit order. 16- and 32-bit samples are automatically +byte-swapped if the file was written with a byte order +opposite to the native machine byte order,</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The actual number of bytes of data that were placed in +<i>buf</i> is returned; <i>TIFFReadEncodedTile</i> returns +−1 if an error was encountered.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFReadRawTile</b>(3TIFF), +<b>TIFFReadTile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadRGBAImage.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadRGBAImage.3tiff.html new file mode 100644 index 0000000000..165284e50c --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadRGBAImage.3tiff.html @@ -0,0 +1,301 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:16 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadRGBAImage</title> +</head> +<body> + +<h1 align=center>TIFFReadRGBAImage</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadRGBAImage, TIFFReadRGBAImageOriented − read +and decode an image into a fixed-format raster</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>#define TIFFGetR(abgr) ((abgr) & 0xff)<br> +#define TIFFGetG(abgr) (((abgr) >> 8) & 0xff)<br> +#define TIFFGetB(abgr) (((abgr) >> 16) & 0xff)<br> +#define TIFFGetA(abgr) (((abgr) >> 24) & +0xff)</b></p> +<!-- INDENTATION --> +<p><b>int TIFFReadRGBAImage(TIFF *</b><i>tif</i><b>, +uint32</b> <i>width</i><b>, uint32</b> <i>height</i><b>, +uint32 *</b><i>raster</i><b>, int</b> +<i>stopOnError</i><b>)<br> +int TIFFReadRGBAImageOriented(TIFF *</b><i>tif</i><b>, +uint32</b> <i>width</i><b>, uint32</b> <i>height</i><b>, +uint32 *</b><i>raster</i><b>, int</b> <i>orientation</i><b>, +int</b> <i>stopOnError</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFReadRGBAImage</i> reads a strip- or tile-based +image into memory, storing the result in the user supplied +<i>raster</i>. The raster is assumed to be an array of +<i>width</i> times <i>height</i> 32-bit entries, where +<i>width</i> must be less than or equal to the width of the +image (<i>height</i> may be any non-zero size). If the +raster dimensions are smaller than the image, the image data +is cropped to the raster bounds. If the raster height is +greater than that of the image, then the image data are +placed in the lower part of the raster. (Note that the +raster is assume to be organized such that the pixel at +location (<i>x</i>,<i>y</i>) is +<i>raster</i>[<i>y</i>*<i>width</i>+<i>x</i>]; with the +raster origin in the lower-left hand corner.)</p> +<!-- INDENTATION --> +<p><i>TIFFReadRGBAImageOriented</i> works like +<i>TIFFReadRGBAImage</i> with except of that user can +specify the raster origin position with the +<i>orientation</i> parameter. Four orientations +supported:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ORIENTATION_TOPLEFT</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>origin in top-left corner,</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ORIENTATION_TOPRIGHT</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>origin in top-right corner,</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ORIENTATION_BOTLEFT</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>origin in bottom-left corner and</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ORIENTATION_BOTRIGHT</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>origin in bottom-right corner.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>If you choose <b>ORIENTATION_BOTLEFT</b> result will be +the same as returned by the <i>TIFFReadRGBAImage.</i></p> +<!-- INDENTATION --> +<p>Raster pixels are 8-bit packed red, green, blue, alpha +samples. The macros <i>TIFFGetR</i>, <i>TIFFGetG</i>, +<i>TIFFGetB</i>, and <i>TIFFGetA</i> should be used to +access individual samples. Images without Associated Alpha +matting information have a constant Alpha of 1.0 (255).</p> +<!-- INDENTATION --> +<p><i>TIFFReadRGBAImage</i> converts non-8-bit images by +scaling sample values. Palette, grayscale, bilevel, +<small>CMYK</small> , and YCbCr images are converted to +<small>RGB</small> transparently. Raster pixels are returned +uncorrected by any colorimetry information present in the +directory.</p> +<!-- INDENTATION --> +<p>The paramater <i>stopOnError</i> specifies how to act if +an error is encountered while reading the image. If +<i>stopOnError</i> is non-zero, then an error will terminate +the operation; otherwise <i>TIFFReadRGBAImage</i> will +continue processing data until all the possible data in the +image have been requested.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>In C++ the <i>stopOnError</i> parameter defaults to +0.</p> +<!-- INDENTATION --> +<p>Samples must be either 1, 2, 4, 8, or 16 bits. +Colorimetric samples/pixel must be either 1, 3, or 4 (i.e. +<i>SamplesPerPixel</i> minus <i>ExtraSamples</i>).</p> +<!-- INDENTATION --> +<p>Palettte image colormaps that appear to be incorrectly +written as 8-bit values are automatically scaled to +16-bits.</p> +<!-- INDENTATION --> +<p><i>TIFFReadRGBAImage</i> is just a wrapper around the +more general <i>TIFFRGBAImage</i>(3TIFF) facilities.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned if the image was successfully read and +converted. Otherwise, 0 is returned if an error was +encountered and <i>stopOnError</i> is zero.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-bit pictures</b>. The image +had <i>BitsPerSample</i> other than 1, 2, 4, 8, or 16.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-channel images</b>. The image +had <i>SamplesPerPixel</i> other than 1, 3, or 4.</p> +<!-- INDENTATION --> +<p><b>Missing needed "PhotometricInterpretation" +tag</b>. The image did not have a tag that describes how to +display the data.</p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +RGB</b>. The image was missing a tag that describes how to +display it, but because it has 3 or 4 samples/pixel, it is +assumed to be <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +min-is-black</b>. The image was missing a tag that describes +how to display it, but because it has 1 sample/pixel, it is +assumed to be a grayscale or bilevel image.</p> +<!-- INDENTATION --> +<p><b>No space for photometric conversion table</b>. There +was insufficient memory for a table used to convert image +samples to 8-bit <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>Missing required "Colormap" tag</b>. A +Palette image did not have a required <i>Colormap</i> +tag.</p> +<!-- INDENTATION --> +<p><b>No space for tile buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>No space for strip buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>Can not handle format</b>. The image has a format +(combination of <i>BitsPerSample</i>, +<i>SamplesPerPixel</i>, and +<i>PhotometricInterpretation</i>) that +<i>TIFFReadRGBAImage</i> can not handle.</p> +<!-- INDENTATION --> +<p><b>No space for B&W mapping table</b>. There was +insufficient memory to allocate a table used to map +grayscale data to <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No space for Palette mapping table</b>. There was +insufficient memory to allocate a table used to map data to +8-bit <small>RGB.</small></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFRGBAImage</b>(3TIFF), +<b>TIFFReadRGBAStrip</b>(3TIFF), +<b>TIFFReadRGBATile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadRGBAStrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadRGBAStrip.3tiff.html new file mode 100644 index 0000000000..df09f649fa --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadRGBAStrip.3tiff.html @@ -0,0 +1,208 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:16 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadRGBAStrip</title> +</head> +<body> + +<h1 align=center>TIFFReadRGBAStrip</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadRGBAStrip − read and decode an image strip +into a fixed-format raster</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>#define TIFFGetR(abgr) ((abgr) & 0xff)<br> +#define TIFFGetG(abgr) (((abgr) >> 8) & 0xff)<br> +#define TIFFGetB(abgr) (((abgr) >> 16) & 0xff)<br> +#define TIFFGetA(abgr) (((abgr) >> 24) & +0xff)</b></p> +<!-- INDENTATION --> +<p><b>int TIFFReadRGBAStrip(TIFF *</b><i>tif</i><b>, +uint32</b> <i>row</i><b>, uint32 +*</b><i>raster</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFReadRGBAStrip</i> reads a single strip of a +strip-based image into memory, storing the result in the +user supplied RGBA <i>raster</i>. The raster is assumed to +be an array of width times rowsperstrip 32-bit entries, +where width is the width of the image (TIFFTAG_IMAGEWIDTH) +and rowsperstrip is the maximum lines in a strip +(TIFFTAG_ROWSPERSTRIP).</p> +<!-- INDENTATION --> +<p>The <i>row</i> value should be the row of the first row +in the strip (strip * rowsperstrip, zero based).</p> +<!-- INDENTATION --> +<p>Note that the raster is assume to be organized such that +the pixel at location (<i>x</i>,<i>y</i>) is +<i>raster</i>[<i>y</i>*<i>width</i>+<i>x</i>]; with the +raster origin in the <i>lower-left hand corner</i> of the +strip. That is bottom to top organization. When reading a +partial last strip in the file the last line of the image +will begin at the beginning of the buffer.</p> +<!-- INDENTATION --> +<p>Raster pixels are 8-bit packed red, green, blue, alpha +samples. The macros <i>TIFFGetR</i>, <i>TIFFGetG</i>, +<i>TIFFGetB</i>, and <i>TIFFGetA</i> should be used to +access individual samples. Images without Associated Alpha +matting information have a constant Alpha of 1.0 (255).</p> +<!-- INDENTATION --> +<p>See the <i>TIFFRGBAImage</i>(3TIFF) page for more details +on how various image types are converted to RGBA values.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Samples must be either 1, 2, 4, 8, or 16 bits. +Colorimetric samples/pixel must be either 1, 3, or 4 (i.e. +<i>SamplesPerPixel</i> minus <i>ExtraSamples</i>).</p> +<!-- INDENTATION --> +<p>Palette image colormaps that appear to be incorrectly +written as 8-bit values are automatically scaled to +16-bits.</p> +<!-- INDENTATION --> +<p><i>TIFFReadRGBAStrip</i> is just a wrapper around the +more general <i>TIFFRGBAImage</i>(3TIFF) facilities. +It’s main advantage over the similar +<i>TIFFReadRGBAImage()</i> function is that for large images +a single buffer capable of holding the whole image +doesn’t need to be allocated, only enough for one +strip. The <i>TIFFReadRGBATile()</i> function does a similar +operation for tiled images.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned if the image was successfully read and +converted. Otherwise, 0 is returned if an error was +encountered.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-bit pictures</b>. The image +had <i>BitsPerSample</i> other than 1, 2, 4, 8, or 16.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-channel images</b>. The image +had <i>SamplesPerPixel</i> other than 1, 3, or 4.</p> +<!-- INDENTATION --> +<p><b>Missing needed "PhotometricInterpretation" +tag</b>. The image did not have a tag that describes how to +display the data.</p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +RGB</b>. The image was missing a tag that describes how to +display it, but because it has 3 or 4 samples/pixel, it is +assumed to be <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +min-is-black</b>. The image was missing a tag that describes +how to display it, but because it has 1 sample/pixel, it is +assumed to be a grayscale or bilevel image.</p> +<!-- INDENTATION --> +<p><b>No space for photometric conversion table</b>. There +was insufficient memory for a table used to convert image +samples to 8-bit <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>Missing required "Colormap" tag</b>. A +Palette image did not have a required <i>Colormap</i> +tag.</p> +<!-- INDENTATION --> +<p><b>No space for tile buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>No space for strip buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>Can not handle format</b>. The image has a format +(combination of <i>BitsPerSample</i>, +<i>SamplesPerPixel</i>, and +<i>PhotometricInterpretation</i>) that +<i>TIFFReadRGBAImage</i> can not handle.</p> +<!-- INDENTATION --> +<p><b>No space for B&W mapping table</b>. There was +insufficient memory to allocate a table used to map +grayscale data to <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No space for Palette mapping table</b>. There was +insufficient memory to allocate a table used to map data to +8-bit <small>RGB.</small></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFRGBAImage</b>(3TIFF), +<b>TIFFReadRGBAImage</b>(3TIFF), +<b>TIFFReadRGBATile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadRGBATile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadRGBATile.3tiff.html new file mode 100644 index 0000000000..ed67b83278 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadRGBATile.3tiff.html @@ -0,0 +1,261 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:16 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadRGBATile</title> +</head> +<body> + +<h1 align=center>TIFFReadRGBATile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadRGBATile − read and decode an image tile +into a fixed-format raster</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="-2%"> + +<p><b>#define TIFFGetR(abgr)</b></p> +</td> +<td width="25%"></td> +<td width="6%"></td> +<td width="61%"> + +<p><b>((abgr) & 0xff)</b></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="-2%"> + +<p><b>#define TIFFGetG(abgr)</b></p> +</td> +<td width="25%"></td> +<td width="6%"></td> +<td width="61%"> + +<p><b>(((abgr) >> 8) & 0xff)</b></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="-2%"> + +<p><b>#define TIFFGetB(abgr)</b></p> +</td> +<td width="25%"></td> +<td width="6%"></td> +<td width="61%"> + +<p><b>(((abgr) >> 16) & 0xff)</b></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="-2%"> + +<p><b>#define TIFFGetA(abgr)</b></p> +</td> +<td width="25%"></td> +<td width="6%"></td> +<td width="61%"> + +<p><b>(((abgr) >> 24) & 0xff)</b></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>int TIFFReadRGBATile(TIFF *</b><i>tif</i><b>, +uint32</b> <i>x</i><b>, uint32</b> <i>y</i><b>, uint32 +*</b><i>raster</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFReadRGBATile</i> reads a single tile of a +tile-based image into memory, storing the result in the user +supplied RGBA <i>raster</i>. The raster is assumed to be an +array of width times length 32-bit entries, where width is +the width of a tile (TIFFTAG_TILEWIDTH) and length is the +height of a tile (TIFFTAG_TILELENGTH).</p> +<!-- INDENTATION --> +<p>The <i>x</i> and <i>y</i> values are the offsets from the +top left corner to the top left corner of the tile to be +read. They must be an exact multiple of the tile width and +length.</p> +<!-- INDENTATION --> +<p>Note that the raster is assume to be organized such that +the pixel at location (<i>x</i>,<i>y</i>) is +<i>raster</i>[<i>y</i>*<i>width</i>+<i>x</i>]; with the +raster origin in the <i>lower-left hand corner</i> of the +tile. That is bottom to top organization. Edge tiles which +partly fall off the image will be filled out with +appropriate zeroed areas.</p> +<!-- INDENTATION --> +<p>Raster pixels are 8-bit packed red, green, blue, alpha +samples. The macros <i>TIFFGetR</i>, <i>TIFFGetG</i>, +<i>TIFFGetB</i>, and <i>TIFFGetA</i> should be used to +access individual samples. Images without Associated Alpha +matting information have a constant Alpha of 1.0 (255).</p> +<!-- INDENTATION --> +<p>See the <i>TIFFRGBAImage</i>(3TIFF) page for more details +on how various image types are converted to RGBA values.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Samples must be either 1, 2, 4, 8, or 16 bits. +Colorimetric samples/pixel must be either 1, 3, or 4 (i.e. +<i>SamplesPerPixel</i> minus <i>ExtraSamples</i>).</p> +<!-- INDENTATION --> +<p>Palette image colormaps that appear to be incorrectly +written as 8-bit values are automatically scaled to +16-bits.</p> +<!-- INDENTATION --> +<p><i>TIFFReadRGBATile</i> is just a wrapper around the more +general <i>TIFFRGBAImage</i>(3TIFF) facilities. It’s +main advantage over the similar <i>TIFFReadRGBAImage()</i> +function is that for large images a single buffer capable of +holding the whole image doesn’t need to be allocated, +only enough for one tile. The <i>TIFFReadRGBAStrip()</i> +function does a similar operation for stripped images.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned if the image was successfully read and +converted. Otherwise, 0 is returned if an error was +encountered.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-bit pictures</b>. The image +had <i>BitsPerSample</i> other than 1, 2, 4, 8, or 16.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-channel images</b>. The image +had <i>SamplesPerPixel</i> other than 1, 3, or 4.</p> +<!-- INDENTATION --> +<p><b>Missing needed "PhotometricInterpretation" +tag</b>. The image did not have a tag that describes how to +display the data.</p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +RGB</b>. The image was missing a tag that describes how to +display it, but because it has 3 or 4 samples/pixel, it is +assumed to be <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +min-is-black</b>. The image was missing a tag that describes +how to display it, but because it has 1 sample/pixel, it is +assumed to be a grayscale or bilevel image.</p> +<!-- INDENTATION --> +<p><b>No space for photometric conversion table</b>. There +was insufficient memory for a table used to convert image +samples to 8-bit <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>Missing required "Colormap" tag</b>. A +Palette image did not have a required <i>Colormap</i> +tag.</p> +<!-- INDENTATION --> +<p><b>No space for tile buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>No space for strip buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>Can not handle format</b>. The image has a format +(combination of <i>BitsPerSample</i>, +<i>SamplesPerPixel</i>, and +<i>PhotometricInterpretation</i>) that +<i>TIFFReadRGBAImage</i> can not handle.</p> +<!-- INDENTATION --> +<p><b>No space for B&W mapping table</b>. There was +insufficient memory to allocate a table used to map +grayscale data to <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No space for Palette mapping table</b>. There was +insufficient memory to allocate a table used to map data to +8-bit <small>RGB.</small></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFRGBAImage</b>(3TIFF), +<b>TIFFReadRGBAImage</b>(3TIFF), +<b>TIFFReadRGBAStrip</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadRawStrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadRawStrip.3tiff.html new file mode 100644 index 0000000000..bd14f723bc --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadRawStrip.3tiff.html @@ -0,0 +1,109 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:16 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadRawStrip</title> +</head> +<body> + +<h1 align=center>TIFFReadRawStrip</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadRawStrip − return the undecoded contents of +a strip of data from an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFReadRawStrip(TIFF *</b><i>tif</i><b>, +tstrip_t</b> <i>strip</i><b>, tdata_t</b> <i>buf</i><b>, +tsize_t</b> <i>size</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Read the contents of the specified strip into the (user +supplied) data buffer. Note that the value of <i>strip</i> +is a ‘‘raw strip number.’’ That is, +the caller must take into account whether or not the data is +organized in separate planes (<i>PlanarConfiguration</i>=2). +To read a full strip of data the data buffer should +typically be at least as large as the number returned by +<i>TIFFStripSize</i>.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The actual number of bytes of data that were placed in +<i>buf</i> is returned; <i>TIFFReadEncodedStrip</i> returns +−1 if an error was encountered.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFReadEncodedStrip</b>(3TIFF), +<b>TIFFReadScanline</b>(3TIFF), <b>TIFFStripSize</b>(3TIFF), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadRawTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadRawTile.3tiff.html new file mode 100644 index 0000000000..bae2b46cd6 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadRawTile.3tiff.html @@ -0,0 +1,111 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:16 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadRawTile</title> +</head> +<body> + +<h1 align=center>TIFFReadRawTile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadRawTile − return an undecoded tile of data +from an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFReadRawTile(TIFF *</b><i>tif</i><b>, +ttile_t</b> <i>tile</i><b>, tdata_t</b> <i>buf</i><b>, +tsize_t</b> <i>size</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Read the contents of the specified tile into the (user +supplied) data buffer. Note that the value of <i>tile</i> is +a ‘‘raw tile number.’’ That is, the +caller must take into account whether or not the data is +organized in separate planes (<i>PlanarConfiguration</i>=2). +<i>TIFFComputeTile</i> automatically does this when +converting an (x,y,z,sample) coordinate quadruple to a tile +number. To read a full tile of data the data buffer should +typically be at least as large as the value returned by +<i>TIFFTileSize</i>.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The actual number of bytes of data that were placed in +<i>buf</i> is returned; <i>TIFFReadEncodedTile</i> returns +−1 if an error was encountered.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFReadEncodedTile</b>(3TIFF), +<b>TIFFReadTile</b>(3TIFF), <b>TIFFTileSize</b>(3TIFF), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadScanline.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadScanline.3tiff.html new file mode 100644 index 0000000000..423645cc96 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadScanline.3tiff.html @@ -0,0 +1,157 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:16 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadScanline</title> +</head> +<body> + +<h1 align=center>TIFFReadScanline</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadScanline − read and decode a scanline of +data from an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFReadScanline(TIFF *</b><i>tif</i><b>, +tdata_t</b> <i>buf</i><b>, uint32</b> <i>row</i><b>, +tsample_t</b> <i>sample</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Read the data for the specified row into the (user +supplied) data buffer <i>buf</i>. The data are returned +decompressed and, in the native byte- and bit-ordering, but +are otherwise packed (see further below). The buffer must be +large enough to hold an entire scanline of data. +Applications should call the routine <i>TIFFScanlineSize</i> +to find out the size (in bytes) of a scanline buffer. The +<i>row</i> parameter is always used by +<i>TIFFReadScanline</i>; the <i>sample</i> parameter is used +only if data are organized in separate planes +(<i>PlanarConfiguration</i>=2).</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The library attempts to hide bit- and byte-ordering +differences between the image and the native machine by +converting data to the native machine order. Bit reversal is +done if the <i>FillOrder</i> tag is opposite to the native +machine bit order. 16- and 32-bit samples are automatically +byte-swapped if the file was written with a byte order +opposite to the native machine byte order,</p> +<!-- INDENTATION --> +<p>In C++ the <i>sample</i> parameter defaults to 0.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFReadScanline</i> returns −1 if it detects an +error; otherwise 1 is returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Compression algorithm does not support random +access</b>. Data was requested in a non-sequential order +from a file that uses a compression algorithm and that has +<i>RowsPerStrip</i> greater than one. That is, data in the +image is stored in a compressed form, and with multiple rows +packed into a strip. In this case, the library does not +support random access to the data. The data should either be +accessed sequentially, or the file should be converted so +that each strip is made up of one row of data.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Reading subsampled YCbCR data does not work correctly +because, for <i>PlanarConfiguration</i>=2 the size of a +scanline is not calculated on a per-sample basis, and for +<i>PlanarConfiguration</i>=1 the library does not unpack the +block-interleaved samples; use the strip- and tile-based +interfaces to read these formats.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFReadEncodedStrip</b>(3TIFF), +<b>TIFFReadRawStrip</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadTile.3tiff.html new file mode 100644 index 0000000000..ff726b49d2 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadTile.3tiff.html @@ -0,0 +1,133 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:16 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadTile</title> +</head> +<body> + +<h1 align=center>TIFFReadTile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadTile − read and decode a tile of data from +an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFReadTile(TIFF *</b><i>tif</i><b>, +tdata_t</b> <i>buf</i><b>, uint32</b> <i>x</i><b>, +uint32</b> <i>y</i><b>, uint32</b> <i>z</i><b>, +tsample_t</b> <i>sample</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Return the data for the tile <i>containing</i> the +specified coordinates. The data placed in <i>buf</i> are +returned decompressed and, typically, in the native byte- +and bit-ordering, but are otherwise packed (see further +below). The buffer must be large enough to hold an entire +tile of data. Applications should call the routine +<i>TIFFTileSize</i> to find out the size (in bytes) of a +tile buffer. The <i>x</i> and <i>y</i> parameters are always +used by <i>TIFFReadTile</i>. The <i>z</i> parameter is used +if the image is deeper than 1 slice +(<i>ImageDepth</i>>1). The <i>sample</i> parameter is +used only if data are organized in separate planes +(<i>PlanarConfiguration</i>=2).</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The library attempts to hide bit- and byte-ordering +differences between the image and the native machine by +converting data to the native machine order. Bit reversal is +done if the <i>FillOrder</i> tag is opposite to the native +machine bit order. 16- and 32-bit samples are automatically +byte-swapped if the file was written with a byte order +opposite to the native machine byte order,</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFReadTile</i> returns −1 if it detects an +error; otherwise the number of bytes in the decoded tile is +returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFCheckTile</b>(3TIFF), +<b>TIFFComputeTile</b>(3TIFF), <b>TIFFOpen</b>(3TIFF), +<b>TIFFReadEncodedTile</b>(3TIFF), +<b>TIFFReadRawTile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFSetDirectory.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFSetDirectory.3tiff.html new file mode 100644 index 0000000000..a0e5cfc0a1 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFSetDirectory.3tiff.html @@ -0,0 +1,122 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:17 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSetDirectory</title> +</head> +<body> + +<h1 align=center>TIFFSetDirectory</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFSetDirectory, TIFFSetSubDirectory − set the +current directory for an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFSetDirectory(TIFF *</b><i>tif</i><b>, +tdir_t</b> <i>dirnum</i><b>)<br> +int TIFFSetSubDirectory(TIFF *</b><i>tif</i><b>, uint32</b> +<i>diroff</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFSetDirectory</i> changes the current directory and +reads its contents with <i>TIFFReadDirectory</i>. The +parameter <i>dirnum</i> specifies the subfile/directory as +an integer number, with the first directory numbered +zero.</p> +<!-- INDENTATION --> +<p><i>TIFFSetSubDirectory</i> acts like +<i>TIFFSetDirectory</i>, except the directory is specified +as a file offset instead of an index; this is required for +accessing subdirectories linked through a <i>SubIFD</i> +tag.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>On successful return 1 is returned. Otherwise, 0 is +returned if <i>dirnum</i> or <i>diroff</i> specifies a +non-existent directory, or if an error was encountered while +reading the directory’s contents.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>%s: Error fetching directory count</b>. An error was +encountered while reading the ‘‘directory +count’’ field.</p> +<!-- INDENTATION --> +<p><b>%s: Error fetching directory link</b>. An error was +encountered while reading the ‘‘link +value’’ that points to the next directory in a +file.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFCurrentDirectory</i>(3TIFF), +<i>TIFFOpen</i>(3TIFF), <i>TIFFReadDirectory</i>(3TIFF), +<i>TIFFWriteDirectory</i>(3TIFF), <i>libtiff</i>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFSetField.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFSetField.3tiff.html new file mode 100644 index 0000000000..2e70225b33 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFSetField.3tiff.html @@ -0,0 +1,1362 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:17 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSetField</title> +</head> +<body> + +<h1 align=center>TIFFSetField</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFSetField, TIFFVSetField − set the value(s) of a +tag in a <small>TIFF</small> file open for writing</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFSetField(TIFF *</b><i>tif</i><b>, ttag_t</b> +<i>tag</i><b>,</b> <i>...</i><b>)</b></p> +<!-- INDENTATION --> +<p><b>#include <stdarg.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFVSetField(TIFF *</b><i>tif</i><b>, ttag_t</b> +<i>tag</i><b>, va_list</b> <i>ap</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFSetField</i> sets the value of a field or +pseudo-tag in the current directory associated with the open +<small>TIFF</small> file <i>tif</i>. (A <i>pseudo-tag</i> is +a parameter that is used to control the operation of the +<small>TIFF</small> library but whose value is not read or +written to the underlying file.) To set the value of a field +the file must have been previously opened for writing with +<i>TIFFOpen</i>(3TIFF); pseudo-tags can be set whether the +file was opened for reading or writing. The field is +identified by <i>tag</i>, one of the values defined in the +include file <b>tiff.h</b> (see also the table below). The +actual value is specified using a variable argument list, as +prescribed by the <i>stdarg</i>(3) interface (or, on some +machines, the <i>varargs</i>(3) interface.)</p> +<!-- INDENTATION --> +<p><i>TIFFVSetField</i> is functionally equivalent to +<i>TIFFSetField</i> except that it takes a pointer to a +variable argument list. <i>TIFFVSetField</i> is useful for +writing routines that are layered on top of the +functionality provided by <i>TIFFSetField</i>.</p> +<!-- INDENTATION --> +<p>The tags understood by <i>libtiff</i>, the number of +parameter values, and the expected types for the parameter +values are shown below. The data types are: <i>char*</i> is +null-terminated string and corresponds to the +<small>ASCII</small> data type; <i>uint16</i> is an unsigned +16-bit value; <i>uint32</i> is an unsigned 32-bit value; +<i>uint16*</i> is an array of unsigned 16-bit values. +<i>void*</i> is an array of data values of unspecified +type.</p> +<!-- INDENTATION --> +<p>Consult the <small>TIFF</small> specification for +information on the meaning of each tag.</p></td> +</table> +<!-- TABS --> + +<p><i>Tag Name Count Types Notes</i></p> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ARTIST</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_BADFAXLINES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_BITSPERSAMPLE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_CLEANFAXDATA</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COLORMAP</p> +</td> +<td width="8%"> + +<p>3</p> +</td> +<td width="24%"> + +<p>uint16*</p> +</td> +<td width="16%"> + +<p>1<<BitsPerSample arrays</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COMPRESSION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_CONSECUTIVEBADFAXLINES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COPYRIGHT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DATETIME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DOCUMENTNAME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DOTRANGE</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_EXTRASAMPLES</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16,uint16*</p> +</td> +<td width="16%"> + +<p>† count & types array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FAXFILLFUNC</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>TIFFFaxFillFunc</p> +</td> +<td width="16%"> + +<p>G3/G4 compression pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FAXMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>int</p> +</td> +<td width="16%"> + +<p>† G3/G4 compression pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FILLORDER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_GROUP3OPTIONS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_GROUP4OPTIONS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_HALFTONEHINTS</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_HOSTCOMPUTER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ICCPROFILE</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint32,void*</p> +</td> +<td width="16%"> + +<p>count, profile data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEDEPTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEDESCRIPTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGELENGTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEWIDTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_INKNAMES</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16, char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_INKSET</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGCOLORMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>int</p> +</td> +<td width="16%"> + +<p>† JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGQUALITY</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>int</p> +</td> +<td width="16%"> + +<p>JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGTABLES</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint32*,void*</p> +</td> +<td width="16%"> + +<p>† count & tables</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGTABLESMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>int</p> +</td> +<td width="16%"> + +<p>† JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MAKE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MATTEING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MAXSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MINSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MODEL</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ORIENTATION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PAGENAME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PAGENUMBER</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PHOTOMETRIC</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PHOTOSHOP</p> +</td> +<td width="8%"> + +<p>?</p> +</td> +<td width="24%"> + +<p>uint32,void*</p> +</td> +<td width="16%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PLANARCONFIG</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PREDICTOR</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PRIMARYCHROMATICITIES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float*</p> +</td> +<td width="16%"> + +<p>6-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_REFERENCEBLACKWHITE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float*</p> +</td> +<td width="16%"> + +<p>† 2*SamplesPerPixel array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_RESOLUTIONUNIT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_RICHTIFFIPTC</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint32,void*</p> +</td> +<td width="16%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ROWSPERSTRIP</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>† must be > 0</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SAMPLEFORMAT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SAMPLESPERPIXEL</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>† value must be <= 4</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SMAXSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>double</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SMINSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>double</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SOFTWARE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_STONITS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>double</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SUBFILETYPE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SUBIFD</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16,uint32*</p> +</td> +<td width="16%"> + +<p>count & offsets array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TARGETPRINTER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_THRESHHOLDING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEDEPTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILELENGTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>† must be a multiple of 8</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEWIDTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>† must be a multiple of 8</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TRANSFERFUNCTION</p> +</td> +<td width="8%"> + +<p>1 or 3‡ uint16*</p> +</td> +<td width="24%"></td> +<td width="16%"> + +<p>1<<BitsPerSample entry arrays</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_WHITEPOINT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float*</p> +</td> +<td width="16%"> + +<p>2-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XMLPACKET</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint32,void*</p> +</td> +<td width="16%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XPOSITION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XRESOLUTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRCOEFFICIENTS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float*</p> +</td> +<td width="16%"> + +<p>† 3-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRPOSITIONING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRSAMPLING</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YPOSITION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YRESOLUTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float</p> +</td> +<td width="16%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>† Tag may not have its values changed once data is +written.<br> +‡ If <i>SamplesPerPixel</i> is one, then a single +array is passed; otherwise three arrays should be +passed.<br> +* The contents of this field are quite complex. See <b>The +ICC Profile Format Specification</b>, Annex B.3 +"Embedding ICC Profiles in TIFF Files" (available +at http://www.color.org) for an explanation.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned if the operation was successful. Otherwise, +0 is returned if an error was detected.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>%s: Cannot modify tag "%s" while +writing</b>. Data has already been written to the file, so +the specified tag’s value can not be changed. This +restriction is applied to all tags that affect the format of +written data.</p> +<!-- INDENTATION --> +<p><b>%d: Bad value for "%s"</b>. An invalid value +was supplied for the named tag.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFGetField</b>(3TIFF), +<b>TIFFSetDirectory</b>(3TIFF), +<b>TIFFWriteDirectory</b>(3TIFF), +<b>TIFFReadDirectory</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWarning.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWarning.3tiff.html new file mode 100644 index 0000000000..df17073b57 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWarning.3tiff.html @@ -0,0 +1,108 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:17 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWarning</title> +</head> +<body> + +<h1 align=center>TIFFWarning</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWarning, TIFFSetWarningHandler − library +warning interface</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>void TIFFWarning(const char *</b><i>module</i><b>, +const char *</b><i>fmt</i><b>,</b> <i>...</i><b>)</b></p> +<!-- INDENTATION --> +<p><b>#include <stdargh.h></b></p> +<!-- INDENTATION --> +<p><b>typedef void (*TIFFWarningHandler)(const char +*</b><i>module</i><b>, const char *</b><i>fmt</i><b>, +va_list</b> <i>ap</i><b>);</b></p> +<!-- INDENTATION --> +<p><b>TIFFWarningHandler +TIFFSetWarningHandler(TIFFWarningHandler</b> +<i>handler</i><b>);</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFWarning</i> invokes the library-wide warning +handler function to (normally) write a warning message to +the <b>stderr</b>. The <i>fmt</i> parameter is a +<i>printf</i>(3S) format string, and any number arguments +can be supplied. The <i>module</i> parameter is interpreted +as a string that, if non-zero, should be printed before the +message; it typically is used to identify the software +module in which a warning is detected.</p> +<!-- INDENTATION --> +<p>Applications that desire to capture control in the event +of a warning should use <i>TIFFSetWarningHandler</i> to +override the default warning handler. A <small>NULL</small> +(0) warning handler function may be installed to suppress +error messages.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFSetWarningHandler</i> returns a reference to the +previous error handling function.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFError</b>(3TIFF), <b>libtiff</b>(3TIFF), +<b>printf</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteDirectory.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteDirectory.3tiff.html new file mode 100644 index 0000000000..07a443e145 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteDirectory.3tiff.html @@ -0,0 +1,176 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:17 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteDirectory</title> +</head> +<body> + +<h1 align=center>TIFFWriteDirectory</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWriteDirectory, TIFFRewriteDirectory, +TIFFCheckpointDirectory − write the current directory +in an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFWriteDirectory(TIFF *</b><i>tif</i><b>)<br> +int TIFFRewriteDirectory(TIFF *</b><i>tif</i><b>)<br> +int TIFFCheckpointDirectory(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFWriteDirectory</i> will write the contents of the +current directory to the file and setup to create a new +subfile in the same file. Applications only need to call +<i>TIFFWriteDirectory</i> when writing multiple subfiles to +a single <small>TIFF</small> file. <i>TIFFWriteDirectory</i> +is automatically called by <i>TIFFClose</i> and +<i>TIFFFlush</i> to write a modified directory if the file +is open for writing.</p> +<!-- INDENTATION --> +<p>The <i>TIFFRewriteDirectory</i> function operates +similarly to <i>TIFFWriteDirectory,</i> but can be called +with directories previously read or written that already +have an established location in the file. It will rewrite +the directory, but instead of place it at it’s old +location (as <i>TIFFWriteDirectory</i> would) it will place +them at the end of the file, correcting the pointer from the +preceeding directory or file header to point to it’s +new location. This is particularly important in cases where +the size of the directory and pointed to data has grown, so +it won’t fit in the space available at the old +location.</p> +<!-- INDENTATION --> +<p>The <i>TIFFCheckpointDirectory</i> writes the current +state of the tiff directory into the file to make what is +currently in the file readable. Unlike +<i>TIFFWriteDirectory, TIFFCheckpointDirectory</i> does not +free up the directory data structures in memory, so they can +be updated (as strips/tiles are written) and written again. +Reading such a partial file you will at worst get a tiff +read error for the first strip/tile encountered that is +incomplete, but you will at least get all the valid data in +the file before that. When the file is complete, just use +<i>TIFFWriteDirectory</i> as usual to finish it off +cleanly.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned when the contents are successfully written +to the file. Otherwise, 0 is returned if an error was +encountered when writing the directory contents.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Error post-encoding before directory write</b>. Before +writing the contents of the current directory, any pending +data are flushed. This message indicates that an error +occurred while doing this.</p> +<!-- INDENTATION --> +<p><b>Error flushing data before directory write</b>. Before +writing the contents of the current directory, any pending +data are flushed. This message indicates that an error +occurred while doing this.</p> +<!-- INDENTATION --> +<p><b>Cannot write directory, out of space</b>. There was +not enough space to allocate a temporary area for the +directory that was to be written.</p> +<!-- INDENTATION --> +<p><b>Error writing directory count</b>. A write error +occurred when writing the count of fields in the +directory.</p> +<!-- INDENTATION --> +<p><b>Error writing directory contents</b>. A write error +occurred when writing the directory fields.</p> +<!-- INDENTATION --> +<p><b>Error writing directory link</b>. A write error +occurred when writing the link to the next directory.</p> +<!-- INDENTATION --> +<p><b>Error writing data for field "%s"</b>. A +write error occurred when writing indirect data for the +specified field.</p> +<!-- INDENTATION --> +<p><b>Error writing TIFF header</b>. A write error occurred +when re-writing header at the front of the file.</p> +<!-- INDENTATION --> +<p><b>Error fetching directory count</b>. A read error +occurred when fetching the directory count field for a +previous directory. This can occur when setting up a link to +the directory that is being written.</p> +<!-- INDENTATION --> +<p><b>Error fetching directory link</b>. A read error +occurred when fetching the directory link field for a +previous directory. This can occur when setting up a link to +the directory that is being written.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFError</b>(3TIFF), +<b>TIFFReadDirectory</b>(3TIFF), +<b>TIFFSetDirectory</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteEncodedStrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteEncodedStrip.3tiff.html new file mode 100644 index 0000000000..5a45f593a2 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteEncodedStrip.3tiff.html @@ -0,0 +1,153 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:17 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteEncodedStrip</title> +</head> +<body> + +<h1 align=center>TIFFWriteEncodedStrip</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>TIFFWritedEncodedStrip − compress and write a +strip of data to an open</big> TIFF <big>file</big></p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>#include <tiffio.h></b></big></p> +<!-- INDENTATION --> +<p><big><b>tsize_t TIFFWriteEncodedStrip(TIFF +*</b><i>tif</i><b>, tstrip_t</b> <i>strip</i><b>, +tdata_t</b> <i>buf</i><b>, tsize_t</b> +<i>size</i><b>)</b></big></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Compress <i>size</i> bytes of raw data from +<i>buf</i> and write the result to the specified strip; +replacing any previously written data. Note that the value +of <i>strip</i> is a ‘‘raw strip +number.’’ That is, the caller must take into +account whether or not the data are organized in separate +planes (<i>PlanarConfiguration</i>=2).</big></p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The library writes encoded data using the native +machine byte order. Correctly implemented</big> TIFF +<big>readers are expected to do any necessary byte-swapping +to correctly process image data with BitsPerSample greater +than 8.</big></p> +<!-- INDENTATION --> +<p><big>The strip number must be valid according to the +current settings of the <i>ImageLength</i> and +<i>RowsPerStrip</i> tags. An image may be dynamically grown +by increasing the value of <i>ImageLength</i> prior to each +call to <i>TIFFWriteEncodedStrip</i>.</big></p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>−1 is returned if an error was encountered. +Otherwise, the value of <i>size</i> is returned.</big></p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: File not open for writing</b>. The file was +opened for reading, not writing.</big></p> +<!-- INDENTATION --> +<p><big><b>Can not write scanlines to a tiled image</b>. The +image is assumed to be organized in tiles because the +<i>TileWidth</i> and <i>TileLength</i> tags have been set +with <i>TIFFSetField</i>(3TIFF).</big></p> +<!-- INDENTATION --> +<p><big><b>%s: Must set "ImageWidth" before +writing data</b>. The image’s width has not be set +before the first write. See <i>TIFFSetField</i>(3TIFF) for +information on how to do this.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: Must set "PlanarConfiguration" +before writing data</b>. The organization of data has not be +defined before the first write. See +<i>TIFFSetField</i>(3TIFF) for information on how to do +this.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: No space for strip arrays"</b>. There +was not enough space for the arrays that hold strip offsets +and byte counts.</big></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteScanline</b>(3TIFF), +<b>TIFFWriteRawStrip</b>(3TIFF), +<b>libtiff</b>(3TIFF)</big></p> +<!-- INDENTATION --> +<p><big>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></big></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteEncodedTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteEncodedTile.3tiff.html new file mode 100644 index 0000000000..0e6e1bac88 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteEncodedTile.3tiff.html @@ -0,0 +1,147 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:17 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteEncodedTile</title> +</head> +<body> + +<h1 align=center>TIFFWriteEncodedTile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>TIFFWritedEncodedTile − compress and write a +tile of data to an open</big> TIFF <big>file</big></p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>#include <tiffio.h></b></big></p> +<!-- INDENTATION --> +<p><big><b>tsize_t TIFFWriteEncodedTile(TIFF +*</b><i>tif</i><b>, ttile_t</b> <i>tile</i><b>, tdata_t</b> +<i>buf</i><b>, tsize_t</b> <i>size</i><b>)</b></big></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Compress <i>size</i> bytes of raw data from +<i>buf</i> and <b>append</b> the result to the end of the +specified tile. Note that the value of <i>tile</i> is a +‘‘raw tile number.’’ That is, the +caller must take into account whether or not the data are +organized in separate places (<i>PlanarConfiguration</i>=2). +<i>TIFFComputeTile</i> automatically does this when +converting an (x,y,z,sample) coordinate quadruple to a tile +number.</big></p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The library writes encoded data using the native +machine byte order. Correctly implemented</big> TIFF +<big>readers are expected to do any necessary byte-swapping +to correctly process image data with BitsPerSample greater +than 8.</big></p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>−1 is returned if an error was encountered. +Otherwise, the value of <i>size</i> is returned.</big></p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: File not open for writing</b>. The file was +opened for reading, not writing.</big></p> +<!-- INDENTATION --> +<p><big><b>Can not write tiles to a stripped image</b>. The +image is assumed to be organized in strips because neither +of the <i>TileWidth</i> or <i>TileLength</i> tags have been +set with <b>TIFFSetField</b>(3TIFF).</big></p> +<!-- INDENTATION --> +<p><big><b>%s: Must set "ImageWidth" before +writing data</b>. The image’s width has not be set +before the first write. See <b>TIFFSetField</b>(3TIFF) for +information on how to do this.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: Must set "PlanarConfiguration" +before writing data</b>. The organization of data has not be +defined before the first write. See +<b>TIFFSetField</b>(3TIFF) for information on how to do +this.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: No space for tile arrays"</b>. There was +not enough space for the arrays that hold tile offsets and +byte counts.</big></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFOpen</b>(3TIFF), <b>TIFFWriteTile</b>(3TIFF), +<b>TIFFWriteRawTile</b>(3TIFF), +<b>libtiff</b>(3TIFF)</big></p> +<!-- INDENTATION --> +<p><big>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></big></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteRawStrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteRawStrip.3tiff.html new file mode 100644 index 0000000000..95b48570ed --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteRawStrip.3tiff.html @@ -0,0 +1,144 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:17 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteRawstrip</title> +</head> +<body> + +<h1 align=center>TIFFWriteRawstrip</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWriteRawStrip − write a strip of raw data to an +open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFWriteRawStrip(TIFF *</b><i>tif</i><b>, +tstrip_t</b> <i>strip</i><b>, tdata_t</b> <i>buf</i><b>, +tsize_t</b> <i>size</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Append <i>size</i> bytes of raw data to the specified +strip.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The strip number must be valid according to the current +settings of the <i>ImageLength</i> and <i>RowsPerStrip</i> +tags. An image may be dynamically grown by increasing the +value of <i>ImageLength</i> prior to each call to +<i>TIFFWriteRawStrip</i>.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>−1 is returned if an error occurred. Otherwise, the +value of <i>size</i> is returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>%s: File not open for writing</b>. The file was opened +for reading, not writing.</p> +<!-- INDENTATION --> +<p><b>Can not write scanlines to a tiled image</b>. The +image is assumed to be organized in tiles because the +<i>TileWidth</i> and <i>TileLength</i> tags have been set +with <b>TIFFSetField</b>(3TIFF).</p> +<!-- INDENTATION --> +<p><b>%s: Must set "ImageWidth" before writing +data</b>. The image’s width has not be set before the +first write. See <b>TIFFSetField</b>(3TIFF) for information +on how to do this.</p> +<!-- INDENTATION --> +<p><b>%s: Must set "PlanarConfiguration" before +writing data</b>. The organization of data has not be +defined before the first write. See +<b>TIFFSetField</b>(3TIFF) for information on how to do +this.</p> +<!-- INDENTATION --> +<p><b>%s: No space for strip arrays"</b>. There was not +enough space for the arrays that hold strip offsets and byte +counts.</p> +<!-- INDENTATION --> +<p><b>%s: Strip %d out of range, max %d</b>. The specified +strip is not a valid strip according to the currently +specified image dimensions.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteEncodedStrip</b>(3TIFF), +<b>TIFFWriteScanline</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteRawTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteRawTile.3tiff.html new file mode 100644 index 0000000000..3d18ed18c3 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteRawTile.3tiff.html @@ -0,0 +1,128 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:18 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteRawtile</title> +</head> +<body> + +<h1 align=center>TIFFWriteRawtile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWriteRawTile − write a tile of raw data to an +open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFWriteRawTile(TIFF *</b><i>tif</i><b>, +ttile_t</b> <i>tile</i><b>, tdata_t</b> <i>buf</i><b>, +tsize_t</b> <i>size</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Append <i>size</i> bytes of raw data to the specified +tile.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>−1 is returned if an error occurred. Otherwise, the +value of <i>size</i> is returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>%s: File not open for writing</b>. The file was opened +for reading, not writing.</p> +<!-- INDENTATION --> +<p><b>Can not write tiles to a stripped image</b>. The image +is assumed to be organized in strips because neither of the +<i>TileWidth</i> or <i>TileLength</i> tags have been set +with <b>TIFFSetField</b>(3TIFF).</p> +<!-- INDENTATION --> +<p><b>%s: Must set "ImageWidth" before writing +data</b>. The image’s width has not be set before the +first write. See <b>TIFFSetField</b>(3TIFF) for information +on how to do this.</p> +<!-- INDENTATION --> +<p><b>%s: Must set "PlanarConfiguration" before +writing data</b>. The organization of data has not be +defined before the first write. See +<b>TIFFSetField</b>(3TIFF) for information on how to do +this.</p> +<!-- INDENTATION --> +<p><b>%s: No space for tile arrays"</b>. There was not +enough space for the arrays that hold tile offsets and byte +counts.</p> +<!-- INDENTATION --> +<p><b>%s: Specified tile %d out of range, max %d</b>. The +specified tile is not valid according to the currently +specified image dimensions.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteEncodedTile</b>(3TIFF), +<b>TIFFWriteScanline</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteScanline.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteScanline.3tiff.html new file mode 100644 index 0000000000..bb9323d2e3 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteScanline.3tiff.html @@ -0,0 +1,206 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:18 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteScanline</title> +</head> +<body> + +<h1 align=center>TIFFWriteScanline</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWriteScanline − write a scanline to an open +<small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFWriteScanline(TIFF *</b><i>tif</i><b>, +tdata_t</b> <i>buf</i><b>, uint32</b> <i>row</i><b>, +tsample_t</b> <i>sample</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Write data to a file at the specified row. The +<i>sample</i> parameter is used only if data are organized +in separate planes (<i>PlanarConfiguration</i>=2). The data +are assumed to be uncompressed and in the native bit- and +byte-order of the host machine. The data written to the file +is compressed according to the compression scheme of the +current <small>TIFF</small> directory (see further below). +If the current scanline is past the end of the current +subfile, the <i>ImageLength</i> field is automatically +increased to include the scanline (except for +<i>PlanarConfiguration</i>=2, where the <i>ImageLength</i> +cannot be changed once the first data are written). If the +<i>ImageLength</i> is increased, the <i>StripOffsets</i> and +<i>StripByteCounts</i> fields are similarly enlarged to +reflect data written past the previous end of image.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The library writes encoded data using the native machine +byte order. Correctly implemented <small>TIFF</small> +readers are expected to do any necessary byte-swapping to +correctly process image data with BitsPerSample greater than +8. The library attempts to hide bit-ordering differences +between the image and the native machine by converting data +from the native machine order.</p> +<!-- INDENTATION --> +<p>In C++ the <i>sample</i> parameter defaults to 0.</p> +<!-- INDENTATION --> +<p>Once data are written to a file for the current +directory, the values of certain tags may not be altered; +see <i>TIFFSetField</i>(3TIFF) for more information.</p> +<!-- INDENTATION --> +<p>It is not possible to write scanlines to a file that uses +a tiled organization. The routine <i>TIFFIsTiled</i> can be +used to determine if the file is organized as tiles or +strips.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFWriteScanline</i> returns −1 if it +immediately detects an error and 1 for a successful +write.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>%s: File not open for writing .</b> The file was +opened for reading, not writing.</p> +<!-- INDENTATION --> +<p><b>Can not write scanlines to a tiled image</b>. An +attempt was made to write a scanline to a tiled image. The +image is assumed to be organized in tiles because the +<i>TileWidth</i> and <i>TileLength</i> tags have been set +with <i>TIFFSetField</i>(3TIFF).</p> +<!-- INDENTATION --> +<p><b>Compression algorithm does not support random +access</b>. Data was written in a non-sequential order to a +file that uses a compression algorithm and that has +<i>RowsPerStrip</i> greater than one. That is, data in the +image is to be stored in a compressed form, and with +multiple rows packed into a strip. In this case, the library +does not support random access to the data. The data should +either be written as entire strips, sequentially by rows, or +the value of <i>RowsPerStrip</i> should be set to one.</p> +<!-- INDENTATION --> +<p><b>%s: Must set "ImageWidth" before writing +data</b>. The image’s width has not be set before the +first write. See <b>TIFFSetField</b>(3TIFF) for information +on how to do this.</p> +<!-- INDENTATION --> +<p><b>%s: Must set "PlanarConfiguration" before +writing data</b>. The organization of data has not be +defined before the first write. See +<b>TIFFSetField</b>(3TIFF) for information on how to do +this.</p> +<!-- INDENTATION --> +<p><b>Can not change "ImageLength" when using +separate planes</b>. Separate image planes are being used +(<i>PlanarConfiguration</i>=2), but the number of rows has +not been specified before the first write. The library +supports the dynamic growth of an image only when data are +organized in a contiguous manner +(<i>PlanarConfiguration</i>=1).</p> +<!-- INDENTATION --> +<p><b>%d: Sample out of range, max %d</b>. The <i>sample</i> +parameter was greater than the value of the SamplesPerPixel +tag.</p> +<!-- INDENTATION --> +<p><b>%s: No space for strip arrays .</b> There was not +enough space for the arrays that hold strip offsets and byte +counts.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Writing subsampled YCbCR data does not work correctly +because, for <i>PlanarConfiguration</i>=2 the size of a +scanline is not calculated on a per-sample basis, and for +<i>PlanarConfiguration</i>=1 the library does not pack the +block-interleaved samples.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteEncodedStrip</b>(3TIFF), +<b>TIFFWriteRawStrip</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteTile.3tiff.html new file mode 100644 index 0000000000..d6bc5d8aed --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteTile.3tiff.html @@ -0,0 +1,115 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:18 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteTile</title> +</head> +<body> + +<h1 align=center>TIFFWriteTile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWriteTile − encode and write a tile of data to +an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFWriteTile(TIFF *</b><i>tif</i><b>, +tdata_t</b> <i>buf</i><b>, uint32</b> <i>x</i><b>, +uint32</b> <i>y</i><b>, uint32</b> <i>z</i><b>, +tsample_t</b> <i>sample</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Write the data for the tile <i>containing</i> the +specified coordinates. The data in <i>buf</i> are is +(potentially) compressed, and written to the indicated file, +normally being appended to the end of the file. The buffer +must be contain an entire tile of data. Applications should +call the routine <i>TIFFTileSize</i> to find out the size +(in bytes) of a tile buffer. The <i>x</i> and <i>y</i> +parameters are always used by <i>TIFFWriteTile</i>. The +<i>z</i> parameter is used if the image is deeper than 1 +slice (<i>ImageDepth</i>>1). The <i>sample</i> parameter +is used only if data are organized in separate planes +(<i>PlanarConfiguration</i>=2).</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFWriteTile</i> returns −1 if it detects an +error; otherwise the number of bytes in the tile is +returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFCheckTile</b>(3TIFF), +<b>TIFFComputeTile</b>(3TIFF), <b>TIFFOpen</b>(3TIFF), +<b>TIFFReadTile</b>(3TIFF), <b>TIFFWriteScanline</b>(3TIFF), +<b>TIFFWriteEncodedTile</b>(3TIFF), +<b>TIFFWriteRawTile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFbuffer.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFbuffer.3tiff.html new file mode 100644 index 0000000000..3d610ca539 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFbuffer.3tiff.html @@ -0,0 +1,116 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:14 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFBUFFER</title> +</head> +<body> + +<h1 align=center>TIFFBUFFER</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadBufferSetup, TIFFWriteBufferSetup − I/O +buffering control routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<pre><b>#include <tiffio.h> + +int TIFFReadBufferSetup(TIFF *</b><i>tif</i><b>, tdata_t</b> <i>buffer</i><b>, tsize_t</b> <i>size</i><b>); +int TIFFWriteBufferSetup(TIFF *</b><i>tif</i><b>, tdata_t</b> <i>buffer</i><b>, tsize_t</b> <i>size</i><b>); +</b></pre> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following routines are provided for client-control of +the I/O buffers used by the library. Applications need never +use these routines; they are provided only for +‘‘intelligent clients’’ that wish to +optimize memory usage and/or eliminate potential copy +operations that can occur when working with images that have +data stored without compression.</p> +<!-- INDENTATION --> +<p><i>TIFFReadBufferSetup</i> sets up the data buffer used +to read raw (encoded) data from a file. If the specified +pointer is <small>NULL</small> (zero), then a buffer of the +appropriate size is allocated. Otherwise the caller must +guarantee that the buffer is large enough to hold any +individual strip of raw data. <i>TIFFReadBufferSetup</i> +returns a non-zero value if the setup was successful and +zero otherwise.</p> +<!-- INDENTATION --> +<p><i>TIFFWriteBufferSetup</i> sets up the data buffer used +to write raw (encoded) data to a file. If the specified +<i>size</i> is −1 then the buffer size is selected to +hold a complete tile or strip, or at least 8 kilobytes, +whichever is greater. If the specified <i>buffer</i> is +<small>NULL</small> (zero), then a buffer of the appropriate +size is dynamically allocated. <i>TIFFWriteBufferSetup</i> +returns a non-zero value if the setup was successful and +zero otherwise.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>%s: No space for data buffer at scanline %ld</b>. +<i>TIFFReadBufferSetup</i> was unable to dynamically +allocate space for a data buffer.</p> +<!-- INDENTATION --> +<p><b>%s: No space for output buffer</b>. +<i>TIFFWriteBufferSetup</i> was unable to dynamically +allocate space for a data buffer.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFcodec.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFcodec.3tiff.html new file mode 100644 index 0000000000..8567b30b4b --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFcodec.3tiff.html @@ -0,0 +1,116 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:15 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>CODEC</title> +</head> +<body> + +<h1 align=center>CODEC</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFFindCODEC, TIFFRegisterCODEC, TIFFUnRegisterCODEC, +TIFFIsCODECConfigured − codec-related utility +routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>const TIFFCodec* TIFFFindCODEC(uint16</b> +<i>scheme</i><b>);<br> +TIFFCodec* TIFFRegisterCODEC(uint16</b> <i>scheme</i><b>, +const char *</b><i>method</i><b>, TIFFInitMethod</b> +<i>init</i><b>);<br> +void TIFFUnRegisterCODEC(TIFFCodec +*</b><i>codec</i><b>);<br> +int TIFFIsCODECConfigured(uint16</b> +<i>scheme</i><b>);</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>libtiff</i> supports a variety of compression schemes +implemented by software <i>codecs</i>. Each codec adheres to +a modular interface that provides for the decoding and +encoding of image data; as well as some other methods for +initialization, setup, cleanup, and the control of default +strip and tile sizes. Codecs are identified by the +associated value of the <small>TIFF</small> +<i>Compression</i> tag; e.g. 5 for <small>LZW</small> +compression.</p> +<!-- INDENTATION --> +<p>The <i>TIFFRegisterCODEC</i> routine can be used to +augment or override the set of codecs available to an +application. If the specified <i>scheme</i> already has a +registered codec then it is <i>overridden</i> and any images +with data encoded with this compression scheme will be +decoded using the supplied coded.</p> +<!-- INDENTATION --> +<p><i>TIFFIsCODECConfigured</i> returns 1 if the codec is +configured and working. Otherwise 0 will be returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>No space to register compression scheme %s</b>. +<i>TIFFRegisterCODEC</i> was unable to allocate memory for +the data structures needed to register a codec.</p> +<!-- INDENTATION --> +<p><b>Cannot remove compression scheme %s; not +registered</b>. <i>TIFFUnRegisterCODEC</i> did not locate +the specified codec in the table of registered compression +schemes.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFcolor.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFcolor.3tiff.html new file mode 100644 index 0000000000..7e4eea51c7 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFcolor.3tiff.html @@ -0,0 +1,975 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:15 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>COLOR</title> +</head> +<body> + +<h1 align=center>COLOR</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFYCbCrToRGBInit, TIFFYCbCrtoRGB, TIFFCIELabToRGBInit, +TIFFCIELabToXYZ, TIFFXYZToRGB − color conversion +routines.</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFYCbCrToRGBInit(TIFFYCbCrToRGB +*</b><i>ycbcr</i><b>, float *</b><i>luma</i><b>, float +*</b><i>refBlackWhite"</i><b>);"<br> +void TIFFYCbCrtoRGB(TIFFYCbCrToRGB *</b><i>ycbcr</i><b>, +uint32</b> <i>Y</i><b>, int32</b> <i>Cb</i><b>, int32</b> +<i>Cr</i><b>, uint32 *</b><i>R</i><b>, uint32 +*</b><i>G</i><b>, uint32 *</b><i>B</i> <b>);</b></p> +<!-- INDENTATION --> +<p><b>int TIFFCIELabToRGBInit(TIFFCIELabToRGB +*</b><i>cielab</i><b>, TIFFDisplay *</b><i>display</i><b>, +float *</b><i>refWhite</i><b>);<br> +void TIFFCIELabToXYZ(TIFFCIELabToRGB *</b><i>cielab</i><b>, +uint32</b> <i>L</i><b>, int32</b> <i>a</i><b>, int32</b> +<i>b</i><b>, float *</b><i>X</i><b>, float *</b><i>Y</i><b>, +float *</b><i>Z</i><b>);<br> +void TIFFXYZToRGB(TIFFCIELabToRGB *</b><i>cielab</i><b>, +float</b> <i>X</i><b>, float</b> <i>Y</i><b>, float</b> +<i>Z"</i><b>,</b><i>uint32</i><b>*"</b><i>R</i><b>, +uint32 *</b><i>G</i><b>, uint32 *</b><i>B</i><b>);</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFF supports several color spaces for images stored in +that format. There is usually a problem of application to +handle the data properly and convert between different +colorspaces for displaying and printing purposes. To +simplify this task libtiff implements several color +conversion routines itself. In particular, these routines +used in <b>TIFFRGBAImage(3TIFF)</b> interface.</p> +<!-- INDENTATION --> +<p><b>TIFFYCbCrToRGBInit()</b> used to initialize +<i>YCbCr</i> to <i>RGB</i> conversion state. Allocating and +freeing of the <i>ycbcr</i> structure belongs to programmer. +<i>TIFFYCbCrToRGB</i> defined in <b>tiffio.h</b> as</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>typedef struct { /* YCbCr->RGB support */ + TIFFRGBValue* clamptab; /* range clamping table */ +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> + +<p>int*</p> +<td width="28%"></td> +<td width="-3%"></td> +<td width="12%"></td> +<td width="6%"> + +<p>Cr_r_tab;<br> +int*</p> +</td> +<td width="56%"> +</td> +<tr valign="top" align="left"> +<td width="28%"></td> +<td width="-3%"></td> +<td width="12%"></td> +<td width="6%"> + +<p>Cb_b_tab;<br> +int32*</p> +</td> +<td width="56%"> +</td> +<tr valign="top" align="left"> +<td width="28%"></td> +<td width="-3%"></td> +<td width="12%"></td> +<td width="6%"> + +<p>Cr_g_tab;<br> +int32*</p> +</td> +<td width="56%"> +</td> +<tr valign="top" align="left"> +<td width="28%"></td> +<td width="-3%"></td> +<td width="12%"></td> +<td width="6%"> + +<p>Cb_g_tab;</p> +</td> +<td width="56%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>int32* Y_tab;<br> +} TIFFYCbCrToRGB;</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>luma</i> is a float array of three values representing +proportions of the red, green and blue in luminance, Y (see +section 21 of the TIFF 6.0 specification, where the YCbCr +images discussed). <i>TIFFTAG_YCBCRCOEFFICIENTS</i> holds +that values in TIFF file. <i>refBlackWhite</i> is a float +array of 6 values which specifies a pair of headroom and +footroom image data values (codes) for each image component +(see section 20 of the TIFF 6.0 specification where the +colorinmetry fields discussed). +<i>TIFFTAG_REFERENCEBLACKWHITE</i> is responsible for +storing these values in TIFF file. Following code snippet +should helps to understand the the technique:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>float *luma, *refBlackWhite; +uint16 hs, vs; + +/* Initialize structures */ +ycbcr = (TIFFYCbCrToRGB*) +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>_TIFFmalloc(TIFFroundup(sizeof(TIFFYCbCrToRGB), +sizeof(long))</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>+ 4*256*sizeof(TIFFRGBValue)</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>+ 2*256*sizeof(int)</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>+ 3*256*sizeof(int32));</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>if (ycbcr == NULL) {<br> +TIFFError("YCbCr->RGB",</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="4" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>"No space for YCbCr->RGB conversion +state");</p> +</td> +<td width="62%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>exit(0);<br> +}</p> +<!-- INDENTATION --> +<p>TIFFGetFieldDefaulted(tif, TIFFTAG_YCBCRCOEFFICIENTS, +&luma);<br> +TIFFGetFieldDefaulted(tif, TIFFTAG_REFERENCEBLACKWHITE, +&refBlackWhite);<br> +if (TIFFYCbCrToRGBInit(ycbcr, luma, refBlackWhite) < +0)</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>exit(0);</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>/* Start conversion */<br> +uint32 r, g, b;<br> +uint32 Y;<br> +int32 Cb, Cr;</p> +<!-- INDENTATION --> +<p>for each pixel in image</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>TIFFYCbCrtoRGB(img->ycbcr, Y, Cb, Cr, &r, &g, +&b);</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>/* Free state structure */<br> +_TIFFfree(ycbcr);</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFCIELabToRGBInit()</b> initializes the <i>CIE +L*a*b* 1976</i> to <i>RGB</i> conversion state. +<b>TIFFCIELabToRGB</b> defined as</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>#define CIELABTORGB_TABLE_RANGE 1500 + +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="9" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> + +<p>typedef struct {</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>/* CIE Lab 1976->RGB support */</p> +</td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>int</p> +</td> +<td width="6%"> + +<p>range;</p> +</td> +<td width="6%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>/* Size of conversion table */</p> +</td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>float</p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>rstep, gstep, bstep;</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>float</p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>X0, Y0, Z0;</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"> + +<p>/* Reference white point */</p> +</td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"></td> +<td width="6%"> + +<p>TIFFDisplay display;</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>float</p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>Yr2r[CIELABTORGB_TABLE_RANGE + 1]; /* Conversion of Yr +to r */</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>float</p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>Yg2g[CIELABTORGB_TABLE_RANGE + 1]; /* Conversion of Yg +to g */</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>float</p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>Yb2b[CIELABTORGB_TABLE_RANGE + 1]; /* Conversion of Yb +to b */</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="37%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>} TIFFCIELabToRGB;</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>display</i> is a display device description, declared +as</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>typedef struct { +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_mat[3][3]; /* XYZ -> luminance matrix */</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_YCR; /* Light o/p for reference white */</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_YCG;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_YCB;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>uint32 d_Vrwr; /* Pixel values for ref. white */</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>uint32 d_Vrwg;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>uint32 d_Vrwb;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_Y0R; /* Residual light for black pixel */</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_Y0G;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_Y0B;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_gammaR; /* Gamma values for the three guns +*/</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_gammaG;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_gammaB;</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>} TIFFDisplay;</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>For example, the one can use sRGB device, which has the +following parameters:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>TIFFDisplay display_sRGB = { +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>{ /* XYZ -> luminance matrix */</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>{ 3.2410F, -1.5374F, -0.4986F },</p> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>{ -0.9692F, 1.8760F, 0.0416F },</p> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>{ 0.0556F, -0.2040F, 1.0570F }</p> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>},</p> +</td> +<td width="6%"> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>100.0F, 100.0F, 100.0F, /* Light o/p for reference white +*/</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>255, 255, 255, /* Pixel values for ref. white */</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>1.0F, 1.0F, 1.0F, /* Residual light o/p for black pixel +*/</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>2.4F, 2.4F, 2.4F, /* Gamma values for the three guns +*/</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>};</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>refWhite</i> is a color temperature of the reference +white. The <i>TIFFTAG_WHITEPOINT</i> contains the +chromaticity of the white point of the image from where the +reference white can be calculated using following +formulae:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>refWhite_Y = 100.0<br> +refWhite_X = whitePoint_x / whitePoint_y * refWhite_Y<br> +refWhite_Z = (1.0 - whitePoint_x - whitePoint_y) / +whitePoint_y * refWhite_X</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The conversion itself performed in two steps: at the +first one we will convert <i>CIE L*a*b* 1976</i> to <i>CIE +XYZ</i> using <b>TIFFCIELabToXYZ()</b> routine, and at the +second step we will convert <i>CIE XYZ</i> to <i>RGB</i> +using <b>TIFFXYZToRGB().</b> Look at the code sample +below:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>float *whitePoint; +float refWhite[3]; + +/* Initialize structures */ +img->cielab = (TIFFCIELabToRGB *) +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>_TIFFmalloc(sizeof(TIFFCIELabToRGB));</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>if (!cielab) {</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>TIFFError("CIE L*a*b*->RGB",</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>"No space for CIE L*a*b*->RGB conversion +state.");</p> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>exit(0);</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>}</p> +<!-- INDENTATION --> +<p>TIFFGetFieldDefaulted(tif, TIFFTAG_WHITEPOINT, +&whitePoint);<br> +refWhite[1] = 100.0F;<br> +refWhite[0] = whitePoint[0] / whitePoint[1] * +refWhite[1];<br> +refWhite[2] = (1.0F - whitePoint[0] - +whitePoint[1])</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>/ whitePoint[1] * refWhite[1];</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>if (TIFFCIELabToRGBInit(cielab, &display_sRGB, +refWhite) < 0) {</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>TIFFError("CIE L*a*b*->RGB",</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>"Failed to initialize CIE L*a*b*->RGB conversion +state.");</p> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>_TIFFfree(cielab);</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>exit(0);</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>}</p> +<!-- INDENTATION --> +<p>/* Now we can start to convert */<br> +uint32 r, g, b;<br> +uint32 L;<br> +int32 a, b;<br> +float X, Y, Z;</p> +<!-- INDENTATION --> +<p>for each pixel in image</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>TIFFCIELabToXYZ(cielab, L, a, b, &X, &Y, +&Z);</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>TIFFXYZToRGB(cielab, X, Y, Z, &r, &g, +&b);</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>/* Don’t forget to free the state structure */<br> +_TIFFfree(cielab);</p></td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFRGBAImage</b>(3TIFF) <b>libtiff</b>(3TIFF),</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFmemory.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFmemory.3tiff.html new file mode 100644 index 0000000000..746b5ec269 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFmemory.3tiff.html @@ -0,0 +1,110 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:15 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>MEMORY</title> +</head> +<body> + +<h1 align=center>MEMORY</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>_TIFFmalloc, _TIFFrealloc, _TIFFfree, _TIFFmemset, +_TIFFmemcpy, _TIFFmemcmp, − memory management-related +functions for use with <small>TIFF</small> files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tdata_t _TIFFmalloc(tsize_t</b> <i>size</i><b>);<br> +tdata_t _TIFFrealloc(tdata_t</b> <i>buffer</i><b>, +tsize_t</b> <i>size</i><b>);<br> +void _TIFFfree(tdata_t</b> <i>buffer</i><b>);<br> +void _TIFFmemset(tdata_t</b> <i>s</i><b>, int</b> +<i>c</i><b>, tsize_t</b> <i>n</i><b>);<br> +void _TIFFmemcpy(tdata_t</b> <i>dest</i><b>, const +tdata_t</b> <i>src</i><b>, tsize_t</b> <i>n</i><b>);<br> +int _TIFFmemcmp(const tdata_t</b> <i>s1</i><b>, const +tdata_t</b> <i>s2</i><b>, tsize_t</b> <i>n</i><b>);</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>These routines are provided for writing portable software +that uses <i>libtiff</i>; they hide any memory-management +related issues, such as dealing with segmented architectures +found on 16-bit machines.</p> +<!-- INDENTATION --> +<p><i>_TIFFmalloc</i> and <i>_TIFFrealloc</i> are used to +dynamically allocate and reallocate memory used by +<i>libtiff</i>; such as memory passed into the I/O routines. +Memory allocated through these interfaces is released back +to the system using the <i>_TIFFfree</i> routine.</p> +<!-- INDENTATION --> +<p>Memory allocated through one of the above interfaces can +be set to a known value using <i>_TIFFmemset</i>, copied to +another memory location using <i>_TIFFmemcpy</i>, or +compared for equality using <i>_TIFFmemcmp</i>. These +routines conform to the equivalent <small>ANSI</small> C +routines: <i>memset</i>, <i>memcpy</i>, and <i>memcmp</i>, +repsectively.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>malloc</b>(3), <b>memory</b>(3), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFquery.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFquery.3tiff.html new file mode 100644 index 0000000000..e27354af84 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFquery.3tiff.html @@ -0,0 +1,148 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:15 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>QUERY</title> +</head> +<body> + +<h1 align=center>QUERY</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFCurrentRow, TIFFCurrentStrip, TIFFCurrentTile, +TIFFCurrentDirectory, TIFFLastDirectory, TIFFFileno, +TIFFFileName, TIFFGetMode, TIFFIsTiled, TIFFIsByteSwapped, +TIFFIsUpSampled, TIFFIsMSB2LSB, TIFFGetVersion − query +routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>uint32 TIFFCurrentRow(TIFF*</b> <i>tif</i><b>)<br> +tstrip_t TIFFCurrentStrip(TIFF*</b> <i>tif</i><b>)<br> +ttile_t TIFFCurrentTile(TIFF*</b> <i>tif</i><b>)<br> +tdir_t TIFFCurrentDirectory(TIFF*</b> <i>tif</i><b>)<br> +int TIFFLastDirectory(TIFF*</b> <i>tif</i><b>)<br> +int TIFFFileno(TIFF*</b> <i>tif</i><b>)<br> +char* TIFFFileName(TIFF*</b> <i>tif</i><b>)<br> +int TIFFGetMode(TIFF*</b> <i>tif</i><b>)<br> +int TIFFIsTiled(TIFF*</b> <i>tif</i><b>)<br> +int TIFFIsByteSwapped(TIFF*</b> <i>tif</i><b>)<br> +int TIFFIsUpSampled(TIFF*</b> <i>tif</i><b>)<br> +int TIFFIsMSB2LSB(TIFF*</b> <i>tif</i><b>)<br> +const char* TIFFGetVersion(void)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following routines return status information about an +open <small>TIFF</small> file.</p> +<!-- INDENTATION --> +<p><i>TIFFCurrentDirectory</i> returns the index of the +current directory (directories are numbered starting at 0). +This number is suitable for use with the +<i>TIFFSetDirectory</i> routine.</p> +<!-- INDENTATION --> +<p><i>TIFFLastDirectory</i> returns a non-zero value if the +current directory is the last directory in the file; +otherwise zero is returned.</p> +<!-- INDENTATION --> +<p><i>TIFFCurrentRow</i>, <i>TIFFCurrentStrip</i>, and +<i>TIFFCurrentTile</i>, return the current row, strip, and +tile, respectively, that is being read or written. These +values are updated each time a read or write is done.</p> +<!-- INDENTATION --> +<p><i>TIFFFileno</i> returns the underlying file descriptor +used to access the <small>TIFF</small> image in the +filesystem.</p> +<!-- INDENTATION --> +<p><i>TIFFFileName</i> returns the pathname argument passed +to <i>TIFFOpen</i> or <i>TIFFFdOpen</i>.</p> +<!-- INDENTATION --> +<p><i>TIFFGetMode</i> returns the mode with which the +underlying file was opened. On <small>UNIX</small> systems, +this is the value passed to the <i>open</i>(2) system +call.</p> +<!-- INDENTATION --> +<p><i>TIFFIsTiled</i> returns a non-zero value if the image +data has a tiled organization. Zero is returned if the image +data is organized in strips.</p> +<!-- INDENTATION --> +<p><i>TIFFIsByteSwapped</i> returns a non-zero value if the +image data was in a different byte-order than the host +machine. Zero is returned if the TIFF file and local host +byte-orders are the same. Note that TIFFReadTile(), +TIFFReadStrip() and TIFFReadScanline() functions already +normally perform byte swapping to local host order if +needed.</p> +<!-- INDENTATION --> +<p><i>TIFFIsUpSampled</i> returns a non-zero value if image +data returned through the read interface routines is being +up-sampled. This can be useful to applications that want to +calculate I/O buffer sizes to reflect this usage (though the +usual strip and tile size routines already do this).</p> +<!-- INDENTATION --> +<p><i>TIFFIsMSB2LSB</i> returns a non-zero value if the +image data is being returned with bit 0 as the most +significant bit.</p> +<!-- INDENTATION --> +<p><i>TIFFGetVersion</i> returns an <small>ASCII</small> +string that has a version stamp for the <small>TIFF</small> +library software.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>libtiff</i>(3TIFF), <i>TIFFOpen</i>(3TIFF), +<i>TIFFFdOpen</i>(3TIFF)</p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFsize.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFsize.3tiff.html new file mode 100644 index 0000000000..54fb71b8c3 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFsize.3tiff.html @@ -0,0 +1,95 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:17 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSIZE</title> +</head> +<body> + +<h1 align=center>TIFFSIZE</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFScanlineSize, TIFFRasterScanlineSize, − return +the size of various items associated with an open +<small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFRasterScanlineSize(TIFF +*</b><i>tif</i><b>)<br> +tsize_t TIFFScanlineSize(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFScanlineSize</i> returns the size in bytes of a +row of data as it would be returned in a call to +<i>TIFFReadScanline</i>, or as it would be expected in a +call to <i>TIFFWriteScanline</i>.</p> +<!-- INDENTATION --> +<p><i>TIFFRasterScanlineSize</i> returns the size in bytes +of a complete decoded and packed raster scanline. Note that +this value may be different from the value returned by +<i>TIFFScanlineSize</i> if data is stored as separate +planes.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFReadScanline</b>(3TIFF), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFstrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFstrip.3tiff.html new file mode 100644 index 0000000000..a0fc358bff --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFstrip.3tiff.html @@ -0,0 +1,129 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:17 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSTRIP</title> +</head> +<body> + +<h1 align=center>TIFFSTRIP</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFDefaultStripSize, TIFFStripSize, TIFFVStripSize, +TIFFRawStripSize, TIFFComputeStrip, TIFFNumberOfStrips +− strip-related utility routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>uint32 TIFFDefaultStripSize(TIFF *</b><i>tif</i><b>, +uint32</b> <i>estimate</i><b>)<br> +tsize_t TIFFStripSize(TIFF *</b><i>tif</i><b>)<br> +tsize_t TIFFVStripSize(TIFF *</b><i>tif</i><b>, uint32</b> +<i>nrows</i><b>)<br> +tsize_t TIFFRawStripSize(TIFF *</b><i>tif</i><b>, +tstrip_t</b> <i>strip</i><b>)<br> +tstrip_t TIFFComputeStrip(TIFF *</b><i>tif</i><b>, +uint32</b> <i>row</i><b>, tsample_t</b> +<i>sample</i><b>)<br> +tstrip_t TIFFNumberOfStrips(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFDefaultStripSize</i> returns the number of rows +for a reasonable-sized strip according to the current +settings of the <i>ImageWidth</i>, <i>BitsPerSample</i>, +<i>SamplesPerPixel</i>, tags and any compression-specific +requirements. If the <i>estimate</i> parameter, if non-zero, +then it is taken as an estimate of the desired strip size +and adjusted according to any compression-specific +requirements. The value returned by this function is +typically used to define the <i>RowsPerStrip</i> tag. In +lieu of any unusual requirements <i>TIFFDefaultStripSize</i> +tries to create strips that have approximately 8 kilobytes +of uncompressed data.</p> +<!-- INDENTATION --> +<p><i>TIFFStripSize</i> returns the equivalent size for a +strip of data as it would be returned in a call to +<i>TIFFReadEncodedStrip</i> or as it would be expected in a +call to <i>TIFFWriteEncodedStrip</i>.</p> +<!-- INDENTATION --> +<p><i>TIFFVStripSize</i> returns the number of bytes in a +strip with <i>nrows</i> rows of data.</p> +<!-- INDENTATION --> +<p><i>TIFFRawStripSize</i> returns the number of bytes in a +raw strip (i.e. not decoded).</p> +<!-- INDENTATION --> +<p><i>TIFFComputeStrip</i> returns the strip that contains +the specified coordinates. A valid strip is always returned; +out-of-range coordinate values are clamped to the bounds of +the image. The <i>row</i> parameter is always used in +calculating a strip. The <i>sample</i> parameter is used +only if data are organized in separate planes +(<i>PlanarConfiguration</i>=2).</p> +<!-- INDENTATION --> +<p><i>TIFFNumberOfStrips</i> returns the number of strips in +the image.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFReadEncodedStrip</b>(3TIFF), +<b>TIFFReadRawStrip</b>(3TIFF), +<b>TIFFWriteEncodedStrip</b>(3TIFF), +<b>TIFFWriteRawStrip</b>(3TIFF), <b>libtiff</b>(3TIFF),</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFswab.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFswab.3tiff.html new file mode 100644 index 0000000000..2924a38bd9 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFswab.3tiff.html @@ -0,0 +1,110 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:17 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>SWAB</title> +</head> +<body> + +<h1 align=center>SWAB</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFGetBitRevTable, TIFFReverseBits, TIFFSwabShort, +TIFFSwabLong, TIFFSwabArrayOfShort, TIFFSwabArrayOfLong +− byte- and bit-swapping routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>const unsigned char* TIFFGetBitRevTable(int</b> +<i>reversed</i><b>)<br> +void TIFFReverseBits(u_char *</b><i>data</i><b>, unsigned +long</b> <i>nbytes</i><b>)<br> +void TIFFSwabShort(uint16 *</b><i>data</i><b>)<br> +void TIFFSwabLong(uint32 *</b><i>data</i><b>)<br> +void TIFFSwabArrayOfShort(uint16 *</b><i>data</i><b>, +unsigned long</b> <i>nshorts</i><b>)<br> +void TIFFSwabArrayOfLong(uint32 *</b><i>data</i><b>, +unsigned long</b> <i>nlongs</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following routines are used by the library to swap +16- and 32-bit data and to reverse the order of bits in +bytes.</p> +<!-- INDENTATION --> +<p><i>TIFFSwabShort</i> and <i>TIFFSwabLong</i> swap the +bytes in a single 16-bit and 32-bit item, respectively. +<i>TIFFSwabArrayOfShort</i> and <i>TIFFSwabArrayOfLong</i> +swap the bytes in an array of 16-bit and 32-bit items, +respectively.</p> +<!-- INDENTATION --> +<p><i>TIFFReverseBits</i> replaces each byte in <i>data</i> +with the equivalent bit-reversed value. This operation is +performed with a lookup table, which is returned using the +<i>TIFFGetBitRevTable</i> function. <i>reversed</i> +parameter specifies which table should be returned. Supply +<i>1</i> if you want bit reversal table. Supply <i>0</i> to +get the table that do not reverse bit values. It is a lookup +table that can be used as an <i>identity function</i>; i.e. +<i>TIFFNoBitRevTable[n] == n</i>.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFtile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFtile.3tiff.html new file mode 100644 index 0000000000..e8e0008a06 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFtile.3tiff.html @@ -0,0 +1,141 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:17 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFTILE</title> +</head> +<body> + +<h1 align=center>TIFFTILE</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFTileSize, TIFFTileRowSize, TIFFVTileSize, +TIFFDefaultTileSize, TIFFComputeTile, TIFFCheckTile, +TIFFNumberOfTiles − tile-related utility routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>void TIFFDefaultTileSize(TIFF *</b><i>tif</i><b>, +uint32 *</b><i>tw</i><b>, uint32 *</b><i>th</i><b>)<br> +tsize_t TIFFTileSize(TIFF *</b><i>tif</i><b>)<br> +tsize_t TIFFTileRowSize(TIFF *</b><i>tif</i><b>)<br> +tsize_t TIFFVTileSize(TIFF *</b><i>tif</i><b>, uint32</b> +<i>nrows</i><b>)<br> +ttile_t TIFFComputeTile(TIFF *</b><i>tif</i><b>, uint32</b> +<i>x</i><b>, uint32</b> <i>y</i><b>, uint32</b> <i>z</i><b>, +tsample_t</b> <i>sample</i><b>)<br> +int TIFFCheckTile(TIFF *</b><i>tif</i><b>, uint32</b> +<i>x</i><b>, uint32</b> <i>y</i><b>, uint32</b> <i>z</i><b>, +tsample_t</b> <i>sample</i><b>)<br> +ttile_t TIFFNumberOfTiles(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFDefaultTileSize</i> returns the pixel width and +height of a reasonable-sized tile; suitable for setting up +the <i>TileWidth</i> and <i>TileLength</i> tags. If the +<i>tw</i> and <i>th</i> values passed in are non-zero, then +they are adjusted to reflect any compression-specific +requirements. The returned width and height are constrained +to be a multiple of 16 pixels to conform with the +<small>TIFF</small> specification.</p> +<!-- INDENTATION --> +<p><i>TIFFTileSize</i> returns the equivalent size for a +tile of data as it would be returned in a call to +<i>TIFFReadTile</i> or as it would be expected in a call to +<i>TIFFWriteTile</i>.</p> +<!-- INDENTATION --> +<p><i>TIFFVTileSize</i> returns the number of bytes in a +row-aligned tile with <i>nrows</i> of data.</p> +<!-- INDENTATION --> +<p><i>TIFFTileRowSize</i> returns the number of bytes of a +row of data in a tile.</p> +<!-- INDENTATION --> +<p><i>TIFFComputeTile</i> returns the tile that contains the +specified coordinates. A valid tile is always returned; +out-of-range coordinate values are clamped to the bounds of +the image. The <i>x</i> and <i>y</i> parameters are always +used in calculating a tile. The <i>z</i> parameter is used +if the image is deeper than 1 slice +(<i>ImageDepth</i>>1). The <i>sample</i> parameter is +used only if data are organized in separate planes +(<i>PlanarConfiguration</i>=2).</p> +<!-- INDENTATION --> +<p><i>TIFFCheckTile</i> returns a non-zero value if the +supplied coordinates are within the bounds of the image and +zero otherwise. The <i>x</i> parameter is checked against +the value of the <i>ImageWidth</i> tag. The <i>y</i> +parameter is checked against the value of the +<i>ImageLength</i> tag. The <i>z</i> parameter is checked +against the value of the <i>ImageDepth</i> tag (if defined). +The <i>sample</i> parameter is checked against the value of +the <i>SamplesPerPixel</i> parameter if the data are +organized in separate planes.</p> +<!-- INDENTATION --> +<p><i>TIFFNumberOfTiles</i> returns the number of tiles in +the image.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFReadEncodedTile</b>(3TIFF), +<b>TIFFReadRawTile</b>(3TIFF), <b>TIFFReadTile</b>(3TIFF), +<b>TIFFWriteEncodedTile</b>(3TIFF), +<b>TIFFWriteRawTile</b>(3TIFF), <b>TIFFWriteTile</b>(3TIFF), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/fax2ps.1.html b/src/3rdparty/libtiff/html/man/fax2ps.1.html new file mode 100644 index 0000000000..c5396143ab --- /dev/null +++ b/src/3rdparty/libtiff/html/man/fax2ps.1.html @@ -0,0 +1,252 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:18 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>FAX2PS</title> +</head> +<body> + +<h1 align=center>FAX2PS</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>fax2ps − convert a <small>TIFF</small> facsimile to +compressed PostScript™</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>fax2ps</b> [ <i>options</i> ] [ <i>file ...</i> ]</p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>fax2ps</i> reads one or more <small>TIFF</small> +facsimile image files and prints a compressed form of +PostScript on the standard output that is suitable for +printing.</p> +<!-- INDENTATION --> +<p>By default, each page is scaled to reflect the image +dimensions and resolutions stored in the file. The +<b>−x</b> and <b>−y</b> options can be used to +specify the horizontal and vertical image resolutions +(lines/inch), respectively. If the <b>−S</b> option is +specified, each page is scaled to fill an output page. The +default output page is 8.5 by 11 inches. Alternate page +dimensions can be specified in inches with the +<b>−W</b> and <b>−H</b> options.</p> +<!-- INDENTATION --> +<p>By default <i>fax2ps</i> generates PostScript for all +pages in the file. The <b>−p</b> option can be used to +select one or more pages from a multi-page document.</p> +<!-- INDENTATION --> +<p><i>fax2ps</i> generates a compressed form of PostScript +that is optimized for sending pages of text to a PostScript +printer attached to a host through a low-speed link (such as +a serial line). Each output page is filled with white and +then only the black areas are drawn. The PostScript +specification of the black drawing operations is optimized +by using a special font that encodes the move-draw +operations required to fill the black regions on the page. +This compression scheme typically results in a substantially +reduced PostScript description, relative to the +straightforward imaging of the page with a PostScript +<i>image</i> operator. 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 <b>tiff2ps</b>(1).</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="4" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="11%"> + +<p><b>−p</b> <i>number</i></p> +</td> +<td width="76%"> + +<p>Print only the indicated page. Multiple pages may be +printed by specifying this option more than once.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−x</b> <i>resolution</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="23%"></td> +<td width="76%"> +<p>Use <i>resolution</i> as the horizontal resolution, in +dots/inch, of the image data. By default this value is taken +from the file.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−y</b> <i>resolution</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="23%"></td> +<td width="76%"> +<p>Use <i>resolution</i> as the vertical resolution, in +lines/inch, of the image data. By default this value is +taken from the file.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="4" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="12%"> + +<p><b>−S</b></p> +</td> +<td width="76%"> + +<p>Scale each page of image data to fill the output page +dimensions. By default images are presented according to the +dimension information recorded in the <small>TIFF</small> +file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="12%"> + +<p><b>−W</b> <i>width</i></p> +</td> +<td width="76%"> + +<p>Use <i>width</i> as the width, in inches, of the output +page.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="12%"> + +<p><b>−H</b> <i>height</i></p> +</td> +<td width="76%"> + +<p>Use <i>height</i> as the height, in inches, of the +output page.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Some messages about malformed <small>TIFF</small> images +come from the <small>TIFF</small> library.</p> +<!-- INDENTATION --> +<p>Various messages about badly formatted facsimile images +may be generated due to transmission errors in received +facsimile. <i>fax2ps</i> attempts to recover from such data +errors by resynchronizing decoding at the end of the current +scanline. This can result in long horizontal black lines in +the resultant PostScript image.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>If the destination printer supports PostScript Level II +then it is always faster to just send the encoded bitmap +generated by the <b>tiff2ps</b>(1) program.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>fax2ps</i> should probably figure out when it is doing +a poor job of compressing the output and just generate +PostScript to image the bitmap raster instead.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiff2ps</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/fax2tiff.1.html b/src/3rdparty/libtiff/html/man/fax2tiff.1.html new file mode 100644 index 0000000000..38b54c013c --- /dev/null +++ b/src/3rdparty/libtiff/html/man/fax2tiff.1.html @@ -0,0 +1,607 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:18 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>FAX2TIFF</title> +</head> +<body> + +<h1 align=center>FAX2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>fax2tiff − create a <small>TIFF</small> Class F fax +file from raw fax data</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>fax2tiff</b> [ <i>options</i> ] [ <b>−o</b> +<i>output.tif</i> ] <i>input.raw</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Fax2tiff</i> creates a <small>TIFF</small> file +containing <small>CCITT</small> Group 3 or Group 4 encoded +data from one or more files containing +‘‘raw’’ Group 3 or Group 4 encoded +data (typically obtained directly from a fax modem). By +default, each row of data in the resultant +<small>TIFF</small> file is 1-dimensionally encoded and +padded or truncated to 1728 pixels, as needed. The resultant +image is a set of low resolution (98 lines/inch) or medium +resolution (196 lines/inch) pages, each of which is a single +strip of data. The generated file conforms to the +<small>TIFF</small> Class F ( <small>FAX</small> ) +specification for storing facsimile data. This means, in +particular, that each page of the data does <b>not</b> +include the trailing <i>return to control</i> ( +<small>RTC</small> ) code; as required for transmission by +the <small>CCITT</small> Group 3 specifications. The old, +‘‘classic’’, format is created if +the <b>−c</b> option is used. (The Class F format can +also be requested with the <b>−f</b> option.)</p> +<!-- INDENTATION --> +<p>The default name of the output image is <i>fax.tif</i>; +this can be changed with the <b>−o</b> option. Each +input file is assumed to be a separate page of facsimile +data from the same document. The order in which input files +are specified on the command line is the order in which the +resultant pages appear in the output file.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Options that affect the interpretation of input data +are:</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−3</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is <small>CCITT</small> Group 3 +encoded (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−4</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is <small>CCITT</small> Group 4 +encoded.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−U</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is uncompressed (Group 3 or Group +4).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−1</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is encoded with the 1-dimensional +version of the <small>CCITT</small> Group 3 Huffman encoding +algorithm (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−2</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is 2-dimensional version of the +<small>CCITT</small> Group 3 Huffman encoding algorithm.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−P</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is <b>not</b> EOL-aligned (default). +This option has effect with Group 3 encoded input only.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−A</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is EOL-aligned. This option has effect +with Group 3 encoded input only.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−M</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Treat input data as having bits filled from most +significant bit ( <small>MSB</small> ) to most least bit ( +<small>LSB</small> ).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−L</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Treat input data as having bits filled from least +significant bit ( <small>LSB</small> ) to most significant +bit ( <small>MSB</small> ) (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−B</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data was encoded with black as 0 and white +as 1.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−W</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data was encoded with black as 1 and white +as 0 (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−R</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the vertical resolution, in lines/inch, of the +input images. By default input are assumed to have a +vertical resolution of 196 lines/inch. If images are low +resolution facsimile, a value of 98 lines/inch should be +specified.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−X</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the width, in pixels, of the input images. By +default input are assumed to have a width of 1728 +pixels.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Options that affect the output file format are:</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−o</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the name of the output file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−7</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be compressed with the +<small>CCITT</small> Group 3 Huffman encoding algorithm +(default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−8</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be compressed with the +<small>CCITT</small> Group 4 Huffman encoding.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−u</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be uncompressed (Group 3 or Group +4).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−5</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be encoded with the 1-dimensional +version of the <small>CCITT</small> Group 3 Huffman encoding +algorithm.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−6</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be encoded with the 2-dimensional +version of the <small>CCITT</small> Group 3 Huffman encoding +algorithm (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−a</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the last bit of each <i>End Of Line</i> ( +<small>EOL</small> ) code to land on a byte boundary +(default). This ‘‘zero padding’’ +will be reflected in the contents of the +<i>Group3Options</i> tag of the resultant +<small>TIFF</small> file. This option has effect with Group +3 encoded output only.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Do not EOL-align output. This option has effect with +Group 3 encoded output only.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate "classic" Group 3 TIFF format.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−f</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate TIFF Class F (TIFF/F) format (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−m</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output data to have bits filled from most +significant bit ( <small>MSB</small> ) to most least bit ( +<small>LSB</small> ).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−l</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output data to have bits filled from least +significant bit ( <small>LSB</small> ) to most significant +bit ( <small>MSB</small> ) (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the number of rows (scanlines) in each strip of +data written to the output file. By default (or when value +<b>0</b> is specified), <i>tiffcp</i> 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> 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.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Stretch the input image vertically by writing each input +row of data twice to the output file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−v</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force <i>fax2tiff</i> to print the number of rows of +data it retrieved from the input file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−z</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be compressed with the LZW encoding.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following warnings and errors come from the decoding +routines in the library.</p> +<!-- INDENTATION --> +<p><b>Warning, %s: Premature EOL at scanline %d (x +%d).\n</b>. The input data had a row that was shorter than +the expected width. The row is padded with white.</p> +<!-- INDENTATION --> +<p><b>%s: Premature EOF at scanline %d (x %d).\n</b>. The +decoder ran out of data in the middle of a scanline. The +resultant row is padded with white.</p> +<!-- INDENTATION --> +<p><b>%s: Bad code word at row %d, x %d\n</b>. An invalid +Group 3 <i>code</i> was encountered while decoding the input +file. The row number and horizontal position is given. The +remainder of the input row is discarded, while the +corresponding output row is padded with white.</p> +<!-- INDENTATION --> +<p><b>%s: Bad 2D code word at scanline %d.\n</b>. An invalid +Group 4 or 2D Group 3 <i>code</i> was encountered while +decoding the input file. The row number and horizontal +position is given. The remainder of the input row is +discarded, while the corresponding output row is padded with +white.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Input data are assumed to have a a ‘‘top +left’’ orientation; it should be possible to +override this assumption from the command line.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b><small>CCITT</small> Recommendation T.4</b> +(Standardization of Group 3 Facsimile Apparatus for Document +Transmission).</p> +<!-- INDENTATION --> +<p><b>The Spirit of TIFF Class F</b>, an appendix to the +TIFF 5.0 specification prepared by Cygnet Technologies.</p> +<!-- INDENTATION --> +<p><b>tiffinfo</b>(1), <b>tiffdither</b>(1), +<b>tiffgt</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/gif2tiff.1.html b/src/3rdparty/libtiff/html/man/gif2tiff.1.html new file mode 100644 index 0000000000..6114bd317a --- /dev/null +++ b/src/3rdparty/libtiff/html/man/gif2tiff.1.html @@ -0,0 +1,141 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:18 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>GIF2TIFF</title> +</head> +<body> + +<h1 align=center>GIF2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>gif2tiff − create a <small>TIFF</small> file from a +GIF87 format image file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>gif2tiff</b> [ <i>options</i> ] <i>input.gif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Gif2tiff</i> converts a file in the GIF87 format to +<small>TIFF.</small> The <small>TIFF</small> image is +created as a palette image, with samples compressed with the +Lempel-Ziv & Welch algorithm (<i>Compression</i>=5). +These characteristics can overridden, or explicitly +specified with the options described below.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>−c +packbits</b> for the PackBits compression algorithm, +<b>−c zip</b> for the Deflate compression algorithm, +and <b>−c lzw</b> for Lempel-Ziv & Welch (the +default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>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.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The program is based on Paul Haeberli’s +<i>fromgif</i> program which, in turn, is based on Marcel +J.E. Mol’s GIF reader.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Should have more options to control output format.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/index.html b/src/3rdparty/libtiff/html/man/index.html new file mode 100644 index 0000000000..7e9e8d2c7f --- /dev/null +++ b/src/3rdparty/libtiff/html/man/index.html @@ -0,0 +1,64 @@ +<HTML><HEAD><TITLE>Libtiff HTML manpage index</TITLE></HEAD><BODY BGCOLOR=white><ul><H2>Man Pages</h2><p> +<li><A HREF=TIFFbuffer.3tiff.html>TIFFbuffer.3tiff.html</a> +<li><A HREF=TIFFClose.3tiff.html>TIFFClose.3tiff.html</a> +<li><A HREF=TIFFcodec.3tiff.html>TIFFcodec.3tiff.html</a> +<li><A HREF=TIFFcolor.3tiff.html>TIFFcolor.3tiff.html</a> +<li><A HREF=TIFFDataWidth.3tiff.html>TIFFDataWidth.3tiff.html</a> +<li><A HREF=TIFFError.3tiff.html>TIFFError.3tiff.html</a> +<li><A HREF=TIFFFlush.3tiff.html>TIFFFlush.3tiff.html</a> +<li><A HREF=TIFFGetField.3tiff.html>TIFFGetField.3tiff.html</a> +<li><A HREF=TIFFmemory.3tiff.html>TIFFmemory.3tiff.html</a> +<li><A HREF=TIFFOpen.3tiff.html>TIFFOpen.3tiff.html</a> +<li><A HREF=TIFFPrintDirectory.3tiff.html>TIFFPrintDirectory.3tiff.html</a> +<li><A HREF=TIFFquery.3tiff.html>TIFFquery.3tiff.html</a> +<li><A HREF=TIFFReadDirectory.3tiff.html>TIFFReadDirectory.3tiff.html</a> +<li><A HREF=TIFFReadEncodedStrip.3tiff.html>TIFFReadEncodedStrip.3tiff.html</a> +<li><A HREF=TIFFReadEncodedTile.3tiff.html>TIFFReadEncodedTile.3tiff.html</a> +<li><A HREF=TIFFReadRawStrip.3tiff.html>TIFFReadRawStrip.3tiff.html</a> +<li><A HREF=TIFFReadRawTile.3tiff.html>TIFFReadRawTile.3tiff.html</a> +<li><A HREF=TIFFReadRGBAImage.3tiff.html>TIFFReadRGBAImage.3tiff.html</a> +<li><A HREF=TIFFReadRGBAStrip.3tiff.html>TIFFReadRGBAStrip.3tiff.html</a> +<li><A HREF=TIFFReadRGBATile.3tiff.html>TIFFReadRGBATile.3tiff.html</a> +<li><A HREF=TIFFReadScanline.3tiff.html>TIFFReadScanline.3tiff.html</a> +<li><A HREF=TIFFReadTile.3tiff.html>TIFFReadTile.3tiff.html</a> +<li><A HREF=TIFFRGBAImage.3tiff.html>TIFFRGBAImage.3tiff.html</a> +<li><A HREF=TIFFSetDirectory.3tiff.html>TIFFSetDirectory.3tiff.html</a> +<li><A HREF=TIFFSetField.3tiff.html>TIFFSetField.3tiff.html</a> +<li><A HREF=TIFFsize.3tiff.html>TIFFsize.3tiff.html</a> +<li><A HREF=TIFFstrip.3tiff.html>TIFFstrip.3tiff.html</a> +<li><A HREF=TIFFswab.3tiff.html>TIFFswab.3tiff.html</a> +<li><A HREF=TIFFtile.3tiff.html>TIFFtile.3tiff.html</a> +<li><A HREF=TIFFWarning.3tiff.html>TIFFWarning.3tiff.html</a> +<li><A HREF=TIFFWriteDirectory.3tiff.html>TIFFWriteDirectory.3tiff.html</a> +<li><A HREF=TIFFWriteEncodedStrip.3tiff.html>TIFFWriteEncodedStrip.3tiff.html</a> +<li><A HREF=TIFFWriteEncodedTile.3tiff.html>TIFFWriteEncodedTile.3tiff.html</a> +<li><A HREF=TIFFWriteRawStrip.3tiff.html>TIFFWriteRawStrip.3tiff.html</a> +<li><A HREF=TIFFWriteRawTile.3tiff.html>TIFFWriteRawTile.3tiff.html</a> +<li><A HREF=TIFFWriteScanline.3tiff.html>TIFFWriteScanline.3tiff.html</a> +<li><A HREF=TIFFWriteTile.3tiff.html>TIFFWriteTile.3tiff.html</a> +<li><A HREF=fax2ps.1.html>fax2ps.1.html</a> +<li><A HREF=fax2tiff.1.html>fax2tiff.1.html</a> +<li><A HREF=gif2tiff.1.html>gif2tiff.1.html</a> +<li><A HREF=pal2rgb.1.html>pal2rgb.1.html</a> +<li><A HREF=ppm2tiff.1.html>ppm2tiff.1.html</a> +<li><A HREF=ras2tiff.1.html>ras2tiff.1.html</a> +<li><A HREF=raw2tiff.1.html>raw2tiff.1.html</a> +<li><A HREF=rgb2ycbcr.1.html>rgb2ycbcr.1.html</a> +<li><A HREF=sgi2tiff.1.html>sgi2tiff.1.html</a> +<li><A HREF=thumbnail.1.html>thumbnail.1.html</a> +<li><A HREF=tiff2bw.1.html>tiff2bw.1.html</a> +<li><A HREF=tiff2pdf.1.html>tiff2pdf.1.html</a> +<li><A HREF=tiff2ps.1.html>tiff2ps.1.html</a> +<li><A HREF=tiff2rgba.1.html>tiff2rgba.1.html</a> +<li><A HREF=tiffcmp.1.html>tiffcmp.1.html</a> +<li><A HREF=tiffcp.1.html>tiffcp.1.html</a> +<li><A HREF=tiffcrop.1.html>tiffcrop.1.html</a> +<li><A HREF=tiffdither.1.html>tiffdither.1.html</a> +<li><A HREF=tiffdump.1.html>tiffdump.1.html</a> +<li><A HREF=tiffgt.1.html>tiffgt.1.html</a> +<li><A HREF=tiffinfo.1.html>tiffinfo.1.html</a> +<li><A HREF=tiffmedian.1.html>tiffmedian.1.html</a> +<li><A HREF=tiffset.1.html>tiffset.1.html</a> +<li><A HREF=tiffsplit.1.html>tiffsplit.1.html</a> +<li><A HREF=tiffsv.1.html>tiffsv.1.html</a> +</ul></BODY></HTML> diff --git a/src/3rdparty/libtiff/html/man/libtiff.3tiff.html b/src/3rdparty/libtiff/html/man/libtiff.3tiff.html new file mode 100644 index 0000000000..bea73f761f --- /dev/null +++ b/src/3rdparty/libtiff/html/man/libtiff.3tiff.html @@ -0,0 +1,3137 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:14 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>INTRO</title> +</head> +<body> + +<h1 align=center>INTRO</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DATA TYPES">DATA TYPES</a><br> +<a href="#LIST OF ROUTINES">LIST OF ROUTINES</a><br> +<a href="#TAG USAGE">TAG USAGE</a><br> +<a href="#PSEUDO TAGS">PSEUDO TAGS</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> +<a href="#BUGS">BUGS</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>libtiff − introduction to <i>libtiff</i>, a +library for reading and writing</big> TIFF +<big>files</big></p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>#include <tiffio.h></b></big></p> +<!-- INDENTATION --> +<p><big>cc file.c <b>-ltiff</b></big></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><i>libtiff</i> is a library for reading and writing +data files encoded with the <i>Tag Image File</i> format, +Revision 6.0 (or revision 5.0 or revision 4.0). This file +format is suitable for archiving multi-color and +monochromatic image data.</big></p> +<!-- INDENTATION --> +<p><big>The library supports several compression algorithms, +as indicated by the <i>Compression</i> field, including: no +compression (1),</big> CCITT <big>1D Huffman compression +(2),</big> CCITT <big>Group 3 Facsimile compression +(3),</big> CCITT <big>Group 4 Facsimile compression (4), +Lempel-Ziv & Welch compression (5), baseline JPEG +compression (7), word-aligned 1D Huffman compression +(32771), and PackBits compression (32773). In addition, +several nonstandard compression algorithms are supported: +the 4-bit compression algorithm used by the +<i>ThunderScan</i> program (32809) (decompression only), +NeXT’s 2-bit compression algorithm (32766) +(decompression only), an experimental LZ-style algorithm +known as Deflate (32946), and an experimental CIE LogLuv +compression scheme designed for images with high dynamic +range (32845 for LogL and 32845 for LogLuv). Directory +information may be in either little- or big-endian byte +order−byte swapping is automatically done by the +library. Data bit ordering may be either Most Significant +Bit (</big> MSB <big>) to Least Significant Bit (</big> LSB +<big>) or</big> LSB <big>to</big> MSB. <big>Finally, the +library does not support files in which the +<i>BitsPerSample</i>, <i>Compression</i>, +<i>MinSampleValue</i>, or <i>MaxSampleValue</i> fields are +defined differently on a per-sample basis (in Rev. 6.0 the +<i>Compression</i> tag is not defined on a per-sample basis, +so this is immaterial).</big></p> +</td> +</table> +<a name="DATA TYPES"></a> +<h2>DATA TYPES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The library makes extensive use of C typedefs to +promote portability. Two sets of typedefs are used, one for +communication with clients of the library and one for +internal data structures and parsing of the</big> TIFF +<big>format. The following typedefs are exposed to users +either through function definitions or through parameters +passed through the varargs interfaces.</big></p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="3" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef unsigned short uint16;</big></p> +</td> +<td width="38%"> + +<p><big>16-bit unsigned integer</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef unsigned <<i>thing</i>> +uint32;</big></p> +</td> +<td width="38%"> + +<p><big>32-bit unsigned integer</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef unsigned int ttag_t;</big></p> +</td> +<td width="38%"> + +<p><big>directory tag</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef uint16 tdir_t;</big></p> +</td> +<td width="38%"> + +<p><big>directory index</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef uint16 tsample_t;</big></p> +</td> +<td width="38%"> + +<p><big>sample number</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef uint32 tstrip_t;</big></p> +</td> +<td width="38%"> + +<p><big>strip number</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef uint32 ttile_t;</big></p> +</td> +<td width="38%"> + +<p><big>tile number</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef int32 tsize_t;</big></p> +</td> +<td width="38%"> + +<p><big>i/o size in bytes</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef void* tdata_t;</big></p> +</td> +<td width="38%"> + +<p><big>image data ref</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef void* thandle_t;</big></p> +</td> +<td width="38%"> + +<p><big>client data handle</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef int32 toff_t;</big></p> +</td> +<td width="38%"> + +<p><big>file offset</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Note that <i>tstrip_t</i>, <i>ttile_t</i>, and +<i>tsize_t</i> are constrained to be no more than 32-bit +quantities by 32-bit fields they are stored in in the</big> +TIFF <big>image. Likewise <i>tsample_t</i> is limited by the +16-bit field used to store the <i>SamplesPerPixel</i> tag. +<i>tdir_t</i> constrains the maximum number of</big> IFDs +<big>that may appear in an image and may be an arbitrary +size (w/o penalty). <i>ttag_t</i> must be either int, +unsigned int, pointer, or double because the library uses a +varargs interface and</big> ANSI C <big>restricts the type +of the parameter before an ellipsis to be a promoted type. +<i>toff_t</i> is defined as int32 because TIFF file offsets +are (unsigned) 32-bit quantities. A signed value is used +because some interfaces return −1 on error. Finally, +note that user-specified data references are passed as +opaque handles and only cast at the lowest layers where +their type is presumed.</big></p> +</td> +</table> +<a name="LIST OF ROUTINES"></a> +<h2>LIST OF ROUTINES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The following routines are part of the library. +Consult specific manual pages for details on their +operation; on most systems doing ‘‘man +function-name’’ will work.</big></p></td> +</table> +<!-- TABS --> + +<p><big><i>Name Description</i></big></p> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="3" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCheckpointDirectory</big></p> +</td> +<td width="67%"> + +<p><big>writes the current state of the directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCheckTile</big></p> +</td> +<td width="67%"> + +<p><big>very x,y,z,sample is within image</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCIELabToRGBInit</big></p> +</td> +<td width="67%"> + +<p><big>initialize CIE L*a*b* 1976 to RGB conversion +state</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCIELabToXYZ</big></p> +</td> +<td width="67%"> + +<p><big>perform CIE L*a*b* 1976 to CIE XYZ +conversion</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFClientOpen</big></p> +</td> +<td width="67%"> + +<p><big>open a file for reading or writing</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFClose</big></p> +</td> +<td width="67%"> + +<p><big>close an open file</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFComputeStrip</big></p> +</td> +<td width="67%"> + +<p><big>return strip containing y,sample</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFComputeTile</big></p> +</td> +<td width="67%"> + +<p><big>return tile containing x,y,z,sample</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCurrentDirectory</big></p> +</td> +<td width="67%"> + +<p><big>return index of current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCurrentRow</big></p> +</td> +<td width="67%"> + +<p><big>return index of current scanline</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCurrentStrip</big></p> +</td> +<td width="67%"> + +<p><big>return index of current strip</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCurrentTile</big></p> +</td> +<td width="67%"> + +<p><big>return index of current tile</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFDataWidth</big></p> +</td> +<td width="67%"> + +<p><big>return the size of TIFF data types</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFError</big></p> +</td> +<td width="67%"> + +<p><big>library error handler</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFdOpen</big></p> +</td> +<td width="67%"> + +<p><big>open a file for reading or writing</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFileName</big></p> +</td> +<td width="67%"> + +<p><big>return name of open file</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFileno</big></p> +</td> +<td width="67%"> + +<p><big>return open file descriptor</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFindCODEC</big></p> +</td> +<td width="67%"> + +<p><big>find standard codec for the specific +scheme</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFlush</big></p> +</td> +<td width="67%"> + +<p><big>flush all pending writes</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFlushData</big></p> +</td> +<td width="67%"> + +<p><big>flush pending data writes</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFGetBitRevTable</big></p> +</td> +<td width="67%"> + +<p><big>return bit reversal table</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFGetField</big></p> +</td> +<td width="67%"> + +<p><big>return tag value in current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFGetFieldDefaulted</big></p> +</td> +<td width="67%"> + +<p><big>return tag value in current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFGetMode</big></p> +</td> +<td width="67%"> + +<p><big>return open file mode</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFGetVersion</big></p> +</td> +<td width="67%"> + +<p><big>return library version string</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFIsCODECConfigured</big></p> +</td> +<td width="67%"> + +<p><big>check, whether we have working codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFIsMSB2LSB</big></p> +</td> +<td width="67%"> + +<p><big>return true if image data is being +returned</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"></td> +<td width="67%"> + +<p><big>with bit 0 as the most significant bit</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFIsTiled</big></p> +</td> +<td width="67%"> + +<p><big>return true if image data is tiled</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFIsByteSwapped</big></p> +</td> +<td width="67%"> + +<p><big>return true if image data is byte-swapped</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFNumberOfStrips</big></p> +</td> +<td width="67%"> + +<p><big>return number of strips in an image</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFNumberOfTiles</big></p> +</td> +<td width="67%"> + +<p><big>return number of tiles in an image</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFOpen</big></p> +</td> +<td width="67%"> + +<p><big>open a file for reading or writing</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFPrintDirectory</big></p> +</td> +<td width="67%"> + +<p><big>print description of the current +directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadBufferSetup</big></p> +</td> +<td width="67%"> + +<p><big>specify i/o buffer for reading</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadDirectory</big></p> +</td> +<td width="67%"> + +<p><big>read the next directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadEncodedStrip</big></p> +</td> +<td width="67%"> + +<p><big>read and decode a strip of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadEncodedTile</big></p> +</td> +<td width="67%"> + +<p><big>read and decode a tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadRawStrip</big></p> +</td> +<td width="67%"> + +<p><big>read a raw strip of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadRawTile</big></p> +</td> +<td width="67%"> + +<p><big>read a raw tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadRGBAImage</big></p> +</td> +<td width="67%"> + +<p><big>read an image into a fixed format raster</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadScanline</big></p> +</td> +<td width="67%"> + +<p><big>read and decode a row of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadTile</big></p> +</td> +<td width="67%"> + +<p><big>read and decode a tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRegisterCODEC</big></p> +</td> +<td width="67%"> + +<p><big>override standard codec for the specific +scheme</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReverseBits</big></p> +</td> +<td width="67%"> + +<p><big>reverse bits in an array of bytes</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRGBAImageBegin</big></p> +</td> +<td width="67%"> + +<p><big>setup decoder state for TIFFRGBAImageGet</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRGBAImageEnd</big></p> +</td> +<td width="67%"> + +<p><big>release TIFFRGBAImage decoder state</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRGBAImageGet</big></p> +</td> +<td width="67%"> + +<p><big>read and decode an image</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRGBAImageOK</big></p> +</td> +<td width="67%"> + +<p><big>is image readable by TIFFRGBAImageGet</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFScanlineSize</big></p> +</td> +<td width="67%"> + +<p><big>return size of a scanline</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSetDirectory</big></p> +</td> +<td width="67%"> + +<p><big>set the current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSetSubDirectory</big></p> +</td> +<td width="67%"> + +<p><big>set the current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSetErrorHandler</big></p> +</td> +<td width="67%"> + +<p><big>set error handler function</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSetField</big></p> +</td> +<td width="67%"> + +<p><big>set a tag’s value in the current +directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSetWarningHandler</big></p> +</td> +<td width="67%"> + +<p><big>set warning handler function</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFStripSize</big></p> +</td> +<td width="67%"> + +<p><big>returns size of a strip</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRawStripSize</big></p> +</td> +<td width="67%"> + +<p><big>returns the number of bytes in a raw +strip</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSwabShort</big></p> +</td> +<td width="67%"> + +<p><big>swap bytes of short</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSwabLong</big></p> +</td> +<td width="67%"> + +<p><big>swap bytes of long</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSwabArrayOfShort</big></p> +</td> +<td width="67%"> + +<p><big>swap bytes of an array of shorts</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSwabArrayOfLong</big></p> +</td> +<td width="67%"> + +<p><big>swap bytes of an array of longs</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFTileRowSize</big></p> +</td> +<td width="67%"> + +<p><big>return size of a row in a tile</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFTileSize</big></p> +</td> +<td width="67%"> + +<p><big>return size of a tile</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFUnRegisterCODEC</big></p> +</td> +<td width="67%"> + +<p><big>unregisters the codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFVGetField</big></p> +</td> +<td width="67%"> + +<p><big>return tag value in current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFVGetFieldDefaulted</big></p> +</td> +<td width="67%"> + +<p><big>return tag value in current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFVSetField</big></p> +</td> +<td width="67%"> + +<p><big>set a tag’s value in the current +directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFVStripSize</big></p> +</td> +<td width="67%"> + +<p><big>returns the number of bytes in a strip</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWarning</big></p> +</td> +<td width="67%"> + +<p><big>library warning handler</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteDirectory</big></p> +</td> +<td width="67%"> + +<p><big>write the current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteEncodedStrip</big></p> +</td> +<td width="67%"> + +<p><big>compress and write a strip of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteEncodedTile</big></p> +</td> +<td width="67%"> + +<p><big>compress and write a tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteRawStrip</big></p> +</td> +<td width="67%"> + +<p><big>write a raw strip of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteRawTile</big></p> +</td> +<td width="67%"> + +<p><big>write a raw tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteScanline</big></p> +</td> +<td width="67%"> + +<p><big>write a scanline of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteTile</big></p> +</td> +<td width="67%"> + +<p><big>compress and write a tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFXYZToRGB</big></p> +</td> +<td width="67%"> + +<p><big>perform CIE XYZ to RGB conversion</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFYCbCrToRGBInit</big></p> +</td> +<td width="67%"> + +<p><big>initialize YCbCr to RGB conversion state</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFYCbCrtoRGB</big></p> +</td> +<td width="67%"> + +<p><big>perform YCbCr to RGB conversion</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Auxiliary functions:</big></p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="3" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFfree</big></p> +</td> +<td width="67%"> + +<p><big>free memory buffer</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFmalloc</big></p> +</td> +<td width="67%"> + +<p><big>dynamically allocate memory buffer</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFmemcmp</big></p> +</td> +<td width="67%"> + +<p><big>compare contents of the memory buffers</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFmemcpy</big></p> +</td> +<td width="67%"> + +<p><big>copy contents of the one buffer to +another</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFmemset</big></p> +</td> +<td width="67%"> + +<p><big>fill memory buffer with a constant byte</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFrealloc</big></p> +</td> +<td width="67%"> + +<p><big>dynamically reallocate memory buffer</big></p> +</td> +</table> +<a name="TAG USAGE"></a> +<h2>TAG USAGE</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The table below lists the</big> TIFF <big>tags that +are recognized and handled by the library. If no use is +indicated in the table, then the library reads and writes +the tag, but does not use it internally. Note that some tags +are meaningful only when a particular compression scheme is +being used; e.g. <i>Group3Options</i> is only useful if +<i>Compression</i> is set to</big> CCITT <big>Group 3 +encoding. Tags of this sort are considered +<i>codec-specific</i> tags and the library does not +recognize them except when the <i>Compression</i> tag has +been previously set to the relevant compression +scheme.</big></p> +<!-- INDENTATION --> +<pre><big><i>Tag Name Value R/W Library Use/Notes +</i></big></pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Artist</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>315</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>BadFaxLines</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>326</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>BitsPerSample</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>258</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>lots</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>CellLength</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>265</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>CellWidth</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>264</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>CleanFaxData</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>327</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ColorMap</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>320</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ColorResponseUnit</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>300</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Compression</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>259</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>choosing codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ConsecutiveBadFaxLines</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>328</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Copyright 33432 R/W</big></p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>DataType</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>32996</big></p> +</td> +<td width="53%"> + +<p><big>R</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>obsoleted by SampleFormat tag</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>DateTime</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>306</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>DocumentName</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>269</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>DotRange</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>336</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ExtraSamples</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>338</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>lots</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FaxRecvParams</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>34908</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FaxSubAddress</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>34909</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FaxRecvTime</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>34910</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FillOrder</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>266</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>control bit order</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FreeByteCounts</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>289</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FreeOffsets</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>288</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>GrayResponseCurve</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>291</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>GrayResponseUnit</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>290</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Group3Options</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>292</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by Group 3 codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Group4Options</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>293</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>HostComputer</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>316</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ImageDepth</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>32997</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>tile/strip calculations</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ImageDescription</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>270</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ImageLength</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>257</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>lots</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ImageWidth</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>256</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>lots</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>InkNames</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>333</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>InkSet</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>332</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>JPEGTables</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>347</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by JPEG codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Make</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>271</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Matteing</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>32995</big></p> +</td> +<td width="53%"> + +<p><big>R</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>obsoleted by ExtraSamples tag</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>MaxSampleValue</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>281</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>MinSampleValue</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>280</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Model</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>272</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>NewSubFileType</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>254</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>called SubFileType in spec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>NumberOfInks</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>334</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Orientation</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>274</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>PageName</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>285</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>PageNumber</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>297</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>PhotometricInterpretation</big></p> +</td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>262</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>R/Wused by Group 3 and JPEG codecs</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>PlanarConfiguration</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>284</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Predictor</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>317</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by LZW and Deflate codecs</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>PrimaryChromacities</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>319</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ReferenceBlackWhite</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>532</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ResolutionUnit</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>296</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by Group 3 codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>RowsPerStrip</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>278</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>SampleFormat</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>339</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>SamplesPerPixel</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>277</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>lots</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>SMinSampleValue</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>340</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>SMaxSampleValue</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>341</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Software</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>305</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>StoNits</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>37439</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>StripByteCounts</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>279</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>StripOffsets</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>273</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>SubFileType</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>255</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>called OSubFileType in spec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TargetPrinter</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>337</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Thresholding</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>263</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TileByteCounts</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>324</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TileDepth</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>32998</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>tile/strip calculations</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TileLength</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>323</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TileOffsets</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>324</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TileWidth</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>322</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TransferFunction</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>301</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>WhitePoint</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>318</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>XPosition</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>286</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>XResolution</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>282</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>YCbCrCoefficients</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>529</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by TIFFRGBAImage support</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>YCbCrPositioning</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>531</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>tile/strip size calulcations</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>YCbCrSubsampling</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>530</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>YPosition</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>286</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>YResolution</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>283</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by Group 3 codec</big></p> +</td> +</table> +<a name="PSEUDO TAGS"></a> +<h2>PSEUDO TAGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>In addition to the normal</big> TIFF <big>tags the +library supports a collection of tags whose values lie in a +range outside the valid range of</big> TIFF <big>tags. These +tags are termed <i>pseud-tags</i> and are used to control +various codec-specific functions within the library. The +table below summarizes the defined pseudo-tags.</big></p> +<!-- INDENTATION --> +<pre><big><i>Tag Name Codec R/W Library Use/Notes +</i></big></pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_FAXMODE</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>G3</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>general codec operation</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_FAXFILLFUNC</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>G3/G4</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>bitmap fill function</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_JPEGQUALITY</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>JPEG</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>compression quality control</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_JPEGCOLORMODE</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>JPEG</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>control colorspace conversions</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_JPEGTABLESMODE</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>JPEG</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>control contents of <i>JPEGTables</i> tag</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_ZIPQUALITY</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>Deflate</big></p> +</td> +<td width="53%"> + +<p><big>R/Wcompression quality level</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_PIXARLOGDATAFMT</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>PixarLog</big></p> +</td> +<td width="53%"> + +<p><big>R/Wuser data format</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_PIXARLOGQUALITY</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>PixarLog</big></p> +</td> +<td width="53%"> + +<p><big>R/Wcompression quality level</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_SGILOGDATAFMT</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>SGILog</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>user data format</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_FAXMODE</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the operation of the Group 3 codec. Possible +values (independent bits that can be combined by +or’ing them together) are: FAXMODE_CLASSIC (enable +old-style format in which the</big> RTC <big>is written at +the end of the last strip), FAXMODE_NORTC (opposite of +FAXMODE_CLASSIC; also called FAXMODE_CLASSF), FAXMODE_NOEOL +(do not write</big> EOL <big>codes at the start of each row +of data), FAXMODE_BYTEALIGN (align each encoded row to an +8-bit boundary), FAXMODE_WORDALIGN (align each encoded row +to an 16-bit boundary), The default value is dependent on +the compression scheme; this pseudo-tag is used by the +various G3 and G4 codecs to share code.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_FAXFILLFUNC</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the function used to convert arrays of black +and white runs to packed bit arrays. This hook can be used +to image decoded scanlines in multi-bit depth rasters (e.g. +for display in colormap mode) or for other purposes. The +default value is a pointer to a builtin function that images +packed bilevel data.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_IPTCNEWSPHOTO</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Tag contaings image metadata per the IPTC newsphoto +spec: Headline, captioning, credit, etc... Used by most wire +services.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_PHOTOSHOP</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Tag contains Photoshop captioning information and +metadata. Photoshop uses in parallel and redundantly +alongside IPTCNEWSPHOTO information.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_JPEGQUALITY</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the compression quality level used in the +baseline algorithm. Note that quality levels are in the +range 0-100 with a default value of 75.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_JPEGCOLORMODE</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control whether or not conversion is done between +RGB and YCbCr colorspaces. Possible values are: +JPEGCOLORMODE_RAW (do not convert), and JPEGCOLORMODE_RGB +(convert to/from RGB) The default value is +JPEGCOLORMODE_RAW.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_JPEGTABLESMODE</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the information written in the +<i>JPEGTables</i> tag. Possible values (independent bits +that can be combined by or’ing them together) are: +JPEGTABLESMODE_QUANT (include quantization tables), and +JPEGTABLESMODE_HUFF (include Huffman encoding tables). The +default value is +JPEGTABLESMODE_QUANT|JPEGTABLESMODE_HUFF.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_ZIPQUALITY</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the compression technique used by the +Deflate codec. Quality levels are in the range 1-9 with +larger numbers yielding better compression at the cost of +more computation. The default quality level is 6 which +yields a good time-space tradeoff.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_PIXARLOGDATAFMT</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the format of user data passed <i>in</i> to +the PixarLog codec when encoding and passed <i>out</i> from +when decoding. Possible values are: PIXARLOGDATAFMT_8BIT for +8-bit unsigned pixels, PIXARLOGDATAFMT_8BITABGR for 8-bit +unsigned ABGR-ordered pixels, PIXARLOGDATAFMT_11BITLOG for +11-bit log-encoded raw data, PIXARLOGDATAFMT_12BITPICIO for +12-bit PICIO-compatible data, PIXARLOGDATAFMT_16BIT for +16-bit signed samples, and PIXARLOGDATAFMT_FLOAT for 32-bit +IEEE floating point samples.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_PIXARLOGQUALITY</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the compression technique used by the +PixarLog codec. This value is treated identically to +TIFFTAG_ZIPQUALITY; see the above description.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_SGILOGDATAFMT</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the format of client data passed <i>in</i> +to the SGILog codec when encoding and passed <i>out</i> from +when decoding. Possible values are: SGILOGDATAFMT_FLTXYZ for +converting between LogLuv and 32-bit IEEE floating valued +XYZ pixels, SGILOGDATAFMT_16BITLUV for 16-bit encoded Luv +pixels, SGILOGDATAFMT_32BITRAW and SGILOGDATAFMT_24BITRAW +for no conversion of data, SGILOGDATAFMT_8BITRGB for +returning 8-bit RGB data (valid only when decoding +LogLuv-encoded data), SGILOGDATAFMT_FLTY for converting +between LogL and 32-bit IEEE floating valued Y pixels, +SGILOGDATAFMT_16BITL for 16-bit encoded L pixels, and +SGILOGDATAFMT_8BITGRY for returning 8-bit greyscale data +(valid only when decoding LogL-encoded data).</big></p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>All error messages are directed through the +<i>TIFFError</i> routine. By default messages are directed +to <b>stderr</b> in the form: <i>module: message\n.</i> +Warning messages are likewise directed through the +<i>TIFFWarning</i> routine.</big></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>fax2tiff</b>(1), <b>gif2tiff</b>(1), +<b>pal2rgb</b>(1), <b>ppm2tiff</b>(1), <b>rgb2ycbcr</b>(1), +<b>ras2tiff</b>(1), <b>raw2tiff</b>(1), <b>sgi2tiff</b>(1), +<b>tiff2bw</b>(1), <b>tiffdither</b>(1), <b>tiffdump</b>(1), +<b>tiffcp</b>(1), <b>tiffcmp</b>(1), <b>tiffgt</b>(1), +<b>tiffinfo</b>(1), <b>tiffmedian</b>(1), +<b>tiffsplit</b>(1), <b>tiffsv</b>(1).</big></p> +<!-- INDENTATION --> +<p><big><b>Tag Image File Format Specification — +Revision 6.0</b>, an Aldus Technical Memorandum.</big></p> +<!-- INDENTATION --> +<p><big><b>The Spirit of TIFF Class F</b>, an appendix to +the TIFF 5.0 specification prepared by Cygnet +Technologies.</big></p> +<!-- INDENTATION --> +<p><big>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></big></p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The library does not support multi-sample images +where some samples have different bits/sample.</big></p> +<!-- INDENTATION --> +<p><big>The library does not support random access to +compressed data that is organized with more than one row per +tile or strip.</big></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/pal2rgb.1.html b/src/3rdparty/libtiff/html/man/pal2rgb.1.html new file mode 100644 index 0000000000..5c3a679a95 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/pal2rgb.1.html @@ -0,0 +1,189 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:18 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>PAL2RGB</title> +</head> +<body> + +<h1 align=center>PAL2RGB</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>pal2rgb − convert a palette color +<small>TIFF</small> image to a full color image</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b> [ <i>options</i> ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Pal2rgb</i> converts a palette color +<small>TIFF</small> image to a full color image by applying +the colormap of the palette image to each sample to generate +a full color <small>RGB</small> image.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Options that affect the interpretation of input data +are:</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−C</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>This option overrides the default behavior of +<i>pal2rgb</i> in determining whether or not colormap +entries contain 16-bit or 8-bit values. By default the +colormap is inspected and if no colormap entry greater than +255 is found, the colormap is assumed to have only 8-bit +values; otherwise 16-bit values (as required by the +<small>TIFF</small> specification) are assumed. The +<b>−C</b> option can be used to explicitly specify the +number of bits for colormap entries: <b>−C 8</b> for +8-bit values, <b>−C 16</b> for 16-bit values.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Options that affect the output file format are:</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="5%"> + +<p><b>−p</b></p> +</td> +<td width="3%"></td> +<td width="80%"> + +<p>Explicitly select the planar configuration used in +organizing data samples in the output image: <b>−p +contig</b> for samples packed contiguously, and <b>−p +separate</b> for samples stored separately. By default +samples are packed.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="5%"> + +<p><b>−c</b></p> +</td> +<td width="3%"></td> +<td width="80%"> + +<p>Use the specific compression algorithm to encoded image +data in the output file: <b>−c packbits</b> for +Macintosh Packbits, <b>−c lzw</b> for Lempel-Ziv & +Welch, <b>−c zip</b> for Deflate, <b>−c none</b> +for no compression. If no compression-related option is +specified, the input file’s compression algorithm is +used.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="5%"> + +<p><b>−r</b></p> +</td> +<td width="3%"></td> +<td width="80%"> + +<p>Explicitly specify the number of rows in each strip of +the output file. If the <b>−r</b> option is not +specified, a number is selected such that each output strip +has approximately 8 kilobytes of data in it.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Only 8-bit images are handled.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/ppm2tiff.1.html b/src/3rdparty/libtiff/html/man/ppm2tiff.1.html new file mode 100644 index 0000000000..60e56e1ff5 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/ppm2tiff.1.html @@ -0,0 +1,141 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:18 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>PPM2TIFF</title> +</head> +<body> + +<h1 align=center>PPM2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>ppm2tiff − create a <small>TIFF</small> file from +<small>PPM, PGM</small> and <small>PBM</small> image +files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ppm2tiff</b> [ <i>options</i> ] [ <i>input.ppm</i> ] +<i>output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>ppm2tiff</i> converts a file in the <small>PPM, +PGM</small> and <small>PBM</small> image formats to +<small>TIFF.</small> By default, the <small>TIFF</small> +image is created with data samples packed +(<i>PlanarConfiguration</i>=1), compressed with the Packbits +algorithm (<i>Compression</i>=32773), and with each strip no +more than 8 kilobytes. These characteristics can be +overridden, or explicitly specified with the options +described below</p> +<!-- INDENTATION --> +<p>If the <small>PPM</small> file contains greyscale data, +then the <i>PhotometricInterpretation</i> tag is set to 1 +(min-is-black), otherwise it is set to 2 (RGB).</p> +<!-- INDENTATION --> +<p>If no <small>PPM</small> file is specified on the command +line, <i>ppm2tiff</i> will read from the standard input.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>none</b> for no compression, <b>packbits</b> for +PackBits compression (will be used by default), <b>lzw</b> +for Lempel-Ziv & Welch compression, <b>jpeg</b> for +baseline JPEG compression, <b>zip</b> for Deflate +compression, <b>g3</b> for CCITT Group 3 (T.4) compression, +and <b>g4</b> for CCITT Group 4 (T.6) compression.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>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.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−R</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Mark the resultant image to have the specified X and Y +resolution (in dots/inch).</p> +</td> +<td width="0%"> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/ras2tiff.1.html b/src/3rdparty/libtiff/html/man/ras2tiff.1.html new file mode 100644 index 0000000000..b0b8993288 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/ras2tiff.1.html @@ -0,0 +1,139 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:18 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>RAS2TIFF</title> +</head> +<body> + +<h1 align=center>RAS2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>ras2tiff − create a <small>TIFF</small> file from a +Sun rasterfile</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ras2tiff</b> [ <i>options</i> ] <i>input.ras +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>ras2tiff</i> converts a file in the Sun rasterfile +format to <small>TIFF.</small> By default, the +<small>TIFF</small> image is created with data samples +packed (<i>PlanarConfiguration</i>=1), compressed with the +Lempel-Ziv & Welch algorithm (<i>Compression</i>=5), and +with each strip no more than 8 kilobytes. These +characteristics can overridden, or explicitly specified with +the options described below.</p> +<!-- INDENTATION --> +<p>Any colormap information in the rasterfile is carried +over to the <small>TIFF</small> file by including a +<i>Colormap</i> tag in the output file. If the rasterfile +has a colormap, the <i>PhotometricInterpretation</i> tag is +set to 3 (palette); otherwise it is set to 2 (RGB) if the +depth is 24 or 1 (min-is-black) if the depth is not 24.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−c</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>−c +packbits</b> for the PackBits compression algorithm, +<b>−c jpeg</b> for the baseline JPEG compression +algorithm, <b>−c zip</b> for the Deflate compression +algorithm, and <b>−c lzw</b> for Lempel-Ziv & +Welch (the default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−r</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>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.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Does not handle all possible rasterfiles. In particular, +<i>ras2tiff</i> does not handle run-length encoded +images.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/raw2tiff.1.html b/src/3rdparty/libtiff/html/man/raw2tiff.1.html new file mode 100644 index 0000000000..360eb27718 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/raw2tiff.1.html @@ -0,0 +1,510 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:18 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>RAW2TIFF</title> +</head> +<body> + +<h1 align=center>RAW2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#GUESSING THE IMAGE GEOMETRY">GUESSING THE IMAGE GEOMETRY</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>raw2tiff − create a <small>TIFF</small> file from a +raw data</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>raw2tiff</b> [ <i>options</i> ] <i>input.raw +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>raw2tiff</i> converts a raw byte sequence into +<small>TIFF.</small> By default, the <small>TIFF</small> +image is created with data samples packed +(<i>PlanarConfiguration</i>=1), compressed with the PackBits +algorithm (<i>Compression</i>=32773), and with each strip no +more than 8 kilobytes. These characteristics can overridden, +or explicitly specified with the options described +below.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−H</b> <i>number</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>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.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−w</b> <i>number</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>width of input image in pixels (can be guessed, see +<b><small>GUESSING THE IMAGE GEOMETRY</small></b> +below).</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−l</b> <i>number</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>length of input image in lines (can be guessed, see +<b><small>GUESSING THE IMAGE GEOMETRY</small></b> +below).</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−b</b> <i>number</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>number of bands in input image (1 by default).</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−d</b> <i>data_type</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>type of samples in input image, where <i>data_type</i> +may be:</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="3" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="10%"> + +<p><b>byte</b></p> +</td> +<td width="70%"> + +<p>8-bit unsigned integer (default),</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="10%"> + +<p><b>short</b></p> +</td> +<td width="70%"> + +<p>16-bit unsigned integer,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="10%"> + +<p><b>long</b></p> +</td> +<td width="70%"> + +<p>32-bit unsigned integer,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="10%"> + +<p><b>sbyte</b></p> +</td> +<td width="70%"> + +<p>8-bit signed integer,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="10%"> + +<p><b>sshort</b></p> +</td> +<td width="70%"> + +<p>16-bit signed integer,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="10%"> + +<p><b>slong</b></p> +</td> +<td width="70%"> + +<p>32-bit signed integer,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="10%"> + +<p><b>float</b></p> +</td> +<td width="70%"> + +<p>32-bit IEEE floating point,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="10%"> + +<p><b>double</b></p> +</td> +<td width="70%"> + +<p>64-bit IEEE floating point.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−i</b> <i>config</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>type of samples interleaving in input image, where +<i>config</i> may be:</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="3" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="8%"> + +<p><b>pixel</b></p> +</td> +<td width="71%"> + +<p>pixel interleaved data (default),</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="8%"> + +<p><b>band</b></p> +</td> +<td width="71%"> + +<p>band interleaved data.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−p</b> <i>photo</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>photometric interpretation (color space) of the input +image, where <i>photo</i> may be:</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="3" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="15%"> + +<p><b>miniswhite</b></p> +</td> +<td width="65%"> + +<p>white color represented with 0 value,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="15%"> + +<p><b>minisblack</b></p> +</td> +<td width="65%"> + +<p>black color represented with 0 value (default),</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="15%"> + +<p><b>rgb</b></p> +</td> +<td width="65%"> + +<p>image has RGB color model,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="15%"> + +<p><b>cmyk</b></p> +</td> +<td width="65%"> + +<p>image has CMYK (separated) color model,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="15%"> + +<p><b>ycbcr</b></p> +</td> +<td width="65%"> + +<p>image has YCbCr color model,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="15%"> + +<p><b>cielab</b></p> +</td> +<td width="65%"> + +<p>image has CIE L*a*b color model,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="15%"> + +<p><b>icclab</b></p> +</td> +<td width="65%"> + +<p>image has ICC L*a*b color model,</p> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="15%"> + +<p><b>itulab</b></p> +</td> +<td width="65%"> + +<p>image has ITU L*a*b color model.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>swap bytes fetched from the input file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−L</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>input data has LSB2MSB bit order (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−M</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>input data has MSB2LSB bit order.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>−c +packbits</b> for the PackBits compression algorithm (the +default), <b>−c jpeg</b> for the baseline JPEG +compression algorithm, <b>−c zip</b> for the Deflate +compression algorithm, and <b>−c lzw</b> for +Lempel-Ziv & Welch.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−r</b> <i>number</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>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.</p> +</td> +</table> +<a name="GUESSING THE IMAGE GEOMETRY"></a> +<h2>GUESSING THE IMAGE GEOMETRY</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>raw2tiff</i> can guess image width and height in case +one or both of these parameters are not specified. If you +omit one of those parameters, the complementary one will be +calculated based on the file size (taking into account +header size, number of bands and data type). If you omit +both parameters, the statistical approach will be used. +Utility will compute correlation coefficient between two +lines at the image center using several appropriate line +sizes and the highest absolute value of the coefficient will +indicate the right line size. That is why you should be +cautious with the very large images, because guessing +process may take a while (depending on your system +performance). Of course, the utility can’t guess the +header size, number of bands and data type, so it should be +specified manually. If you don’t know anything about +your image, just try with the several combinations of those +options.</p> +<!-- INDENTATION --> +<p>There is no magic, it is just a mathematical statistics, +so it can be wrong in some cases. But for most ordinary +images guessing method will work fine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/rgb2ycbcr.1.html b/src/3rdparty/libtiff/html/man/rgb2ycbcr.1.html new file mode 100644 index 0000000000..5cff15fb53 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/rgb2ycbcr.1.html @@ -0,0 +1,155 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:19 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>RGB2YCBCR</title> +</head> +<body> + +<h1 align=center>RGB2YCBCR</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>rgb2ycbcr − convert non-YCbCr <small>TIFF</small> +images to a YCbCr <small>TIFF</small> image</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>rgb2ycbcr</b> [ <i>options</i> ] <i>src1.tif src2.tif +... dst.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>rgb2ycbcr</i> converts <small>RGB</small> color, +greyscale, or bi-level <small>TIFF</small> images to YCbCr +images by transforming and sampling pixel data. If multiple +files are specified on the command line each source file is +converted to a separate directory in the destination +file.</p> +<!-- INDENTATION --> +<p>By default, chrominance samples are created by sampling 2 +by 2 blocks of luminance values; this can be changed with +the <b>−h</b> and <b>−v</b> options. Output data +are compressed with the <small>PackBits</small> compression +scheme, by default; an alternate scheme can be selected with +the <b>−c</b> option. By default, output data are +compressed in strips with the number of rows in each strip +selected so that the size of a strip is never more than 8 +kilobytes; the <b>−r</b> option can be used to +explicitly set the number of rows per strip.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>−c +packbits</b> for the PackBits compression algorithm (the +default), <b>−c jpeg</b> for the JPEG compression +algorithm, <b>−c zip</b> for the deflate compression +algorithm, and <b>−c lzw</b> for Lempel-Ziv & +Welch.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−h</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the horizontal sampling dimension to one of: 1, 2 +(default), or 4.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>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.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−v</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the vertical sampling dimension to one of: 1, 2 +(default), or 4.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/sgi2tiff.1.html b/src/3rdparty/libtiff/html/man/sgi2tiff.1.html new file mode 100644 index 0000000000..fe90d6477f --- /dev/null +++ b/src/3rdparty/libtiff/html/man/sgi2tiff.1.html @@ -0,0 +1,147 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:19 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>SGI2TIFF</title> +</head> +<body> + +<h1 align=center>SGI2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>sgi2tiff − create a <small>TIFF</small> file from +an <small>SGI</small> image file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>sgi2tiff</b> [ <i>options</i> ] <i>input.rgb +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>sgi2tiff</i> converts a file in the <small>SGI</small> +image format to <small>TIFF.</small> By default, the +<small>TIFF</small> image is created with data samples +packed (<i>PlanarConfiguration</i>=1), compressed with the +Lempel-Ziv & Welch algorithm (<i>Compression</i>=5), and +with each strip no more than 8 kilobytes. These +characteristics can overridden, or explicitly specified with +the options described below.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>−c +packbits</b> for the PackBits compression algorithm), +<b>−c jpeg</b> for the baseline JPEG compression +algorithm, <b>−c zip</b> for the Deflate compression +algorithm, and <b>−c lzw</b> for Lempel-Ziv & +Welch (the default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Explicitly select the planar configuration used in +organizing data samples in the output image: <b>−p +contig</b> for samples packed contiguously, and <b>−p +separate</b> for samples stored separately. By default +samples are packed.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>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.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Does not record colormap information.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/thumbnail.1.html b/src/3rdparty/libtiff/html/man/thumbnail.1.html new file mode 100644 index 0000000000..fabc60116e --- /dev/null +++ b/src/3rdparty/libtiff/html/man/thumbnail.1.html @@ -0,0 +1,148 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:19 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>THUMBNAIL</title> +</head> +<body> + +<h1 align=center>THUMBNAIL</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>thumbnail − create a <small>TIFF</small> file with +thumbnail images</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>thumbnail</b> [ <i>options</i> ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>thumbnail</i> is a program written to show how one +might use the SubIFD tag (#330) to store thumbnail images. +<i>thumbnail</i> copies a <small>TIFF</small> Class F +facsimile file to the output file and for each image an +8-bit greyscale <i>thumbnail sketch</i>. The output file +contains the thumbnail image with the associated +full-resolution page linked below with the SubIFD tag.</p> +<!-- INDENTATION --> +<p>By default, thumbnail images are 216 pixels wide by 274 +pixels high. Pixels are calculated by sampling and filtering +the input image with each pixel value passed through a +contrast curve.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−w</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the width of thumbnail images in pixels.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−h</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the height of thumbnail images in pixels.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a contrast curve to apply in generating the +thumbnail images. By default pixels values are passed +through a linear contrast curve that simply maps the pixel +value ranges. Alternative curves are: <b>exp50</b> for a 50% +exponential curve, <b>exp60</b> for a 60% exponential curve, +<b>exp70</b> for a 70% exponential curve, <b>exp80</b> for a +80% exponential curve, <b>exp90</b> for a 90% exponential +curve, <b>exp</b> for a pure exponential curve, +<b>linear</b> for a linear curve.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>There are no options to control the format of the saved +thumbnail images.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffdump</b>(1), <b>tiffgt</b>(1), <b>tiffinfo</b>(1), +<b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiff2bw.1.html b/src/3rdparty/libtiff/html/man/tiff2bw.1.html new file mode 100644 index 0000000000..6b6accfc1d --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiff2bw.1.html @@ -0,0 +1,161 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:19 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFF2BW</title> +</head> +<body> + +<h1 align=center>TIFF2BW</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiff2bw − convert a color <small>TIFF</small> image +to greyscale</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiff2bw</b> [ <i>options</i> ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Tiff2bw</i> converts an <small>RGB</small> or Palette +color <small>TIFF</small> image to a greyscale image by +combining percentages of the red, green, and blue channels. +By default, output samples are created by taking 28% of the +red channel, 59% of the green channel, and 11% of the blue +channel. To alter these percentages, the <b>−R</b>, +<b>−G</b>, and <b>−B</b> options may be +used.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>−c +packbits</b> for the PackBits compression algorithm, +<b>−c zip</b> for the Deflate compression algorithm, +<b>−c g3</b> for the CCITT Group 3 compression +algorithm, <b>−c g4</b> for the CCITT Group 4 +compression algorithm, and <b>−c lzw</b> for +Lempel-Ziv & Welch (the default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>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.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−R</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the percentage of the red channel to use +(default 28).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−G</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the percentage of the green channel to use +(default 59).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−B</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the percentage of the blue channel to use +(default 11).</p> +</td> +<td width="0%"> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiff2pdf.1.html b/src/3rdparty/libtiff/html/man/tiff2pdf.1.html new file mode 100644 index 0000000000..80e0d557ae --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiff2pdf.1.html @@ -0,0 +1,609 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:19 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFF2PDF</title> +</head> +<body> + +<h1 align=center>TIFF2PDF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#EXAMPLES">EXAMPLES</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p>tiff2pdf − convert a TIFF image to a PDF +document</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>tiff2pdf</b> [ <i>options</i> ] <i>input.tiff</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><i>tiff2pdf</i> opens a TIFF image and writes a PDF +document to standard output.</p> +<!-- INDENTATION --> +<p>The program converts one TIFF file to one PDF file, +including multiple page TIFF files, tiled TIFF files, black +and white. grayscale, and color TIFF files that contain data +of TIFF photometric interpretations of bilevel, grayscale, +RGB, YCbCr, CMYK separation, and ICC L*a*b* as supported by +<i>libtiff</i> and PDF.</p> +<!-- INDENTATION --> +<p>If you have multiple TIFF files to convert into one PDF +file then use <i>tiffcp</i> or other program to concatenate +the files into a multiple page TIFF file. 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.</p> +<!-- INDENTATION --> +<p>The standard output is standard output. Set the output +file name with the <b>−o</b> <i>output.pdf</i> +option.</p> +<!-- INDENTATION --> +<p>All black and white files are compressed into a single +strip CCITT G4 Fax compressed PDF, unless tiled, where tiled +black and white images are compressed into tiled CCITT G4 +Fax compressed PDF, <i>libtiff</i> CCITT support is +assumed.</p> +<!-- INDENTATION --> +<p>Color and grayscale data can be compressed using either +JPEG compression, ITU-T T.81, or Zip/Deflate LZ77 +compression. Set the compression type using the +<b>−j</b> or <b>−z</b> options. JPEG compression +support requires that <i>libtiff</i> be configured with JPEG +support, and Zip/Deflate compression support requires that +<i>libtiff</i> be configured with Zip support, in +tiffconf.h. Use only one or the other of <b>−j</b> and +<b>−z.</b></p> +<!-- INDENTATION --> +<p>If the input TIFF contains single strip CCITT G4 Fax +compressed information, then that is written to the PDF file +without transcoding, unless the options of no compression +and no passthrough are set, <b>−d</b> and +<b>−n.</b></p> +<!-- INDENTATION --> +<p>If the input TIFF contains JPEG or single strip +Zip/Deflate compressed information, and they are configured, +then that is written to the PDF file without transcoding, +unless the options of no compression and no passthrough are +set.</p> +<!-- INDENTATION --> +<p>The default page size upon which the TIFF image is placed +is determined by the resolution and extent of the image +data. Default values for the TIFF image resolution can be +set using the <b>−x</b> and <b>−y</b> options. +The page size can be set using the <b>−p</b> option +for paper size, or <b>−w</b> and <b>−l</b> for +paper width and length, then each page of the TIFF image is +centered on its page. The distance unit for default +resolution and page width and length can be set by the +<b>−u</b> option, the default unit is inch.</p> +<!-- INDENTATION --> +<p>Various items of the output document information can be +set with the <b>−e</b>, <b>−c</b>, +<b>−a</b>, <b>−t</b>, <b>−s</b>, and +<b>−k</b> options. Setting the argument of the option +to "" for these tags causes the relevant document +information field to be not written. Some of the document +information values otherwise get their information from the +input TIFF image, the software, author, document name, and +image description.</p> +<!-- INDENTATION --> +<p>The Portable Document Format (PDF) specification is +copyrighted by Adobe Systems, Incorporated.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−o</b> <i>output-file</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set the output to go to file. <i>output-file</i></p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="4" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="4%"> + +<p><b>−j</b></p> +</td> +<td width="5%"></td> +<td width="77%"> + +<p>Compress with JPEG (requires <i>libjpeg</i> configured +with <i>libtiff</i>).</p> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="4%"> + +<p><b>−z</b></p> +</td> +<td width="5%"></td> +<td width="77%"> + +<p>Compress with Zip/Deflate (requires <i>zlib</i> +configured with <i>libtiff</i>).</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−q</b> <i>quality</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set the compression quality, 1-100 for JPEG.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="4" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−n</b></p> +</td> +<td width="7%"></td> +<td width="77%"> + +<p>Do not allow data to be converted without uncompressing, +no compressed data passthrough.</p> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−b</b></p> +</td> +<td width="7%"></td> +<td width="77%"> + +<p>Set PDF ‘‘Interpolate’’ user +preference.</p> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−d</b></p> +</td> +<td width="7%"></td> +<td width="77%"> + +<p>Do not compress (decompress).</p> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−i</b></p> +</td> +<td width="7%"></td> +<td width="77%"> + +<p>Invert colors.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−p</b> <i>paper-size</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set paper size, e.g., <b>letter</b>, <b>legal</b>, +<b>A4</b>.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−u</b> [<b>i</b>|<b>m</b>]</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set distance unit, <b>i</b> for inch, <b>m</b> for +centimeter.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−w</b> <i>width</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set width in units.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−l</b> <i>length</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set length in units.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−x</b> <i>xres</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set x/width resolution default.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−y</b> <i>yres</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set y/length resolution default.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−r</b> [<b>d</b>|<b>o</b>]</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set <b>d</b> for resolution default for images without +resolution, <b>o</b> for resolution override for all +images.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−f</b></p> +</td> +<td width="13%"></td> +<td width="57%"> + +<p>Set PDF ‘‘Fit Window’’ user +preference.</p> +</td> +<td width="14%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−e</b> <i>YYYYMMDDHHMMSS</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information date, overrides image or current +date/time default, <i>YYYYMMDDHHMMSS.</i></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−c</b> <i>creator</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information creator, overrides image +software default.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−a</b> <i>author</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information author, overrides image artist +default.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−t</b> <i>title</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information title, overrides image document +name default.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−s</b> <i>subject</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information subject, overrides image image +description default.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−k</b> <i>keywords</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information keywords.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−h</b></p> +</td> +<td width="13%"></td> +<td width="57%"> + +<p>List usage reminder to stderr and exit.</p> +</td> +<td width="14%"> +</td> +</table> +<a name="EXAMPLES"></a> +<h2>EXAMPLES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p>The following example would generate the file output.pdf +from input.tiff.</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="20%"></td> +<td width="79%"> +<pre>tiff2pdf −o output.pdf input.tiff +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p>The following example would generate PDF output from +input.tiff and write it to standard output.</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="20%"></td> +<td width="79%"> +<pre>tiff2pdf input.tiff +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p>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.</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="20%"></td> +<td width="79%"> +<pre>tiff2pdf −p letter −j −q 75 −t "Document" −f −o output.pdf input.tiff +</pre> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p>Please report bugs via the web interface at</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="20%"></td> +<td width="79%"> + +<p>http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>libtiff</b>(3), <b>tiffcp</b>(1), +<b>tiff2ps</b>(1)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiff2ps.1.html b/src/3rdparty/libtiff/html/man/tiff2ps.1.html new file mode 100644 index 0000000000..e13bb8f893 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiff2ps.1.html @@ -0,0 +1,532 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:19 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFF2PS</title> +</head> +<body> + +<h1 align=center>TIFF2PS</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#EXAMPLES">EXAMPLES</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiff2ps − convert a <small>TIFF</small> image to +PostScript™</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiff2ps</b> [ <i>options</i> ] <i>input.tif +...</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiff2ps</i> reads <small>TIFF</small> images and +writes PostScript or Encapsulated PostScript (EPS) on the +standard output. By default, <i>tiff2ps</i> writes +Encapsulated PostScript for the first image in the specified +<small>TIFF</small> image file.</p> +<!-- INDENTATION --> +<p>By default, <i>tiff2ps</i> will generate PostScript that +fills a printed area specified by the <small>TIFF</small> +tags in the input file. If the file does not contain +<i>XResolution</i> or <i>YResolution</i> tags, then the +printed area is set according to the image dimensions. The +<b>−w</b> and <b>−h</b> options (see below) can +be used to set the dimensions of the printed area in inches; +overriding any relevant <small>TIFF</small> tags.</p> +<!-- INDENTATION --> +<p>The PostScript generated for <small>RGB,</small> palette, +and <small>CMYK</small> images uses the <i>colorimage</i> +operator. The PostScript generated for greyscale and bilevel +images uses the <i>image</i> operator. When the +<i>colorimage</i> operator is used, PostScript code to +emulate this operator on older PostScript printers is also +generated. Note that this emulation code can be very +slow.</p> +<!-- INDENTATION --> +<p>Color images with associated alpha data are composited +over a white background.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−1</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate PostScript Level 1 (the default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−2</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate PostScript Level 2.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−3</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate PostScript Level 3. It basically allows one to +use the /flateDecode filter for ZIP compressed TIFF +images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−a</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate output for all IFDs (pages) in the input +file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−b</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the bottom margin for the output (in inches). +This does not affect the height of the printed image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Center the image in the output. This option only shows +an effect if both the <b>−w</b> and the +<b>−h</b> option are given.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−d</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the initial <small>TIFF</small> directory to the +specified directory number. (NB: Directories are numbered +starting at zero.) This option is useful for selecting +individual pages in a multi-page (e.g. facsimile) file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−e</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the generation of Encapsulated PostScript (implies +<b>−z</b>).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−h</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the vertical size of the printed area (in +inches).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−H</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the maximum height of image (in inches). Images +with larger sizes will be split in several pages. Option +<b>−L</b> may be used for specifying size of split +images overlapping.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−i</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Enable/disable pixel interpolation. This option requires +a single numeric value: zero to disable pixel interpolation +and non-zero to enable. The default is enabled.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−L</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the size of overlapping for split images (in +inches). Used in conjunction with <b>−H</b> +option.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−l</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the left margin for the output (in inches). This +does not affect the width of the printed image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−m</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Where possible render using the <i>imagemask</i> +PostScript operator instead of the <i>image</i> operator. +When this option is specified <i>tiff2ps</i> will use +<i>imagemask</i> for rendering 1 bit deep images. If this +option is not specified or if the image depth is greater +than 1 then the <i>image</i> operator is used.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−o</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the initial <small>TIFF</small> directory to the +<small>IFD</small> at the specified file offset. This option +is useful for selecting thumbnail images and the like which +are hidden using the <i>SubIFD</i> tag.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the generation of (non-Encapsulated) +PostScript.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Rotate image by 180 degrees.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate output for a single IFD (page) in the input +file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−w</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the horizontal size of the printed area (in +inches).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−x</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Override resolution units specified in the TIFF as +centimeters.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−y</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Override resolution units specified in the TIFF as +inches.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−z</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>When generating PostScript Level 2, data is scaled so +that it does not image into the <i>deadzone</i> on a page +(the outer margin that the printing device is unable to +mark). This option suppresses this behavior. When PostScript +Level 1 is generated, data is imaged to the entire printed +page and this option has no affect.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="EXAMPLES"></a> +<h2>EXAMPLES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following generates PostScript Level 2 for all pages +of a facsimile:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiff2ps −a2 fax.tif | lpr +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Note also that if you have version 2.6.1 or newer of +Ghostscript then you can efficiently preview facsimile +generated with the above command.</p> +<!-- INDENTATION --> +<p>To generate Encapsulated PostScript for a the image at +directory 2 of an image use:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiff2ps −d 1 foo.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>(Notice that directories are numbered starting at +zero.)</p> +<!-- INDENTATION --> +<p>If you have a long image, it may be split in several +pages:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiff2ps −h11 −w8.5 −H14 −L.5 foo.tif > foo.ps +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The page size is set to 8.5x11 by <b>−w</b> and +<b>−h</b> options. We will accept a small amount of +vertical compression, so <b>−H</b> set to 14. Any +pages between 11 and 14 inches will be fit onto one page. +Pages longer than 14 inches are cut off at 11 and continued +on the next page. The <b>−L.5</b> option says to +repeat a half inch on the next page (to improve +readability).</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Because PostScript does not support the notion of a +colormap, 8-bit palette images produce 24-bit PostScript +images. 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.</p> +<!-- INDENTATION --> +<p>Does not handle tiled images when generating PostScript +Level I output.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffgt</b>(1), <b>tiffmedian</b>(1), <b>tiff2bw</b>(1), +<b>tiffsv</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiff2rgba.1.html b/src/3rdparty/libtiff/html/man/tiff2rgba.1.html new file mode 100644 index 0000000000..eec3968317 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiff2rgba.1.html @@ -0,0 +1,162 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:19 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFF2RGBA</title> +</head> +<body> + +<h1 align=center>TIFF2RGBA</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiff2rgba − convert a <small>TIFF</small> image to +RGBA color space</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiff2rgba</b> [ <i>options</i> ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Tiff2rgba</i> converts a wide variety of TIFF images +into an RGBA TIFF image. This includes the ability to +translate different color spaces and photometric +interpretation into RGBA, support for alpha blending, and +translation of many different bit depths into a 32bit RGBA +image.</p> +<!-- INDENTATION --> +<p>Internally this program is implemented using the +<i>TIFFReadRGBAImage()</i> function, and it suffers any +limitations of that image. This includes limited support for +> 8 BitsPerSample images, and flaws with some esoteric +combinations of BitsPerSample, photometric interpretation, +block organization and planar configuration.</p> +<!-- INDENTATION --> +<p>The generated images are stripped images with four +samples per pixel (red, green, blue and alpha) or if the +<b>−n</b> 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 supporting software.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression (the default), +<b>−c packbits</b> for the PackBits compression +algorithm, <b>−c zip</b> for the Deflate compression +algorithm, <b>−c jpeg</b> for the JPEG compression +algorithm, and <b>−c lzw</b> for Lempel-Ziv & +Welch.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>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.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−b</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Process the image one block (strip/tile) at a time +instead of by reading the whole image into memory at once. +This may be necessary for very large images on systems with +limited RAM.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−n</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Drop the alpha component from the output file, producing +a pure RGB file. Currently this does not work if the +<b>−b</b> flag is also in effect.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiff2bw</b>(1), <b>TIFFReadRGBAImage</b>(3t), +<b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffcmp.1.html b/src/3rdparty/libtiff/html/man/tiffcmp.1.html new file mode 100644 index 0000000000..a9fca2f15a --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffcmp.1.html @@ -0,0 +1,156 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:19 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFCMP</title> +</head> +<body> + +<h1 align=center>TIFFCMP</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffcmp − compare two <small>TIFF</small> files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffcmp</b> [ <i>options</i> ] <i>file1.tif +file2.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Tiffcmp</i> compares the tags and data in two files +created according to the Tagged Image File Format, Revision +6.0. The schemes used for compressing data in each file are +immaterial when data are compared−data are compared on +a scanline-by-scanline basis after decompression. Most +directory tags are checked; notable exceptions are: +<i>GrayResponseCurve</i>, <i>ColorResponseCurve</i>, and +<i>ColorMap</i> tags. Data will not be compared if any of +the <i>BitsPerSample</i>, <i>SamplesPerPixel</i>, or +<i>ImageWidth</i> values are not equal. By default, +<i>tiffcmp</i> will terminate if it encounters any +difference.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−l</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>List each byte of image data that differs between the +files.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−z</b> <i>number</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>List specified number of image data bytes that differs +between the files.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−t</b></p> +</td> +<td width="11%"></td> +<td width="52%"> + +<p>Ignore any differences in directory tags.</p> +</td> +<td width="23%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Tags that are not recognized by the library are not +compared; they may also generate spurious diagnostics.</p> +<!-- INDENTATION --> +<p>The image data of tiled files is not compared, since the +<i>TIFFReadScanline()</i> function is used. An error will be +reported for tiled files.</p> +<!-- INDENTATION --> +<p>The pixel and/or sample number reported in differences +may be off in some exotic cases.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffcp.1.html b/src/3rdparty/libtiff/html/man/tiffcp.1.html new file mode 100644 index 0000000000..2b30d5f19a --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffcp.1.html @@ -0,0 +1,522 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:19 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFCP</title> +</head> +<body> + +<h1 align=center>TIFFCP</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#EXAMPLES">EXAMPLES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffcp − copy (and possibly convert) a +<small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffcp</b> [ <i>options</i> ] <i>src1.tif ... srcN.tif +dst.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffcp</i> combines one or more files created +according to the Tag Image File Format, Revision 6.0 into a +single <small>TIFF</small> file. Because the output file may +be compressed using a different algorithm than the input +files, <i>tiffcp</i> is most often used to convert between +different compression schemes.</p> +<!-- INDENTATION --> +<p>By default, <i>tiffcp</i> will copy all the understood +tags in a <small>TIFF</small> directory of an input file to +the associated directory in the output file.</p> +<!-- INDENTATION --> +<p><i>tiffcp</i> can be used to reorganize the storage +characteristics of data in a file, but it is explicitly +intended to not alter or convert the image data content in +any way.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−b</b> <i>image</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>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 image of +noise the camera saw with its shutter closed.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−B</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be written with Big-Endian byte order. +This option only has an effect when the output file is +created or overwritten and not when it is appended to.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−C</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Suppress the use of ‘‘strip +chopping’’ when reading images that have a +single strip/tile of uncompressed data.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the compression to use for data written to the +output file: <b>none</b> for no compression, <b>packbits</b> +for PackBits compression, <b>lzw</b> for Lempel-Ziv & +Welch compression, <b>jpeg</b> for baseline JPEG +compression, <b>zip</b> for Deflate compression, <b>g3</b> +for CCITT Group 3 (T.4) compression, and <b>g4</b> for CCITT +Group 4 (T.6) compression. By default <i>tiffcp</i> will +compress data according to the value of the +<i>Compression</i> tag found in the source file.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>The <small>CCITT</small> Group 3 and Group 4 compression +algorithms can only be used with bilevel data.</p> +<!-- INDENTATION --> +<p>Group 3 compression can be specified together with +several T.4-specific options: <b>1d</b> for 1-dimensional +encoding, <b>2d</b> for 2-dimensional encoding, and +<b>fill</b> to force each encoded scanline to be zero-filled +so that the terminating EOL code lies on a byte boundary. +Group 3-specific options are specified by appending a +‘‘:’’-separated list to the +‘‘g3’’ option; e.g. <b>−c +g3:2d:fill</b> to get 2D-encoded data with byte-aligned EOL +codes.</p> +<!-- INDENTATION --> +<p><small>LZW</small> compression can be specified together +with a <i>predictor</i> value. A predictor value of 2 causes +each scanline of the output image to undergo horizontal +differencing before it is encoded; a value of 1 forces each +scanline to be encoded without differencing. LZW-specific +options are specified by appending a +‘‘:’’-separated list to the +‘‘lzw’’ option; e.g. <b>−c +lzw:2</b> for <small>LZW</small> compression with horizontal +differencing.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−f</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the bit fill order to use in writing output +data. By default, <i>tiffcp</i> will create a new file with +the same fill order as the original. Specifying <b>−f +lsb2msb</b> will force data to be written with the FillOrder +tag set to <small>LSB2MSB,</small> while <b>−f +msb2lsb</b> will force data to be written with the FillOrder +tag set to <small>MSB2LSB.</small></p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−i</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Ignore non-fatal read errors and continue processing of +the input file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−l</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the length of a tile (in pixels). <i>tiffcp</i> +attempts to set the tile dimensions so that no more than 8 +kilobytes of data appear in a tile.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−L</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be written with Little-Endian byte +order. This option only has an effect when the output file +is created or overwritten and not when it is appended +to.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−M</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Suppress the use of memory-mapped files when reading +images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the planar configuration to use in writing image +data that has one 8-bit sample per pixel. By default, +<i>tiffcp</i> will create a new file with the same planar +configuration as the original. Specifying <b>−p +contig</b> will force data to be written with multi-sample +data packed together, while <b>−p separate</b> will +force samples to be written in separate planes.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the number of rows (scanlines) in each strip of +data written to the output file. By default (or when value +<b>0</b> is specified), <i>tiffcp</i> 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> it will +results in infinite number of the rows per strip. The entire +image will be the one strip in that case.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the output file to be written with data organized +in strips (rather than tiles).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−t</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the output file to be written with data organized +in tiles (rather than strips). options can be used to force +the resultant image to be written as strips or tiles of +data, respectively.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−w</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the width of a tile (in pixels). <i>tiffcp</i> +attempts to set the tile dimensions so that no more than 8 +kilobytes of data appear in a tile. <i>tiffcp</i> attempts +to set the tile dimensions so that no more than 8 kilobytes +of data appear in a tile.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−,=</b><i>character</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>substitute <i>character</i> for ‘,’ in +parsing image directory indices in files. This is necessary +if filenames contain commas. Note that <b>−,=</b> with +whitespace immediately following will disable the special +meaning of the ‘,’ entirely. See examples.</p> +</td> +</table> +<a name="EXAMPLES"></a> +<h2>EXAMPLES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following concatenates two files and writes the +result using <small>LZW</small> encoding:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcp −c lzw a.tif b.tif result.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>To convert a G3 1d-encoded <small>TIFF</small> to a +single strip of G4-encoded data the following might be +used:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcp −c g4 −r 10000 g3.tif g4.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>(1000 is just a number that is larger than the number of +rows in the source file.)</p> +<!-- INDENTATION --> +<p>To extract a selected set of images from a multi-image +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’’:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcp album.tif,0,2 result.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>A trailing comma denotes remaining images in sequence. +The following command will copy all image with except the +first one:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcp album.tif,1, result.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>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:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcp −c none −b CCD.tif CCD.tif,1, result.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>If the file above were named +‘‘CCD,X.tif’’, the <b>−,=</b> +option would be required to correctly parse this filename +with image numbers, as follows:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcp −c none −,=% −b CCD,X.tif CCD,X%1%.tif result.tif + +</pre> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcmp</b>(1), +<b>tiffmedian</b>(1), <b>tiffsplit</b>(1), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffcrop.1.html b/src/3rdparty/libtiff/html/man/tiffcrop.1.html new file mode 100644 index 0000000000..4c25c2921b --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffcrop.1.html @@ -0,0 +1,851 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:19 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFCROP</title> +</head> +<body> + +<h1 align=center>TIFFCROP</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#EXAMPLES">EXAMPLES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffcrop − copy, convert, crop, extract, or process +a <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffcrop</b> [ <i>options</i> ] <i>src1.tif ... +srcN.tif dst.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffcrop</i> combines one or more files created +according to the Tag Image File Format, Revision 6.0 into a +single <small>TIFF</small> file. The output file may be +compressed using a different algorithm than the input files. +<i>tiffcrop</i> is most often used to extract portions of an +image for processing with bar code recognizer or OCR +software when that software cannot restrict the region of +interest to a specific portion of the image or to improve +efficiency when the regions of interest must be rotated. It +can also be used to subdivide all or part of a processed +image into smaller sections.</p> +<!-- INDENTATION --> +<p>Functions are applied to the input image in the following +order:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>cropping, fixed area extraction, zones, inversion, mirroring, rotation. +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Functions are applied to the output image in the +following order:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>output resolution, output margins, rows and columns +<b>or</b> page size divisions, orientation options, strip, +tile, byte order, and compression options.</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>By default, <i>tiffcrop</i> will copy all the understood +tags in a <small>TIFF</small> directory of an input file to +the associated directory in the output file. Options can be +used to force the resultant image to be written as strips or +tiles of data, respectively.</p> +<!-- INDENTATION --> +<p><i>tiffcrop</i> can be used to reorganize the storage +characteristics of data in a file, and to reorganize, +extract, rotate, and otherwise process the image data as +specified at the same time whereas tiffcp does not alter the +image data itself.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−N odd|even|#,#-#,#|last</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Specify one or more series or range(s) of images within +file to process. The words <b>odd</b> or <b>even</b> may be +used to specify all odd or even numbered images. The word +<b>last</b> may be used in place of a number in the sequence +to indicate the final image in the file without knowing how +many images there are. Ranges of images may be specified +with a dash and multiple sets can be indicated by joining +them in a comma-separated list. eg. use <b>−N +1,5-7,last</b> to process the 1st, 5th through 7th, and +final image in the file.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−E top|bottom|left|right</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Specify the top, bottom, left, or right edge as the +reference from which to calcuate the width and length of +crop regions or sequence of postions for zones. May be +abbreviated to first letter.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−U in|cm|px</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Specify the type of units to apply to dimensions for +margins and crop regions for input and output images. Inches +or centimeters are converted to pixels using the resolution +unit specified in the TIFF file (which defaults to inches if +not specified in the IFD).</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−m #,#,#,#</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Specify margins to be removed from the input image. The +order must be top, left, bottom, right with only commas +separating the elements of the list. Margins are scaled +according to the current units and removed before any other +extractions are computed. Captial M was in use.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="6%"> + +<p><b>−X #</b></p> +</td> +<td width="2%"></td> +<td width="80%"> + +<p>Set the horizontal (X-axis) dimension of a region to +extract relative to the specified origin reference. If the +origin is the top or bottom edge, the X axis value will be +assumed to start at the left edge.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="6%"> + +<p><b>−Y #</b></p> +</td> +<td width="2%"></td> +<td width="80%"> + +<p>Set the vertical (Y-axis) dimension of a region to +extract relative to the specified origin reference. If the +origin is the left or right edge, the Y axis value will be +assumed to start at the top.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−Z #:#,#:#</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Specify zones of the image designated as position X of Y +equal sized portions measured from the reference edge, eg +1:3 would be first third of the image starting from the +reference edge minus any margins specified for the confining +edges. Multiple zones can be specified as a comma separated +list but they must reference the same edge. To extract the +top quarter and the bottom third of an image you would use +<b>−Z 1:4,3:3.</b></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−F horiz|vert</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Flip, ie mirror, the image or extracted region +horizontally or vertically.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−R 90|180|270</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Rotate the image or extracted region 90, 180, or 270 +degrees clockwise.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="6%"> + +<p><b>−I</b></p> +</td> +<td width="2%"></td> +<td width="80%"> + +<p>Invert the colorspace values for grayscale and bilevel +images. This would be used to correct negative images that +have incorrect PHOTMETRIC INTERPRETATION tags. No support +for color images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="6%"> + +<p><b>−H #</b></p> +</td> +<td width="2%"></td> +<td width="80%"> + +<p>Set the horizontal resolution of output images to # +expressed in the current units.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="6%"> + +<p><b>−V #</b></p> +</td> +<td width="2%"></td> +<td width="80%"> + +<p>Set the vertical resolution of the output images to # +expressed in the current units.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="6%"> + +<p><b>−J #</b></p> +</td> +<td width="2%"></td> +<td width="80%"> + +<p>Set the horizontal margin of an output page size to # +expressed in the current units.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="6%"> + +<p><b>−K #</b></p> +</td> +<td width="2%"></td> +<td width="80%"> + +<p>Set the vertical margin of an output page size to # +expressed in the current units.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−O portrait|landscape|auto</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Set the output orientation of the pages or sections. Auto +will use the arrangement that requires the fewest pages.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−S cols:rows</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Divide each image into cols across and rows down equal +sections.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−P page</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Format the output images to fit on page size paper. Use +-P list to show the supported page sizes and dimensions.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−B</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be written with Big-Endian byte order. +This option only has an effect when the output file is +created or overwritten and not when it is appended to.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−C</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Suppress the use of ‘‘strip +chopping’’ when reading images that have a +single strip/tile of uncompressed data.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the compression to use for data written to the +output file: <b>none</b> for no compression, <b>packbits</b> +for PackBits compression, <b>lzw</b> for Lempel-Ziv & +Welch compression, <b>jpeg</b> for baseline JPEG +compression, <b>zip</b> for Deflate compression, <b>g3</b> +for CCITT Group 3 (T.4) compression, and <b>g4</b> for CCITT +Group 4 (T.6) compression. By default <i>tiffcrop</i> will +compress data according to the value of the +<i>Compression</i> tag found in the source file.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>The <small>CCITT</small> Group 3 and Group 4 compression +algorithms can only be used with bilevel data.</p> +<!-- INDENTATION --> +<p>Group 3 compression can be specified together with +several T.4-specific options: <b>1d</b> for 1-dimensional +encoding, <b>2d</b> for 2-dimensional encoding, and +<b>fill</b> to force each encoded scanline to be zero-filled +so that the terminating EOL code lies on a byte boundary. +Group 3-specific options are specified by appending a +‘‘:’’-separated list to the +‘‘g3’’ option; e.g. <b>−c +g3:2d:fill</b> to get 2D-encoded data with byte-aligned EOL +codes.</p> +<!-- INDENTATION --> +<p><small>LZW</small> compression can be specified together +with a <i>predictor</i> value. A predictor value of 2 causes +each scanline of the output image to undergo horizontal +differencing before it is encoded; a value of 1 forces each +scanline to be encoded without differencing. LZW-specific +options are specified by appending a +‘‘:’’-separated list to the +‘‘lzw’’ option; e.g. <b>−c +lzw:2</b> for <small>LZW</small> compression with horizontal +differencing.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−f</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the bit fill order to use in writing output +data. By default, <i>tiffcrop</i> will create a new file +with the same fill order as the original. Specifying +<b>−f lsb2msb</b> will force data to be written with +the FillOrder tag set to <small>LSB2MSB,</small> while +<b>−f msb2lsb</b> will force data to be written with +the FillOrder tag set to <small>MSB2LSB.</small></p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−i</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Ignore non-fatal read errors and continue processing of +the input file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−l</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the length of a tile (in pixels). +<i>tiffcrop</i> attempts to set the tile dimensions so that +no more than 8 kilobytes of data appear in a tile.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−L</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be written with Little-Endian byte +order. This option only has an effect when the output file +is created or overwritten and not when it is appended +to.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−M</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Suppress the use of memory-mapped files when reading +images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the planar configuration to use in writing image +data that has more than one 8-bit sample per pixel. By +default, <i>tiffcrop</i> will create a new file with the +same planar configuration as the original. Specifying +<b>−p contig</b> will force data to be written with +multi-sample data packed together, while <b>−p +separate</b> will force samples to be written in separate +planes.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the number of rows (scanlines) in each strip of +data written to the output file. By default (or when value +<b>0</b> is specified), <i>tiffcrop</i> attempts to set the +rows/strip that no more than 8 kilobytes of data appear in a +strip. If you specify the special value <b>-1</b> it will +results in infinite number of the rows per strip. The entire +image will be the one strip in that case.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the output file to be written with data organized +in strips (rather than tiles).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−t</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the output file to be written with data organized +in tiles (rather than strips).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−w</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the width of a tile (in pixels). <i>tiffcrop</i> +attempts to set the tile dimensions so that no more than 8 +kilobytes of data appear in a tile. <i>tiffcrop</i> attempts +to set the tile dimensions so that no more than 8 kilobytes +of data appear in a tile.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−,={character}</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>substitute {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.</p> +</td> +</table> +<a name="EXAMPLES"></a> +<h2>EXAMPLES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following concatenates two files and writes the +result using <small>LZW</small> encoding:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcrop -c lzw a.tif b.tif result.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>To convert a G3 1d-encoded <small>TIFF</small> to a +single strip of G4-encoded data the following might be +used:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcrop -c g4 -r 10000 g3.tif g4.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>(1000 is just a number that is larger than the number of +rows in the source file.)</p> +<!-- INDENTATION --> +<p>To extract a selected set of images from a multi-image +TIFF file use the -N option described above. Thus, to copy +the 1st and 3rd images of image file "album.tif" +to "result.tif":</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcrop -N 1,3 album.tif result.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Invert a bilevel image scan of a microfilmed document and +crop off margins of 0.25 inches on the left and right, 0.5 +inch on the top, nad 0.75 inch on the bottom. From the +remaining portion of the image, select the second and third +quarters, ie, one half of the area left from the center to +each margin.</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcrop -U in -m 0.5,0.25,0.75,0.25 -E left -Z 2:4,3:4 -I MicrofilmNegative.tif MicrofilmPostiveCenter.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Extract only the final image of a large Architectural E +sized multipage TIFF file and rotate it 90 degrees clockwise +while reformatting the output to fit on tabloid sized sheets +with one quarter of an inch on each side:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcrop -N last -R 90 -O auto -P tabloid -U in -J 0.25 -K 0.25 -H 300 -V 300 Big-PlatMap.tif BigPlatMap-Tabloid.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The output images will have a specified resolution of 300 +dpi in both directions. The orientation of each page will be +determined by whichever choice requires the fewest pages. To +specify a specific orientation, use the portrait or +landscape option.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcmp</b>(1), +<b>tiffcp</b>(1), <b>tiffmedian</b>(1), <b>tiffsplit</b>(1), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffdither.1.html b/src/3rdparty/libtiff/html/man/tiffdither.1.html new file mode 100644 index 0000000000..2427a90125 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffdither.1.html @@ -0,0 +1,183 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:19 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFDITHER</title> +</head> +<body> + +<h1 align=center>TIFFDITHER</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffdither − convert a greyscale image to bilevel +using dithering</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffdither</b> [ <i>options</i> ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffdither</i> converts a single channel 8-bit +greyscale image to a bilevel image using Floyd-Steinberg +error propagation with thresholding.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−c</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Specify the compression to use for data written to the +output file: <b>none</b> for no compression, <b>packbits</b> +for PackBits compression, <b>lzw</b> for Lempel-Ziv & +Welch compression, <b>zip</b> for Deflate compression, +<b>g3</b> for CCITT Group 3 (T.4) compression, and <b>g4</b> +for CCITT Group 4 (T.6) compression. By default +<i>tiffdither</i> will compress data according to the value +of the <i>Compression</i> tag found in the source file.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>The <small>CCITT</small> Group 3 and Group 4 compression +algorithms can only be used with bilevel data.</p> +<!-- INDENTATION --> +<p>Group 3 compression can be specified together with +several T.4-specific options: <b>1d</b> for 1-dimensional +encoding, <b>2d</b> for 2-dimensional encoding, and +<b>fill</b> to force each encoded scanline to be zero-filled +so that the terminating EOL code lies on a byte boundary. +Group 3-specific options are specified by appending a +‘‘:’’-separated list to the +‘‘g3’’ option; e.g. <b>−c +g3:2d:fill</b> to get 2D-encoded data with byte-aligned EOL +codes.</p> +<!-- INDENTATION --> +<p><small>LZW</small> compression can be specified together +with a <i>predictor</i> value. A predictor value of 2 causes +each scanline of the output image to undergo horizontal +differencing before it is encoded; a value of 1 forces each +scanline to be encoded without differencing. LZW-specific +options are specified by appending a +‘‘:’’-separated list to the +‘‘lzw’’ option; e.g. <b>−c +lzw:2</b> for <small>LZW</small> compression with horizontal +differencing.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−f</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the bit fill order to use in writing output +data. By default, <i>tiffdither</i> will create a new file +with the same fill order as the original. Specifying +<b>−f lsb2msb</b> will force data to be written with +the <i>FillOrder</i> tag set to <small>LSB2MSB ,</small> +while <b>−f msb2lsb</b> will force data to be written +with the <i>Fill- Order</i> tag set to <small>MSB2LSB +.</small></p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−t</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the threshold value for dithering. By default the +threshold value is 128.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The dither algorithm is taken from the +<b>tiffmedian</b>(1) program (written by Paul Heckbert).</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>fax2tiff</b>(1), +<b>tiffinfo</b>(1), <b>tiffcp</b>(1), <b>tiff2bw</b>(1), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffdump.1.html b/src/3rdparty/libtiff/html/man/tiffdump.1.html new file mode 100644 index 0000000000..abf0662c66 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffdump.1.html @@ -0,0 +1,145 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:20 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFDUMP</title> +</head> +<body> + +<h1 align=center>TIFFDUMP</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffdump − print verbatim information about +<small>TIFF</small> files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffdump</b> [ <i>options</i> ] <i>name ...</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffdump</i> displays directory information from files +created according to the Tag Image File Format, Revision +6.0. The header of each <small>TIFF</small> file (magic +number, version, and first directory offset) is displayed, +followed by the tag contents of each directory in the file. +For each tag, the name, data type, count, and value(s) is +displayed. When the symbolic name for a tag or data type is +known, the symbolic name is displayed followed by it’s +numeric (decimal) value. Tag values are displayed enclosed +in ‘‘<>’’ characters +immediately preceded by the value of the count field. For +example, an <i>ImageWidth</i> tag might be displayed as +‘‘ImageWidth (256) SHORT (3) +1<800>’’.</p> +<!-- INDENTATION --> +<p><i>tiffdump</i> is particularly useful for investigating +the contents of <small>TIFF</small> files that +<i>libtiff</i> does not understand.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−h</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Force numeric data to be printed in hexadecimal rather +than the default decimal.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−m</b> <i>items</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Change the number of indirect data items that are +printed. By default, this will be 24.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−o</b> <i>offset</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Dump the contents of the <small>IFD</small> at the a +particular file offset. The file offset may be specified +using the usual C-style syntax; i.e. a leading +‘‘0x’’ for hexadecimal and a leading +‘‘0’’ for octal.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b>(1), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffgt.1.html b/src/3rdparty/libtiff/html/man/tiffgt.1.html new file mode 100644 index 0000000000..e8bd4b2312 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffgt.1.html @@ -0,0 +1,551 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:20 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFGT</title> +</head> +<body> + +<h1 align=center>TIFFGT</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffgt − display an image stored in a +<small>TIFF</small> file (Silicon Graphics version)</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffgt</b> [ <i>options</i> ] <i>input.tif ...</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffgt</i> displays one or more images stored using +the Tag Image File Format, Revision 6.0. Each image is +placed in a fixed size window that the user must position on +the display (unless configured otherwise through X +defaults). If the display has fewer than 24 bitplanes, or if +the image does not warrant full color, then +<small>RGB</small> color values are mapped to the closest +values that exist in the colormap (this is done using the +<i>rgbi</i> routine found in the graphics utility library +<b>−lgutil</b>.)</p> +<!-- INDENTATION --> +<p><i>tiffgt</i> correctly handles files with any of the +following characteristics:</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="3" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="34%"> + +<p><i>BitsPerSample</i></p> +</td> +<td width="50%"> + +<p>1, 2, 4, 8, 16</p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="34%"> + +<p><i>SamplesPerPixel</i></p> +</td> +<td width="50%"> + +<p>1, 3, 4 (the 4th sample is ignored)</p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="34%"> + +<p><i>PhotometricInterpretation</i></p> +</td> +<td width="50%"> + +<p>0 (min-is-white), 1 (min-is-black), 2 (RGB), 3 +(palette), 6 (YCbCr)</p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="34%"> + +<p><i>PlanarConfiguration</i></p> +</td> +<td width="50%"> + +<p>1 (contiguous), 2 (separate)</p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="34%"> + +<p><i>Orientation</i></p> +</td> +<td width="50%"> + +<p>1 (top-left), 4 (bottom-left)</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Data may be organized as strips or tiles and may be +compressed with any of the compression algorithms supported +by the <i>libtiff</i>(3) library.</p> +<!-- INDENTATION --> +<p>For palette images (<i>PhotometricInterpretation</i>=3), +<i>tiffgt</i> inspects the colormap values and assumes +either 16-bit or 8-bit values according to the maximum +value. That is, if no colormap entry greater than 255 is +found, <i>tiffgt</i> assumes the colormap has only 8-bit +values; otherwise it assumes 16-bit values. This inspection +is done to handle old images written by previous (incorrect) +versions of <i>libtiff</i>.</p> +<!-- INDENTATION --> +<p><i>tiffgt</i> can be used to display multiple images +one-at-a-time. The left mouse button switches the display to +the first image in the <i>next</i> file in the list of files +specified on the command line. The right mouse button +switches to the first image in the <i>previous</i> file in +the list. The middle mouse button causes the first image in +the first file specified on the command line to be +displayed. In addition the following keyboard commands are +recognized:</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="4" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>b</b></p> +</td> +<td width="80%"> + +<p>Use a <i>PhotometricInterpretation</i> of MinIsBlack in +displaying the current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>l</b></p> +</td> +<td width="80%"> + +<p>Use a <i>FillOrder</i> of lsb-to-msb in decoding the +current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>m</b></p> +</td> +<td width="80%"> + +<p>Use a <i>FillOrder</i> of msb-to-lsb in decoding the +current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>c</b></p> +</td> +<td width="80%"> + +<p>Use a colormap visual to display the current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>r</b></p> +</td> +<td width="80%"> + +<p>Use a true color (24-bit RGB) visual to display the +current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>w</b></p> +</td> +<td width="80%"> + +<p>Use a <i>PhotometricInterpretation</i> of MinIsWhite in +displaying the current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>W</b></p> +</td> +<td width="80%"> + +<p>Toggle (enable/disable) display of warning messages from +the <small>TIFF</small> library when decoding images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>E</b></p> +</td> +<td width="80%"> + +<p>Toggle (enable/disable) display of error messages from +the <small>TIFF</small> library when decoding images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>z</b></p> +</td> +<td width="80%"> + +<p>Reset all parameters to their default settings +(<i>FillOrder</i>, <i>PhotometricInterpretation</i>, +handling of warnings and errors).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>PageUp</b></p> +</td> +<td width="80%"> + +<p>Display the previous image in the current file or the +last image in the previous file.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>PageDown</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Display the next image in the current file or the first +image in the next file.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="6%"> + +<p><b>Home</b></p> +</td> +<td width="2%"></td> +<td width="80%"> + +<p>Display the first image in the current file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="6%"> + +<p><b>End</b></p> +</td> +<td width="2%"></td> +<td width="80%"> + +<p>Display the last image in the current file +(unimplemented).</p> +</td> +<td width="0%"> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force image display in a colormap window.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−d</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify an image to display by directory number. By +default the first image in the file is displayed. +Directories are numbered starting at zero.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−e</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Enable reporting of error messages from the +<small>TIFF</small> library. By default <i>tiffgt</i> +silently ignores images that cannot be read.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−f</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force <i>tiffgt</i> to run as a foreground process. By +default <i>tiffgt</i> will place itself in the background +once it has opened the requested image file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−l</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the presumed bit ordering to be <small>LSB</small> +to <small>MSB.</small></p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−m</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the presumed bit ordering to be <small>MSB</small> +to <small>LSB.</small></p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−o</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify an image to display by directory offset. By +default the first image in the file is displayed. +Directories offsets may be specified using C-style syntax; +i.e. a leading ‘‘0x’’ for +hexadecimal and a leading ‘‘0’’ for +octal.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Override the value of the +<i>PhotometricInterpretation</i> tag; the parameter may be +one of: <b>miniswhite</b>, <b>minisblack</b>, <b>rgb</b>, +<b>palette</b>, <b>mask</b>, <b>separated</b>, <b>ycbcr</b>, +and <b>cielab</b>.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force image display in a full color window.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Stop on the first read error. By default all errors in +the input data are ignored and <i>tiffgt</i> does it’s +best to display as much of an image as possible.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−w</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Enable reporting of warning messages from the +<small>TIFF</small> library. By default <i>tiffgt</i> +ignores warning messages generated when reading an +image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−v</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Place information in the title bar describing what type +of window (full color or colormap) is being used, the name +of the input file, and the directory index of the image (if +non-zero). By default, the window type is not shown in the +title bar.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Images wider and taller than the display are silently +truncated to avoid crashing old versions of the window +manager.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffdump</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffinfo.1.html b/src/3rdparty/libtiff/html/man/tiffinfo.1.html new file mode 100644 index 0000000000..4863ed3762 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffinfo.1.html @@ -0,0 +1,196 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:20 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFINFO</title> +</head> +<body> + +<h1 align=center>TIFFINFO</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffinfo − print information about +<small>TIFF</small> files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b> [ <i>options</i> ] <i>input.tif +...</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Tiffinfo</i> displays information about files created +according to the Tag Image File Format, Revision 6.0. By +default, the contents of each <small>TIFF</small> directory +in each file is displayed, with the value of each tag shown +symbolically (where sensible).</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Display the colormap and color/gray response curves, if +present.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−D</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>In addition to displaying the directory tags, read and +decompress all the data in each image (but not display +it).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−d</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>In addition to displaying the directory tags, print each +byte of decompressed data in hexadecimal.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−j</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Display any <small>JPEG</small> -related tags that are +present.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−o</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the initial <small>TIFF</small> directory according +to the specified file offset. The file offset may be +specified using the usual C-style syntax; i.e. a leading +‘‘0x’’ for hexadecimal and a leading +‘‘0’’ for octal.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Display the offsets and byte counts for each data strip +in a directory.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−z</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Enable strip chopping when reading image data.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−#</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the initial <small>TIFF</small> directory to +<i>#</i>.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffcp</b>(1), <b>tiffcmp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffmedian.1.html b/src/3rdparty/libtiff/html/man/tiffmedian.1.html new file mode 100644 index 0000000000..59613177c9 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffmedian.1.html @@ -0,0 +1,183 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:20 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFMEDIAN</title> +</head> +<body> + +<h1 align=center>TIFFMEDIAN</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffmedian − apply the median cut algorithm to data +in a <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffmedian</b> [ <i>options</i> ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffmedian</i> applies the median cut algorithm to an +<small>RGB</small> image in <i>input.tif</i> to generate a +palette image that is written to <i>output.tif</i>. The +generated colormap has, by default, 256 entries. The image +data is quantized by mapping each pixel to the closest color +values in the colormap.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the compression to use for data written to the +output file: <b>none</b> for no compression, <b>packbits</b> +for PackBits compression, <b>lzw</b> for Lempel-Ziv & +Welch compression, and <b>zip</b> for Deflate compression. +By default <i>tiffmedian</i> will compress data according to +the value of the <i>Compression</i> tag found in the source +file.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p><small>LZW</small> compression can be specified together +with a <i>predictor</i> value. A predictor value of 2 causes +each scanline of the output image to undergo horizontal +differencing before it is encoded; a value of 1 forces each +scanline to be encoded without differencing. LZW-specific +options are specified by appending a +‘‘:’’-separated list to the +‘‘lzw’’ option; e.g. <b>−c +lzw:2</b> for <small>LZW</small> compression with horizontal +differencing.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−C</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Specify the number of entries to use in the generated +colormap. By default all 256 entries/colors are used.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−f</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Apply Floyd-Steinberg dithering before selecting a +colormap entry.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−r</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Specify the number of rows (scanlines) in each strip of +data written to the output file. By default, +<i>tiffmedian</i> attempts to set the rows/strip that no +more than 8 kilobytes of data appear in a strip.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>This program is derived from Paul Heckbert’s +<i>median</i> program.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffcmp</b>(1), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p><b>Color Image Quantization for Frame Buffer Display</b>, +Paul Heckbert, SIGGRAPH proceedings, 1982, pp. 297-307.</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffset.1.html b/src/3rdparty/libtiff/html/man/tiffset.1.html new file mode 100644 index 0000000000..fb4d0ed580 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffset.1.html @@ -0,0 +1,176 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:20 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSET</title> +</head> +<body> + +<h1 align=center>TIFFSET</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#EXAMPLES">EXAMPLES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffset − set a field in a <small>TIFF</small> +header</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffset</b> [ <i>options</i> ] <i>filename.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Tiffset</i> sets the value of a <small>TIFF</small> +header to a specified value.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−s</b> <i>tagnumber</i> [ <i>count</i> ] +<i>value ...</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Set the value of the named tag to the value or values +specified.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−sf</b> <i>tagnumber filename</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Set the value of the tag to the contents of filename. +This option is supported for ASCII tags only.</p> +</td> +</table> +<a name="EXAMPLES"></a> +<h2>EXAMPLES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following example sets the image description tag +(270) of a.tif to the contents of the file descrip:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffset −sf 270 descrip a.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following example sets the artist tag (315) of a.tif +to the string +‘‘Anonymous’’:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffset −s 305 Anonymous a.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>This example sets the resolution of the file a.tif to 300 +dpi:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffset −s 296 2 a.tif +tiffset −s 282 300.0 a.tif +tiffset −s 283 300.0 a.tif +</pre> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffdump</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffsplit.1.html b/src/3rdparty/libtiff/html/man/tiffsplit.1.html new file mode 100644 index 0000000000..adbc2f8899 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffsplit.1.html @@ -0,0 +1,102 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:20 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSPLIT</title> +</head> +<body> + +<h1 align=center>TIFFSPLIT</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffsplit − split a multi-image <small>TIFF</small> +into single-image <small>TIFF</small> files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffsplit</b> <i>src.tif</i> [ <i>prefix</i> ]</p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffsplit</i> takes a multi-directory (page) +<small>TIFF</small> file and creates one or more +single-directory (page) <small>TIFF</small> files from it. +The output files are given names created by concatenating a +prefix, a lexically ordered suffix in the range +[<i>aaa</i>-<i>zzz</i>], the suffix <i>.tif</i> (e.g. +<i>xaaa.tif</i>, <i>xaab.tif</i>, <i>xzzz.tif</i>). If a +prefix is not specified on the command line, the default +prefix of <i>x</i> is used.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Only a select set of ‘‘known +tags’’ is copied when splitting.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffcp</b>(1), <b>tiffinfo</b>(1), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffsv.1.html b/src/3rdparty/libtiff/html/man/tiffsv.1.html new file mode 100644 index 0000000000..fb484b01f8 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffsv.1.html @@ -0,0 +1,207 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Fri Jul 13 17:43:20 2007 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSV</title> +</head> +<body> + +<h1 align=center>TIFFSV</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#NOTE">NOTE</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffsv − save an image from the framebuffer in a +<small>TIFF</small> file (Silicon Graphics version)</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffsv</b> [ <i>options</i> ] <i>output.tif</i> [ +<i>x1 x2 y1 y2</i> ]</p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffsv</i> saves all or part of the framebuffer in a +file using the Tag Image File Format, Revision 6.0. By +default, the image is saved with data samples packed +(<i>PlanarConfiguration</i>=1), compressed with the +Lempel-Ziv & Welch algorithm (<i>Compression</i>=5), and +with each strip no more than 8 kilobytes. These +characteristics can be overridden, or explicitly specified +with the options described below.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−b</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Save the image as a greyscale image as if it were +processed by <i>tiff2bw</i>(1). This option is included for +compatibility with the standard <i>scrsave</i>(6D) +program.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the compression to use for data written to the +output file: <b>none</b> for no compression, <b>packbits</b> +for PackBits compression, <b>jpeg</b> for baseline JPEG +compression, <b>zip</b> for Deflate compression, and +<b>lzw</b> for Lempel-Ziv & Welch compression +(default).</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p><small>LZW</small> compression can be specified together +with a <i>predictor</i> value. A predictor value of 2 causes +each scanline of the output image to undergo horizontal +differencing before it is encoded; a value of 1 forces each +scanline to be encoded without differencing. LZW-specific +options are specified by appending a +‘‘:’’-separated list to the +‘‘lzw’’ option; e.g. <b>−c +lzw:2</b> for <small>LZW</small> compression with horizontal +differencing.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the planar configuration to use in writing image +data. By default, <i>tiffsv</i> will create a new file with +the data samples packed contiguously. Specifying <b>−p +contig</b> will force data to be written with multi-sample +data packed together, while <b>−p separate</b> will +force samples to be written in separate planes.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the number of rows (scanlines) in each strip of +data written to the output file. By default, <i>tiffsv</i> +attempts to set the rows/strip that no more than 8 kilobytes +of data appear in a strip.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="NOTE"></a> +<h2>NOTE</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Except for the use of <small>TIFF,</small> this program +is equivalent to the standard <i>scrsave</i> program. This +means, for example, that you can use it in conjunction with +the standard <i>icut</i> program simply by creating a link +called <i>scrsave</i>, or by creating a shell script called +<i>scrsave</i> that invokes <i>tiffgt</i> with the +appropriate options.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>If data are saved compressed and in separate planes, then +the rows in each strip is silently set to one to avoid +limitations in the <b>libtiff</b>(3TIFF) library.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>scrsave</b>(6D) <b>pal2rgb</b>(1), <b>tiffdump</b>(1), +<b>tiffgt</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> |