FM / man

/usr/share/doc/libtiff-devel/html/man

Name	Size	Mode	Actions
CMakeLists.txt	3460	0644	edit dl rm
fax2ps.1.html	7741	0644	edit dl rm
fax2tiff.1.html	14713	0644	edit dl rm
HtmlDoc.cmake	2147	0644	edit dl rm
index.html	3826	0644	edit dl rm
libtiff.3tiff.html	24576	0644	edit dl rm
pal2rgb.1.html	5244	0644	edit dl rm
ppm2tiff.1.html	3979	0644	edit dl rm
raw2tiff.1.html	12746	0644	edit dl rm
tiff2bw.1.html	4057	0644	edit dl rm
tiff2pdf.1.html	17942	0644	edit dl rm
tiff2ps.1.html	15016	0644	edit dl rm
tiff2rgba.1.html	4588	0644	edit dl rm
TIFFbuffer.3tiff.html	3880	0644	edit dl rm
TIFFClose.3tiff.html	2479	0644	edit dl rm
tiffcmp.1.html	4401	0644	edit dl rm
TIFFcodec.3tiff.html	3700	0644	edit dl rm
TIFFcolor.3tiff.html	22763	0644	edit dl rm
tiffcp.1.html	15754	0644	edit dl rm
tiffcrop.1.html	20402	0644	edit dl rm
TIFFDataWidth.3tiff.html	2556	0644	edit dl rm
tiffdither.1.html	5789	0644	edit dl rm
tiffdump.1.html	4416	0644	edit dl rm
TIFFError.3tiff.html	3247	0644	edit dl rm
TIFFFieldDataType.3tiff.html	2182	0644	edit dl rm
TIFFFieldName.3tiff.html	2127	0644	edit dl rm
TIFFFieldPassCount.3tiff.html	2612	0644	edit dl rm
TIFFFieldReadCount.3tiff.html	2820	0644	edit dl rm
TIFFFieldTag.3tiff.html	2249	0644	edit dl rm
TIFFFieldWriteCount.3tiff.html	3144	0644	edit dl rm
TIFFFlush.3tiff.html	3345	0644	edit dl rm
TIFFGetField.3tiff.html	33458	0644	edit dl rm
tiffinfo.1.html	4454	0644	edit dl rm
tiffmedian.1.html	5154	0644	edit dl rm
TIFFmemory.3tiff.html	3569	0644	edit dl rm
TIFFOpen.3tiff.html	13700	0644	edit dl rm
TIFFPrintDirectory.3tiff.html	4733	0644	edit dl rm
TIFFquery.3tiff.html	5166	0644	edit dl rm
TIFFReadDirectory.3tiff.html	8102	0644	edit dl rm
TIFFReadEncodedStrip.3tiff.html	4299	0644	edit dl rm
TIFFReadEncodedTile.3tiff.html	4133	0644	edit dl rm
TIFFReadRawStrip.3tiff.html	3340	0644	edit dl rm
TIFFReadRawTile.3tiff.html	3425	0644	edit dl rm
TIFFReadRGBAImage.3tiff.html	10482	0644	edit dl rm
TIFFReadRGBAStrip.3tiff.html	7481	0644	edit dl rm
TIFFReadRGBATile.3tiff.html	8477	0644	edit dl rm
TIFFReadScanline.3tiff.html	5257	0644	edit dl rm
TIFFReadTile.3tiff.html	4278	0644	edit dl rm
TIFFRGBAImage.3tiff.html	12310	0644	edit dl rm
tiffset.1.html	4920	0644	edit dl rm
TIFFSetDirectory.3tiff.html	3828	0644	edit dl rm
TIFFSetField.3tiff.html	31093	0644	edit dl rm
TIFFsize.3tiff.html	2748	0644	edit dl rm
tiffsplit.1.html	2927	0644	edit dl rm
TIFFstrip.3tiff.html	4356	0644	edit dl rm
TIFFswab.3tiff.html	3492	0644	edit dl rm
TIFFtile.3tiff.html	5014	0644	edit dl rm
TIFFWarning.3tiff.html	3353	0644	edit dl rm
TIFFWriteDirectory.3tiff.html	6486	0644	edit dl rm
TIFFWriteEncodedStrip.3tiff.html	5093	0644	edit dl rm
TIFFWriteEncodedTile.3tiff.html	4894	0644	edit dl rm
TIFFWriteRawStrip.3tiff.html	4511	0644	edit dl rm
TIFFWriteRawTile.3tiff.html	3978	0644	edit dl rm
TIFFWriteScanline.3tiff.html	7387	0644	edit dl rm
TIFFWriteTile.3tiff.html	3638	0644	edit dl rm

Edit: /usr/share/doc/libtiff-devel/html/man/TIFFOpen.3tiff.html (13700B)

<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta name="Content-Style" content="text/css">
<title>TIFFOpen</title>
</head>
<body>

<h1 align=center>TIFFOpen</h1>
<a href="#NAME">NAME</a> 
<a href="#SYNOPSIS">SYNOPSIS</a> 
<a href="#DESCRIPTION">DESCRIPTION</a> 
<a href="#OPTIONS">OPTIONS</a> 
<a href="#BYTE ORDER">BYTE ORDER</a> 
<a href="#RETURN VALUES">RETURN VALUES</a> 
<a href="#DIAGNOSTICS">DIAGNOSTICS</a> 
<a href="#SEE ALSO">SEE ALSO</a>

<hr>
<a name="NAME"></a>
<h2>NAME</h2>

<table width="100%" border=0 rules="none" frame="void"
 cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
TIFFOpen, TIFFFdOpen, TIFFClientOpen &minus; open a
TIFF file for reading or writing
</td>
</table>
<a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2>

<table width="100%" border=0 rules="none" frame="void"
 cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
#include &lt;tiffio.h&gt;

TIFF* TIFFOpen(const char *filename,
const char *mode) 
TIFF* TIFFFdOpen(const int fd, const char
*filename, const char
*mode)

typedef tsize_t (*TIFFReadWriteProc)(thandle_t,
tdata_t, tsize_t); 
typedef toff_t (*TIFFSeekProc)(thandle_t, toff_t, int); 
typedef int (*TIFFCloseProc)(thandle_t); 
typedef toff_t (*TIFFSizeProc)(thandle_t); 
typedef int (*TIFFMapFileProc)(thandle_t, tdata_t*,
toff_t*); 
typedef void (*TIFFUnmapFileProc)(thandle_t, tdata_t,
toff_t);

TIFF* TIFFClientOpen(const char
*filename, const char *mode,
thandle_t clientdata, TIFFReadWriteProc
readproc, TIFFReadWriteProc
writeproc, TIFFSeekProc seekproc,
TIFFCloseProc closeproc, TIFFSizeProc
sizeproc, TIFFMapFileProc mapproc,
TIFFUnmapFileProc unmapproc)
</td>
</table>
<a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2>

<table width="100%" border=0 rules="none" frame="void"
 cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
TIFFOpen opens a TIFF file whose
name is filename and returns a handle to be used in
subsequent calls to routines in libtiff. If the open
operation fails, then zero is returned. The mode
parameter specifies if the file is to be opened for reading
(&lsquo;&lsquo;r&rsquo;&rsquo;), writing
(&lsquo;&lsquo;w&rsquo;&rsquo;), or appending
(&lsquo;&lsquo;a&rsquo;&rsquo;) 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.

If a file is opened for reading, the first
TIFF directory in the file is automatically
read (also see TIFFSetDirectory(3TIFF) for reading
directories other than the first). If a file is opened for
writing or appending, a default directory is automatically
created for writing subsequent data. This directory has all
the default values specified in TIFF Revision
6.0: BitsPerSample=1, ThreshHolding=bilevel
art scan, FillOrder=1 (most significant bit of each
data byte is filled first), Orientation=1 (the 0th
row represents the visual top of the image, and the 0th
column represents the visual left hand side),
SamplesPerPixel=1, RowsPerStrip=infinity,
ResolutionUnit=2 (inches), and Compression=1
(no compression). To alter these values, or to define values
for additional fields, TIFFSetField(3TIFF) must be
used.

TIFFFdOpen is like TIFFOpen except that it
opens a TIFF file given an open file
descriptor fd. The file&rsquo;s name and mode must
reflect that of the open descriptor. The object associated
with the file descriptor must support random
access.

TIFFClientOpen is like TIFFOpen except that
the caller supplies a collection of functions that the
library will use to do UNIX -like I/O
operations. The readproc and writeproc are
called to read and write data at the current file position.
seekproc is called to change the current file
position a la lseek(2). closeproc is invoked
to release any resources associated with an open file.
sizeproc is invoked to obtain the size in bytes of a
file. mapproc and unmapproc are called to map
and unmap a file&rsquo;s contents in memory; c.f.
mmap(2) and munmap(2). The clientdata
parameter is an opaque &lsquo;&lsquo;handle&rsquo;&rsquo;
passed to the client-specified routines passed as parameters
to TIFFClientOpen.
</td>
</table>
<a name="OPTIONS"></a>
<h2>OPTIONS</h2>

<table width="100%" border=0 rules="none" frame="void"
 cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
The open mode parameter can include the following flags
in addition to the &lsquo;&lsquo;r&rsquo;&rsquo;,
&lsquo;&lsquo;w&rsquo;&rsquo;, and
&lsquo;&lsquo;a&rsquo;&rsquo; flags. Note however that
option flags must follow the read-write-append
specification.
</td>
</table>

<table width="100%" border=0 rules="none" frame="void"
 cols="5" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td>
<td width="2%">

l
</td>
<td width="6%"></td>
<td width="80%">

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
CPU byte order.
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="2%">

b
</td>
<td width="6%"></td>
<td width="80%">

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
CPU byte order.
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="2%">

L
</td>
<td width="6%"></td>
<td width="80%">

Force image data that is read or written to be treated
with bits filled from Least Significant Bit (
LSB ) to Most Significant Bit (
MSB ). Note that this is the opposite to the
way the library has worked from its inception.
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="2%">

B
</td>
<td width="6%"></td>
<td width="80%">

Force image data that is read or written to be treated
with bits filled from Most Significant Bit (
MSB ) to Least Significant Bit (
LSB ); this is the default.
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="2%">

H
</td>
<td width="6%"></td>
<td width="80%">

Force image data that is read or written to be treated
with bits filled in the same order as the native
CPU.
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="2%">

M
</td>
<td width="6%"></td>
<td width="80%">

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.
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="2%">

m
</td>
<td width="6%"></td>
<td width="80%">

Disable the use of memory-mapped files.
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="2%">

C
</td>
<td width="6%"></td>
<td width="80%">

Enable the use of &lsquo;&lsquo;strip
chopping&rsquo;&rsquo; 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.
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="2%">

c
</td>
<td width="6%"></td>
<td width="80%">

Disable the use of strip chopping when reading
images.
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="2%">

h
</td>
<td width="6%"></td>
<td width="80%">

Read TIFF header only, do not load the first image
directory. That could be useful in case of the broken first
directory. We can open the file and proceed to the other
directories.
</td>
<td width="0%">
</td>
</table>
<a name="BYTE ORDER"></a>
<h2>BYTE ORDER</h2>

<table width="100%" border=0 rules="none" frame="void"
 cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
The TIFF specification (all
versions) states that compliant readers must be
capable of reading images written in either byte order.
Nonetheless some software that claims to support the reading
of TIFF images is incapable of reading images
in anything but the native CPU 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 CPU 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
&lsquo;&lsquo;b&rsquo;&rsquo; and
&lsquo;&lsquo;l&rsquo;&rsquo; option flags may be included
in the call to open a file; for example,
&lsquo;&lsquo;wb&rsquo;&rsquo; or
&lsquo;&lsquo;wl&rsquo;&rsquo;.
</td>
</table>
<a name="RETURN VALUES"></a>
<h2>RETURN VALUES</h2>

<table width="100%" border=0 rules="none" frame="void"
 cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
Upon successful completion TIFFOpen,
TIFFFdOpen, and TIFFClientOpen return a
TIFF pointer. Otherwise, NULL is
returned.
</td>
</table>
<a name="DIAGNOSTICS"></a>
<h2>DIAGNOSTICS</h2>

<table width="100%" border=0 rules="none" frame="void"
 cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
All error messages are directed to the
TIFFError(3TIFF) routine. Likewise, warning messages
are directed to the TIFFWarning(3TIFF) routine.

&quot;%s&quot;: Bad mode. The specified
mode parameter was not one of
&lsquo;&lsquo;r&rsquo;&rsquo; (read),
&lsquo;&lsquo;w&rsquo;&rsquo; (write), or
&lsquo;&lsquo;a&rsquo;&rsquo; (append).

%s: Cannot open. TIFFOpen() was unable to
open the specified filename for read/writing.

Cannot read TIFF header. An error occurred while
attempting to read the header information.

Error writing TIFF header. An error occurred while
writing the default header information for a new file.

Not a TIFF file, bad magic number %d (0x%x). The
magic number in the header was not (hex) 0x4d4d or (hex)
0x4949.

Not a TIFF file, bad version number %d (0x%x). The
version field in the header was not 42 (decimal).

Cannot append to file that has opposite byte
ordering. A file with a byte ordering opposite to the
native byte ordering of the current machine was opened for
appending (&lsquo;&lsquo;a&rsquo;&rsquo;). This is a
limitation of the library.
</td>
</table>
<a name="SEE ALSO"></a>
<h2>SEE ALSO</h2>

<table width="100%" border=0 rules="none" frame="void"
 cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
libtiff(3TIFF), TIFFClose(3TIFF)
</td>
</table>
<hr>
</body>
</html>

cmd: