|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<html>
|
|
Packit |
7838c8 |
<head>
|
|
Packit |
7838c8 |
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
|
Packit |
7838c8 |
<meta name="Content-Style" content="text/css">
|
|
Packit |
7838c8 |
<title>TIFFReadDirectory</title>
|
|
Packit |
7838c8 |
</head>
|
|
Packit |
7838c8 |
<body>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
TIFFReadDirectory
|
|
Packit |
7838c8 |
NAME
|
|
Packit |
7838c8 |
SYNOPSIS
|
|
Packit |
7838c8 |
DESCRIPTION
|
|
Packit |
7838c8 |
NOTES
|
|
Packit |
7838c8 |
RETURN VALUES
|
|
Packit |
7838c8 |
DIAGNOSTICS
|
|
Packit |
7838c8 |
SEE ALSO
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
NAME
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>TIFFReadDirectory − get the contents of the
|
|
Packit |
7838c8 |
next directory in an open</big> TIFF <big>file</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
SYNOPSIS
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>#include <tiffio.h></big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>int TIFFReadDirectory(TIFF
|
|
Packit |
7838c8 |
*tif)</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
DESCRIPTION
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>Read the next directory in the specified file and
|
|
Packit |
7838c8 |
make it the current directory. Applications only need to
|
|
Packit |
7838c8 |
call TIFFReadDirectory to read multiple subfiles in a
|
|
Packit |
7838c8 |
single</big> TIFF <big>file— the first directory in a
|
|
Packit |
7838c8 |
file is automatically read when TIFFOpen is
|
|
Packit |
7838c8 |
called.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
NOTES
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>If the library is compiled with</big>
|
|
Packit |
7838c8 |
STRIPCHOP_SUPPORT <big>enabled, then images that have a
|
|
Packit |
7838c8 |
single uncompressed strip or tile of data are automatically
|
|
Packit |
7838c8 |
treated as if they were made up of multiple strips or tiles
|
|
Packit |
7838c8 |
of approximately 8 kilobytes each. This operation is done
|
|
Packit |
7838c8 |
only in-memory; it does not alter the contents of the file.
|
|
Packit |
7838c8 |
However, the construction of the ‘‘chopped
|
|
Packit |
7838c8 |
strips’’ is visible to the application through
|
|
Packit |
7838c8 |
the number of strips [tiles] returned by
|
|
Packit |
7838c8 |
TIFFNumberOfStrips
|
|
Packit |
7838c8 |
[TIFFNumberOfTiles].</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
RETURN VALUES
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>If the next directory was successfully read, 1 is
|
|
Packit |
7838c8 |
returned. Otherwise, 0 is returned if an error was
|
|
Packit |
7838c8 |
encountered, or if there are no more directories to be
|
|
Packit |
7838c8 |
read.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
DIAGNOSTICS
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>All error messages are directed to the
|
|
Packit |
7838c8 |
TIFFError(3TIFF) routine. All warning messages are
|
|
Packit |
7838c8 |
directed to the TIFFWarning(3TIFF) routine.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>Seek error accessing TIFF directory. An error
|
|
Packit |
7838c8 |
occurred while positioning to the location of the
|
|
Packit |
7838c8 |
directory.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>Wrong data type %d for field "%s".
|
|
Packit |
7838c8 |
The tag entry in the directory had an incorrect data type.
|
|
Packit |
7838c8 |
For example, an ImageDescription tag with a</big>
|
|
Packit |
7838c8 |
SHORT <big>data type.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>TIFF directory is missing required "%s"
|
|
Packit |
7838c8 |
field. The specified tag is required to be present by
|
|
Packit |
7838c8 |
the</big> TIFF <big>5.0 specification, but is missing. The
|
|
Packit |
7838c8 |
directory is (usually) unusable.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>%s: Rational with zero denominator. A
|
|
Packit |
7838c8 |
directory tag has a</big> RATIONAL <big>value whose
|
|
Packit |
7838c8 |
denominator is zero.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>Incorrect count %d for field "%s" (%lu,
|
|
Packit |
7838c8 |
expecting %lu); tag ignored. The specified tag’s
|
|
Packit |
7838c8 |
count field is bad. For example, a count other than 1 for a
|
|
Packit |
7838c8 |
SubFileType tag.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>Cannot handle different per-sample values for
|
|
Packit |
7838c8 |
field "%s". The tag has SamplesPerPixel
|
|
Packit |
7838c8 |
values and they are not all the same; e.g.
|
|
Packit |
7838c8 |
BitsPerSample. The library is unable to handle images
|
|
Packit |
7838c8 |
of this sort.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>Count mismatch for field "%s";
|
|
Packit |
7838c8 |
expecting %d, got %d. The count field in a tag does not
|
|
Packit |
7838c8 |
agree with the number expected by the library. This should
|
|
Packit |
7838c8 |
never happen, so if it does, the library refuses to read the
|
|
Packit |
7838c8 |
directory.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>Invalid TIFF directory; tags are not sorted in
|
|
Packit |
7838c8 |
ascending order. The directory tags are not properly
|
|
Packit |
7838c8 |
sorted as specified in the</big> TIFF <big>5.0
|
|
Packit |
7838c8 |
specification. This error is not fatal.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>Ignoring unknown field with tag %d (0x%x). An
|
|
Packit |
7838c8 |
unknown tag was encountered in the directory; the library
|
|
Packit |
7838c8 |
ignores all such tags.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>TIFF directory is missing requred
|
|
Packit |
7838c8 |
"ImageLength" field. The image violates the
|
|
Packit |
7838c8 |
specification by not having a necessary field. There is no
|
|
Packit |
7838c8 |
way for the library to recover from this error.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>TIFF directory is missing requred
|
|
Packit |
7838c8 |
"PlanarConfig" field. The image violates the
|
|
Packit |
7838c8 |
specification by not having a necessary field. There is no
|
|
Packit |
7838c8 |
way for the library to recover from this error.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>TIFF directory is missing requred
|
|
Packit |
7838c8 |
"StripOffsets" field. The image has multiple
|
|
Packit |
7838c8 |
strips, but is missing the tag that specifies the file
|
|
Packit |
7838c8 |
offset to each strip of data. There is no way for the
|
|
Packit |
7838c8 |
library to recover from this error.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>TIFF directory is missing requred
|
|
Packit |
7838c8 |
"TileOffsets" field. The image has multiple
|
|
Packit |
7838c8 |
tiles, but is missing the tag that specifies the file offset
|
|
Packit |
7838c8 |
to each tile of data. There is no way for the library to
|
|
Packit |
7838c8 |
recover from this error.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>TIFF directory is missing required
|
|
Packit |
7838c8 |
"StripByteCounts" field. The image has
|
|
Packit |
7838c8 |
multiple strips, but is missing the tag that specifies the
|
|
Packit |
7838c8 |
size of each strip of data. There is no way for the library
|
|
Packit |
7838c8 |
to recover from this error.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>TIFF directory is missing required
|
|
Packit |
7838c8 |
"StripByteCounts" field, calculating from
|
|
Packit |
7838c8 |
imagelength. The image violates the specification by not
|
|
Packit |
7838c8 |
having a necessary field. However, when the image is
|
|
Packit |
7838c8 |
comprised of only one strip or tile, the library will
|
|
Packit |
7838c8 |
estimate the missing value based on the file size.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>Bogus "StripByteCounts" field, ignoring
|
|
Packit |
7838c8 |
and calculating from imagelength. Certain vendors
|
|
Packit |
7838c8 |
violate the specification by writing zero for the
|
|
Packit |
7838c8 |
StripByteCounts tag when they want to leave the value
|
|
Packit |
7838c8 |
unspecified. If the image has a single strip, the library
|
|
Packit |
7838c8 |
will estimate the missing value based on the file
|
|
Packit |
7838c8 |
size.</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
SEE ALSO
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
cols="2" cellspacing="0" cellpadding="0">
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>TIFFOpen(3TIFF),
|
|
Packit |
7838c8 |
TIFFWriteDirectory(3TIFF),
|
|
Packit |
7838c8 |
TIFFSetDirectory(3TIFF),
|
|
Packit |
7838c8 |
TIFFSetSubDirectory(3TIFF),
|
|
Packit |
7838c8 |
libtiff(3TIFF)</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
<big>Libtiff library home page:
|
|
Packit |
7838c8 |
http://www.simplesystems.org/libtiff/</big>
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
|
|
Packit |
7838c8 |
</body>
|
|
Packit |
7838c8 |
</html>
|