TIFFWriteEncodedTile(3tiff)				 Introduction to Library Functions			       TIFFWriteEncodedTile(3tiff)

NAME

       TIFFWriteEncodedTile - 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 is organized in separate planes (PlanarConfiguration=2).  TIFF-
       ComputeTile automatically does this when converting an (x,y,z,sample) coordinate quadruple to a tile number.

EXTENDED DESCRIPTION

       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.

   Diagnostics
       All error messages are directed to the TIFFError(3tiff) routine.

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

       Can not write tiles to aTherimage isaassumed to be organized in strips because neither the TileWidth nor the TileLength tag  has  been  set
			       with TIFFSetField(3tiff).

       %s: Must set "ImageWidthTheeimagewwidthghastnot been set before the first write. See TIFFSetField(3tiff) for information on how to do this.

       %s: Must set "PlanarConfTheraorganization woftidataahas not been defined before the first write. See TIFFSetField(3tiff) for information on
			       how to do this.

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

RETURN VALUES

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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWTiff			   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |External			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

NOTES

       This man page was originally written by Sam Leffler. Updated by Breda McColgan, Sun Microsystems Inc., 2004.

SunOS 5.10							    05 Apr 2004 				       TIFFWriteEncodedTile(3tiff)