<meta content="groff -Thtml, see www.gnu.org" name="generator">

<meta content="text/css" name="Content-Style">

<title>TIFFWriteEncodedStrip</title>

TIFFWriteEncodedStrip

NAME

SYNOPSIS

DESCRIPTION

NOTES

RETURN VALUES

DIAGNOSTICS

SEE ALSO

NAME

       cols="2" cellspacing="0" cellpadding="0">

<big>TIFFWritedEncodedStrip − compress and write a</big>

strip of data to an open TIFF <big>file</big>

SYNOPSIS

       cols="2" cellspacing="0" cellpadding="0">

<big>#include <tiffio.h></big>

<big>tsize_t TIFFWriteEncodedStrip(TIFF</big>

*tif, tstrip_t strip,

tdata_t buf, tsize_t

size)

DESCRIPTION

       cols="2" cellspacing="0" cellpadding="0">

<big>Compress size bytes of raw data from</big>

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).

NOTES

       cols="2" cellspacing="0" cellpadding="0">

<big>The library writes encoded data using the native</big>

machine byte order. Correctly implemented TIFF

<big>readers are expected to do any necessary byte-swapping</big>

to correctly process image data with BitsPerSample greater

than 8.

<big>The strip number must be valid according to the</big>

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

       cols="2" cellspacing="0" cellpadding="0">

<big>−1 is returned if an error was encountered.</big>

Otherwise, the value of size is returned.

DIAGNOSTICS

       cols="2" cellspacing="0" cellpadding="0">

<big>All error messages are directed to the</big>

TIFFError(3TIFF) routine.

<big>%s: File not open for writing. The file was</big>

opened for reading, not writing.

<big>Can not write scanlines to a tiled image. The</big>

image is assumed to be organized in tiles because the

TileWidth and TileLength tags have been set

with TIFFSetField(3TIFF).

<big>%s: Must set "ImageWidth" before</big>

writing data. The image’s width has not be set

before the first write. See TIFFSetField(3TIFF) for

information on how to do this.

<big>%s: Must set "PlanarConfiguration"</big>

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.

<big>%s: No space for strip arrays". There</big>

was not enough space for the arrays that hold strip offsets

and byte counts.

SEE ALSO

       cols="2" cellspacing="0" cellpadding="0">

<big>TIFFOpen(3TIFF),</big>

TIFFWriteScanline(3TIFF),

TIFFWriteRawStrip(3TIFF),

libtiff(3TIFF)

<big>Libtiff library home page:</big>

http://www.remotesensing.org/libtiff/