TIFFWriteEncodedTile(3T)

TIFFWriteEncodedTile(3TMISC. REFERENCE MANUAL PAGETIFFWriteEncodedTile(3T)

NAME

     TIFFWritedEncodedTile - compress and write a tile of data to
     an open TIFF file

SYNOPSIS

     #include <tiffio.h>
     tsize_t  TIFFWriteEncodedTile(TIFF*   tif,   ttile_t   tile,
     tdata_t buf, tsize_t size)

DESCRIPTION

     Compress size bytes of raw data  from  buf  and  append  the
     result  to  the  end  of  the specified tile.  Note that the
     value of tile is a ``raw tile number.''  That is, the caller
     must take into account whether or not the data are organized
     in separate places (PlanarConfiguration=2).  TIFFComputeTile
     automatically  does  this  when converting an (x,y,z,sample)
     coordinate quadruple to a tile number.

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.

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(3T)  rou-
     tine.

     %s: File not open for writing.   The  file  was  opened  for
     reading, not writing.

     Can not write tiles to  a  stripped  image.   The  image  is
     assumed  to  be  organized  in strips because neither of the
     TileWidth  or   TileLength   tags   have   been   set   with
     TIFFSetField(3T).

     %s: Must set "ImageWidth" before writing data.  The  image's
     width   has   not  be  set  before  the  first  write.   See
     TIFFSetField(3T) 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(3T) for information on  how  to  do
     this.

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

                 Last change: December 16, 1991                 1

TIFFWriteEncodedTile(3TMISC. REFERENCE MANUAL PAGETIFFWriteEncodedTile(3T)

SEE ALSO

     libtiff(3T),        TIFFOpen(3T),         TIFFWriteTile(3T),
     TIFFWriteRawTile(3T)

                 Last change: December 16, 1991                 2