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/TIFFOpenOptions.3tiff.html (7052B)

<!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>TIFFOPENOPTIONS</title>

</head>
<body>

<h1 align="center">TIFFOPENOPTIONS</h1>

<a href="#NAME">NAME</a> 
<a href="#SYNOPSIS">SYNOPSIS</a> 
<a href="#DESCRIPTION">DESCRIPTION</a> 
<a href="#EXAMPLE">EXAMPLE</a> 
<a href="#NOTE">NOTE</a> 
<a href="#SEE ALSO">SEE ALSO</a> 
<a href="#AUTHOR">AUTHOR</a> 
<a href="#COPYRIGHT">COPYRIGHT</a>

<hr>

TIFFOpenOptions
&minus; open a TIFF file for reading or writing

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

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

typedef
TIFFOpenOptions TIFFOpenOptions 
TIFFOpenOptions *TIFFOpenOptionsAlloc(void) 
void TIFFOpenOptionsFree(TIFFOpenOptions*)
 
void
TIFFOpenOptionsSetMaxSingleMemAlloc(TIFFOpenOptions
*opts, 
tmsize_t max_single_mem_alloc) 
void
TIFFOpenOptionsSetMaxCumulatedMemAlloc(TIFFOpenOptions
*opts, 
tmsize_t max_cumulated_mem_alloc) 
void
TIFFOpenOptionsSetErrorHandlerExtR(TIFFOpenOptions
*opts, - 
TIFFErrorHandlerExtR handler, void
*errorhandler_user_data) 
void
TIFFOpenOptionsSetWarningHandlerExtR(TIFFOpenOptions
*opts, - 
TIFFErrorHandlerExtR handler, void
*warnhandler_user_data) 
void
TIFFOpenOptionsSetWarnAboutUnknownTags(TIFFOpenOptions
*opts, int 
warn_about_unknown_tags)

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

TIFFOpenOptions
is an opaque structure which can be passed to the TIFF
open&quot;Ext&quot; functions to define some libtiff
internal settings. The settings are the maximum single
memory allocation limit and per&minus;TIFF handle
(re&minus;entrant) error handler and warning handler
functions. For those handler a pointer to a custom
defined data structure user_data can be given
along.

TIFFOpenOptionsAlloc()
allocates memory for the TIFFOpenOptions opaque
structure and returns a TIFFOpenOptions pointer.

TIFFOpenOptionsFree()
releases the allocated memory for TIFFOpenOptions.
The allocated memory for TIFFOpenOptions can be
released straight after successful execution of the related
TIFFOpen&quot;Ext&quot; functions like
TIFFOpenExt().

TIFFOpenOptionsSetMaxSingleMemAlloc()
(added in libtiff 4.5.0) sets the value for the maximum
single memory limit in byte that libtiff internal
memory allocation functions are allowed to request per
call.

NOTE:

However, the libtiff
external functions _TIFFmalloc() and -
_TIFFrealloc() do not apply this internal
memory allocation limit set by
TIFFOpenOptionsSetMaxSingleMemAlloc()!

TIFFOpenOptionsSetMaxCumulatedMemAlloc()
(added in libtiff 4.6.1) sets the maximum cumulated memory
allocations in byte, for a given TIFF handle, that
libtiff internal memory allocation functions are
allowed.

NOTE:

TIFFOpenOptionsSetErrorHandlerExtR()
sets the function pointer to an application&minus;specific
and per&minus;TIFF handle (re&minus;entrant) error handler.
Furthermore, a pointer to a custom defined data
structure errorhandler_user_data can be passed.
This error handler is invoked through TIFFErrorExtR()
and the errorhandler_user_data pointer is given
along. The errorhandler_user_data argument may be
NULL.

TIFFOpenOptionsSetWarningHandlerExtR()
works like TIFFOpenOptionsSetErrorHandlerExtR() but
for the warning handler, which is invoked through
TIFFWarningExtR()

TIFFOpenOptionsSetWarnAboutUnknownTags()
sets whether libtiff should emit a warning when encountering
a unknown tag. This function has been added in libtiff 4.7.1
and the default value is FALSE (change of behaviour compared
to earlier versions).

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

<pre style="margin-left:15%; margin-top: 1em">#include &quot;tiffio.h&quot;

typedef struct MyErrorHandlerUserDataStruct
{
    /* ... any user data structure ... */
} MyErrorHandlerUserDataStruct;

static int myErrorHandler(TIFF *tiff, void *user_data, const char *module,
                      const char *fmt, va_list ap)
{
    MyErrorHandlerUserDataStruct *errorhandler_user_data =
        (MyErrorHandlerUserDataStruct *)user_data;
    /*... code of myErrorHandler ...*/
    return 1;
}

main()
{
    tmsize_t limit = (256 * 1024 * 1024);
    MyErrorHandlerUserDataStruct user_data = { /* ... any data ... */};

TIFFOpenOptions *opts = TIFFOpenOptionsAlloc();
    TIFFOpenOptionsSetMaxSingleMemAlloc(opts, limit);
    TIFFOpenOptionsSetErrorHandlerExtR(opts, myErrorHandler, &amp;user_data);
    TIFF *tif = TIFFOpenExt(&quot;foo.tif&quot;, &quot;r&quot;, opts);
    TIFFOpenOptionsFree(opts);
    /* ... go on here ... */

TIFFClose(tif);
}</pre>

This
functionality was introduced with libtiff 4.5.

libtiff
(3tiff), TIFFOpen (3tiff), TIFFError (3tiff),
TIFFWarning (3tiff)

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

LibTIFF
contributors

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

1988-2025,
LibTIFF contributors
<hr>
</body>
</html>

cmd: