TIFFGetField(3TIFF)                           TIFFGetField(3TIFF)



NAME
       TIFFGetField, TIFFVGetField - get the value(s) of a tag in
       an open TIFF file

SYNOPSIS
       #include 

       int TIFFGetField(TIFF *tif, ttag_t tag, ...)

       #include 

       int TIFFVGetField(TIFF *tif, ttag_t tag, va_list ap)
       int TIFFGetFieldDefaulted(TIFF *tif, ttag_t tag, ...)
       int TIFFVGetFieldDefaulted(TIFF *tif, ttag_t tag,  va_list
       ap)

DESCRIPTION
       TIFFGetField  returns  the  value  of  a tag or pseudo-tag
       associated with the the current directory  of  the  opened
       TIFF  file tif.  (A pseudo-tag is a parameter that is used
       to control the operation of the  TIFF  library  but  whose
       value  is not read or written to the underlying file.) The
       file   must   have    been    previously    opened    with
       TIFFOpen(3TIFF).  The tag is identified by tag, one of the
       values defined in the include file tiff.h  (see  also  the
       table  below).  The  type and number of values returned is
       dependent on the  tag  being  requested.  The  programming
       interface  uses  a variable argument list as prescribed by
       the stdarg(3) interface. The returned values  should  only
       be interpreted if TIFFGetField returns 1.

       TIFFVGetField  is  functionally equivalent to TIFFGetField
       except that it takes a  pointer  to  a  variable  argument
       list.   TIFFVGetField is useful for layering interfaces on
       top of the functionality provided by TIFFGetField.

       TIFFGetFieldDefaulted and TIFFVGetFieldDefaulted are iden-
       tical  to TIFFGetField and TIFFVGetField, except that if a
       tag is not defined in the current directory and it  has  a
       default value, then the default value is returned.

       The  tags  understood  by  libtiff(3TIFF),  the  number of
       parameter values, and the types for  the  returned  values
       are  shown below. The data types are specified as in C and
       correspond to the types used  to  specify  tag  values  to
       TIFFSetField(3TIFF).   Remember  that TIFFGetField returns
       parameter values, so all the listed data types are  point-
       ers  to  storage where values should be returned.  Consult
       the TIFF specification (or  relevant  industry  specifica-
       tion) for information on the meaning of each tag and their
       possible values.

       Tag Name                        Count  Types             Notes
       TIFFTAG_ARTIST                  1      char**
       TIFFTAG_BADFAXLINES             1      uint32*
       TIFFTAG_BITSPERSAMPLE           1      uint16*
       TIFFTAG_CLEANFAXDATA            1      uint16*
       TIFFTAG_COLORMAP                3      uint16**          1<





Interix / SUA
Hosted at SUA Community for Interix, SUA and SFU
Interix / SUA