1QUERY(3TIFF)                                                      QUERY(3TIFF)
2
3
4

NAME

6       TIFFCurrentRow,  TIFFCurrentStrip,  TIFFCurrentTile,  TIFFCurrentDirec‐
7       tory, TIFFLastDirectory, TIFFFileno, TIFFFileName,  TIFFGetMode,  TIFF‐
8       IsTiled, TIFFIsByteSwapped, TIFFIsUpSampled, TIFFIsMSB2LSB, TIFFGetVer‐
9       sion - query routines
10

SYNOPSIS

12       #include <tiffio.h>
13
14       uint32 TIFFCurrentRow(TIFF* tif)
15       tstrip_t TIFFCurrentStrip(TIFF* tif)
16       ttile_t TIFFCurrentTile(TIFF* tif)
17       tdir_t TIFFCurrentDirectory(TIFF* tif)
18       int TIFFLastDirectory(TIFF* tif)
19       int TIFFFileno(TIFF* tif)
20       char* TIFFFileName(TIFF* tif)
21       int TIFFGetMode(TIFF* tif)
22       int TIFFIsTiled(TIFF* tif)
23       int TIFFIsByteSwapped(TIFF* tif)
24       int TIFFIsUpSampled(TIFF* tif)
25       int TIFFIsMSB2LSB(TIFF* tif)
26       const char* TIFFGetVersion(void)
27

DESCRIPTION

29       The following routines return status information  about  an  open  TIFF
30       file.
31
32       TIFFCurrentDirectory returns the index of the current directory (direc‐
33       tories are numbered starting at 0). This number  is  suitable  for  use
34       with the TIFFSetDirectory routine.
35
36       TIFFLastDirectory  returns a non-zero value if the current directory is
37       the last directory in the file; otherwise zero is returned.
38
39       TIFFCurrentRow, TIFFCurrentStrip, and TIFFCurrentTile, return the  cur‐
40       rent row, strip, and tile, respectively, that is being read or written.
41       These values are updated each time a read or write is done.
42
43       TIFFFileno returns the underlying file descriptor used  to  access  the
44       TIFF image in the filesystem.
45
46       TIFFFileName returns the pathname argument passed to TIFFOpen or TIFFF‐
47       dOpen.
48
49       TIFFGetMode returns the mode with which the underlying file was opened.
50       On UNIX systems, this is the value passed to the open(2) system call.
51
52       TIFFIsTiled  returns  a  non-zero  value  if the image data has a tiled
53       organization. Zero is returned  if  the  image  data  is  organized  in
54       strips.
55
56       TIFFIsByteSwapped  returns  a non-zero value if the image data was in a
57       different byte-order than the host machine. Zero  is  returned  if  the
58       TIFF file and local host byte-orders are the same.  Note that TIFFRead‐
59       Tile(), TIFFReadStrip() and TIFFReadScanline() functions  already  nor‐
60       mally perform byte swapping to local host order if needed.
61
62       TIFFIsUpSampled returns a non-zero value if image data returned through
63       the read interface routines is being up-sampled. This can be useful  to
64       applications  that  want  to calculate I/O buffer sizes to reflect this
65       usage (though the usual strip and tile size routines already do this).
66
67       TIFFIsMSB2LSB returns a non-zero value  if  the  image  data  is  being
68       returned with bit 0 as the most significant bit.
69
70       TIFFGetVersion returns an ASCII string that has a version stamp for the
71       TIFF library software.
72

DIAGNOSTICS

74       None.
75

SEE ALSO

77       libtiff(3TIFF), TIFFOpen(3TIFF), TIFFFdOpen(3TIFF)
78
79
80
81libtiff                        October 29, 2004                   QUERY(3TIFF)
Impressum