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