Initial import
git-svn-id: http://moon:8086/svn/software/trunk/libsrc/libtiff@1 b431acfa-c32f-4a4a-93f1-934dc6c82436
This commit is contained in:
Executable
+69
@@ -0,0 +1,69 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFClose</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFClose</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: May 2, 1990<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF=index.html>Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFClose - close a previously opened
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>void TIFFClose(TIFF* tif)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>TIFFClose</I>
|
||||
|
||||
closes a file that was previously opened with
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T).
|
||||
|
||||
Any buffered data are flushed to the file, including the contents of
|
||||
the current directory (if modified); and all resources
|
||||
are reclaimed.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
Likewise, warning messages are directed to the
|
||||
<I><A HREF="TIFFWarning.3t.html">TIFFWarning</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF=index.html>man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:37 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+97
@@ -0,0 +1,97 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFError</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFError</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFError, TIFFSetErrorHandler - library error handling interface
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>void TIFFError(const char* module, const char* fmt, ...)</B>
|
||||
|
||||
<P>
|
||||
<B>#include <<A HREF="file:/usr/include/stdarg.h">stdarg.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>typedef void (*TIFFErrorHandler)(const char* module, const char* fmt, va_list ap);</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>TIFFErrorHandler TIFFSetErrorHandler(TIFFErrorHandler handler);</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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><A HREF="printf.3s.html">printf</A></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>
|
||||
|
||||
Applications that desire to capture control in the event of an error
|
||||
should use
|
||||
<I>TIFFSetErrorHandler</I>
|
||||
|
||||
to override the default error handler.
|
||||
A
|
||||
<FONT SIZE="-1">NULL</FONT>
|
||||
(0) error handling function may be installed to
|
||||
suppress error messages.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
<I>TIFFSetErrorHandler</I>
|
||||
|
||||
returns a reference to the previous error handling function.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWarning.3t.html">TIFFWarning</A></I>(3T),
|
||||
|
||||
<I><A HREF="printf.3s.html">printf</A></I>(3S)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:37 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+93
@@ -0,0 +1,93 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFFlush</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFFlush</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: December 16, 1991<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFFlush, TIFFFlushData - flush pending writes to an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFFlush(TIFF* tif)</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFFlushData(TIFF* tif)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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>
|
||||
|
||||
<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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
0 is returned if an error is encountered, otherwise 1 is returned.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteEncodedStrip.3t.html">TIFFWriteEncodedStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteEncodedTile.3t.html">TIFFWriteEncodedTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteRawStrip.3t.html">TIFFWriteRawStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteRawTile.3t.html">TIFFWriteRawTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteScanline.3t.html">TIFFWriteScanline</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteTile.3t.html">TIFFWriteTile</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:37 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+266
@@ -0,0 +1,266 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFGetField</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFGetField</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: August 22, 1997<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFGetField, TIFFVGetField - get the value(s) of a tag in an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFGetField(TIFF* tif, ttag_t tag, ...)</B>
|
||||
|
||||
<P>
|
||||
<B>#include <<A HREF="file:/usr/include/stdarg.h">stdarg.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFVGetField(TIFF* tif, ttag_t tag, va_list ap)</B>
|
||||
|
||||
<P>
|
||||
<B>int TIFFGetFieldDefaulted(TIFF* tif, ttag_t tag, ...)</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFVGetFieldDefaulted(TIFF* tif, ttag_t tag, va_list ap)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>TIFFGetField</I>
|
||||
|
||||
returns the value of a tag or pseudo-tag associated with the
|
||||
the current directory of the open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<I>tif</I>.
|
||||
|
||||
(A
|
||||
<I>pseudo-tag </I>
|
||||
|
||||
is a parameter that is used to control the operation of the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
library but whose value is not read or written to the underlying file.)
|
||||
The file must have been previously opened with
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T).
|
||||
|
||||
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><A HREF="stdarg+3">stdarg</A></I>(3)
|
||||
|
||||
interface.
|
||||
The returned values should only be interpreted if
|
||||
<I>TIFFGetField</I>
|
||||
|
||||
returns 1.
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
The tags understood by
|
||||
<I>libtiff</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><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T).
|
||||
|
||||
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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
specification for information on the meaning of
|
||||
each tag and their possible values.
|
||||
<P>
|
||||
|
||||
<PRE>
|
||||
|
||||
<I>Tag Name</I> <I>Count</I> <I>Types</I> <I>Notes</I>
|
||||
|
||||
TIFFTAG_ARTIST 1 char**
|
||||
TIFFTAG_BADFAXLINES 1 uint32*
|
||||
TIFFTAG_BITSPERSAMPLE 1 uint16*
|
||||
TIFFTAG_CLEANFAXDATA 1 uint16*
|
||||
TIFFTAG_COLORMAP 3 uint16** 1<<BitsPerSample arrays
|
||||
TIFFTAG_COMPRESSION 1 uint16*
|
||||
TIFFTAG_CONSECUTIVEBADFAXLINES 1 uint32*
|
||||
TIFFTAG_DATATYPE 1 uint16*
|
||||
TIFFTAG_DATETIME 1 char**
|
||||
TIFFTAG_DOCUMENTNAME 1 char**
|
||||
TIFFTAG_DOTRANGE 2 uint16*
|
||||
TIFFTAG_EXTRASAMPLES 2 uint16*,uint16** count & types array
|
||||
TIFFTAG_FAXMODE 1 int* G3/G4 compression pseudo-tag
|
||||
TIFFTAG_FAXFILLFUNC 1 TIFFFaxFillFunc* G3/G4 compression pseudo-tag
|
||||
TIFFTAG_FILLORDER 1 uint16*
|
||||
TIFFTAG_GROUP3OPTIONS 1 uint32*
|
||||
TIFFTAG_GROUP4OPTIONS 1 uint32*
|
||||
TIFFTAG_HALFTONEHINTS 2 uint16*
|
||||
TIFFTAG_HOSTCOMPUTER 1 char**
|
||||
TIFFTAG_IMAGEDEPTH 1 uint32*
|
||||
TIFFTAG_IMAGEDESCRIPTION 1 char**
|
||||
TIFFTAG_IMAGELENGTH 1 uint32*
|
||||
TIFFTAG_IMAGEWIDTH 1 uint32*
|
||||
TIFFTAG_INKNAMES 1 char**
|
||||
TIFFTAG_INKSET 1 uint16*
|
||||
TIFFTAG_JPEGTABLES 2 u_short*,void** count & tables
|
||||
TIFFTAG_JPEGQUALITY 1 int* JPEG pseudo-tag
|
||||
TIFFTAG_JPEGCOLORMODE 1 int* JPEG pseudo-tag
|
||||
TIFFTAG_JPEGTABLESMODE 1 int* JPEG pseudo-tag
|
||||
TIFFTAG_MAKE 1 char**
|
||||
TIFFTAG_MATTEING 1 uint16*
|
||||
TIFFTAG_MAXSAMPLEVALUE 1 uint16*
|
||||
TIFFTAG_MINSAMPLEVALUE 1 uint16*
|
||||
TIFFTAG_MODEL 1 char**
|
||||
TIFFTAG_ORIENTATION 1 uint16*
|
||||
TIFFTAG_PAGENAME 1 char**
|
||||
TIFFTAG_PAGENUMBER 2 uint16*
|
||||
TIFFTAG_PHOTOMETRIC 1 uint16*
|
||||
TIFFTAG_PLANARCONFIG 1 uint16*
|
||||
TIFFTAG_PREDICTOR 1 uint16*
|
||||
TIFFTAG_PRIMARYCHROMATICITIES 1 float** 6-entry array
|
||||
TIFFTAG_REFERENCEBLACKWHITE 1 float** 2*SamplesPerPixel array
|
||||
TIFFTAG_RESOLUTIONUNIT 1 uint16*
|
||||
TIFFTAG_ROWSPERSTRIP 1 uint32*
|
||||
TIFFTAG_SAMPLEFORMAT 1 uint16*
|
||||
TIFFTAG_SAMPLESPERPIXEL 1 uint16*
|
||||
TIFFTAG_SMAXSAMPLEVALUE 1 double*
|
||||
TIFFTAG_SMINSAMPLEVALUE 1 double*
|
||||
TIFFTAG_SOFTWARE 1 char**
|
||||
TIFFTAG_STONITS 1 double**
|
||||
TIFFTAG_STRIPBYTECOUNTS 1 uint32**
|
||||
TIFFTAG_STRIPOFFSETS 1 uint32**
|
||||
TIFFTAG_SUBFILETYPE 1 uint32*
|
||||
TIFFTAG_SUBIFD 2 uint16*,uint32** count & offsets array
|
||||
TIFFTAG_TARGETPRINTER 1 char**
|
||||
TIFFTAG_THRESHHOLDING 1 uint16*
|
||||
TIFFTAG_TILEBYTECOUNTS 1 uint32**
|
||||
TIFFTAG_TILEDEPTH 1 uint32*
|
||||
TIFFTAG_TILELENGTH 1 uint32*
|
||||
TIFFTAG_TILEOFFSETS 1 uint32**
|
||||
TIFFTAG_TILEWIDTH 1 uint32*
|
||||
TIFFTAG_TRANSFERFUNCTION 1 or 3+ uint16**1<<BitsPerSample entry arrays
|
||||
TIFFTAG_WHITEPOINT 1 float** 2-entry array
|
||||
TIFFTAG_XPOSITION 1 float*
|
||||
TIFFTAG_XRESOLUTION 1 float*
|
||||
TIFFTAG_YCBCRCOEFFICIENTS 1 float** 3-entry array
|
||||
TIFFTAG_YCBCRPOSITIONING 1 uint16*
|
||||
TIFFTAG_YCBCRSUBSAMPLING 2 uint16*
|
||||
TIFFTAG_YPOSITION 1 float*
|
||||
TIFFTAG_YRESOLUTION 1 float*
|
||||
TIFFTAG_ICCPROFILE 2 uint32*,void** count, profile datadd
|
||||
</PRE>
|
||||
|
||||
+ If
|
||||
<I>SamplesPerPixel</I>
|
||||
|
||||
is one, then a single array is returned; otherwise three arrays are
|
||||
returned.
|
||||
|
||||
dd 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 <A HREF="http://www.color.org)">http://www.color.org)</A> for an explanation.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
1 is returned if the tag is defined in the current
|
||||
directory; otherwise a 0 is returned.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<P>
|
||||
|
||||
<B>Unknown field, tag 0x%x</B>.
|
||||
|
||||
An unknown tag was supplied.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFSetDirectory.3t.html">TIFFSetDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadDirectory.3t.html">TIFFReadDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteDirectory.3t.html">TIFFWriteDirectory</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:37 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+361
@@ -0,0 +1,361 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFOpen</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFOpen</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: January 9, 1996<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFOpen, TIFFFdOpen, TIFFClientOpen - open a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file for reading or writing
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<PRE>
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
<B>TIFF* TIFFOpen(const char* filename, const char* mode)</B>
|
||||
|
||||
<B>TIFF* TIFFFdOpen(const int fd, const char* filename, const char* mode)</B>
|
||||
|
||||
<B>typedef tsize_t (*TIFFReadWriteProc)(thandle_t, tdata_t, tsize_t);</B>
|
||||
<B>typedef toff_t (*TIFFSeekProc)(thandle_t, toff_t, int);</B>
|
||||
<B>typedef int (*TIFFCloseProc)(thandle_t);</B>
|
||||
<B>typedef toff_t (*TIFFSizeProc)(thandle_t);</B>
|
||||
<B>typedef int (*TIFFMapFileProc)(thandle_t, tdata_t*, toff_t*);</B>
|
||||
<B>typedef void (*TIFFUnmapFileProc)(thandle_t, tdata_t, toff_t);</B>
|
||||
|
||||
<B>TIFF* TIFFClientOpen(const char* filename, const char* mode, thandle_t clientdata,</B>
|
||||
<B> TIFFReadWriteProc readproc, TIFFReadWriteProc writeproc, TIFFSeekProc seekproc,</B>
|
||||
<B> TIFFCloseProc closeproc, TIFFSizeProc sizeproc, TIFFMapFileProc mapproc,</B>
|
||||
<B> TIFFUnmapFileProc unmapproc)</B>
|
||||
</PRE>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>TIFFOpen</I>
|
||||
|
||||
opens a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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>
|
||||
|
||||
If a file is opened for reading, the first
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
directory in the file is automatically read
|
||||
(also see
|
||||
<I><A HREF="TIFFSetDirectory.3t.html">TIFFSetDirectory</A></I>(3T)
|
||||
|
||||
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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
must be used.
|
||||
<P>
|
||||
|
||||
<I>TIFFFdOpen</I>
|
||||
|
||||
is like
|
||||
<I>TIFFOpen</I>
|
||||
|
||||
except that it opens a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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>
|
||||
|
||||
<I>TIFFClientOpen</I>
|
||||
|
||||
is like
|
||||
<I>TIFFOpen</I>
|
||||
|
||||
except that the caller supplies a collection of functions that the
|
||||
library will use to do <FONT SIZE="-1">UNIX</FONT>-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><A HREF="lseek+2">lseek</A></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><A HREF="mmap+2">mmap</A></I>(2)
|
||||
|
||||
and
|
||||
<I><A HREF="munmap+2">munmap</A></I>(2).
|
||||
|
||||
The
|
||||
<I>clientdata</I>
|
||||
|
||||
parameter is an opaque ``handle'' passed to the client-specified
|
||||
routines passed as parameters to
|
||||
<I>TIFFClientOpen</I>.
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
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.
|
||||
<DL COMPACT>
|
||||
<DT><B>l</B>
|
||||
|
||||
<DD>
|
||||
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
|
||||
<FONT SIZE="-1">CPU</FONT>
|
||||
byte order.
|
||||
<DT><B>b</B>
|
||||
|
||||
<DD>
|
||||
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
|
||||
<FONT SIZE="-1">CPU</FONT>
|
||||
byte order.
|
||||
<DT><B>L</B>
|
||||
|
||||
<DD>
|
||||
Force image data that is read or written to be treated with
|
||||
bits filled from Least Significant Bit (<FONT SIZE="-1">LSB</FONT>) to
|
||||
Most Significant Bit (<FONT SIZE="-1">MSB</FONT>).
|
||||
Note that this is the opposite to the way the library has
|
||||
worked from its inception.
|
||||
<DT><B>B</B>
|
||||
|
||||
<DD>
|
||||
Force image data that is read or written to be treated with
|
||||
bits filled from Most Significant Bit (<FONT SIZE="-1">MSB</FONT>) to
|
||||
Least Significant Bit (<FONT SIZE="-1">LSB</FONT>); this is the default.
|
||||
<DT><B>H</B>
|
||||
|
||||
<DD>
|
||||
Force image data that is read or written to be treated with
|
||||
bits filled in the same order as the native
|
||||
<FONT SIZE="-1">CPU.</FONT>
|
||||
<DT><B>M</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>m</B>
|
||||
|
||||
<DD>
|
||||
Disable the use of memory-mapped files.
|
||||
<DT><B>C</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>c</B>
|
||||
|
||||
<DD>
|
||||
Disable the use of strip chopping when reading images.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>BYTE ORDER</H2>
|
||||
|
||||
The
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
images is incapable of reading images in anything but the native
|
||||
<FONT SIZE="-1">CPU</FONT>
|
||||
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
|
||||
<FONT SIZE="-1">CPU</FONT>
|
||||
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''.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
Upon successful completion
|
||||
<I>TIFFOpen</I>,
|
||||
|
||||
<I>TIFFFdOpen</I>,
|
||||
|
||||
and
|
||||
<I>TIFFClientOpen</I>
|
||||
|
||||
return a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
pointer.
|
||||
Otherwise, NULL is returned.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
Likewise, warning messages are directed to the
|
||||
<I><A HREF="TIFFWarning.3t.html">TIFFWarning</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<P>
|
||||
|
||||
<B>"%s": Bad mode</B>.
|
||||
The specified
|
||||
<I>mode</I>
|
||||
|
||||
parameter was not one of ``r'' (read), ``w'' (write), or ``a'' (append).
|
||||
<P>
|
||||
|
||||
<B>%s: Cannot open</B>.
|
||||
|
||||
<I>TIFFOpen</I>()
|
||||
|
||||
was unable to open the specified filename for read/writing.
|
||||
<P>
|
||||
|
||||
<B>Cannot read TIFF header</B>.
|
||||
|
||||
An error occurred while attempting to read the header information.
|
||||
<P>
|
||||
|
||||
<B>Error writing TIFF header</B>.
|
||||
|
||||
An error occurred while writing the default header information
|
||||
for a new file.
|
||||
<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>
|
||||
|
||||
<B>Not a TIFF file, bad version number %d (0x%x)</B>.
|
||||
|
||||
The version field in the header was not 42 (decimal).
|
||||
<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.
|
||||
<A NAME="lbAI"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFClose.3t.html">TIFFClose</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">BYTE ORDER</A><DD>
|
||||
<DT><A HREF="#lbAG">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAH">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAI">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:37 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+100
@@ -0,0 +1,100 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFPrintDirectory</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFPrintDirectory</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: December 12, 1991<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFPrintDirectory - print a description of a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
directory
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>void TIFFPrintDirectory(TIFF* tif, FILE* fd, long flags)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>TIFFPrintDirectory</I>
|
||||
|
||||
prints a description of the current directory in the specified
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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>
|
||||
<PRE>
|
||||
|
||||
#define TIFFPRINT_NONE 0x0 /* no extra info */
|
||||
#define TIFFPRINT_STRIPS 0x1 /* strips/tiles info */
|
||||
#define TIFFPRINT_CURVES 0x2 /* color/gray response curves */
|
||||
#define TIFFPRINT_COLORMAP 0x4 /* colormap */
|
||||
#define TIFFPRINT_JPEGQTABLES 0x100 /* JPEG Q matrices */
|
||||
#define TIFFPRINT_JPEGACTABLES 0x200 /* JPEG AC tables */
|
||||
#define TIFFPRINT_JPEGDCTABLES 0x200 /* JPEG DC tables */
|
||||
</PRE>
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
In C++ the
|
||||
<I>flags</I>
|
||||
|
||||
parameter defaults to 0.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
None.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
None.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadDirectory.3t.html">TIFFReadDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFSetDirectory.3t.html">TIFFSetDirectory</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:37 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+370
@@ -0,0 +1,370 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFRGBAImage</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFRGBAImage</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFRGBAImage - read and decode an image into a raster
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<PRE>
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
<B>typedef unsigned char TIFFRGBValue;</B>
|
||||
<B>typedef struct _TIFFRGBAImage TIFFRGBAImage;</B>
|
||||
<B>int TIFFRGBAImageOK(TIFF* tif, char emsg[1024]);</B>
|
||||
<B>int TIFFRGBAImageBegin(TIFFRGBAImage* img, TIFF* tif, int stopOnError, char emsg[1024]);</B>
|
||||
<B>int TIFFRGBAImageGet(TIFFRGBAImage* img, uint32* raster, uint32 width, uint32 height);</B>
|
||||
<B>void TIFFRGBAImageEnd(TIFFRGBAImage* img);</B>
|
||||
</PRE><A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
The routines described here provide a high-level interface
|
||||
through which
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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>
|
||||
|
||||
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>
|
||||
|
||||
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 lower-left hand corner.)
|
||||
<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>
|
||||
|
||||
<I>TIFFRGBAImageGet</I>
|
||||
|
||||
converts non-8-bit images by scaling sample values.
|
||||
Palette, grayscale, bilevel,
|
||||
<FONT SIZE="-1">CMYK</FONT>, and YCbCr images are converted to
|
||||
<FONT SIZE="-1">RGB</FONT>
|
||||
transparently.
|
||||
Raster pixels are returned uncorrected by any colorimetry information
|
||||
present in the directory.
|
||||
<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>TIFFRGBAImageGet</I>
|
||||
|
||||
will continue processing data until all the possible data in the
|
||||
image have been requested.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>ALTERNATE RASTER FORMATS</H2>
|
||||
|
||||
To use the core support for reading and processing
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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
|
||||
<FONT SIZE="-1">ABGR</FONT>
|
||||
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.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SIMULTANEOUS RASTER STORE AND DISPLAY</H2>
|
||||
|
||||
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><A HREF="tiffgt+1.html">tiffgt</A></I>(1)
|
||||
|
||||
utility uses the following put method to update the display as
|
||||
the raster is being filled:
|
||||
<P>
|
||||
<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>
|
||||
|
||||
<P>
|
||||
(the original routine provided by the library is saved in the
|
||||
variable
|
||||
<I>putContig</I>.)
|
||||
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SUPPORTING ADDITIONAL TIFF FORMATS</H2>
|
||||
|
||||
The
|
||||
<I>TIFFRGBAImage</I>
|
||||
|
||||
routines support the most commonly encountered flavors of
|
||||
<FONT SIZE="-1">TIFF.</FONT>
|
||||
It is possible to extend this support by overriding the ``<I>get method</I>''
|
||||
invoked by
|
||||
<I>TIFFRGBAImageGet</I>
|
||||
|
||||
to read
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
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>
|
||||
|
||||
Palettte image colormaps that appear to be incorrectly written
|
||||
as 8-bit values are automatically scaled to 16-bits.
|
||||
<A NAME="lbAI"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
All routines return
|
||||
1 if the operation was successful.
|
||||
Otherwise, 0 is returned if an error was encountered and
|
||||
<I>stopOnError</I>
|
||||
|
||||
is zero.
|
||||
<A NAME="lbAJ"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<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>
|
||||
|
||||
<B>Sorry, can not handle %d-channel images</B>.
|
||||
|
||||
The image had
|
||||
<I>SamplesPerPixel</I>
|
||||
|
||||
other than 1, 3, or 4.
|
||||
<P>
|
||||
|
||||
<B>Missing needed "PhotometricInterpretation" tag</B>.
|
||||
The image did not have a tag that describes how to display
|
||||
the data.
|
||||
<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
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<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>
|
||||
|
||||
<B>No space for photometric conversion table</B>.
|
||||
|
||||
There was insufficient memory for a table used to convert
|
||||
image samples to 8-bit
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<P>
|
||||
|
||||
<B>Missing required "Colormap" tag</B>.
|
||||
A Palette image did not have a required
|
||||
<I>Colormap</I>
|
||||
|
||||
tag.
|
||||
<P>
|
||||
|
||||
<B>No space for tile buffer</B>.
|
||||
|
||||
There was insufficient memory to allocate an i/o buffer.
|
||||
<P>
|
||||
|
||||
<B>No space for strip buffer</B>.
|
||||
|
||||
There was insufficient memory to allocate an i/o buffer.
|
||||
<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>
|
||||
|
||||
<B>No space for B&W mapping table</B>.
|
||||
|
||||
There was insufficient memory to allocate a table used to map
|
||||
grayscale data to
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<P>
|
||||
|
||||
<B>No space for Palette mapping table</B>.
|
||||
|
||||
There was insufficient memory to allocate a table used to map
|
||||
data to 8-bit
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<A NAME="lbAK"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Orientations other than bottom-left, or top-left are
|
||||
not handled correctly.
|
||||
<A NAME="lbAL"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRGBAImage.3t.html">TIFFReadRGBAImage</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRGBAStrip.3t.html">TIFFReadRGBAStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRGBATile.3t.html">TIFFReadRGBATile</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">ALTERNATE RASTER FORMATS</A><DD>
|
||||
<DT><A HREF="#lbAF">SIMULTANEOUS RASTER STORE AND DISPLAY</A><DD>
|
||||
<DT><A HREF="#lbAG">SUPPORTING ADDITIONAL TIFF FORMATS</A><DD>
|
||||
<DT><A HREF="#lbAH">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAI">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAJ">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAK">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAL">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+212
@@ -0,0 +1,212 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFReadDirectory</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFReadDirectory</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReadDirectory - get the contents of the next directory in an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFReadDirectory(TIFF* tif)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file-
|
||||
the first directory in a file is automatically read when
|
||||
<I>TIFFOpen</I>
|
||||
|
||||
is called.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
If the library is compiled with
|
||||
<FONT SIZE="-1">STRIPCHOP_SUPPORT</FONT>
|
||||
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>].
|
||||
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
All warning messages are directed to the
|
||||
<I><A HREF="TIFFWarning.3t.html">TIFFWarning</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<P>
|
||||
|
||||
<B>Seek error accessing TIFF directory</B>.
|
||||
An error occurred while positioning to the location of the
|
||||
directory.
|
||||
<P>
|
||||
|
||||
<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
|
||||
<FONT SIZE="-1">SHORT</FONT>
|
||||
data type.
|
||||
<P>
|
||||
|
||||
<B>TIFF directory is missing required "%s" field</B>.
|
||||
The specified tag is required to be present by the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
5.0 specification, but is missing.
|
||||
The directory is (usually) unusable.
|
||||
<P>
|
||||
|
||||
<B>%s: Rational with zero denominator</B>.
|
||||
A directory tag has a
|
||||
<FONT SIZE="-1">RATIONAL</FONT>
|
||||
value whose denominator is zero.
|
||||
<P>
|
||||
|
||||
<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.
|
||||
<P>
|
||||
|
||||
<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.
|
||||
<P>
|
||||
|
||||
<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.
|
||||
<P>
|
||||
|
||||
<B>Invalid TIFF directory; tags are not sorted in ascending order</B>.
|
||||
The directory tags are not properly sorted as specified
|
||||
in the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
5.0 specification.
|
||||
This error is not fatal.
|
||||
<P>
|
||||
|
||||
<B>Ignoring unknown field with tag %d (0x%x)</B>.
|
||||
An unknown tag was encountered in the directory;
|
||||
the library ignores all such tags.
|
||||
<P>
|
||||
|
||||
<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.
|
||||
<P>
|
||||
|
||||
<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.
|
||||
<P>
|
||||
|
||||
<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.
|
||||
<P>
|
||||
|
||||
<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.
|
||||
<P>
|
||||
|
||||
<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.
|
||||
<P>
|
||||
|
||||
<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.
|
||||
<P>
|
||||
|
||||
<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.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteDirectory.3t.html">TIFFWriteDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFSetDirectory.3t.html">TIFFSetDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFSetSubDirectory.3t.html">TIFFSetSubDirectory</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+103
@@ -0,0 +1,103 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFReadEncodedStrip</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFReadEncodedStrip</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReadEncodedStrip - read and decode a strip of data from an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>tsize_t TIFFReadEncodedStrip(TIFF* tif, tstrip_t strip, tdata_t buf, tsize_t size)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
Read the specified strip of data and place up to
|
||||
<I>size</I>
|
||||
|
||||
bytes of decompressed information in the (user supplied) data buffer.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
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
|
||||
<I><A HREF="TIFFStripSize.3t.html">TIFFStripSize</A></I>(3T).
|
||||
|
||||
<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,
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRawStrip.3t.html">TIFFReadRawStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadScanline.3t.html">TIFFReadScanline</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+107
@@ -0,0 +1,107 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFReadEncodedTile</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFReadEncodedTile</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReadEncodedTile - read and decode a tile of data from an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFReadEncodedTile(TIFF* tif, u_long tile, u_char* buf, u_long size)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
Read the specified tile of data and place up to
|
||||
<I>size</I>
|
||||
|
||||
bytes of decompressed information in the (user supplied) data buffer.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
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>
|
||||
|
||||
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,
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRawTile.3t.html">TIFFReadRawTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadTile.3t.html">TIFFReadTile</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+262
@@ -0,0 +1,262 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFReadRGBAImage</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFReadRGBAImage</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: February 14, 1992<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReadRGBAImage - read and decode an image into a fixed-format raster
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<PRE>
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<B>#define TIFFGetR(abgr) ((abgr) & 0xff)</B>
|
||||
<B>#define TIFFGetG(abgr) (((abgr) >> 8) & 0xff)</B>
|
||||
<B>#define TIFFGetB(abgr) (((abgr) >> 16) & 0xff)</B>
|
||||
<B>#define TIFFGetA(abgr) (((abgr) >> 24) & 0xff)</B>
|
||||
|
||||
<B>int TIFFReadRGBAImage(TIFF* tif, u_long width, u_long height, u_long* raster, int stopOnError)</B>
|
||||
</PRE><A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>TIFFReadRGBAImage</I>
|
||||
|
||||
reads a strip- or tile-based image into memory, storing the<BR>
|
||||
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>
|
||||
|
||||
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>
|
||||
|
||||
<I>TIFFReadRGBAImage</I>
|
||||
|
||||
converts non-8-bit images by scaling sample values.
|
||||
Palette, grayscale, bilevel,
|
||||
<FONT SIZE="-1">CMYK</FONT>, and YCbCr images are converted to
|
||||
<FONT SIZE="-1">RGB</FONT>
|
||||
transparently.
|
||||
Raster pixels are returned uncorrected by any colorimetry information
|
||||
present in the directory.
|
||||
<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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
In C++ the
|
||||
<I>stopOnError</I>
|
||||
|
||||
parameter defaults to 0.
|
||||
<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>
|
||||
|
||||
Palettte image colormaps that appear to be incorrectly written
|
||||
as 8-bit values are automatically scaled to 16-bits.
|
||||
<P>
|
||||
|
||||
<I>TIFFReadRGBAImage</I>
|
||||
|
||||
is just a wrapper around the more general
|
||||
<I><A HREF="TIFFRGBAImage.3t.html">TIFFRGBAImage</A></I>(3T)
|
||||
|
||||
facilities.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<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>
|
||||
|
||||
<B>Sorry, can not handle %d-channel images</B>.
|
||||
|
||||
The image had
|
||||
<I>SamplesPerPixel</I>
|
||||
|
||||
other than 1, 3, or 4.
|
||||
<P>
|
||||
|
||||
<B>Missing needed "PhotometricInterpretation" tag</B>.
|
||||
The image did not have a tag that describes how to display
|
||||
the data.
|
||||
<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
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<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>
|
||||
|
||||
<B>No space for photometric conversion table</B>.
|
||||
|
||||
There was insufficient memory for a table used to convert
|
||||
image samples to 8-bit
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<P>
|
||||
|
||||
<B>Missing required "Colormap" tag</B>.
|
||||
A Palette image did not have a required
|
||||
<I>Colormap</I>
|
||||
|
||||
tag.
|
||||
<P>
|
||||
|
||||
<B>No space for tile buffer</B>.
|
||||
|
||||
There was insufficient memory to allocate an i/o buffer.
|
||||
<P>
|
||||
|
||||
<B>No space for strip buffer</B>.
|
||||
|
||||
There was insufficient memory to allocate an i/o buffer.
|
||||
<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>
|
||||
|
||||
<B>No space for B&W mapping table</B>.
|
||||
|
||||
There was insufficient memory to allocate a table used to map
|
||||
grayscale data to
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<P>
|
||||
|
||||
<B>No space for Palette mapping table</B>.
|
||||
|
||||
There was insufficient memory to allocate a table used to map
|
||||
data to 8-bit
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Orientations other than bottom-left, or top-left are
|
||||
not handled correctly.
|
||||
<A NAME="lbAI"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFRGBAImage.3t.html">TIFFRGBAImage</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRGBAStrip.3t.html">TIFFReadRGBAStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRGBATile.3t.html">TIFFReadRGBATile</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAI">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+249
@@ -0,0 +1,249 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFReadRGBAStrip</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFReadRGBAStrip</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: December 10, 1998<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReadRGBAStrip - read and decode an image strip into a fixed-format raster
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<PRE>
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<B>#define TIFFGetR(abgr) ((abgr) & 0xff)</B>
|
||||
<B>#define TIFFGetG(abgr) (((abgr) >> 8) & 0xff)</B>
|
||||
<B>#define TIFFGetB(abgr) (((abgr) >> 16) & 0xff)</B>
|
||||
<B>#define TIFFGetA(abgr) (((abgr) >> 24) & 0xff)</B>
|
||||
|
||||
<B>int TIFFReadRGBAStrip(TIFF* tif, tstrip_t strip, uint32 * raster )</B>
|
||||
</PRE><A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>TIFFReadRGBAStrip</I>
|
||||
|
||||
reads a single strip of a strip-based image into memory, <BR>
|
||||
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>
|
||||
<P>
|
||||
|
||||
The
|
||||
<I>strip</I>
|
||||
|
||||
value should be the strip number (strip zero is the first) as returned by the
|
||||
<I>TIFFComputeStrip</I>
|
||||
|
||||
function, but always for sample 0.
|
||||
<P>
|
||||
<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>
|
||||
<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>
|
||||
|
||||
See the
|
||||
<I><A HREF="TIFFRGBAImage.3t.html">TIFFRGBAImage</A></I>(3T)
|
||||
|
||||
page for more details on how various image types are converted to RGBA
|
||||
values.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
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>
|
||||
|
||||
Palette image colormaps that appear to be incorrectly written
|
||||
as 8-bit values are automatically scaled to 16-bits.
|
||||
<P>
|
||||
|
||||
<I>TIFFReadRGBAStrip</I>
|
||||
|
||||
is just a wrapper around the more general
|
||||
<I><A HREF="TIFFRGBAImage.3t.html">TIFFRGBAImage</A></I>(3T)
|
||||
|
||||
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.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
1 is returned if the image was successfully read and converted.
|
||||
Otherwise, 0 is returned if an error was encountered.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<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>
|
||||
|
||||
<B>Sorry, can not handle %d-channel images</B>.
|
||||
|
||||
The image had
|
||||
<I>SamplesPerPixel</I>
|
||||
|
||||
other than 1, 3, or 4.
|
||||
<P>
|
||||
|
||||
<B>Missing needed "PhotometricInterpretation" tag</B>.
|
||||
The image did not have a tag that describes how to display
|
||||
the data.
|
||||
<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
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<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>
|
||||
|
||||
<B>No space for photometric conversion table</B>.
|
||||
|
||||
There was insufficient memory for a table used to convert
|
||||
image samples to 8-bit
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<P>
|
||||
|
||||
<B>Missing required "Colormap" tag</B>.
|
||||
A Palette image did not have a required
|
||||
<I>Colormap</I>
|
||||
|
||||
tag.
|
||||
<P>
|
||||
|
||||
<B>No space for tile buffer</B>.
|
||||
|
||||
There was insufficient memory to allocate an i/o buffer.
|
||||
<P>
|
||||
|
||||
<B>No space for strip buffer</B>.
|
||||
|
||||
There was insufficient memory to allocate an i/o buffer.
|
||||
<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>
|
||||
|
||||
<B>No space for B&W mapping table</B>.
|
||||
|
||||
There was insufficient memory to allocate a table used to map
|
||||
grayscale data to
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<P>
|
||||
|
||||
<B>No space for Palette mapping table</B>.
|
||||
|
||||
There was insufficient memory to allocate a table used to map
|
||||
data to 8-bit
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Orientations other than bottom-left, or top-left are
|
||||
not handled correctly.
|
||||
<A NAME="lbAI"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFRGBAImage.3t.html">TIFFRGBAImage</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRGBAImage.3t.html">TIFFReadRGBAImage</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRGBATile.3t.html">TIFFReadRGBATile</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAI">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+251
@@ -0,0 +1,251 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFReadRGBATile</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFReadRGBATile</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: December 10, 1998<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReadRGBATile - read and decode an image tile into a fixed-format raster
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<PRE>
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<B>#define TIFFGetR(abgr) ((abgr) & 0xff)</B>
|
||||
<B>#define TIFFGetG(abgr) (((abgr) >> 8) & 0xff)</B>
|
||||
<B>#define TIFFGetB(abgr) (((abgr) >> 16) & 0xff)</B>
|
||||
<B>#define TIFFGetA(abgr) (((abgr) >> 24) & 0xff)</B>
|
||||
|
||||
<B>int TIFFReadRGBATile(TIFF* tif, uint32 x, uint32 y, uint32 * raster )</B>
|
||||
</PRE><A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>TIFFReadRGBATile</I>
|
||||
|
||||
reads a single tile of a tile-based image into memory, <BR>
|
||||
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>
|
||||
<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>
|
||||
<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>
|
||||
<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>
|
||||
|
||||
See the
|
||||
<I><A HREF="TIFFRGBAImage.3t.html">TIFFRGBAImage</A></I>(3T)
|
||||
|
||||
page for more details on how various image types are converted to RGBA
|
||||
values.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
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>
|
||||
|
||||
Palette image colormaps that appear to be incorrectly written
|
||||
as 8-bit values are automatically scaled to 16-bits.
|
||||
<P>
|
||||
|
||||
<I>TIFFReadRGBATile</I>
|
||||
|
||||
is just a wrapper around the more general
|
||||
<I><A HREF="TIFFRGBAImage.3t.html">TIFFRGBAImage</A></I>(3T)
|
||||
|
||||
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.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
1 is returned if the image was successfully read and converted.
|
||||
Otherwise, 0 is returned if an error was encountered.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<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>
|
||||
|
||||
<B>Sorry, can not handle %d-channel images</B>.
|
||||
|
||||
The image had
|
||||
<I>SamplesPerPixel</I>
|
||||
|
||||
other than 1, 3, or 4.
|
||||
<P>
|
||||
|
||||
<B>Missing needed "PhotometricInterpretation" tag</B>.
|
||||
The image did not have a tag that describes how to display
|
||||
the data.
|
||||
<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
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<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>
|
||||
|
||||
<B>No space for photometric conversion table</B>.
|
||||
|
||||
There was insufficient memory for a table used to convert
|
||||
image samples to 8-bit
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<P>
|
||||
|
||||
<B>Missing required "Colormap" tag</B>.
|
||||
A Palette image did not have a required
|
||||
<I>Colormap</I>
|
||||
|
||||
tag.
|
||||
<P>
|
||||
|
||||
<B>No space for tile buffer</B>.
|
||||
|
||||
There was insufficient memory to allocate an i/o buffer.
|
||||
<P>
|
||||
|
||||
<B>No space for strip buffer</B>.
|
||||
|
||||
There was insufficient memory to allocate an i/o buffer.
|
||||
<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>
|
||||
|
||||
<B>No space for B&W mapping table</B>.
|
||||
|
||||
There was insufficient memory to allocate a table used to map
|
||||
grayscale data to
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<P>
|
||||
|
||||
<B>No space for Palette mapping table</B>.
|
||||
|
||||
There was insufficient memory to allocate a table used to map
|
||||
data to 8-bit
|
||||
<FONT SIZE="-1">RGB.</FONT>
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Orientations other than bottom-left, or top-left are
|
||||
not handled correctly.
|
||||
<A NAME="lbAI"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFRGBAImage.3t.html">TIFFRGBAImage</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRGBAImage.3t.html">TIFFReadRGBAImage</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRGBAStrip.3t.html">TIFFReadRGBAStrip</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAI">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+88
@@ -0,0 +1,88 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFReadRawStrip</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFReadRawStrip</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReadRawStrip - return the undecoded contents
|
||||
of a strip of data from an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>tsize_t TIFFReadRawStrip(TIFF* tif, tstrip_t strip, tdata_t buf, tsize_t size)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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>.
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadEncodedStrip.3t.html">TIFFReadEncodedStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadScanline.3t.html">TIFFReadScanline</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFStripSize.3t.html">TIFFStripSize</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+91
@@ -0,0 +1,91 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFReadRawTile</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFReadRawTile</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReadRawTile - return an undecoded tile of data from an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>tsize_t TIFFReadRawTile(TIFF* tif, ttile_t tile, tdata_t buf, tsize_t size)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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>.
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadEncodedTile.3t.html">TIFFReadEncodedTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadTile.3t.html">TIFFReadTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFTileSize.3t.html">TIFFTileSize</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+139
@@ -0,0 +1,139 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFReadScanline</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFReadScanline</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReadScanline - read and decode a scanline of data from an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFReadScanline(TIFF* tif, tdata_t buf, uint32 row, tsample_t sample)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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).
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
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>
|
||||
|
||||
In C++ the
|
||||
<I>sample</I>
|
||||
|
||||
parameter defaults to 0.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
<I>TIFFReadScanline</I>
|
||||
|
||||
returns -1 if it detects an error; otherwise 1 is returned.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<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.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAI"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadEncodedStrip.3t.html">TIFFReadEncodedStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRawStrip.3t.html">TIFFReadRawStrip</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAI">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+120
@@ -0,0 +1,120 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFReadTile</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFReadTile</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: December 16, 1991<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReadTile - read and decode a tile of data from an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>tsize_t TIFFReadTile(TIFF* tif, tdata_t buf, uint32 x, uint32 y, uint32 z, tsample_t sample)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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).
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
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,
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
<I>TIFFReadTile</I>
|
||||
|
||||
returns -1 if it detects an error; otherwise the number of
|
||||
bytes in the decoded tile is returned.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFCheckTile.3t.html">TIFFCheckTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFComputeTile.3t.html">TIFFComputeTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadEncodedTile.3t.html">TIFFReadEncodedTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRawTile.3t.html">TIFFReadRawTile</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+114
@@ -0,0 +1,114 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFSetDirectory</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFSetDirectory</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFSetDirectory, TIFFSetSubDirectory - set the current directory for an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFSetDirectory(TIFF* tif, tdir_t dirnum)</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFSetSubDirectory(TIFF* tif, uint32 diroff)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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>
|
||||
|
||||
<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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<P>
|
||||
|
||||
<B>%s: Error fetching directory count</B>.
|
||||
|
||||
An error was encountered while reading the ``directory count'' field.
|
||||
<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.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFCurrentDirectory.3t.html">TIFFCurrentDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadDirectory.3t.html">TIFFReadDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteDirectory.3t.html">TIFFWriteDirectory</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+269
@@ -0,0 +1,269 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFSetField</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFSetField</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: August 28, 1997<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFSetField - set the value(s) of a tag in a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file open for writing
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFSetField(TIFF* tif, ttag_t tag, ...)</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/stdarg.h">stdarg.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFVSetField(TIFF* tif, ttag_t tag, va_list ap)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>TIFFSetField</I>
|
||||
|
||||
sets the value of a field
|
||||
or pseudo-tag in the current directory associated with
|
||||
the open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<I>tif</I>.
|
||||
|
||||
(A
|
||||
<I>pseudo-tag </I>
|
||||
|
||||
is a parameter that is used to control the operation of the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T);
|
||||
|
||||
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><A HREF="stdarg+3">stdarg</A></I>(3)
|
||||
|
||||
interface (or, on some machines, the
|
||||
<I><A HREF="varargs+3">varargs</A></I>(3)
|
||||
|
||||
interface.)
|
||||
<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>
|
||||
|
||||
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
|
||||
<FONT SIZE="-1">ASCII</FONT>
|
||||
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>
|
||||
Consult the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
specification for information on the meaning of each tag.
|
||||
<P>
|
||||
|
||||
<PRE>
|
||||
|
||||
<I>Tag Name</I> <I>Count</I> <I>Types</I> <I>Notes</I>
|
||||
|
||||
TIFFTAG_ARTIST 1 char*
|
||||
TIFFTAG_BADFAXLINES 1 uint32
|
||||
TIFFTAG_BITSPERSAMPLE 1 uint16 +
|
||||
TIFFTAG_CLEANFAXDATA 1 uint16
|
||||
TIFFTAG_COLORMAP 3 uint16* 1<<BitsPerSample arrays
|
||||
TIFFTAG_COMPRESSION 1 uint16 +
|
||||
TIFFTAG_CONSECUTIVEBADFAXLINES 1 uint32
|
||||
TIFFTAG_DATETIME 1 char*
|
||||
TIFFTAG_DOCUMENTNAME 1 char*
|
||||
TIFFTAG_DOTRANGE 2 uint16
|
||||
TIFFTAG_EXTRASAMPLES 2 uint16,uint16* + count & types array
|
||||
TIFFTAG_FAXMODE 1 int + G3/G4 compression pseudo-tag
|
||||
TIFFTAG_FAXFILLFUNC 1 TIFFFaxFillFunc G3/G4 compression pseudo-tag
|
||||
TIFFTAG_FILLORDER 1 uint16 +
|
||||
TIFFTAG_GROUP3OPTIONS 1 uint32 +
|
||||
TIFFTAG_GROUP4OPTIONS 1 uint32 +
|
||||
TIFFTAG_HALFTONEHINTS 2 uint16
|
||||
TIFFTAG_HOSTCOMPUTER 1 char*
|
||||
TIFFTAG_IMAGEDESCRIPTION 1 char*
|
||||
TIFFTAG_IMAGEDEPTH 1 uint32 +
|
||||
TIFFTAG_IMAGELENGTH 1 uint32
|
||||
TIFFTAG_IMAGEWIDTH 1 uint32 +
|
||||
TIFFTAG_INKNAMES 1 char*
|
||||
TIFFTAG_INKSET 1 uint16 +
|
||||
TIFFTAG_JPEGTABLES 2 uint32*,void* + count & tables
|
||||
TIFFTAG_JPEGQUALITY 1 int JPEG pseudo-tag
|
||||
TIFFTAG_JPEGCOLORMODE 1 int + JPEG pseudo-tag
|
||||
TIFFTAG_JPEGTABLESMODE 1 int + JPEG pseudo-tag
|
||||
TIFFTAG_MAKE 1 char*
|
||||
TIFFTAG_MATTEING 1 uint16 +
|
||||
TIFFTAG_MAXSAMPLEVALUE 1 uint16
|
||||
TIFFTAG_MINSAMPLEVALUE 1 uint16
|
||||
TIFFTAG_MODEL 1 char*
|
||||
TIFFTAG_ORIENTATION 1 uint16
|
||||
TIFFTAG_PAGENAME 1 char*
|
||||
TIFFTAG_PAGENUMBER 2 uint16
|
||||
TIFFTAG_PHOTOMETRIC 1 uint16
|
||||
TIFFTAG_PLANARCONFIG 1 uint16 +
|
||||
TIFFTAG_PREDICTOR 1 uint16 +
|
||||
TIFFTAG_PRIMARYCHROMATICITIES 1 float* 6-entry array
|
||||
TIFFTAG_REFERENCEBLACKWHITE 1 float* + 2*SamplesPerPixel array
|
||||
TIFFTAG_RESOLUTIONUNIT 1 uint16
|
||||
TIFFTAG_ROWSPERSTRIP 1 uint32 + must be > 0
|
||||
TIFFTAG_SAMPLEFORMAT 1 uint16 +
|
||||
TIFFTAG_SAMPLESPERPIXEL 1 uint16 + value must be <= 4
|
||||
TIFFTAG_SMAXSAMPLEVALUE 1 double
|
||||
TIFFTAG_SMINSAMPLEVALUE 1 double
|
||||
TIFFTAG_SOFTWARE 1 char*
|
||||
TIFFTAG_STONITS 1 double +
|
||||
TIFFTAG_SUBFILETYPE 1 uint32
|
||||
TIFFTAG_SUBIFD 2 uint16,uint32* count & offsets array
|
||||
TIFFTAG_TARGETPRINTER 1 char*
|
||||
TIFFTAG_THRESHHOLDING 1 uint16
|
||||
TIFFTAG_TILEDEPTH 1 uint32 +
|
||||
TIFFTAG_TILELENGTH 1 uint32 + must be a multiple of 8
|
||||
TIFFTAG_TILEWIDTH 1 uint32 + must be a multiple of 8
|
||||
TIFFTAG_TRANSFERFUNCTION 1 or 3 dd uint16*1<<BitsPerSample entry arrays
|
||||
TIFFTAG_XPOSITION 1 float
|
||||
TIFFTAG_XRESOLUTION 1 float
|
||||
TIFFTAG_WHITEPOINT 1 float* 2-entry array
|
||||
TIFFTAG_YCBCRCOEFFICIENTS 1 float* + 3-entry array
|
||||
TIFFTAG_YCBCRPOSITIONING 1 uint16 +
|
||||
TIFFTAG_YCBCRSAMPLING 2 uint16 +
|
||||
TIFFTAG_YPOSITION 1 float
|
||||
TIFFTAG_YRESOLUTION 1 float
|
||||
TIFFTAG_ICCPROFILE 2 uint32,void* count, profile data*
|
||||
</PRE>
|
||||
|
||||
<P>
|
||||
+ Tag may not have its values changed once data is written.
|
||||
<BR>
|
||||
|
||||
|
||||
dd
|
||||
If
|
||||
<I>SamplesPerPixel</I>
|
||||
|
||||
is one, then a single array is passed; otherwise three arrays should be
|
||||
passed.
|
||||
|
||||
* 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 <A HREF="http://www.color.org)">http://www.color.org)</A> for an explanation.
|
||||
<BR>
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
1 is returned if the tag is defined in the current
|
||||
directory; otherwise a 0 is returned.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
1 is returned if the operation was successful.
|
||||
Otherwise, 0 is returned if an error was detected.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<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>
|
||||
|
||||
<B>%d: Bad value for "%s"</B>.
|
||||
An invalid value was supplied for the named tag.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFGetField.3t.html">TIFFGetField</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFSetDirectory.3t.html">TIFFSetDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteDirectory.3t.html">TIFFWriteDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadDirectory.3t.html">TIFFReadDirectory</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+98
@@ -0,0 +1,98 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFWarning</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFWarning</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFWarning, TIFFSetWarningHandler - library warning interface
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>void TIFFWarning(const char* module, const char* fmt, ...)</B>
|
||||
|
||||
<P>
|
||||
<B>#include <<A HREF="file:/usr/include/stdargh.h">stdargh.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>typedef void (*TIFFWarningHandler)(const char* module, const char* fmt, va_list ap);</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>TIFFWarningHandler TIFFSetWarningHandler(TIFFWarningHandler handler);</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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><A HREF="printf.3s.html">printf</A></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>
|
||||
|
||||
Applications that desire to capture control in the event of a warning
|
||||
should use
|
||||
<I>TIFFSetWarningHandler</I>
|
||||
|
||||
to override the default warning handler.
|
||||
A
|
||||
<FONT SIZE="-1">NULL</FONT>
|
||||
(0) warning handler function may be installed to
|
||||
suppress error messages.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
<I>TIFFSetWarningHandler</I>
|
||||
|
||||
returns a reference to the previous error handling function.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T),
|
||||
|
||||
<I><A HREF="printf.3s.html">printf</A></I>(3S)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+148
@@ -0,0 +1,148 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFWriteDirectory</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFWriteDirectory</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: December 16, 1991<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFWriteDirectory - write the current directory in an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFWriteDirectory(TIFF* tif)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<B>Error writing directory count</B>.
|
||||
|
||||
A write error occurred when writing the count of fields in the directory.
|
||||
<P>
|
||||
|
||||
<B>Error writing directory contents</B>.
|
||||
|
||||
A write error occurred when writing the directory fields.
|
||||
<P>
|
||||
|
||||
<B>Error writing directory link</B>.
|
||||
|
||||
A write error occurred when writing the link to the next directory.
|
||||
<P>
|
||||
|
||||
<B>Error writing data for field "%s"</B>.
|
||||
A write error occurred when writing indirect data for the specified field.
|
||||
<P>
|
||||
|
||||
<B>Error writing TIFF header</B>.
|
||||
|
||||
A write error occurred when re-writing header at the front of the file.
|
||||
<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>
|
||||
|
||||
<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.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadDirectory.3t.html">TIFFReadDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFSetDirectory.3t.html">TIFFSetDirectory</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+147
@@ -0,0 +1,147 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFWriteEncodedStrip</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFWriteEncodedStrip</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFWritedEncodedStrip - compress and write a strip of data to an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>tsize_t TIFFWriteEncodedStrip(TIFF* tif, tstrip_t strip, tdata_t buf, tsize_t size)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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 places (<I>PlanarConfiguration</I>=2).
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
The library writes encoded data using the native machine byte order.
|
||||
Correctly implemented
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
readers are expected to do any necessary byte-swapping to
|
||||
correctly process image data with BitsPerSample greater than 8.
|
||||
<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>TIFFWriteEncodedStrip</I>.
|
||||
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
-1 is returned if an error was encountered.
|
||||
Otherwise, the value of
|
||||
<I>size</I>
|
||||
|
||||
is returned.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<P>
|
||||
|
||||
<B>%s: File not open for writing</B>.
|
||||
The file was opened for reading, not writing.
|
||||
<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
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T).
|
||||
|
||||
<P>
|
||||
|
||||
<B>%s: Must set "ImageWidth" before writing data</B>.
|
||||
The image's width has not be set before the first write.
|
||||
See
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
for information on how to do this.
|
||||
<P>
|
||||
|
||||
<B>%s: Must set "PlanarConfiguration" before writing data</B>.
|
||||
The organization of data has not be defined before the first write.
|
||||
See
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
for information on how to do this.
|
||||
<P>
|
||||
|
||||
<B>%s: No space for strip arrays"</B>.
|
||||
There was not enough space for the arrays that hold strip
|
||||
offsets and byte counts.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteScanline.3t.html">TIFFWriteScanline</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteRawStrip.3t.html">TIFFWriteRawStrip</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+137
@@ -0,0 +1,137 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFWriteEncodedTile</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFWriteEncodedTile</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: December 16, 1991<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFWritedEncodedTile - compress and write a tile of data to an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>tsize_t TIFFWriteEncodedTile(TIFF* tif, ttile_t tile, tdata_t buf, tsize_t size)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
The library writes encoded data using the native machine byte order.
|
||||
Correctly implemented
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
readers are expected to do any necessary byte-swapping to
|
||||
correctly process image data with BitsPerSample greater than 8.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
-1 is returned if an error was encountered.
|
||||
Otherwise, the value of
|
||||
<I>size</I>
|
||||
|
||||
is returned.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<P>
|
||||
|
||||
<B>%s: File not open for writing</B>.
|
||||
The file was opened for reading, not writing.
|
||||
<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
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T).
|
||||
|
||||
<P>
|
||||
|
||||
<B>%s: Must set "ImageWidth" before writing data</B>.
|
||||
The image's width has not be set before the first write.
|
||||
See
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
for information on how to do this.
|
||||
<P>
|
||||
|
||||
<B>%s: Must set "PlanarConfiguration" before writing data</B>.
|
||||
The organization of data has not be defined before the first write.
|
||||
See
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
for information on how to do this.
|
||||
<P>
|
||||
|
||||
<B>%s: No space for tile arrays"</B>.
|
||||
There was not enough space for the arrays that hold tile
|
||||
offsets and byte counts.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteTile.3t.html">TIFFWriteTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteRawTile.3t.html">TIFFWriteRawTile</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+134
@@ -0,0 +1,134 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFWriteRawstrip</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFWriteRawstrip</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFWriteRawStrip - write a strip of raw data to an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>tsize_t TIFFWriteRawStrip(TIFF* tif, tstrip_t strip, tdata_t buf, tsize_t size)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
Append
|
||||
<I>size</I>
|
||||
|
||||
bytes of raw data to the specified strip.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
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>.
|
||||
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
-1 is returned if an error occurred.
|
||||
Otherwise, the value of
|
||||
<I>size</I>
|
||||
|
||||
is returned.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<P>
|
||||
|
||||
<B>%s: File not open for writing</B>.
|
||||
The file was opened for reading, not writing.
|
||||
<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
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T).
|
||||
|
||||
<P>
|
||||
|
||||
<B>%s: Must set "ImageWidth" before writing data</B>.
|
||||
The image's width has not be set before the first write.
|
||||
See
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
for information on how to do this.
|
||||
<P>
|
||||
|
||||
<B>%s: Must set "PlanarConfiguration" before writing data</B>.
|
||||
The organization of data has not be defined before the first write.
|
||||
See
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
for information on how to do this.
|
||||
<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>
|
||||
|
||||
<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.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteEncodedStrip.3t.html">TIFFWriteEncodedStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteScanline.3t.html">TIFFWriteScanline</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+116
@@ -0,0 +1,116 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFWriteRawtile</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFWriteRawtile</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: December 16, 1991<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFWriteRawTile - write a tile of raw data to an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>tsize_t TIFFWriteRawTile(TIFF* tif, ttile_t tile, tdata_t buf, tsize_t size)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
Append
|
||||
<I>size</I>
|
||||
|
||||
bytes of raw data to the specified tile.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
-1 is returned if an error occurred.
|
||||
Otherwise, the value of
|
||||
<I>size</I>
|
||||
|
||||
is returned.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<P>
|
||||
|
||||
<B>%s: File not open for writing</B>.
|
||||
The file was opened for reading, not writing.
|
||||
<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
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T).
|
||||
|
||||
<P>
|
||||
|
||||
<B>%s: Must set "ImageWidth" before writing data</B>.
|
||||
The image's width has not be set before the first write.
|
||||
See
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
for information on how to do this.
|
||||
<P>
|
||||
|
||||
<B>%s: Must set "PlanarConfiguration" before writing data</B>.
|
||||
The organization of data has not be defined before the first write.
|
||||
See
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
for information on how to do this.
|
||||
<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>
|
||||
|
||||
<B>%s: Specified tile %d out of range, max %d</B>.
|
||||
The specified tile is not valid according to the currently
|
||||
specified image dimensions.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteEncodedTile.3t.html">TIFFWriteEncodedTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteScanline.3t.html">TIFFWriteScanline</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+225
@@ -0,0 +1,225 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFWriteScanline</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFWriteScanline</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: December 16, 1991<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFWriteScanline - write a scanline to an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFWriteScanline(TIFF* tif, tdata_t buf, uint32 row, tsample_t sample)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
The library writes encoded data using the native machine byte order.
|
||||
Correctly implemented
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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>
|
||||
|
||||
In C++ the
|
||||
<I>sample</I>
|
||||
|
||||
parameter defaults to 0.
|
||||
<P>
|
||||
|
||||
Once data are written to a file for the current directory,
|
||||
the values of certain tags may not be altered; see
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
for more information.
|
||||
<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.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
<I>TIFFWriteScanline</I>
|
||||
|
||||
returns -1 if it immediately detects an error
|
||||
and 1 for a successful write.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<P>
|
||||
|
||||
<B>%s: File not open for writing .</B>
|
||||
|
||||
The file was opened for reading, not writing.
|
||||
<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><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T).
|
||||
|
||||
<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>
|
||||
|
||||
<B>%s: Must set "ImageWidth" before writing data</B>.
|
||||
The image's width has not be set before the first write.
|
||||
See
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
for information on how to do this.
|
||||
<P>
|
||||
|
||||
<B>%s: Must set "PlanarConfiguration" before writing data</B>.
|
||||
The organization of data has not be defined before the first write.
|
||||
See
|
||||
<I><A HREF="TIFFSetField.3t.html">TIFFSetField</A></I>(3T)
|
||||
|
||||
for information on how to do this.
|
||||
<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>
|
||||
|
||||
<B>%d: Sample out of range, max %d</B>.
|
||||
|
||||
The
|
||||
<I>sample</I>
|
||||
|
||||
parameter was greater than the value of the SamplesPerPixel tag.
|
||||
<P>
|
||||
|
||||
<B>%s: No space for strip arrays .</B>
|
||||
|
||||
There was not enough space for the arrays that hold strip
|
||||
offsets and byte counts.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAI"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteEncodedStrip.3t.html">TIFFWriteEncodedStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteRawStrip.3t.html">TIFFWriteRawStrip</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAI">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:39 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+109
@@ -0,0 +1,109 @@
|
||||
Content-type: text/html
|
||||
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFWriteTile</TITLE>
|
||||
</HEAD><BODY>
|
||||
<H1>TIFFWriteTile</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: November 29, 1999<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFWriteTile - encode and write a tile of data to an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>tsize_t TIFFWriteTile(TIFF* tif, tdata_t buf, uint32 x, uint32 y, uint32 z, tsample_t sample)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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).
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
<I>TIFFWriteTile</I>
|
||||
|
||||
returns -1 if it detects an error; otherwise the number of
|
||||
bytes in the tile is returned.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFCheckTile.3t.html">TIFFCheckTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFComputeTile.3t.html">TIFFComputeTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadTile.3t.html">TIFFReadTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteScanline.3t.html">TIFFWriteScanline</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteEncodedTile.3t.html">TIFFWriteEncodedTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteRawTile.3t.html">TIFFWriteRawTile</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
Time: 18:38:00 GMT, November 30, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+101
@@ -0,0 +1,101 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFBUFFER</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFBUFFER</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReadBufferSetup,
|
||||
TIFFWriteBufferSetup
|
||||
- I/O buffering control routines
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<PRE>
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
<B>int TIFFReadBufferSetup(TIFF*, tdata_t buffer, tsize_t size);</B>
|
||||
<B>int TIFFWriteBufferSetup(TIFF*, tdata_t buffer, tsize_t size);</B>
|
||||
</PRE>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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>
|
||||
|
||||
<I>TIFFReadBufferSetup</I>
|
||||
|
||||
sets up the data buffer used to read raw (encoded) data from a file.
|
||||
If the specified pointer is
|
||||
<FONT SIZE="-1">NULL</FONT>
|
||||
(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>
|
||||
|
||||
<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
|
||||
<FONT SIZE="-1">NULL</FONT>
|
||||
(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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
<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>
|
||||
|
||||
<B>%s: No space for output buffer</B>.
|
||||
|
||||
<I>TIFFWriteBufferSetup</I>
|
||||
|
||||
was unable to dynamically allocate space for a data buffer.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:39 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+102
@@ -0,0 +1,102 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of CODEC</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>CODEC</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFFindCODEC, TIFFRegisterCODEC, TIFFUnRegisterCODEC - codec-related utility routines
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>const TIFFCodec* TIFFFindCODEC(uint16 scheme);</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>TIFFCodec* TIFFRegisterCODEC(uint16 scheme, const char* method, TIFFInitMethod init);</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>void TIFFUnRegisterCODEC(TIFFCodec* codec);</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
<I>Compression</I>
|
||||
|
||||
tag; e.g. 5 for
|
||||
<FONT SIZE="-1">LZW</FONT>
|
||||
compression.
|
||||
<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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
<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>
|
||||
|
||||
<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.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:39 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+104
@@ -0,0 +1,104 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of MEMORY</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>MEMORY</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
_TIFFmalloc, _TIFFrealloc, _TIFFfree, _TIFFmemset, _TIFFmemcpy, _TIFFmemcmp, - memory management-related functions for use with
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
files
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<PRE>
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
<B>tdata_t _TIFFmalloc(tsize_t);</B>
|
||||
<B>tdata_t _TIFFrealloc(tdata_t, tsize_t);</B>
|
||||
<B>void _TIFFfree(tdata_t);</B>
|
||||
<B>void _TIFFmemset(tdata_t, int, tsize_t);</B>
|
||||
<B>void _TIFFmemcpy(tdata_t, const tdata_t, tsize_t);</B>
|
||||
<B>int _TIFFmemcmp(const tdata_t, const tdata_t, tsize_t);</B>
|
||||
</PRE>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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>
|
||||
|
||||
<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>
|
||||
|
||||
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
|
||||
<FONT SIZE="-1">ANSI</FONT>
|
||||
C routines:
|
||||
<I>memset</I>,
|
||||
|
||||
<I>memcpy</I>,
|
||||
|
||||
and
|
||||
<I>memcmp</I>,
|
||||
|
||||
repsectively.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
None.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="malloc+3c">malloc</A></I>(3C),
|
||||
|
||||
<I><A HREF="memory+3c">memory</A></I>(3C)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:39 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+178
@@ -0,0 +1,178 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of QUERY</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>QUERY</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFCurrentRow,
|
||||
TIFFCurrentStrip,
|
||||
TIFFCurrentTile,
|
||||
TIFFCurrentDirectory,
|
||||
TIFFLastDirectory,
|
||||
TIFFFileno,
|
||||
TIFFFileName,
|
||||
TIFFGetMode,
|
||||
TIFFIsTiled,
|
||||
TIFFIsByteSwapped,
|
||||
TIFFIsUpSampled,
|
||||
TIFFIsMSB2LSB
|
||||
- query routines
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<PRE>
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
<B>uint32 TIFFCurrentRow(TIFF* tif)</B>
|
||||
<B>tstrip_t TIFFCurrentStrip(TIFF* tif)</B>
|
||||
<B>ttile_t TIFFCurrentTile(TIFF* tif)</B>
|
||||
<B>tdir_t TIFFCurrentDirectory(TIFF* tif)</B>
|
||||
<B>int TIFFLastDirectory(TIFF* tif)</B>
|
||||
<B>int TIFFFileno(TIFF* tif)</B>
|
||||
<B>char* TIFFFileName(TIFF* tif)</B>
|
||||
<B>int TIFFGetMode(TIFF* tif)</B>
|
||||
<B>int TIFFIsTiled(TIFF* tif)</B>
|
||||
<B>int TIFFIsByteSwapped(TIFF* tif)</B>
|
||||
<B>int TIFFIsUpSampled(TIFF* tif)</B>
|
||||
<B>int TIFFIsMSB2LSB(TIFF* tif)</B>
|
||||
<B>const char* TIFFGetVersion(void)</B>
|
||||
</PRE>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
The following routines return status information about an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file.
|
||||
<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>
|
||||
|
||||
<I>TIFFLastDirectory</I>
|
||||
|
||||
returns a non-zero value if the current directory is the
|
||||
last directory in the file;
|
||||
otherwise zero is returned.
|
||||
<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>
|
||||
|
||||
<I>TIFFFileno</I>
|
||||
|
||||
returns the underlying file descriptor used to access the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
image in the filesystem.
|
||||
<P>
|
||||
|
||||
<I>TIFFFileName</I>
|
||||
|
||||
returns the pathname argument passed to
|
||||
<I>TIFFOpen</I>
|
||||
|
||||
or
|
||||
<I>TIFFFdOpen</I>.
|
||||
|
||||
<P>
|
||||
|
||||
<I>TIFFGetMode</I>
|
||||
|
||||
returns the mode with which the underlying file was opened.
|
||||
On
|
||||
<FONT SIZE="-1">UNIX</FONT>
|
||||
systems, this is the value passed to the
|
||||
<I><A HREF="open+2">open</A></I>(2)
|
||||
|
||||
system call.
|
||||
<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>
|
||||
|
||||
<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 image data and local host byte-orders
|
||||
are the same.
|
||||
Data samples that are more than 8 bits wide must be byte-swapped
|
||||
by the application.
|
||||
<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>
|
||||
|
||||
<I>TIFFIsMSB2LSB</I>
|
||||
|
||||
returns a non-zero value if the image data is being returned with
|
||||
bit 0 as the most significant bit.
|
||||
<P>
|
||||
|
||||
<I>TIFFGetVersion</I>
|
||||
|
||||
returns an
|
||||
<FONT SIZE="-1">ASCII</FONT>
|
||||
string that has a version stamp for the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
library software.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
None.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFFdOpen.3t.html">TIFFFdOpen</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:39 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+75
@@ -0,0 +1,75 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFSIZE</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFSIZE</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFScanlineSize,
|
||||
TIFFRasterScanlineSize,
|
||||
- return the size of various items associated with an open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<PRE>
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
<B>tsize_t TIFFRasterScanlineSize(TIFF* tif)</B>
|
||||
<B>tsize_t TIFFScanlineSize(TIFF* tif)</B>
|
||||
</PRE><A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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>
|
||||
|
||||
<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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
None.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadScanline.3t.html">TIFFReadScanline</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:39 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+131
@@ -0,0 +1,131 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFSTRIP</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFSTRIP</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFDefaultStripSize,
|
||||
TIFFStripSize,
|
||||
TIFFVStripSize,
|
||||
TIFFComputeStrip,
|
||||
TIFFNumberOfStrips
|
||||
- strip-related utility routines
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<PRE>
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
<B>uint32 TIFFDefaultStripSize(TIFF* tif, uint32 estimate)</B>
|
||||
<B>tsize_t TIFFStripSize(TIFF* tif)</B>
|
||||
<B>tsize_t TIFFVStripSize(TIFF* tif, uint32 nrows)</B>
|
||||
<B>tstrip_t TIFFComputeStrip(TIFF* tif, uint32 row, tsample_t sample)</B>
|
||||
<B>tstrip_t TIFFNumberOfStrips(TIFF* tif)</B>
|
||||
</PRE>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<I>TIFFVStripSize</I>
|
||||
|
||||
returns the number of bytes in a strip with
|
||||
<I>nrows</I>
|
||||
|
||||
rows of data.
|
||||
<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>
|
||||
|
||||
<I>TIFFNumberOfStrips</I>
|
||||
|
||||
returns the number of strips in the image.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
None.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadEncodedStrip.3t.html">TIFFReadEncodedStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRawStrip.3t.html">TIFFReadRawStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteEncodedStrip.3t.html">TIFFWriteEncodedStrip</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteRawStrip.3t.html">TIFFWriteRawStrip</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:39 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+108
@@ -0,0 +1,108 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of SWAB</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>SWAB</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: December 16, 1991<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFReverseBits, TIFFSwabShort, TIFFSwabLong, TIFFSwabArrayOfShort, TIFFSwabArrayOfLong - byte- and bit-swapping routines
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>const unsigned char* TIFFGetBitRevTable(int reversed);</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>void TIFFReverseBits(u_char* data, unsigned long nbytes)</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>void TIFFSwabShort(uint16* data)</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>void TIFFSwabLong(uint32* data)</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>void TIFFSwabArrayOfShort(uint16* data, unsigned long nshorts)</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>void TIFFSwabArrayOfLong(uint32* data, unsigned long nlongs)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
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>
|
||||
|
||||
<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>
|
||||
|
||||
<I>TIFFReverseBits</I>
|
||||
|
||||
replaces each byte in
|
||||
<I>data</I>
|
||||
|
||||
with the equivalent bit-reversed value.
|
||||
This operation is done with a lookup table,
|
||||
<I>TIFFBitRevTable</I>
|
||||
|
||||
which is declared public.
|
||||
A second table,
|
||||
<I>TIFFNoBitRevTable</I>
|
||||
|
||||
is also declared public; it is a lookup table that
|
||||
can be used as an
|
||||
<I>identity function</I>;
|
||||
|
||||
i.e.
|
||||
<I>TIFFNoBitRevTable[n] == n</I>.
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
None.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:39 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+183
@@ -0,0 +1,183 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFTILE</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFTILE</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: February 14, 1992<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFTileSize,
|
||||
TIFFTileRowSize,
|
||||
TIFFVTileSize,
|
||||
TIFFDefaultTileSize,
|
||||
TIFFComputeTile,
|
||||
TIFFCheckTile,
|
||||
TIFFNumberOfTiles
|
||||
- tile-related utility routines
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<PRE>
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
<B>void TIFFDefaultTileSize(TIFF* tif, uint32* tw, uint32* th)</B>
|
||||
<B>tsize_t TIFFTileSize(TIFF* tif)</B>
|
||||
<B>tsize_t TIFFTileRowSize(TIFF* tif)</B>
|
||||
<B>tsize_t TIFFVTileSize(TIFF* tif, uint32 nrows)</B>
|
||||
<B>ttile_t TIFFComputeTile(TIFF* tif, uint32 x, uint32 y, uint32 z, tsample_t sample)</B>
|
||||
<B>int TIFFCheckTile(TIFF* tif, uint32 x, uint32 y, uint32 z, tsample_t sample)</B>
|
||||
<B>ttile_t TIFFNumberOfTiles(TIFF* tif)</B>
|
||||
</PRE>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
specification.
|
||||
<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>
|
||||
|
||||
<I>TIFFVTileSize</I>
|
||||
|
||||
returns the number of bytes in a row-aligned tile with
|
||||
<I>nrows</I>
|
||||
|
||||
of data.
|
||||
<P>
|
||||
|
||||
<I>TIFFTileRowSize</I>
|
||||
|
||||
returns the number of bytes of a row of data in a tile.
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<I>TIFFNumberOfTiles</I>
|
||||
|
||||
returns the number of tiles in the image.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
None.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadEncodedTile.3t.html">TIFFReadEncodedTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadRawTile.3t.html">TIFFReadRawTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadTile.3t.html">TIFFReadTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteEncodedTile.3t.html">TIFFWriteEncodedTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteRawTile.3t.html">TIFFWriteRawTile</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteTile.3t.html">TIFFWriteTile</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:39 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+210
@@ -0,0 +1,210 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of FAX2PS</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>FAX2PS</H1>
|
||||
Section: User Commands (1)<BR>Updated: March 16, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
fax2ps - convert a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
facsimile to compressed P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>tm
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>fax2ps</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
] [
|
||||
<I>file</I>...
|
||||
|
||||
]
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>fax2ps</I>
|
||||
|
||||
reads one or more
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
facsimile image files and prints a compressed form of
|
||||
P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> on the standard output that is suitable for printing.
|
||||
<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>
|
||||
|
||||
By default
|
||||
<I>fax2ps</I>
|
||||
|
||||
generates P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> 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>
|
||||
|
||||
<I>fax2ps</I>
|
||||
|
||||
generates a compressed form of P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> that is
|
||||
optimized for sending pages of text to a P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>
|
||||
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 P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> 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 P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> description, relative to the straightforward
|
||||
imaging of the page with a P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>
|
||||
<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
|
||||
<I><A HREF="tiff2ps+1.html">tiff2ps</A></I>(1).
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-p</B><I> number</I>
|
||||
|
||||
<DD>
|
||||
Print only the indicated page.
|
||||
Multiple pages may be printed by specifying
|
||||
this option more than once.
|
||||
<DT><B>-x</B><I> resolution</I>
|
||||
|
||||
<DD>
|
||||
Use
|
||||
<I>resolution</I>
|
||||
|
||||
as the horizontal resolution, in dots/inch, of the image data.
|
||||
By default this value is taken from the file.
|
||||
<DT><B>-y</B><I> resolution</I>
|
||||
|
||||
<DD>
|
||||
Use
|
||||
<I>resolution</I>
|
||||
|
||||
as the vertical resolution, in lines/inch, of the image data.
|
||||
By default this value is taken from the file.
|
||||
<DT><B>-S</B>
|
||||
|
||||
<DD>
|
||||
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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file.
|
||||
<DT><B>-W</B><I> width</I>
|
||||
|
||||
<DD>
|
||||
Use
|
||||
<I>width</I>
|
||||
|
||||
as the width, in inches, of the output page.
|
||||
The default page width is 8.5 inches.
|
||||
<DT><B>-H</B><I> height</I>
|
||||
|
||||
<DD>
|
||||
Use
|
||||
<I>height</I>
|
||||
|
||||
as the height, in inches, of the output page.
|
||||
The default page height is 11 inches.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
Some messages about malformed
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
images come from the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
library.
|
||||
<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
|
||||
P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> image.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
If the destination printer supports P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level II then
|
||||
it is always faster to just send the encoded bitmap generated
|
||||
by the
|
||||
<I><A HREF="tiff2ps+1.html">tiff2ps</A></I>(1)
|
||||
|
||||
program.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
<I>fax2ps</I>
|
||||
|
||||
should probably figure out when it is doing a poor
|
||||
job of compressing the output and just generate
|
||||
P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> to image the bitmap raster instead.
|
||||
<A NAME="lbAI"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="tiff2ps+1.html">tiff2ps</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAG">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAH">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAI">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+257
@@ -0,0 +1,257 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of FAX2TIFF</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>FAX2TIFF</H1>
|
||||
Section: User Commands (1)<BR>Updated: September 24, 1994<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
fax2tiff - create a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
Class F fax file from raw fax data
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>fax2tiff</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
] [
|
||||
<B>-o</B>
|
||||
|
||||
<I>output.tif</I>
|
||||
|
||||
]
|
||||
<I>input.g3</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>Fax2tiff</I>
|
||||
|
||||
creates a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file containing
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
Group 3 or Group 4 encoded data from one or more files containing ``raw''
|
||||
Group 3 encoded data (typically obtained directly from a fax modem).
|
||||
By default, each row of data in the resultant
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file is 2-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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
Class F (<FONT SIZE="-1">FAX</FONT>) 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>
|
||||
|
||||
(<FONT SIZE="-1">RTC</FONT>) code; as required
|
||||
for transmission by the
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
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>
|
||||
|
||||
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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
Options that affect the interpretation of input data are:
|
||||
<DL COMPACT>
|
||||
<DT><B>-2</B>
|
||||
|
||||
<DD>
|
||||
Assume input data is 2-d Huffman encoded.
|
||||
<DT><B>-B</B>
|
||||
|
||||
<DD>
|
||||
Assume input data was encoded with
|
||||
black as 0 and white as 1.
|
||||
<DT><B>-L</B>
|
||||
|
||||
<DD>
|
||||
Treat input data as having bits filled from least
|
||||
significant bit (<FONT SIZE="-1">LSB</FONT>) to most significant bit (<FONT SIZE="-1">MSB</FONT>).
|
||||
(This is the default.)
|
||||
<DT><B>-M</B>
|
||||
|
||||
<DD>
|
||||
Treat input data as having bits filled from most
|
||||
significant bit (<FONT SIZE="-1">MSB</FONT>) to most least bit (<FONT SIZE="-1">LSB</FONT>).
|
||||
<DT><B>-R</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-W</B>
|
||||
|
||||
<DD>
|
||||
Assume input data was encoded with
|
||||
black as 1 and white as 0.
|
||||
(This is the default.)
|
||||
</DL>
|
||||
<P>
|
||||
|
||||
Options that affect the output file format are:
|
||||
<DL COMPACT>
|
||||
<DT><B>-1</B>
|
||||
|
||||
<DD>
|
||||
Force output to be compressed with the 1-dimensional
|
||||
version of the
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
Group 3 Huffman encoding algorithm.
|
||||
<DT><B>-4</B>
|
||||
|
||||
<DD>
|
||||
Force output to be compressed with the
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
Group 4 Huffman encoding.
|
||||
<DT><B>-o</B>
|
||||
|
||||
<DD>
|
||||
Specify the name of the output file.
|
||||
<DT><B>-p</B>
|
||||
|
||||
<DD>
|
||||
Force the last bit of each
|
||||
<I>End Of Line</I>
|
||||
|
||||
(<FONT SIZE="-1">EOL</FONT>) code to land on a byte boundary.
|
||||
This ``zero padding'' will be reflected in the contents of the
|
||||
<I>Group3Options</I>
|
||||
|
||||
tag of the resultant
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file.
|
||||
<DT><B>-s</B>
|
||||
|
||||
<DD>
|
||||
Stretch the input image vertically by writing each input row of
|
||||
data twice to the output file.
|
||||
<DT><B>-v</B>
|
||||
|
||||
<DD>
|
||||
Force
|
||||
<I>fax2tiff</I>
|
||||
|
||||
to print the number of rows of data it retrieved from the input file.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
The following warnings and errors come from the decoding
|
||||
routines in the library.
|
||||
<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 value of 1728.
|
||||
The row is padded with white.
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<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.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Should not have the constant width 1728 built into it.
|
||||
Input data are assumed to have a a ``top left'' orientation;
|
||||
it should be possible to override this assumption
|
||||
from the command line.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I></I><FONT SIZE="-1"><I>CCITT</I></FONT><I> Recommendation T.4</I>
|
||||
|
||||
(Standardization of Group 3 Facsimile Apparatus for Document Transmission).
|
||||
<P>
|
||||
|
||||
<I>The Spirit of TIFF Class F</I>,
|
||||
|
||||
an appendix to the TIFF 5.0 specification prepared by Cygnet Technologies.
|
||||
<P>
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffdither+1.html">tiffdither</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffgt+1.html">tiffgt</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3).
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAG">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+112
@@ -0,0 +1,112 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of GIF2TIFF</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>GIF2TIFF</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
gif2tiff - create a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file from a GIF87 format image file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>gif2tiff</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>input.gif</I>
|
||||
|
||||
<I>output.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>Gif2tiff</I>
|
||||
|
||||
converts a file in the GIF87 format to
|
||||
<FONT SIZE="-1">TIFF.</FONT>
|
||||
The
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
image is created as a palette image, with samples
|
||||
compressed with the Lempel-Ziv & Welch algorithm (<I>Compression</I>=5).
|
||||
|
||||
These characteristics can overriden, or explicitly specified
|
||||
with the options described below.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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).
|
||||
<DT><B>-r</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Should have more options to control output format.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="pal2rgb+1.html">pal2rgb</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAG">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+69
@@ -0,0 +1,69 @@
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<TITLE>Libtiff HTML manpage index</TITLE>
|
||||
</HEAD>
|
||||
<BODY BGCOLOR=white>
|
||||
<FONT FACE="Helvetica,Sans,Arial">
|
||||
<ul>
|
||||
<H2>Man Pages</h2>
|
||||
These pages were generated using Richard Verhoeven's man2html, modified and packaged by Michael Hamilton
|
||||
<p>
|
||||
<li><A HREF=TIFFClose.3t.html>TIFFClose.3t</a>
|
||||
<li><A HREF=TIFFError.3t.html>TIFFError.3t</a>
|
||||
<li><A HREF=TIFFFlush.3t.html>TIFFFlush.3t</a>
|
||||
<li><A HREF=TIFFGetField.3t.html>TIFFGetField.3t</a>
|
||||
<li><A HREF=TIFFOpen.3t.html>TIFFOpen.3t</a>
|
||||
<li><A HREF=TIFFPrintDirectory.3t.html>TIFFPrintDirectory.3t</a>
|
||||
<li><A HREF=TIFFRGBAImage.3t.html>TIFFRGBAImage.3t</a>
|
||||
<li><A HREF=TIFFReadDirectory.3t.html>TIFFReadDirectory.3t</a>
|
||||
<li><A HREF=TIFFReadEncodedStrip.3t.html>TIFFReadEncodedStrip.3t</a>
|
||||
<li><A HREF=TIFFReadEncodedTile.3t.html>TIFFReadEncodedTile.3t</a>
|
||||
<li><A HREF=TIFFReadRGBAImage.3t.html>TIFFReadRGBAImage.3t</a>
|
||||
<li><A HREF=TIFFReadRGBAStrip.3t.html>TIFFReadRGBAStrip.3t</a>
|
||||
<li><A HREF=TIFFReadRGBATile.3t.html>TIFFReadRGBATile.3t</a>
|
||||
<li><A HREF=TIFFReadRawStrip.3t.html>TIFFReadRawStrip.3t</a>
|
||||
<li><A HREF=TIFFReadRawTile.3t.html>TIFFReadRawTile.3t</a>
|
||||
<li><A HREF=TIFFReadScanline.3t.html>TIFFReadScanline.3t</a>
|
||||
<li><A HREF=TIFFReadTile.3t.html>TIFFReadTile.3t</a>
|
||||
<li><A HREF=TIFFSetDirectory.3t.html>TIFFSetDirectory.3t</a>
|
||||
<li><A HREF=TIFFSetField.3t.html>TIFFSetField.3t</a>
|
||||
<li><A HREF=TIFFWarning.3t.html>TIFFWarning.3t</a>
|
||||
<li><A HREF=TIFFWriteDirectory.3t.html>TIFFWriteDirectory.3t</a>
|
||||
<li><A HREF=TIFFWriteEncodedStrip.3t.html>TIFFWriteEncodedStrip.3t</a>
|
||||
<li><A HREF=TIFFWriteEncodedTile.3t.html>TIFFWriteEncodedTile.3t</a>
|
||||
<li><A HREF=TIFFWriteRawStrip.3t.html>TIFFWriteRawStrip.3t</a>
|
||||
<li><A HREF=TIFFWriteRawTile.3t.html>TIFFWriteRawTile.3t</a>
|
||||
<li><A HREF=TIFFWriteScanline.3t.html>TIFFWriteScanline.3t</a>
|
||||
<li><A HREF=TIFFWriteTile.3t.html>TIFFWriteTile.3t</a>
|
||||
<li><A HREF=TIFFbuffer.3t.html>TIFFbuffer.3t</a>
|
||||
<li><A HREF=TIFFcodec.3t.html>TIFFcodec.3t</a>
|
||||
<li><A HREF=TIFFmemory.3t.html>TIFFmemory.3t</a>
|
||||
<li><A HREF=TIFFquery.3t.html>TIFFquery.3t</a>
|
||||
<li><A HREF=TIFFsize.3t.html>TIFFsize.3t</a>
|
||||
<li><A HREF=TIFFstrip.3t.html>TIFFstrip.3t</a>
|
||||
<li><A HREF=TIFFswab.3t.html>TIFFswab.3t</a>
|
||||
<li><A HREF=TIFFtile.3t.html>TIFFtile.3t</a>
|
||||
<li><A HREF=fax2ps.1.html>fax2ps.1</a>
|
||||
<li><A HREF=fax2tiff.1.html>fax2tiff.1</a>
|
||||
<li><A HREF=gif2tiff.1.html>gif2tiff.1</a>
|
||||
<li><A HREF=libtiff.3t.html>libtiff.3t</a>
|
||||
<li><A HREF=pal2rgb.1.html>pal2rgb.1</a>
|
||||
<li><A HREF=ppm2tiff.1.html>ppm2tiff.1</a>
|
||||
<li><A HREF=ras2tiff.1.html>ras2tiff.1</a>
|
||||
<li><A HREF=rgb2ycbcr.1.html>rgb2ycbcr.1</a>
|
||||
<li><A HREF=sgi2tiff.1.html>sgi2tiff.1</a>
|
||||
<li><A HREF=thumbnail.1.html>thumbnail.1</a>
|
||||
<li><A HREF=tiff2bw.1.html>tiff2bw.1</a>
|
||||
<li><A HREF=tiff2ps.1.html>tiff2ps.1</a>
|
||||
<li><A HREF=tiffcmp.1.html>tiffcmp.1</a>
|
||||
<li><A HREF=tiffcp.1.html>tiffcp.1</a>
|
||||
<li><A HREF=tiffdither.1.html>tiffdither.1</a>
|
||||
<li><A HREF=tiffdump.1.html>tiffdump.1</a>
|
||||
<li><A HREF=tiffgt.1.html>tiffgt.1</a>
|
||||
<li><A HREF=tiffinfo.1.html>tiffinfo.1</a>
|
||||
<li><A HREF=tiffmedian.1.html>tiffmedian.1</a>
|
||||
<li><A HREF=tiffsplit.1.html>tiffsplit.1</a>
|
||||
<li><A HREF=tiffsv.1.html>tiffsv.1</a>
|
||||
</ul>
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+612
@@ -0,0 +1,612 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of INTRO</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>INTRO</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: August 21, 1997<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
libtiff - introduction to
|
||||
<I>libtiff</I>,
|
||||
|
||||
a library for reading and writing
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
files
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
cc file.c
|
||||
<B>-ltiff</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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.
|
||||
<P>
|
||||
|
||||
The library supports several compression algorithms, as indicated
|
||||
by the
|
||||
<I>Compression</I>
|
||||
|
||||
field, including:
|
||||
no compression (1),
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
1D Huffman compression (2),
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
Group 3 Facsimile compression (3),
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
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 (<FONT SIZE="-1">MSB</FONT>) to Least Significant Bit (<FONT SIZE="-1">LSB</FONT>) or
|
||||
<FONT SIZE="-1">LSB</FONT>
|
||||
to
|
||||
<FONT SIZE="-1">MSB.</FONT>
|
||||
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).
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>DATA TYPES</H2>
|
||||
|
||||
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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
format.
|
||||
The following typedefs are exposed to users either through
|
||||
function definitions or through parameters passed through the
|
||||
varargs interfaces.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
<PRE>
|
||||
typedef unsigned short uint16; 16-bit unsigned integer
|
||||
typedef unsigned <<I>thing</I>> uint32; 32-bit unsigned integer
|
||||
|
||||
typedef unsigned int ttag_t; directory tag
|
||||
typedef uint16 tdir_t; directory index
|
||||
typedef uint16 tsample_t; sample number
|
||||
typedef uint32 tstrip_t; strip number
|
||||
typedef uint32 ttile_t; tile number
|
||||
typedef int32 tsize_t; i/o size in bytes
|
||||
typedef void* tdata_t; image data ref
|
||||
typedef void* thandle_t; client data handle
|
||||
typedef int32 toff_t; file offset
|
||||
</PRE>
|
||||
|
||||
<P>
|
||||
|
||||
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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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
|
||||
<FONT SIZE="-1">IFDs</FONT>
|
||||
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
|
||||
<FONT SIZE="-1">ANSI C</FONT>
|
||||
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.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>LIST OF ROUTINES</H2>
|
||||
|
||||
The following routines are part of the library.
|
||||
Consult specific manual pages for details on their operation.
|
||||
The manual page names listed below are for systems
|
||||
where the full function names can not be encoded in the filesystem;
|
||||
on most systems doing ``man function-name'' will work.
|
||||
<P>
|
||||
<PRE>
|
||||
|
||||
<I>Name</I> <I>Appears on Page</I> <I>Description</I>
|
||||
|
||||
TIFFCheckTile tile.3t very x,y,z,sample is within image
|
||||
TIFFClientOpen open.3t open a file for reading or writing
|
||||
TIFFClose close.3t close an open file
|
||||
TIFFComputeStrip strip.3t return strip containing y,sample
|
||||
TIFFComputeTile tile.3t return tile containing x,y,z,sample
|
||||
TIFFCurrentDirectory query.3t return index of current directory
|
||||
TIFFCurrentRow query.3t return index of current scanline
|
||||
TIFFCurrentStrip query.3t return index of current strip
|
||||
TIFFCurrentTile query.3t return index of current tile
|
||||
TIFFError error.3t library error handler
|
||||
TIFFFdOpen open.3t open a file for reading or writing
|
||||
TIFFFileName query.3t return name of open file
|
||||
TIFFFileno query.3t return open file descriptor
|
||||
TIFFFlush flush.3t flush all pending writes
|
||||
TIFFFlushData flush.3t flush pending data writes
|
||||
TIFFGetBitRevTable swab.3t return bit reversal table
|
||||
TIFFGetField getfield.3t return tag value in current directory
|
||||
TIFFGetFieldDefaulted getfield.3t return tag value in current directory
|
||||
TIFFGetMode query.3t return open file mode
|
||||
TIFFGetVersion query.3t return library version string
|
||||
TIFFIsTiled query.3t return true if image data is tiled
|
||||
TIFFIsByteSwapped query.3t return true if image data is byte-swapped
|
||||
TIFFNumberOfStrips strip.3t return number of strips in an image
|
||||
TIFFNumberOfTiles tile.3t return number of tiles in an image
|
||||
TIFFOpen open.3t open a file for reading or writing
|
||||
TIFFPrintDirectory print.3t print description of the current directory
|
||||
TIFFReadBufferSetup rdbuf.3t specify i/o buffer for reading
|
||||
TIFFReadDirectory readdir.3t read the next directory
|
||||
TIFFReadEncodedStrip rdestrip.3t read and decode a strip of data
|
||||
TIFFReadEncodedTile rdetile.3t read and decode a tile of data
|
||||
TIFFReadRawStrip rdrstrip.3t read a raw strip of data
|
||||
TIFFReadRawTile rdrtile.3t read a raw tile of data
|
||||
TIFFReadRGBAImage rdimage.3t read an image into a fixed format raster
|
||||
TIFFReadScanline readline.3t read and decode a row of data
|
||||
TIFFReadTile readtile.3t read and decode a tile of data
|
||||
TIFFReverseBits swab.3t reverse bits in an array of bytes
|
||||
TIFFRGBAImageBegin rgbaimage.3t setup decoder state for TIFFRGBAImageGet
|
||||
TIFFRGBAImageEnd rgbaimage.3t release TIFFRGBAImage decoder state
|
||||
TIFFRGBAImageGet rgbaimage.3t read and decode an image
|
||||
TIFFRGBAImageOK rgbaimage.3t is image readable by TIFFRGBAImageGet
|
||||
TIFFScanlineSize size.3t return size of a scanline
|
||||
TIFFSetDirectory setdir.3t set the current directory
|
||||
TIFFSetSubDirectory setdir.3t set the current directory
|
||||
TIFFSetErrorHandler error.3t set error handler function
|
||||
TIFFSetField setfield.3t set a tag's value in the current directory
|
||||
TIFFSetWarningHandler error.3t set warning handler function
|
||||
TIFFStripSize size.3t return size of a strip
|
||||
TIFFSwabShort swab.3t swap bytes of short
|
||||
TIFFSwabLong swab.3t swap bytes of long
|
||||
TIFFSwabArrayOfShort swab.3t swap bytes of an array of shorts
|
||||
TIFFSwabArrayOfLong swab.3t swap bytes of an array of longs
|
||||
TIFFTileRowSize size.3t return size of a row in a tile
|
||||
TIFFTileSize size.3t return size of a tile
|
||||
TIFFVGetField getfield.3t return tag value in current directory
|
||||
TIFFVGetFieldDefaulted getfield.3t return tag value in current directory
|
||||
TIFFVSetField setfield.3t set a tag's value in the current directory
|
||||
TIFFWarning warning.3t library warning handler
|
||||
TIFFWriteDirectory writedir.3t write the current directory
|
||||
TIFFWriteEncodedStrip wrestrip.3t compress and write a strip of data
|
||||
TIFFWriteEncodedTile wretile.3t compress and write a tile of data
|
||||
TIFFWriteRawStrip wrrstrip.3t write a raw strip of data
|
||||
TIFFWriteRawTile wrrtile.3t write a raw tile of data
|
||||
TIFFWriteScanline writeline.3t write a scanline of data
|
||||
TIFFWriteTile wrrtile.3t compress and write a tile of data
|
||||
</PRE>
|
||||
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>TAG USAGE</H2>
|
||||
|
||||
The table below lists the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
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.
|
||||
<P>
|
||||
<PRE>
|
||||
|
||||
<I>Tag Name</I> <I>Value</I> <I>R/W</I> <I>Library Use/Notes</I>
|
||||
|
||||
Artist 315 R/W
|
||||
BadFaxLines 326 R/W
|
||||
BitsPerSample 258 R/W lots
|
||||
CellLength 265 parsed but ignored
|
||||
CellWidth 264 parsed but ignored
|
||||
CleanFaxData 327 R/W
|
||||
ColorMap 320 R/W
|
||||
ColorResponseUnit 300 parsed but ignored
|
||||
Compression 259 R/W choosing codec
|
||||
ConsecutiveBadFaxLines 328 R/W
|
||||
DataType 32996 R obsoleted by SampleFormat tag
|
||||
DateTime 306 R/W
|
||||
DocumentName 269 R/W
|
||||
DotRange 336 R/W
|
||||
ExtraSamples 338 R/W lots
|
||||
FaxRecvParams 34908 R/W
|
||||
FaxSubAddress 34909 R/W
|
||||
FaxRecvTime 34910 R/W
|
||||
FillOrder 266 R/W control bit order
|
||||
FreeByteCounts 289 parsed but ignored
|
||||
FreeOffsets 288 parsed but ignored
|
||||
GrayResponseCurve 291 parsed but ignored
|
||||
GrayResponseUnit 290 parsed but ignored
|
||||
Group3Options 292 R/W used by Group 3 codec
|
||||
Group4Options 293 R/W
|
||||
HostComputer 316 R/W
|
||||
ImageDepth 32997 R/W tile/strip calculations
|
||||
ImageDescription 270 R/W
|
||||
ImageLength 257 R/W lots
|
||||
ImageWidth 256 R/W lots
|
||||
InkNames 333 R/W
|
||||
InkSet 332 R/W
|
||||
JPEGTables 347 R/W used by JPEG codec
|
||||
Make 271 R/W
|
||||
Matteing 32995 R obsoleted by ExtraSamples tag
|
||||
MaxSampleValue 281 R/W
|
||||
MinSampleValue 280 R/W
|
||||
Model 272 R/W
|
||||
NewSubFileType 254 R/W called SubFileType in spec
|
||||
NumberOfInks 334 R/W
|
||||
Orientation 274 R/W
|
||||
PageName 285 R/W
|
||||
PageNumber 297 R/W
|
||||
PhotometricInterpretation 262 R/Wused by Group 3 and JPEG codecs
|
||||
PlanarConfiguration 284 R/W data i/o
|
||||
Predictor 317 R/W used by LZW and Deflate codecs
|
||||
PrimaryChromacities 319 R/W
|
||||
ReferenceBlackWhite 532 R/W
|
||||
ResolutionUnit 296 R/W used by Group 3 codec
|
||||
RowsPerStrip 278 R/W data i/o
|
||||
SampleFormat 339 R/W
|
||||
SamplesPerPixel 277 R/W lots
|
||||
SMinSampleValue 340 R/W
|
||||
SMaxSampleValue 341 R/W
|
||||
Software 305 R/W
|
||||
StoNits 37439 R/W
|
||||
StripByteCounts 279 R/W data i/o
|
||||
StripOffsets 273 R/W data i/o
|
||||
SubFileType 255 R/W called OSubFileType in spec
|
||||
TargetPrinter 337 R/W
|
||||
Thresholding 263 R/W
|
||||
TileByteCounts 324 R/W data i/o
|
||||
TileDepth 32998 R/W tile/strip calculations
|
||||
TileLength 323 R/W data i/o
|
||||
TileOffsets 324 R/W data i/o
|
||||
TileWidth 322 R/W data i/o
|
||||
TransferFunction 301 R/W
|
||||
WhitePoint 318 R/W
|
||||
XPosition 286 R/W
|
||||
XResolution 282 R/W
|
||||
YCbCrCoefficients 529 R/W used by TIFFRGBAImage support
|
||||
YCbCrPositioning 531 R/W tile/strip size calulcations
|
||||
YCbCrSubsampling 530 R/W
|
||||
YPosition 286 R/W
|
||||
YResolution 283 R/W used by Group 3 codec
|
||||
</PRE><A NAME="lbAH"> </A>
|
||||
<H2>PSEUDO TAGS</H2>
|
||||
|
||||
In addition to the normal
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
tags the library supports a collection of
|
||||
tags whose values lie in a range outside the valid range of
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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.
|
||||
<P>
|
||||
<PRE>
|
||||
|
||||
<I>Tag Name</I> <I>Codec</I> <I>R/W</I> <I>Library Use/Notes</I>
|
||||
|
||||
TIFFTAG_FAXMODE G3 R/W general codec operation
|
||||
TIFFTAG_FAXFILLFUNC G3/G4 R/W bitmap fill function
|
||||
TIFFTAG_JPEGQUALITY JPEG R/W compression quality control
|
||||
TIFFTAG_JPEGCOLORMODE JPEG R/W control colorspace conversions
|
||||
TIFFTAG_JPEGTABLESMODE JPEG R/W control contents of <I>JPEGTables</I> tag
|
||||
TIFFTAG_ZIPQUALITY Deflate R/Wcompression quality level
|
||||
TIFFTAG_PIXARLOGDATAFMT PixarLog R/Wuser data format
|
||||
TIFFTAG_PIXARLOGQUALITY PixarLog R/Wcompression quality level
|
||||
TIFFTAG_SGILOGDATAFMT SGILog R/W user data format
|
||||
</PRE>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>TIFFTAG_FAXMODE</B>
|
||||
|
||||
<DD>
|
||||
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
|
||||
<FONT SIZE="-1">RTC</FONT>
|
||||
is written at the end of the last strip),
|
||||
FAXMODE_NORTC
|
||||
(opposite of
|
||||
FAXMODE_CLASSIC;
|
||||
also called
|
||||
FAXMODE_CLASSF),
|
||||
FAXMODE_NOEOL
|
||||
(do not write
|
||||
<FONT SIZE="-1">EOL</FONT>
|
||||
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.
|
||||
<DT><B>TIFFTAG_FAXFILLFUNC</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>TIFFTAG_IPTCNEWSPHOTO</B>
|
||||
|
||||
<DD>
|
||||
Tag contaings image metadata per the IPTC newsphoto spec: Headline,
|
||||
captioning, credit, etc... Used by most wire services.
|
||||
<DT><B>TIFFTAG_PHOTOSHOP</B>
|
||||
|
||||
<DD>
|
||||
Tag contains Photoshop captioning information and metadata. Photoshop
|
||||
uses in parallel and redundantly alongside IPTCNEWSPHOTO information.
|
||||
<DT><B>TIFFTAG_JPEGQUALITY</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>TIFFTAG_JPEGCOLORMODE</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>TIFFTAG_JPEGTABLESMODE</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>TIFFTAG_ZIPQUALITY</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>TIFFTAG_PIXARLOGDATAFMT</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>TIFFTAG_PIXARLOGQUALITY</B>
|
||||
|
||||
<DD>
|
||||
Control the compression technique used by the PixarLog codec.
|
||||
This value is treated identically to TIFFTAG_ZIPQUALITY; see the
|
||||
above description.
|
||||
<DT><B>TIFFTAG_SGILOGDATAFMT</B>
|
||||
|
||||
<DD>
|
||||
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).
|
||||
</DL>
|
||||
<A NAME="lbAI"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
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.
|
||||
<A NAME="lbAJ"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?fax2tiff+1">fax2tiff</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?gif2tiff+1">gif2tiff</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?pal2rgb+1">pal2rgb</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?ppm2tiff+1">ppm2tiff</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?rgb2ycbcr+1">rgb2ycbcr</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?ras2tiff+1">ras2tiff</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?sgi2tiff+1">sgi2tiff</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?tiff2bw+1">tiff2bw</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?tiffdither+1">tiffdither</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?tiffdump+1">tiffdump</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?tiffcp+1">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?tiffcmp+1">tiffcmp</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?tiffgt+1">tiffgt</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?tiffinfo+1">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?tiffmedian+1">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?tiffsplit+1">tiffsplit</A></I>(1),
|
||||
|
||||
<I><A HREF="http:/cgi-bin/man2html?tiffsv+1">tiffsv</A></I>(1),
|
||||
|
||||
<P>
|
||||
|
||||
<I>Tag Image File Format Specification - Revision 6.0</I>,
|
||||
|
||||
an Aldus Technical Memorandum.
|
||||
<P>
|
||||
|
||||
<I>The Spirit of TIFF Class F</I>,
|
||||
|
||||
an appendix to the TIFF 5.0 specification prepared by Cygnet Technologies.
|
||||
<A NAME="lbAK"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
The library does not support multi-sample images
|
||||
where some samples have different bits/sample.
|
||||
<P>
|
||||
|
||||
The library does not support random access to compressed data
|
||||
that is organized with more than one row per tile or strip.
|
||||
The library discards unknown tags.
|
||||
The library should do more validity checking of a directory's contents.
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">DATA TYPES</A><DD>
|
||||
<DT><A HREF="#lbAF">LIST OF ROUTINES</A><DD>
|
||||
<DT><A HREF="#lbAG">TAG USAGE</A><DD>
|
||||
<DT><A HREF="#lbAH">PSEUDO TAGS</A><DD>
|
||||
<DT><A HREF="#lbAI">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
|
||||
<DT><A HREF="#lbAK">BUGS</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:39 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+149
@@ -0,0 +1,149 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of PAL2RGB</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>PAL2RGB</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
pal2rgb - convert a palette color
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
image to a full color image
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>pal2rgb</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>input.tif</I>
|
||||
|
||||
<I>output.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>Pal2rgb</I>
|
||||
|
||||
converts a palette color
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
image to a full color image by
|
||||
applying the colormap of the palette image to each sample
|
||||
to generate a full color
|
||||
<FONT SIZE="-1">RGB</FONT>
|
||||
image.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
Options that affect the interpretation of input data are:
|
||||
<DL COMPACT>
|
||||
<DT><B>-C</B>
|
||||
|
||||
<DD>
|
||||
This option overrides the default behaviour 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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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.
|
||||
</DL>
|
||||
<P>
|
||||
|
||||
Options that affect the output file format are:
|
||||
<DL COMPACT>
|
||||
<DT><B>-p</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-r</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Only 8-bit images are handled.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+129
@@ -0,0 +1,129 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of PPM2TIFF</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>PPM2TIFF</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
ppm2tiff - create a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file from a
|
||||
<FONT SIZE="-1">PPM</FONT>
|
||||
image file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>ppm2tiff</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
] [
|
||||
<I>input.ppm</I>
|
||||
|
||||
]
|
||||
<I>output.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>ppm2tiff</I>
|
||||
|
||||
converts a file in the
|
||||
<FONT SIZE="-1">PPM</FONT>
|
||||
image format to
|
||||
<FONT SIZE="-1">TIFF.</FONT>
|
||||
By default, the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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 be overriden, or explicitly specified
|
||||
with the options described below
|
||||
<P>
|
||||
|
||||
If the
|
||||
<FONT SIZE="-1">PPM</FONT>
|
||||
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>
|
||||
|
||||
If no
|
||||
<FONT SIZE="-1">PPM</FONT>
|
||||
file is specified on the command line,
|
||||
<I>ppm2tiff</I>
|
||||
|
||||
will read from the standard input.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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 compression (the default).
|
||||
<DT><B>-r</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-R</B>
|
||||
|
||||
<DD>
|
||||
Mark the resultant image to have the specified
|
||||
X and Y resolution (in dots/inch).
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+127
@@ -0,0 +1,127 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of RAS2TIFF</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>RAS2TIFF</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
ras2tiff - create a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file from a Sun rasterfile
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>ras2tiff</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>input.ras</I>
|
||||
|
||||
<I>output.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>ras2tiff</I>
|
||||
|
||||
converts a file in the Sun rasterfile format to
|
||||
<FONT SIZE="-1">TIFF.</FONT>
|
||||
By default, the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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 overriden, or explicitly specified
|
||||
with the options described below.
|
||||
<P>
|
||||
|
||||
Any colormap information in the rasterfile is carried over to the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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).
|
||||
<DT><B>-r</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Does not handle all possible rasterfiles.
|
||||
In particular,
|
||||
<I>ras2tiff</I>
|
||||
|
||||
does not handle run-length encoded images.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="pal2rgb+1.html">pal2rgb</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+129
@@ -0,0 +1,129 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of RGB2YCBCR</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>RGB2YCBCR</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
rgb2ycbcr - convert non-YCbCr
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
images to a YCbCr
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
image
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>rgb2ycbcr</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>src1.tif src2.tif ... dst.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>rgb2ycbcr</I>
|
||||
|
||||
converts
|
||||
<FONT SIZE="-1">RGB</FONT>
|
||||
color, greyscale, or bi-level
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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>
|
||||
|
||||
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
|
||||
<FONT SIZE="-1">LZW</FONT>
|
||||
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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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 JPEG compression algorithm,
|
||||
and
|
||||
<B>-c lzw</B>
|
||||
|
||||
for Lempel-Ziv & Welch (the default).
|
||||
<DT><B>-h</B>
|
||||
|
||||
<DD>
|
||||
Set the horizontal sampling dimension to one of: 1, 2 (default), or 4.
|
||||
<DT><B>-r</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-v</B>
|
||||
|
||||
<DD>
|
||||
Set the vertical sampling dimension to one of: 1, 2 (default), or 4.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+123
@@ -0,0 +1,123 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of SGI2TIFF</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>SGI2TIFF</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
sgi2tiff - create a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file from an
|
||||
<FONT SIZE="-1">SGI</FONT>
|
||||
image file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>sgi2tiff</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>input.rgb</I>
|
||||
|
||||
<I>output.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>sgi2tiff</I>
|
||||
|
||||
converts a file in the
|
||||
<FONT SIZE="-1">SGI</FONT>
|
||||
image format to
|
||||
<FONT SIZE="-1">TIFF.</FONT>
|
||||
By default, the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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 overriden, or explicitly specified
|
||||
with the options described below.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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).
|
||||
<DT><B>-p</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-r</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Does not record colormap information.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+123
@@ -0,0 +1,123 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of THUMBNAIL</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>THUMBNAIL</H1>
|
||||
Section: User Commands (1)<BR>Updated: September 26, 1994<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
thumbnail - create a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file with thumbnail images
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>thumbnail</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>input.tif</I>
|
||||
|
||||
<I>output.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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>
|
||||
|
||||
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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-w</B>
|
||||
|
||||
<DD>
|
||||
Specify the width of thumbnail images in pixels.
|
||||
<DT><B>-h</B>
|
||||
|
||||
<DD>
|
||||
Specify the height of thumbnail images in pixels.
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
There are no options to control the format of the saved thumbnail images.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="tiffdump+1.html">tiffdump</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffgt+1.html">tiffgt</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+125
@@ -0,0 +1,125 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFF2BW</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFF2BW</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
tiff2bw - convert a color
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
image to greyscale
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>tiff2bw</B>
|
||||
|
||||
[
|
||||
options
|
||||
]
|
||||
<I>input.tif</I>
|
||||
|
||||
<I>output.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>Tiff2bw</I>
|
||||
|
||||
converts an
|
||||
<FONT SIZE="-1">RGB</FONT>
|
||||
or Palette color
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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).
|
||||
<DT><B>-r</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-R</B>
|
||||
|
||||
<DD>
|
||||
Specify the percentage of the red channel to use (default 28).
|
||||
<DT><B>-G</B>
|
||||
|
||||
<DD>
|
||||
Specify the percentage of the green channel to use (default 59).
|
||||
<DT><B>-B</B>
|
||||
|
||||
<DD>
|
||||
Specify the percentage of the blue channel to use (default 11).
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="pal2rgb+1.html">pal2rgb</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+237
@@ -0,0 +1,237 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFF2PS</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFF2PS</H1>
|
||||
Section: User Commands (1)<BR>Updated: January 27, 1997<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
tiff2ps - convert a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
image to P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>tm
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>tiff2ps</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>input.tif ...</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>tiff2ps</I>
|
||||
|
||||
reads
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
images and writes P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> or Encapsulated P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> (EPS)
|
||||
on the standard output.
|
||||
By default,
|
||||
<I>tiff2ps</I>
|
||||
|
||||
writes Encapsulated P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> for the first image in the specified
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
image file.
|
||||
<P>
|
||||
|
||||
By default,
|
||||
<I>tiff2ps</I>
|
||||
|
||||
will generate P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> that fills a printed area specified
|
||||
by the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
tags.
|
||||
<P>
|
||||
|
||||
The P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> generated for
|
||||
<FONT SIZE="-1">RGB,</FONT>
|
||||
palette, and
|
||||
<FONT SIZE="-1">CMYK</FONT>
|
||||
images uses the
|
||||
<I>colorimage</I>
|
||||
|
||||
operator.
|
||||
The P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> generated for
|
||||
greyscale and bilevel images
|
||||
uses the
|
||||
<I>image</I>
|
||||
|
||||
operator.
|
||||
When the
|
||||
<I>colorimage</I>
|
||||
|
||||
operator is used, P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> code to emulate this operator
|
||||
on older P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> printers is also generated.
|
||||
Note that this emulation code can be very slow.
|
||||
<P>
|
||||
|
||||
Color images with associated alpha data are composited over
|
||||
a white background.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-1</B>
|
||||
|
||||
<DD>
|
||||
Generate P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level I (the default).
|
||||
<DT><B>-2</B>
|
||||
|
||||
<DD>
|
||||
Generate P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level II.
|
||||
<DT><B>-a</B>
|
||||
|
||||
<DD>
|
||||
Generate output for all IFDs (pages) in the input file.
|
||||
<DT><B>-d</B>
|
||||
|
||||
<DD>
|
||||
Set the initial
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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.
|
||||
<DT><B>-e</B>
|
||||
|
||||
<DD>
|
||||
Force the generation of Encapsulated P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>.
|
||||
<DT><B>-h</B>
|
||||
|
||||
<DD>
|
||||
Specify the vertical size of the printed area (in inches).
|
||||
<DT><B>-o</B>
|
||||
|
||||
<DD>
|
||||
Set the initial
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
directory to the
|
||||
<FONT SIZE="-1">IFD</FONT>
|
||||
at the specified file offset.
|
||||
This option is useful for selecting thumbnail images and the
|
||||
like which are hidden using the SubIFD tag.
|
||||
<DT><B>-p</B>
|
||||
|
||||
<DD>
|
||||
Force the generation of (non-Encapsulated) P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>.
|
||||
<DT><B>-s</B>
|
||||
|
||||
<DD>
|
||||
Generate output for a single IFD (page) in the input file.
|
||||
<DT><B>-w</B>
|
||||
|
||||
<DD>
|
||||
Specify the horizontal size of the printed area (in inches).
|
||||
<DT><B>-z</B>
|
||||
|
||||
<DD>
|
||||
When generating P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level II, 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 behaviour.
|
||||
When P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level I is generated, data is imaged to the entire printed
|
||||
page and this option has no affect.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>EXAMPLES</H2>
|
||||
|
||||
The following generates P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level II for all pages of a facsimile:
|
||||
<DL COMPACT><DT><DD>
|
||||
<PRE>
|
||||
tiff2ps -a2 fax.tif | lpr
|
||||
</PRE>
|
||||
|
||||
</DL>
|
||||
|
||||
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>
|
||||
|
||||
To generate Encapsulated P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> for a the image at directory 2
|
||||
of an image use:
|
||||
<DL COMPACT><DT><DD>
|
||||
<PRE>
|
||||
tiff2ps -d 1 foo.tif
|
||||
</PRE>
|
||||
|
||||
</DL>
|
||||
|
||||
(notice that directories are numbered starting at zero.)
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Because P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> does not support the notion of a colormap,
|
||||
8-bit palette images produce 24-bit P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> 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.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Does not handle tiled images when generating PS Level I output.
|
||||
<A NAME="lbAI"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="pal2rgb+1.html">pal2rgb</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffgt+1.html">tiffgt</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="tiff2bw+1.html">tiff2bw</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffsv+1.html">tiffsv</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">EXAMPLES</A><DD>
|
||||
<DT><A HREF="#lbAG">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAH">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAI">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+106
@@ -0,0 +1,106 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFCMP</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFCMP</H1>
|
||||
Section: User Commands (1)<BR>Updated: September 26, 1994<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
tiffcmp - compare two
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
files
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>tiffcmp</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>file1.tif file2.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-l</B>
|
||||
|
||||
<DD>
|
||||
List each byte of image data that differs between the files.
|
||||
<DT><B>-t</B>
|
||||
|
||||
<DD>
|
||||
Ignore any differences in directory tags.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Tags that are not recognized by the library are not
|
||||
compared; they may also generate spurious diagnostics.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="pal2rgb+1.html">pal2rgb</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+291
@@ -0,0 +1,291 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFCP</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFCP</H1>
|
||||
Section: User Commands (1)<BR>Updated: January 9, 1996<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
tiffcp - copy (and possibly convert) a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>tiffcp</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>src1.tif ... srcN.tif dst.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>tiffcp</I>
|
||||
|
||||
combines one or more files created according
|
||||
to the Tag Image File Format, Revision 6.0
|
||||
into a single
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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>
|
||||
|
||||
By default,
|
||||
<I>tiffcp</I>
|
||||
|
||||
will copy all the understood tags in a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
directory of an input
|
||||
file to the associated directory in the output file.
|
||||
<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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-B</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-C</B>
|
||||
|
||||
<DD>
|
||||
Suppress the use of ``strip chopping'' when reading images
|
||||
that have a single strip/tile of uncompressed data.
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><DD>
|
||||
The
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
Group 3 and Group 4 compression algorithms can only
|
||||
be used with bilevel data.
|
||||
<DT><DD>
|
||||
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.
|
||||
<DT><DD>
|
||||
<FONT SIZE="-1">LZW</FONT>
|
||||
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
|
||||
<FONT SIZE="-1">LZW</FONT>
|
||||
compression with horizontal differencing.
|
||||
<DT><B>-f</B>
|
||||
|
||||
<DD>
|
||||
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
|
||||
<FONT SIZE="-1">LSB2MSB,</FONT>
|
||||
while
|
||||
<B>-f msb2lsb</B>
|
||||
|
||||
will force data to be written with the FillOrder tag set to
|
||||
<FONT SIZE="-1">MSB2LSB.</FONT>
|
||||
<DT><B>-l</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-L</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-M</B>
|
||||
|
||||
<DD>
|
||||
Suppress the use of memory-mapped files when reading images.
|
||||
<DT><B>-p</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-r</B>
|
||||
|
||||
<DD>
|
||||
Specify the number of rows (scanlines) in each strip of data
|
||||
written to the output file.
|
||||
By default,
|
||||
<I>tiffcp</I>
|
||||
|
||||
attempts to set the rows/strip
|
||||
that no more than 8 kilobytes of data appear in a strip.
|
||||
<DT><B>-s</B>
|
||||
|
||||
<DD>
|
||||
Force the output file to be written with data organized in strips
|
||||
(rather than tiles).
|
||||
<DT><B>-t</B>
|
||||
|
||||
<DD>
|
||||
Force the output file to be written wtih 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.
|
||||
<DT><B>-w</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>EXAMPLES</H2>
|
||||
|
||||
The following concatenates two files and writes the result using
|
||||
<FONT SIZE="-1">LZW</FONT>
|
||||
encoding:
|
||||
<DL COMPACT><DT><DD>
|
||||
<PRE>
|
||||
tiffcp -c lzw a.tif b.tif result.tif
|
||||
</PRE>
|
||||
|
||||
</DL>
|
||||
|
||||
<P>
|
||||
|
||||
To convert a G3 1d-encoded
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
to a single strip of G4-encoded data the following might be used:
|
||||
<DL COMPACT><DT><DD>
|
||||
<PRE>
|
||||
tiffcp -c g4 -r 10000 g3.tif g4.tif
|
||||
</PRE>
|
||||
|
||||
</DL>
|
||||
|
||||
(1000 is just a number that is larger than the number of rows in
|
||||
the source file.)
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="pal2rgb+1.html">pal2rgb</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcmp+1.html">tiffcmp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffsplit+1.html">tiffsplit</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">EXAMPLES</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:48 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+171
@@ -0,0 +1,171 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFDITHER</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFDITHER</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
tiffdither - convert a greyscale image to bilevel using dithering
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>tiffdither</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>input.tif</I>
|
||||
|
||||
<I>output.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>tiffdither</I>
|
||||
|
||||
converts a single channel 8-bit greyscale image to a bilevel image
|
||||
using Floyd-Steinberg error propagation with threholding.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><DD>
|
||||
The
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
Group 3 and Group 4 compression algorithms can only
|
||||
be used with bilevel data.
|
||||
<DT><DD>
|
||||
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.
|
||||
<DT><DD>
|
||||
<FONT SIZE="-1">LZW</FONT>
|
||||
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
|
||||
<FONT SIZE="-1">LZW</FONT>
|
||||
compression with horizontal differencing.
|
||||
<DT><B>-f</B>
|
||||
|
||||
<DD>
|
||||
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 FillOrder tag set to
|
||||
<FONT SIZE="-1">LSB2MSB ,</FONT>
|
||||
while
|
||||
<B>-f msb2lsb</B>
|
||||
|
||||
will force data to be written with the FillOrder tag set to
|
||||
<FONT SIZE="-1">MSB2LSB .</FONT>
|
||||
<DT><B>-t</B>
|
||||
|
||||
<DD>
|
||||
Set the threshold value for dithering.
|
||||
By default the threshold value is 128.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
The dither algorithm is taken from the
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1)
|
||||
|
||||
program (written by Paul Heckbert).
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="pal2rgb+1.html">pal2rgb</A></I>(1),
|
||||
|
||||
<I><A HREF="fax2tiff+1.html">fax2tiff</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiff2bw+1.html">tiff2bw</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:48 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+97
@@ -0,0 +1,97 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFDUMP</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFDUMP</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
tiffdump - print verbatim information about
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
files
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>tiffdump</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>name ...</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>tiffdump</I>
|
||||
|
||||
displays directory information from files created according
|
||||
to the Tag Image File Format, Revision 6.0.
|
||||
The header of each
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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, datatype, count, and value(s) is displayed.
|
||||
When the symbolic name for a tag or datatype 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>
|
||||
|
||||
<I>tiffdump</I>
|
||||
|
||||
is particularly useful for investigating the contents of
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
files that
|
||||
<I>libtiff</I>
|
||||
|
||||
does not understand.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-h</B>
|
||||
|
||||
<DD>
|
||||
Force numeric data to be printed in hexadecimal rather than the
|
||||
default decimal.
|
||||
<DT><B>-o</B>
|
||||
|
||||
<DD>
|
||||
Dump the contents of the
|
||||
<FONT SIZE="-1">IFD</FONT>
|
||||
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.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:48 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+325
@@ -0,0 +1,325 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFGT</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFGT</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
tiffgt - display an image stored in a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file (Silicon Graphics version)
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>tiffgt</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>input.tif ...</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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
|
||||
<FONT SIZE="-1">RGB</FONT>
|
||||
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>
|
||||
|
||||
<I>tiffgt</I>
|
||||
|
||||
correctly handles files with any of the following characteristics:
|
||||
<P>
|
||||
|
||||
|
||||
|
||||
<PRE>
|
||||
BitsPerSample 1, 2, 4, 8, 16
|
||||
SamplesPerPixel 1, 3, 4 (the 4th sample is ignored)
|
||||
PhotometricInterpretation 0 (min-is-white), 1 (min-is-black), 2 (RGB), 3 (palette), 6 (YCbCr)
|
||||
PlanarConfiguration 1 (contiguous), 2 (separate)
|
||||
Orientation 1 (top-left), 4 (bottom-left)
|
||||
</PRE>
|
||||
|
||||
|
||||
<P>
|
||||
Data may be organized as strips or tiles and may be
|
||||
compressed with any of the compression algorithms supported
|
||||
by the
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
library.
|
||||
<P>
|
||||
|
||||
For palette images (<I>PhotomatricInterpretation</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>
|
||||
|
||||
<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:
|
||||
<DL COMPACT>
|
||||
<DT><B>b</B>
|
||||
|
||||
<DD>
|
||||
Use a
|
||||
<I>PhotometricIntepretation</I>
|
||||
|
||||
of MinIsBlack in displaying the current image.
|
||||
<DT><B>l</B>
|
||||
|
||||
<DD>
|
||||
Use a
|
||||
<I>FillOrder</I>
|
||||
|
||||
of lsb-to-msb in decoding the current image.
|
||||
<DT><B>m</B>
|
||||
|
||||
<DD>
|
||||
Use a
|
||||
<I>FillOrder</I>
|
||||
|
||||
of msb-tolmsb in decoding the current image.
|
||||
<DT><B>c</B>
|
||||
|
||||
<DD>
|
||||
Use a colormap visual to display the current image.
|
||||
<DT><B>r</B>
|
||||
|
||||
<DD>
|
||||
Use a true color (24-bit RGB) visual to display the current image.
|
||||
<DT><B>w</B>
|
||||
|
||||
<DD>
|
||||
Use a
|
||||
<I>PhotometricIntepretation</I>
|
||||
|
||||
of MinIsWhite in displaying the current image.
|
||||
<DT><B>W</B>
|
||||
|
||||
<DD>
|
||||
Toggle (enable/disable) display of warning messages from the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
library when decoding images.
|
||||
<DT><B>E</B>
|
||||
|
||||
<DD>
|
||||
Toggle (enable/disable) display of error messages from the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
library when decoding images.
|
||||
<DT><B>z</B>
|
||||
|
||||
<DD>
|
||||
Reset all parameters to their default settings (<I>FillOrder</I>,
|
||||
|
||||
<I>PhotometricInterpretation</I>,
|
||||
|
||||
handling of warnings and errors).
|
||||
<DT><B>PageUp</B>
|
||||
|
||||
<DD>
|
||||
Display the previous image in the current file or the last
|
||||
image in the previous file.
|
||||
<DT><B>PageDown</B>
|
||||
|
||||
<DD>
|
||||
Display the next image in the current file or the first image
|
||||
in the next file.
|
||||
<DT><B>Home</B>
|
||||
|
||||
<DD>
|
||||
Display the first image in the current file.
|
||||
<DT><B>End</B>
|
||||
|
||||
<DD>
|
||||
Display the last image in the current file (unimplemented).
|
||||
</DL>
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
Force image display in a colormap window.
|
||||
<DT><B>-d</B>
|
||||
|
||||
<DD>
|
||||
Specify an image to display by directory number.
|
||||
By default the first image in the file is displayed.
|
||||
Directories are numbered starting at zero.
|
||||
<DT><B>-e</B>
|
||||
|
||||
<DD>
|
||||
Enable reporting of error messages from the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
library.
|
||||
By default
|
||||
<I>tiffgt</I>
|
||||
|
||||
silently ignores images that cannot be read.
|
||||
<DT><B>-f</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-l</B>
|
||||
|
||||
<DD>
|
||||
Force the presumed bit ordering to be
|
||||
<FONT SIZE="-1">LSB</FONT>
|
||||
to
|
||||
<FONT SIZE="-1">MSB.</FONT>
|
||||
<DT><B>-m</B>
|
||||
|
||||
<DD>
|
||||
Force the presumed bit ordering to be
|
||||
<FONT SIZE="-1">MSB</FONT>
|
||||
to
|
||||
<FONT SIZE="-1">LSB.</FONT>
|
||||
<DT><B>-o</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-p</B>
|
||||
|
||||
<DD>
|
||||
Override the value of the
|
||||
<I>PhotometricInterpretation</I>
|
||||
|
||||
tag; the parameter may be one of:
|
||||
<I>miniswhite</I>,
|
||||
|
||||
<I>minisblack</I>,
|
||||
|
||||
<I>rgb</I>,
|
||||
|
||||
<I>palette</I>,
|
||||
|
||||
<I>mask</I>,
|
||||
|
||||
<I>separated</I>,
|
||||
|
||||
<I>ycbcr</I>,
|
||||
|
||||
and
|
||||
<I>cielab</I>.
|
||||
|
||||
<DT><B>-r</B>
|
||||
|
||||
<DD>
|
||||
Force image display in a full color window.
|
||||
<DT><B>-s</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-w</B>
|
||||
|
||||
<DD>
|
||||
Enable reporting of warning messages from the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
library.
|
||||
By default
|
||||
<I>tiffgt</I>
|
||||
|
||||
ignores warning messages generated when reading an image.
|
||||
<DT><B>-v</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Images wider and taller than the display are silently truncated to avoid
|
||||
crashing old versions of the window manager.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="tiffdump+1.html">tiffdump</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:48 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+114
@@ -0,0 +1,114 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFINFO</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFINFO</H1>
|
||||
Section: User Commands (1)<BR>Updated: January 27, 1997<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
tiffinfo - print information about
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
files
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>tiffinfo</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>input.tif ...</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>Tiffinfo</I>
|
||||
|
||||
displays information about files created according
|
||||
to the Tag Image File Format, Revision 6.0.
|
||||
By default, the contents of each
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
directory in each file
|
||||
is displayed, with the value of each tag shown symbolically
|
||||
(where sensible).
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
Display the colormap and color/gray response curves, if present.
|
||||
<DT><B>-D</B>
|
||||
|
||||
<DD>
|
||||
In addition to displaying the directory tags,
|
||||
read and decompress all the data in each image (but not display it).
|
||||
<DT><B>-d</B>
|
||||
|
||||
<DD>
|
||||
In addition to displaying the directory tags,
|
||||
print each byte of decompressed data in hexadecimal.
|
||||
<DT><B>-j</B>
|
||||
|
||||
<DD>
|
||||
Display any <FONT SIZE="-2">JPEG</FONT>-related tags that are present.
|
||||
<DT><B>-o</B>
|
||||
|
||||
<DD>
|
||||
Set the initial
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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.
|
||||
<DT><B>-s</B>
|
||||
|
||||
<DD>
|
||||
Display the offsets and byte counts for each data strip in a directory.
|
||||
<DT><B>-z</B>
|
||||
|
||||
<DD>
|
||||
Enable strip chopping when reading image data.
|
||||
<DT><B>-#</B>
|
||||
|
||||
<DD>
|
||||
Set the initial
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
directory to
|
||||
<I>#</I>.
|
||||
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="pal2rgb+1.html">pal2rgb</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcmp+1.html">tiffcmp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:48 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+150
@@ -0,0 +1,150 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFMEDIAN</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFMEDIAN</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
tiffmedian - apply the median cut algorithm to data in a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>tiffmedian</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>input.tif</I>
|
||||
|
||||
<I>output.tif</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>tiffmedian</I>
|
||||
|
||||
applys the median cut algorithm to an
|
||||
<FONT SIZE="-1">RGB</FONT>
|
||||
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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><DD>
|
||||
<FONT SIZE="-1">LZW</FONT>
|
||||
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
|
||||
<FONT SIZE="-1">LZW</FONT>
|
||||
compression with horizontal differencing.
|
||||
<DT><B>-C</B>
|
||||
|
||||
<DD>
|
||||
Specify the number of entries to use in the generated colormap.
|
||||
By default all 256 entries/colors are used.
|
||||
<DT><B>-f</B>
|
||||
|
||||
<DD>
|
||||
Apply Floyd-Steinberg dithering before selecting a colormap entry.
|
||||
<DT><B>-r</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>NOTES</H2>
|
||||
|
||||
This program is derived from Paul Heckbert's
|
||||
<I>median</I>
|
||||
|
||||
program.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="pal2rgb+1.html">pal2rgb</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcmp+1.html">tiffcmp</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
<P>
|
||||
|
||||
"Color Image Quantization for Frame Buffer Display", Paul
|
||||
Heckbert, SIGGRAPH proceedings, 1982, pp. 297-307.
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">NOTES</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:48 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+90
@@ -0,0 +1,90 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFCP</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFCP</H1>
|
||||
Section: User Commands (1)<BR>Updated: September 26, 1994<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
tiffsplit - split a multi-image
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
into single-image
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
files
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>tiffsplit</B>
|
||||
|
||||
<I>src.tif</I>
|
||||
|
||||
[
|
||||
<I>prefix</I>
|
||||
|
||||
]
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>tiffsplit</I>
|
||||
|
||||
takes a multi-directory (page)
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file and creates one or more single-directory (page)
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
files from it.
|
||||
The output files are given names created by concatenating
|
||||
a prefix, a lexically ordered
|
||||
suffix in the range [<I>aa</I>-<I>zz</I>], the suffix
|
||||
<I>.tif </I>
|
||||
|
||||
(e.g.
|
||||
<I>xaa.tif</I>,
|
||||
|
||||
<I>xab.tif</I>,
|
||||
|
||||
...
|
||||
<I>xzz.tif</I>).
|
||||
|
||||
If a prefix is not specified on the command line,
|
||||
the default prefix of
|
||||
<I>x</I>
|
||||
|
||||
is used.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
None.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Only a select set of ``known tags'' is copied when spliting.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:48 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Executable
+192
@@ -0,0 +1,192 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFSV</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFSV</H1>
|
||||
Section: User Commands (1)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
tiffsv - save an image from the framebuffer in a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file (Silicon Graphics version)
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>tiffsv</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
]
|
||||
<I>output.tif</I>
|
||||
|
||||
[
|
||||
<I>x1 x2 y1 y2</I>
|
||||
|
||||
]
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<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 overriden, or explicitly specified
|
||||
with the options described below.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
<DL COMPACT>
|
||||
<DT><B>-b</B>
|
||||
|
||||
<DD>
|
||||
Save the image as a greyscale image
|
||||
as if it were processed by
|
||||
<I><A HREF="tiff2bw+1.html">tiff2bw</A></I>(1).
|
||||
|
||||
This option is included for compatibility with the standard
|
||||
<I><A HREF="scrsave+6d">scrsave</A></I>(6D)
|
||||
|
||||
program.
|
||||
<DT><B>-c</B>
|
||||
|
||||
<DD>
|
||||
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).
|
||||
<DT><DD>
|
||||
<FONT SIZE="-1">LZW</FONT>
|
||||
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
|
||||
<FONT SIZE="-1">LZW</FONT>
|
||||
compression with horizontal differencing.
|
||||
<DT><B>-p</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-r</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>NOTE</H2>
|
||||
|
||||
Except for the use of
|
||||
<FONT SIZE="-1">TIFF,</FONT>
|
||||
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.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
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
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
library.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="scrsave+6d">scrsave</A></I>(6D)
|
||||
|
||||
<I><A HREF="pal2rgb+1.html">pal2rgb</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffdump+1.html">tiffdump</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffgt+1.html">tiffgt</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">NOTE</A><DD>
|
||||
<DT><A HREF="#lbAG">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:48 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Reference in New Issue
Block a user