1314 lines
20 KiB
HTML
1314 lines
20 KiB
HTML
<html>
|
|
<head>
|
|
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
|
<meta name="Content-Style" content="text/css">
|
|
<title>TIFFSetField</title>
|
|
</head>
|
|
<body>
|
|
|
|
<h1 align=center>TIFFSetField</h1>
|
|
<a href="#NAME">NAME</a><br>
|
|
<a href="#SYNOPSIS">SYNOPSIS</a><br>
|
|
<a href="#DESCRIPTION">DESCRIPTION</a><br>
|
|
<a href="#RETURN VALUES">RETURN VALUES</a><br>
|
|
<a href="#RETURN VALUES">RETURN VALUES</a><br>
|
|
<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
|
|
<a href="#SEE ALSO">SEE ALSO</a><br>
|
|
|
|
<hr>
|
|
<!-- Creator : groff version 1.18 -->
|
|
<!-- CreationDate: Mon Oct 7 17:36:23 2002 -->
|
|
<a name="NAME"></a>
|
|
<h2>NAME</h2>
|
|
<!-- INDENTATION -->
|
|
<p><table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>TIFFSetField − set the value(s) of a tag in a
|
|
<small>TIFF</small> file open for writing</p>
|
|
</td>
|
|
</table></p>
|
|
<a name="SYNOPSIS"></a>
|
|
<h2>SYNOPSIS</h2>
|
|
<!-- INDENTATION -->
|
|
<p><table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p><b>#include <tiffio.h><br>
|
|
int TIFFSetField(TIFF* tif, ttag_t tag, ...)<br>
|
|
#include <stdarg.h><br>
|
|
int TIFFVSetField(TIFF* tif, ttag_t tag, va_list ap)</b></p>
|
|
</td>
|
|
</table></p>
|
|
<a name="DESCRIPTION"></a>
|
|
<h2>DESCRIPTION</h2>
|
|
<!-- INDENTATION -->
|
|
<p><table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p><i>TIFFSetField</i> sets the value of a field or
|
|
pseudo-tag in the current directory associated with the open
|
|
<small>TIFF</small> file <i>tif</i>. (A <i>pseudo-tag</i> is
|
|
a parameter that is used to control the operation of the
|
|
<small>TIFF</small> library but whose value is not read or
|
|
written to the underlying file.) To set the value of a field
|
|
the file must have been previously opened for writing with
|
|
<i>TIFFOpen</i>(3T); pseudo-tags can be set whether the file
|
|
was opened for reading or writing. The field is identified
|
|
by <i>tag</i>, one of the values defined in the include file
|
|
<b>tiff.h</b> (see also the table below). The actual value
|
|
is specified using a variable argument list, as prescribed
|
|
by the <i>stdarg</i>(3) interface (or, on some machines, the
|
|
<i>varargs</i>(3) interface.)</p>
|
|
<!-- INDENTATION -->
|
|
<p><i>TIFFVSetField</i> is functionally equivalent to
|
|
<i>TIFFSetField</i> except that it takes a pointer to a
|
|
variable argument list. <i>TIFFVSetField</i> is useful for
|
|
writing routines that are layered on top of the
|
|
functionality provided by <i>TIFFSetField</i>.</p>
|
|
<!-- INDENTATION -->
|
|
<p>The tags understood by <i>libtiff</i>, the number of
|
|
parameter values, and the expected types for the parameter
|
|
values are shown below. The data types are: <i>char*</i> is
|
|
null-terminated string and corresponds to the
|
|
<small>ASCII</small> data type; <i>uint16</i> is an unsigned
|
|
16-bit value; <i>uint32</i> is an unsigned 32-bit value;
|
|
<i>uint16*</i> is an array of unsigned 16-bit values.
|
|
<i>void*</i> is an array of data values of unspecified
|
|
type.</p>
|
|
<!-- INDENTATION -->
|
|
<p>Consult the <small>TIFF</small> specification for
|
|
information on the meaning of each tag.</p></td>
|
|
</table></p>
|
|
<!-- TABS -->
|
|
|
|
<p><i>Tag Name Count Types Notes</i></p>
|
|
<!-- TABS -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="5" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_ARTIST</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_BADFAXLINES</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_BITSPERSAMPLE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_CLEANFAXDATA</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_COLORMAP</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>3</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16*</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>1<<BitsPerSample arrays</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_COMPRESSION</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_CONSECUTIVEBADFAXLINES</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_COPYRIGHT</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_DATETIME</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_DOCUMENTNAME</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_DOTRANGE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>2</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_EXTRASAMPLES</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>2</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16,uint16*</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>† count & types array</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_FAXMODE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>int</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>† G3/G4 compression pseudo-tag</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_FAXFILLFUNC</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>TIFFFaxFillFunc</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>G3/G4 compression pseudo-tag</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_FILLORDER</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_GROUP3OPTIONS</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_GROUP4OPTIONS</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_HALFTONEHINTS</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>2</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_HOSTCOMPUTER</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_IMAGEDESCRIPTION</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_IMAGEDEPTH</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_IMAGELENGTH</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_IMAGEWIDTH</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_INKNAMES</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_INKSET</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_JPEGTABLES</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>2</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32*,void*</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>† count & tables</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_JPEGQUALITY</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>int</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>JPEG pseudo-tag</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_JPEGCOLORMODE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>int</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>† JPEG pseudo-tag</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_JPEGTABLESMODE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>int</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>† JPEG pseudo-tag</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_MAKE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_MATTEING</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_MAXSAMPLEVALUE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_MINSAMPLEVALUE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_MODEL</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_ORIENTATION</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_PAGENAME</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_PAGENUMBER</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>2</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_PHOTOMETRIC</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_PLANARCONFIG</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_PREDICTOR</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_PRIMARYCHROMATICITIES</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>float*</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>6-entry array</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_REFERENCEBLACKWHITE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>float*</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>† 2*SamplesPerPixel array</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_RESOLUTIONUNIT</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_ROWSPERSTRIP</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>† must be > 0</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_SAMPLEFORMAT</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_SAMPLESPERPIXEL</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>† value must be <= 4</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_SMAXSAMPLEVALUE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>double</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_SMINSAMPLEVALUE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>double</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_SOFTWARE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_STONITS</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>double</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_SUBFILETYPE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_SUBIFD</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>2</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16,uint32*</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>count & offsets array</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_TARGETPRINTER</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>char*</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_THRESHHOLDING</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_TILEDEPTH</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_TILELENGTH</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>† must be a multiple of 8</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_TILEWIDTH</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>† must be a multiple of 8</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_TRANSFERFUNCTION</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1 or 3‡ uint16*</p>
|
|
</td>
|
|
<td width="24%"></td>
|
|
<td width="16%">
|
|
|
|
<p>1<<BitsPerSample entry arrays</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_XPOSITION</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>float</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_XRESOLUTION</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>float</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_WHITEPOINT</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>float*</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>2-entry array</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_YCBCRCOEFFICIENTS</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>float*</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>† 3-entry array</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_YCBCRPOSITIONING</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_YCBCRSAMPLING</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>2</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint16</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>†</p>
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_YPOSITION</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>float</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_YRESOLUTION</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>1</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>float</p>
|
|
</td>
|
|
<td width="16%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="41%">
|
|
|
|
<p>TIFFTAG_ICCPROFILE</p>
|
|
</td>
|
|
<td width="8%">
|
|
|
|
<p>2</p>
|
|
</td>
|
|
<td width="24%">
|
|
|
|
<p>uint32,void*</p>
|
|
</td>
|
|
<td width="16%">
|
|
|
|
<p>count, profile data*</p>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<p><table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>† Tag may not have its values changed once data is
|
|
written.<br>
|
|
‡ If <i>SamplesPerPixel</i> is one, then a single
|
|
array is passed; otherwise three arrays should be
|
|
passed.<br>
|
|
* The contents of this field are quite complex. See <i>The
|
|
ICC Profile Format Specification</i>, Annex B.3
|
|
"Embedding ICC Profiles in TIFF Files" (available
|
|
at http://www.color.org) for an explanation.</p>
|
|
</td>
|
|
</table></p>
|
|
<a name="RETURN VALUES"></a>
|
|
<h2>RETURN VALUES</h2>
|
|
<!-- INDENTATION -->
|
|
<p><table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>1 is returned if the tag is defined in the current
|
|
directory; otherwise a 0 is returned.</p>
|
|
</td>
|
|
</table></p>
|
|
<a name="RETURN VALUES"></a>
|
|
<h2>RETURN VALUES</h2>
|
|
<!-- INDENTATION -->
|
|
<p><table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>1 is returned if the operation was successful. Otherwise,
|
|
0 is returned if an error was detected.</p>
|
|
</td>
|
|
</table></p>
|
|
<a name="DIAGNOSTICS"></a>
|
|
<h2>DIAGNOSTICS</h2>
|
|
<!-- INDENTATION -->
|
|
<p><table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>All error messages are directed to the
|
|
<i>TIFFError</i>(3T) routine.</p>
|
|
<!-- INDENTATION -->
|
|
<p><b>%s: Cannot modify tag "%s" while
|
|
writing</b>. Data has already been written to the file, so
|
|
the specified tag’s value can not be changed. This
|
|
restriction is applied to all tags that affect the format of
|
|
written data.</p>
|
|
<!-- INDENTATION -->
|
|
<p><b>%d: Bad value for "%s"</b>. An invalid value
|
|
was supplied for the named tag.</p>
|
|
</td>
|
|
</table></p>
|
|
<a name="SEE ALSO"></a>
|
|
<h2>SEE ALSO</h2>
|
|
<!-- INDENTATION -->
|
|
<p><table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p><i>libtiff</i>(3T), <i>TIFFOpen</i>(3T),
|
|
<i>TIFFGetField</i>(3T), <i>TIFFSetDirectory</i>(3T),
|
|
<i>TIFFWriteDirectory</i>(3T),
|
|
<i>TIFFReadDirectory</i>(3T)</p>
|
|
</td>
|
|
</table></p>
|
|
<hr>
|
|
</body>
|
|
</html>
|