/usr/man507/cat.3/TIFFGetMode.3.Z

NAME

       TIFFCurrentRow,  TIFFCurrentStrip,  TIFFCurrentTile,  TIFFCurrentDirec-
       tory, TIFFLastDirectory, TIFFFileno, TIFFFileName,  TIFFGetMode,  TIFF-
       IsTiled, TIFFIsByteSwapped, TIFFIsUpSampled, TIFFIsMSB2LSB - query rou-
       tines

SYNOPSIS

       #include <tiffio.h>
       uint32 TIFFCurrentRow(TIFF* tif)
       tstrip_t TIFFCurrentStrip(TIFF* tif)
       ttile_t TIFFCurrentTile(TIFF* tif)
       tdir_t TIFFCurrentDirectory(TIFF* tif)
       int TIFFLastDirectory(TIFF* tif)
       int TIFFFileno(TIFF* tif)
       char* TIFFFileName(TIFF* tif)
       int TIFFGetMode(TIFF* tif)
       int TIFFIsTiled(TIFF* tif)
       int TIFFIsByteSwapped(TIFF* tif)
       int TIFFIsUpSampled(TIFF* tif)
       int TIFFIsMSB2LSB(TIFF* tif)
       const char* TIFFGetVersion(void)

DESCRIPTION

       The following routines return status information  about  an  open  TIFF
       file.

       TIFFCurrentDirectory returns the index of the current directory (direc-
       tories are numbered starting at 0).  This number is  suitable  for  use
       with the TIFFSetDirectory routine.

       TIFFLastDirectory  returns a non-zero value if the current directory is
       the last directory in the file; otherwise zero is returned.

       TIFFCurrentRow, TIFFCurrentStrip, and TIFFCurrentTile, return the  cur-
       rent row, strip, and tile, respectively, that is being read or written.
       These values are updated each time a read or write is done.

       TIFFFileno returns the underlying file descriptor used  to  access  the
       TIFF image in the filesystem.

       TIFFFileName returns the pathname argument passed to TIFFOpen or TIFFF-
       dOpen.

       TIFFGetMode returns the mode with which the underlying file was opened.
       On UNIX systems, this is the value passed to the open(2) system call.

       TIFFIsTiled  returns  a  non-zero  value  if the image data has a tiled
       organization.  Zero is returned if  the  image  data  is  organized  in
       strips.

       TIFFIsByteSwapped  returns  a non-zero value if the image data was in a
       different byte-order than the host machine.  Zero is  returned  if  the
       TIFF file and local host byte-orders are the same.  Note that TIFFRead-
       Tile(), TIFFReadStrip() and TIFFReadScanline() functions  already  nor-
       mally perform byte swapping to local host order if needed.

       TIFFIsUpSampled returns a non-zero value if image data returned through
       the read interface routines is being up-sampled.  This can be useful to
       applications  that  want  to calculate I/O buffer sizes to reflect this
       usage (though the usual strip and tile size routines already do  this).

       TIFFIsMSB2LSB  returns  a  non-zero  value  if  the image data is being
       returned with bit 0 as the most significant bit.

       TIFFGetVersion returns an ASCII string that has a version stamp for the
       TIFF library software.

DIAGNOSTICS

       None.

SEE ALSO

       libtiff(3T), TIFFOpen(3T), TIFFFdOpen(3T)

                               October 15, 1995                      QUERY(3T)
See also TIFFCurrentDirectory(3)
See also TIFFCurrentRow(3)
See also TIFFCurrentStrip(3)
See also TIFFCurrentTile(3)
See also TIFFFileName(3)
See also TIFFFileno(3)
See also TIFFIsByteSwapped(3)
See also TIFFIsMSB2LSB(3)
See also TIFFIsTiled(3)
See also TIFFIsUpSampled(3)
See also TIFFLastDirectory(3)
See also TIFFquery(3)