TIFFWriteEncodedStrip - compress and write a strip of data to an open TIFF file
Contents
Copyright
1988-2022, LibTIFF contributors
4.7 Apr 30, 2025 TIFFWRITEENCODEDSTRIP(3tiff)
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 (PlanarConfiguration = 2).
Diagnostics
All error messages are directed to the TIFFErrorExtR() routine.
%s:Filenotopenforwriting:
The file was opened for reading, not writing.
Cannotwritescanlinestoatiledimage:
The image is assumed to be organized in tiles because the TileWidth and TileLength tags have been set
with TIFFSetField().
%s:Mustset"ImageWidth"beforewritingdata\fP:
The image's width has not be set before the first write. See TIFFSetField() for information on how to
do this.
%s:Mustset"PlanarConfiguration"beforewritingdata:
The organization of data has not be defined before the first write. See TIFFSetField() for information
on how to do this.
%s:Nospaceforstriparrays":
There was not enough space for the arrays that hold strip offsets and byte counts.
Name
TIFFWriteEncodedStrip - compress and write a strip of data to an open TIFF file
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 settings 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.
See Also
TIFFOpen (3tiff), TIFFWriteScanline (3tiff), TIFFWriteRawStrip (3tiff), libtiff (3tiff)
Synopsis
#include <tiffio.h>
tsize_tTIFFWriteEncodedStrip(TIFF*tif,tstrip_tstrip,tdata_tbuf,tsize_tsize)