TIFFReadEncodedStrip(3TIFF)           TIFFReadEncodedStrip(3TIFF)



NAME
       TIFFReadEncodedStrip  -  read  and  decode a strip of data
       from an open TIFF file

SYNOPSIS
       #include 

       tsize_t TIFFReadEncodedStrip(TIFF  *tif,  tstrip_t  strip,
       tdata_t buf, tsize_t size)

DESCRIPTION
       Read  the  specified  strip  of  data and place up to size
       bytes of decompressed information in the  (user  supplied)
       data buffer.

NOTES
       The  value  of  strip is a ``raw strip number.''  That is,
       the caller must take into account whether or not the  data
       are  organized in separate planes (PlanarConfiguration=2).
       To read a full strip of data the data buffer should  typi-
       cally be at least as large as the number returned by TIFF-
       StripSize(3TIFF).  If the -1 passed in size parameter, the
       whole  strip  will  be  read.  You should be sure you have
       enough space allocated for the buffer.

       The library attempts to hide bit- and  byte-ordering  dif-
       ferences  between the image and the native machine by con-
       verting data to the native machine order.  Bit reversal is
       done  if  the  FillOrder  tag  is  opposite  to the native
       machine bit order. 16- and 32-bit  samples  are  automati-
       cally  byte-swapped  if  the  file was written with a byte
       order opposite to the native machine byte order,

RETURN VALUES
       The actual number of bytes of data that were placed in buf
       is  returned;  TIFFReadEncodedStrip returns -1 if an error
       was encountered.

DIAGNOSTICS
       All error messages are directed  to  the  TIFFError(3TIFF)
       routine.

SEE ALSO
       TIFFOpen(3TIFF),   TIFFReadRawStrip(3TIFF),  TIFFReadScan-
       line(3TIFF), libtiff(3TIFF)

       Libtiff   library   home   page:    http://www.remotesens-
       ing.org/libtiff/



libtiff                  October 15, 1TIFFReadEncodedStrip(3TIFF)