Current Directory: /usr/share/doc/libtiff-devel/html/man
Viewing File: /usr/share/doc/libtiff-devel/html/man/TIFFDeferStrileArrayWriting.3tiff.html
<!-- Creator : groff version 1.22.4 -->
<!-- CreationDate: Sun Nov 2 19:00:00 2025 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>TIFFDEFERSTRILEARRAYWRITING</title>
</head>
<body>
<h1 align="center">TIFFDEFERSTRILEARRAYWRITING</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#RETURNS">RETURNS</a><br>
<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
<a href="#NOTE">NOTE</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<a href="#AUTHOR">AUTHOR</a><br>
<a href="#COPYRIGHT">COPYRIGHT</a><br>
<hr>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">TIFFDeferStrileArrayWriting
− defer strile array writing</p>
<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>
<pre style="margin-left:15%; margin-top: 1em">#include <tiffio.h></pre>
<p style="margin-left:11%;"><b>int
TIFFDeferStrileArrayWriting(TIFF *tif) <br>
int TIFFForceStrileArrayWriting(TIFF *tif)</b></p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b><i>TIFFDeferStrileArrayWriting()</i></b>
is an advanced writing function that must be used in a
particular sequence, and generally together with
<i>TIFFForceStrileArrayWriting()</i>, to achieve its
intended effect. Their aim is to control when and where the
<b>StripOffsets</b> / <b>StripByteCounts</b> or
<b>TileOffsets</b> / <b>TileByteCounts</b> arrays are
written into the file.</p>
<p style="margin-left:11%; margin-top: 1em">The purpose of
this is to generate 'cloud−optimized geotiff' files
where the first KB of the file only contain the IFD entries
without the potentially large strile arrays. Those are
written afterwards.</p>
<p style="margin-left:11%; margin-top: 1em">More precisely,
when TIFFWriteCheck() is called, the tag entries for those
arrays will be written with type = count = offset = 0 as a
temporary value.</p>
<p style="margin-left:11%; margin-top: 1em">Its effect is
only valid for the current directory, and before
TIFFWriteDirectory() is first called, and will be reset when
changing directory.</p>
<p style="margin-left:11%; margin-top: 1em">The typical
sequence of calls is:</p>
<pre style="margin-left:15%; margin-top: 1em">TIFFOpen()
/* or TIFFCreateDirectory(tif) */
/* Set fields with calls to TIFFSetField(tif, ...) */
TIFFDeferStrileArrayWriting(tif)
TIFFWriteCheck(tif, ...)
TIFFWriteDirectory(tif)
/* ... potentially create other directories and come back to the above directory */
TIFFForceStrileArrayWriting(tif) /* emit the arrays at the end of file */</pre>
<h2>RETURNS
<a name="RETURNS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">1 in case of
success, 0 otherwise.</p>
<h2>DIAGNOSTICS
<a name="DIAGNOSTICS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">All error
messages are directed to the TIFFErrorExtR() routine.
Likewise, warning messages are directed to the
TIFFWarningExtR() routine.</p>
<h2>NOTE
<a name="NOTE"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">This
functionality was introduced with libtiff 4.1.</p>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><i>libtiff</i>
(3tiff)</p>
<h2>AUTHOR
<a name="AUTHOR"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">LibTIFF
contributors</p>
<h2>COPYRIGHT
<a name="COPYRIGHT"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">1988-2025,
LibTIFF contributors</p>
<hr>
</body>
</html>