DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

TIFFWriteEncodedStrip(3T)





TIFFWriteEncodedStrip(3TIFFMISC. REFERENCE MANUAL PAGETIFFWriteEncodedStrip(3TIFF)



NAME

     TIFFWritedEncodedStrip - compress and write a strip of  data
     to an open TIFF file


SYNOPSIS

     #include <tiffio.h>

     tsize_t  TIFFWriteEncodedStrip(TIFF  *tif,  tstrip_t  strip,
     tdata_t buf


DESCRIPTION

     Compress size bytes of raw  data  from  buf  and  write  the
     result  to  the  specified  strip;  replacing any previously
     written data. Note that 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 (PlanarCon-
     figuration=2).


NOTES

     The library writes encoded data  using  the  native  machine
     byte  order. Correctly implemented TIFF readers are expected
     to do any necessary byte-swapping to correctly process image
     data with BitsPerSample greater than 8.

     The strip number must be valid according to the current set-
     tings  of  the  ImageLength and RowsPerStrip tags.  An image
     may  be  dynamically  grown  by  increasing  the  value   of
     ImageLength prior to each call to TIFFWriteEncodedStrip.


RETURN VALUES

     -1 is returned if an error was encountered.  Otherwise,  the
     value of size is returned.


DIAGNOSTICS

     All error messages are directed to the TIFFError(3TIFF) rou-
     tine.

     %s: File not open for writing. The file was opened for read-
     ing, not writing.

     Can not write scanlines to  a  tiled  image.  The  image  is
     assumed  to  be organized in tiles because the TileWidth and
     TileLength tags have been set with TIFFSetField(3TIFF).

     %s: Must set "ImageWidth" before writing data.  The  image's
     width   has   not   be  set  before  the  first  write.  See
     TIFFSetField(3TIFF) for information on how to do this.

     %s: Must set "PlanarConfiguration" before writing data.  The
     organization  of  data  has  not be defined before the first
     write. See TIFFSetField(3TIFF) for information on how to  do
     this.

libtiff           Last change: October 15, 1995                 1


TIFFWriteEncodedStrip(3TIFFMISC. REFERENCE MANUAL PAGETIFFWriteEncodedStrip(3TIFF)


     %s: No space for strip arrays".  There was not enough  space
     for the arrays that hold strip offsets and byte counts.


SEE ALSO

     libtiff(3TIFF),  TIFFOpen(3TIFF),  TIFFWriteScanline(3TIFF),
     TIFFWriteRawStrip(3TIFF)

libtiff           Last change: October 15, 1995                 2


Man(1) output converted with man2html