Initial import
git-svn-id: http://moon:8086/svn/software/trunk/libsrc/libtiff_2007@1 b431acfa-c32f-4a4a-93f1-934dc6c82436
This commit is contained in:
Executable
+269
@@ -0,0 +1,269 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of TIFFSetField</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>TIFFSetField</H1>
|
||||
Section: Misc. Reference Manual Pages (3T)<BR>Updated: August 28, 1997<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
TIFFSetField - set the value(s) of a tag in a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file open for writing
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFSetField(TIFF* tif, ttag_t tag, ...)</B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>#include <<A HREF="file:/usr/include/stdarg.h">stdarg.h</A>></B>
|
||||
|
||||
<BR>
|
||||
|
||||
<B>int TIFFVSetField(TIFF* tif, ttag_t tag, va_list ap)</B>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>TIFFSetField</I>
|
||||
|
||||
sets the value of a field
|
||||
or pseudo-tag in the current directory associated with
|
||||
the open
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file
|
||||
<I>tif</I>.
|
||||
|
||||
(A
|
||||
<I>pseudo-tag </I>
|
||||
|
||||
is a parameter that is used to control the operation of the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
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><A HREF="TIFFOpen.3t.html">TIFFOpen</A></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><A HREF="stdarg+3">stdarg</A></I>(3)
|
||||
|
||||
interface (or, on some machines, the
|
||||
<I><A HREF="varargs+3">varargs</A></I>(3)
|
||||
|
||||
interface.)
|
||||
<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>
|
||||
|
||||
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
|
||||
<FONT SIZE="-1">ASCII</FONT>
|
||||
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>
|
||||
Consult the
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
specification for information on the meaning of each tag.
|
||||
<P>
|
||||
|
||||
<PRE>
|
||||
|
||||
<I>Tag Name</I> <I>Count</I> <I>Types</I> <I>Notes</I>
|
||||
|
||||
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 & 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_IMAGEDESCRIPTION 1 char*
|
||||
TIFFTAG_IMAGEDEPTH 1 uint32 +
|
||||
TIFFTAG_IMAGELENGTH 1 uint32
|
||||
TIFFTAG_IMAGEWIDTH 1 uint32 +
|
||||
TIFFTAG_INKNAMES 1 char*
|
||||
TIFFTAG_INKSET 1 uint16 +
|
||||
TIFFTAG_JPEGTABLES 2 uint32*,void* + count & 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_PRIMARYCHROMATICITIES 1 float* 6-entry array
|
||||
TIFFTAG_REFERENCEBLACKWHITE 1 float* + 2*SamplesPerPixel array
|
||||
TIFFTAG_RESOLUTIONUNIT 1 uint16
|
||||
TIFFTAG_ROWSPERSTRIP 1 uint32 + must be > 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 & offsets array
|
||||
TIFFTAG_TARGETPRINTER 1 char*
|
||||
TIFFTAG_THRESHHOLDING 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 dd uint16*1<<BitsPerSample entry arrays
|
||||
TIFFTAG_XPOSITION 1 float
|
||||
TIFFTAG_XRESOLUTION 1 float
|
||||
TIFFTAG_WHITEPOINT 1 float* 2-entry array
|
||||
TIFFTAG_YCBCRCOEFFICIENTS 1 float* + 3-entry array
|
||||
TIFFTAG_YCBCRPOSITIONING 1 uint16 +
|
||||
TIFFTAG_YCBCRSAMPLING 2 uint16 +
|
||||
TIFFTAG_YPOSITION 1 float
|
||||
TIFFTAG_YRESOLUTION 1 float
|
||||
TIFFTAG_ICCPROFILE 2 uint32,void* count, profile data*
|
||||
</PRE>
|
||||
|
||||
<P>
|
||||
+ Tag may not have its values changed once data is written.
|
||||
<BR>
|
||||
|
||||
|
||||
dd
|
||||
If
|
||||
<I>SamplesPerPixel</I>
|
||||
|
||||
is one, then a single array is passed; otherwise three arrays should be
|
||||
passed.
|
||||
|
||||
* 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 <A HREF="http://www.color.org)">http://www.color.org)</A> for an explanation.
|
||||
<BR>
|
||||
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
1 is returned if the tag is defined in the current
|
||||
directory; otherwise a 0 is returned.
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>RETURN VALUES</H2>
|
||||
|
||||
1 is returned if the operation was successful.
|
||||
Otherwise, 0 is returned if an error was detected.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
All error messages are directed to the
|
||||
<I><A HREF="TIFFError.3t.html">TIFFError</A></I>(3T)
|
||||
|
||||
routine.
|
||||
<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>
|
||||
|
||||
<B>%d: Bad value for "%s"</B>.
|
||||
An invalid value was supplied for the named tag.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I><A HREF="libtiff.3t.html">libtiff</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFOpen.3t.html">TIFFOpen</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFGetField.3t.html">TIFFGetField</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFSetDirectory.3t.html">TIFFSetDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFWriteDirectory.3t.html">TIFFWriteDirectory</A></I>(3T),
|
||||
|
||||
<I><A HREF="TIFFReadDirectory.3t.html">TIFFReadDirectory</A></I>(3T)
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
|
||||
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:38 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Reference in New Issue
Block a user