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_t 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 or‐
53       ganization. Zero is returned if the image data is organized in strips.
54
55       TIFFIsByteSwapped returns a non-zero value if the image data was  in  a
56       different  byte-order  than  the  host machine. Zero is returned if the
57       TIFF file and local host byte-orders are the same.  Note that TIFFRead‐
58       Tile(), TIFFReadEncodedStrip() and TIFFReadScanline() functions already
59       normally perform byte swapping to local host order if needed.
60
61       TIFFIsUpSampled returns a non-zero value if image data returned through
62       the  read interface routines is being up-sampled. This can be useful to
63       applications that want to calculate I/O buffer sizes  to  reflect  this
64       usage (though the usual strip and tile size routines already do this).
65
66       TIFFIsMSB2LSB  returns  a non-zero value if the image data is being re‐
67       turned with bit 0 as the most significant bit.
68
69       TIFFGetVersion returns an ASCII string that has a version stamp for the
70       TIFF library software.
71

DIAGNOSTICS

73       None.
74

SEE ALSO

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