TIFFSetField(3tiff) Introduction to Library Functions TIFFSetField(3tiff)
NAME
TIFFSetField, TIFFVSetField - set the value(s) of a tag in a TIFF file open for writing
SYNOPSIS
#include <tiffio.h>
int TIFFSetField(TIFF* tif, ttag_t tag, ...)
#include <stdarg.h>
int TIFFVSetField(TIFF* tif, ttag_t tag, va_list ap)
DESCRIPTION
TIFFSetField sets the value of a field or pseudo-tag in the current directory associated with the open TIFF file. A pseudo-tag is a parame-
ter that is used to control the operation of the TIFF 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 TIFFOpen(3tiff). Pseudo-tags can be set whether the
file was opened for reading or writing.
The field is identified by tag, one of the values defined in the include file tiff.h (see also the table below). The actual value is speci-
fied using a variable argument list as prescribed by the stdarg(3) interface, or, on some machines, the varargs(3) interface.
EXTENDED DESCRIPTION
TIFFVSetField is functionally equivalent to TIFFSetField except that TIFFVSetField takes a pointer to a variable argument list. TIFFVSet-
Field is useful for writing routines that are layered on top of the functionality provided by TIFFSetField.
The tags understood by libtiff, the number of parameter values, and the expected types for the parameter values are shown below. The data
types are as follows:
char*
Null-terminated string, corresponds to the ASCII data type
uint16
Unsigned 16-bit value
uint32
Unsigned 32-bit value
uint16*
Array of unsigned 16-bit values
void*
Array of data values of unspecified type
Consult the TIFF specification for information on the meaning of each tag.
+-------------------------------+----------------+-----------------+------------------------------+
|TAG NAME | COUNT | TYPES | NOTES |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_ARTIST | 1 | char* | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_BADFAXLINES | 1 | uint32 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_BITSPERSAMPLE | 1 | uint16 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_CLEANFAXDATA | 1 | uint16 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_COLORMAP | 3 | uint16* | 1<<BitsPerSample arrays |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_COMPRESSION | 1 | uint16 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_CONSECUTIVEBADFAXLINES | 1 | uint32 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_DATETIME | 1 | char* | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_DOCUMENTNAME | 1 | char* | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_DOTRANGE | 2 | uint16 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_EXTRASAMPLES | 2 | uint16,uint16* | -- count and types array |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_FAXMODE | 1 | int | -- G3/G4 compression pseudo- |
| | | | tag |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_FAXFILLFUNC | 1 | TIFFFaxFillFunc | G3/G4 compression pseudo-tag |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_FILLORDER | 1 | uint16 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_GROUP3OPTIONS | 1 | uint32 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_GROUP4OPTIONS | 1 | uint32 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_HALFTONEHINTS | 2 | uint16 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_HOSTCOMPUTER | 1 | char* | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_IMAGEDEPTH | 1 | uint32 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_IMAGEDESCRIPTION | 1 | char* | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_IMAGELENGTH | 1 | uint32 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_IMAGEWIDTH | 1 | uint32 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_INKNAMES | 1 | char* | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_INKSET | 1 | uint16 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_JPEGTABLES | 2 | uint32*,void* | -- count and tables |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_JPEGQUALITY | 1 | int | JPEG pseudo-tag |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_JPEGCOLORMODE | 1 | int | -- JPEG pseudo-tag |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_JPEGTABLESMODE | 1 | int | -- JPEG pseudo-tag |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_MAKE | 1 | char* | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_MATTEING | 1 | uint16 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_MAXSAMPLEVALUE | 1 | uint16 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_MINSAMPLEVALUE | 1 | uint16 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_MODEL | 1 | char* | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_ORIENTATION | 1 | uint16 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_PAGENAME | 1 | char* | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_PAGENUMBER | 2 | uint16 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_PHOTOMETRIC | 1 | uint16 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_PLANARCONFIG | 1 | uint16 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_PREDICTOR | 1 | uint16 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_PRIMARYCHROMACITIES | 1 | float* | 6-entry array |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_REFERENCEBLACKWHITE | 1 | float* | - 2*SamplesPerPixel array |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_RESOLUTIONUNIT | 1 | uint16 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_ROWSPERSTRIP | 1 | uint32 | -- must be greater than 0 |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_SAMPLEFORMAT | 1 | uint16 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_SAMPLESPERPIXEL | 1 | uint16 | -- value must be <= 4 |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_SMAXSAMPLEVALUE | 1 | double | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_SMINSAMPLEVALUE | 1 | double | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_SOFTWARE | 1 | char* | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_STONITS | 1 | double | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_SUBFILETYPE | 1 | uint32 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_SUBIFD | 2 | uint16,uint32* | count and offsets array |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_TARGETPRINTER | 1 | char* | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_THRESHOLDING | 1 | uint16 | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_TILEDEPTH | 1 | uint32 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_TILELENGTH | 1 | uint32 | -- must be a multiple of 8 |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_TILEWIDTH | 1 | uint32 | -- must be a multiple of 8 |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_TRANSFERFUNCTION | 1 or 3= | uint16* | 1<<BitsPerSample entry |
| | | | arrays |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_WHITEPOINT | 1 | float* | 2-entry array |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_XPOSITION | 1 | float | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_XRESOLUTION | 1 | float | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_YCBCRCOEFFICIENTS | 1 | float* | - 3-entry array |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_YCBCRPOSITIONING | 1 | uint16 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_YCBCRSUBSAMPLING | 2 | uint16 | -- |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_YPOSITION | 1 | float | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_YRESOLUTION | 1 | float | |
+-------------------------------+----------------+-----------------+------------------------------+
|TIFFTAG_ICCPROFILE | 2 | uint32,void* | count, profile data+ |
+-------------------------------+----------------+-----------------+------------------------------+
- Tag may not have its values changed once data is written.
= If SamplesPerPixel is 1, then a single array is passed. Otherwise, three arrays should be passed.
+ The contents of this field are quite complex. See The ICC Profile Format Specification, Annex B "Embedding ICC Pro-
files in TIFF Files", available at http://www.color.org, for an explanation.
Diagnostics
All error messages are directed to the TIFFError(3tiff) routine.
%s: Cannot modify tag "%Datahihaswralready been written to the file, so the specified tag value cannot be changed. This restriction is
applied to all tags that affect the format of written data.
%d: Bad value for "%s". An invalid value was supplied for the named tag.
RETURN VALUES
1 is returned if the tag is defined in the current directory. Otherwise, 0 is returned.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWTiff |
+-----------------------------+-----------------------------+
|Interface stability |External |
+-----------------------------+-----------------------------+
SEE ALSO
libtiff(3), TIFFOpen(3tiff), TIFFGetField(3tiff), TIFFSetDirectory(3tiff), TIFFReadDirectory(3tiff), TIFFWriteDirectory(3tiff)
NOTES
This man page was originally written by Sam Leffler. Updated by Breda McColgan, Sun Microsystems Inc., 2004.
SunOS 5.10 05 Apr 2004 TIFFSetField(3tiff)