FM / man

/usr/share/doc/libtiff-devel/html/man

Name	Size	Mode	Actions
CMakeLists.txt	3435	0644	edit dl rm
fax2ps.1.html	6463	0644	edit dl rm
fax2tiff.1.html	15703	0644	edit dl rm
HtmlDoc.cmake	2147	0644	edit dl rm
index.html	3826	0644	edit dl rm
libtiff.3tiff.html	55646	0644	edit dl rm
pal2rgb.1.html	4522	0644	edit dl rm
ppm2tiff.1.html	3836	0644	edit dl rm
raw2tiff.1.html	11353	0644	edit dl rm
tiff2bw.1.html	3835	0644	edit dl rm
tiff2pdf.1.html	11566	0644	edit dl rm
tiff2ps.1.html	13490	0644	edit dl rm
tiff2rgba.1.html	4620	0644	edit dl rm
TIFFbuffer.3tiff.html	3668	0644	edit dl rm
TIFFClose.3tiff.html	2200	0644	edit dl rm
tiffcmp.1.html	3763	0644	edit dl rm
TIFFcodec.3tiff.html	3470	0644	edit dl rm
TIFFcolor.3tiff.html	18970	0644	edit dl rm
tiffcp.1.html	14246	0644	edit dl rm
tiffcrop.1.html	30269	0644	edit dl rm
TIFFDataWidth.3tiff.html	2268	0644	edit dl rm
TIFFDeferStrileArrayWriting.3tiff.html	4022	0644	edit dl rm
tiffdither.1.html	5324	0644	edit dl rm
tiffdump.1.html	3554	0644	edit dl rm
TIFFError.3tiff.html	3176	0644	edit dl rm
TIFFFieldDataType.3tiff.html	2184	0644	edit dl rm
TIFFFieldName.3tiff.html	2129	0644	edit dl rm
TIFFFieldPassCount.3tiff.html	2618	0644	edit dl rm
TIFFFieldReadCount.3tiff.html	2826	0644	edit dl rm
TIFFFieldTag.3tiff.html	2253	0644	edit dl rm
TIFFFieldWriteCount.3tiff.html	3150	0644	edit dl rm
TIFFFlush.3tiff.html	2901	0644	edit dl rm
TIFFGetField.3tiff.html	33650	0644	edit dl rm
tiffinfo.1.html	4186	0644	edit dl rm
tiffmedian.1.html	4669	0644	edit dl rm
TIFFmemory.3tiff.html	3306	0644	edit dl rm
TIFFOpen.3tiff.html	14772	0644	edit dl rm
TIFFOpenOptions.3tiff.html	7052	0644	edit dl rm
TIFFPrintDirectory.3tiff.html	4258	0644	edit dl rm
TIFFquery.3tiff.html	5098	0644	edit dl rm
TIFFReadDirectory.3tiff.html	7557	0644	edit dl rm
TIFFReadEncodedStrip.3tiff.html	3576	0644	edit dl rm
TIFFReadEncodedTile.3tiff.html	3516	0644	edit dl rm
TIFFReadRawStrip.3tiff.html	2862	0644	edit dl rm
TIFFReadRawTile.3tiff.html	2951	0644	edit dl rm
TIFFReadRGBAImage.3tiff.html	8618	0644	edit dl rm
TIFFReadRGBAStrip.3tiff.html	7258	0644	edit dl rm
TIFFReadRGBATile.3tiff.html	8048	0644	edit dl rm
TIFFReadScanline.3tiff.html	4500	0644	edit dl rm
TIFFReadTile.3tiff.html	3646	0644	edit dl rm
TIFFRGBAImage.3tiff.html	11629	0644	edit dl rm
tiffset.1.html	3630	0644	edit dl rm
TIFFSetDirectory.3tiff.html	3429	0644	edit dl rm
TIFFSetField.3tiff.html	31189	0644	edit dl rm
TIFFsize.3tiff.html	2469	0644	edit dl rm
tiffsplit.1.html	3125	0644	edit dl rm
TIFFStrileQuery.3tiff.html	4958	0644	edit dl rm
TIFFstrip.3tiff.html	4180	0644	edit dl rm
TIFFswab.3tiff.html	3239	0644	edit dl rm
TIFFtile.3tiff.html	4867	0644	edit dl rm
TIFFWarning.3tiff.html	3136	0644	edit dl rm
TIFFWriteDirectory.3tiff.html	6273	0644	edit dl rm
TIFFWriteEncodedStrip.3tiff.html	4424	0644	edit dl rm
TIFFWriteEncodedTile.3tiff.html	4215	0644	edit dl rm
TIFFWriteRawStrip.3tiff.html	3999	0644	edit dl rm
TIFFWriteRawTile.3tiff.html	3630	0644	edit dl rm
TIFFWriteScanline.3tiff.html	6819	0644	edit dl rm
TIFFWriteTile.3tiff.html	3170	0644	edit dl rm

Edit: /usr/share/doc/libtiff-devel/html/man/TIFFDeferStrileArrayWriting.3tiff.html (4022B)

<!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>

<p style="margin-left:11%; margin-top: 1em">TIFFDeferStrileArrayWriting
&minus; defer strile array writing</p>

<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>

<pre style="margin-left:15%; margin-top: 1em">#include &lt;tiffio.h&gt;</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&minus;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>

<p style="margin-left:11%; margin-top: 1em">This
functionality was introduced with libtiff 4.1.</p>

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

TIFFDEFERSTRILEARRAYWRITING

NAME
SYNOPSIS
DESCRIPTION
RETURNS
DIAGNOSTICS
NOTE
SEE ALSO
AUTHOR
COPYRIGHT

NAME

TIFFDeferStrileArrayWriting − defer strile array writing

SYNOPSIS

#include <tiffio.h>

int TIFFDeferStrileArrayWriting(TIFF *tif)
int TIFFForceStrileArrayWriting(TIFF *tif)

DESCRIPTION

TIFFDeferStrileArrayWriting() is an advanced writing function that must be used in a particular sequence, and generally together with TIFFForceStrileArrayWriting(), to achieve its intended effect. Their aim is to control when and where the StripOffsets / StripByteCounts or TileOffsets / TileByteCounts arrays are written into the file.

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.

More precisely, when TIFFWriteCheck() is called, the tag entries for those arrays will be written with type = count = offset = 0 as a temporary value.

Its effect is only valid for the current directory, and before TIFFWriteDirectory() is first called, and will be reset when changing directory.

The typical sequence of calls is:

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 */

RETURNS

1 in case of success, 0 otherwise.

DIAGNOSTICS

All error messages are directed to the TIFFErrorExtR() routine. Likewise, warning messages are directed to the TIFFWarningExtR() routine.

NOTE

This functionality was introduced with libtiff 4.1.

AUTHOR

LibTIFF contributors

COPYRIGHT

1988-2025, LibTIFF contributors