1<!-- Creator     : groff version 1.19.2 -->
2<!-- CreationDate: Mon Jan  2 17:41:45 2006 -->
3<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
4"http://www.w3.org/TR/html4/loose.dtd">
5<html>
6<head>
7<meta name="generator" content="groff -Thtml, see www.gnu.org">
8<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
9<meta name="Content-Style" content="text/css">
10<style type="text/css">
11       p     { margin-top: 0; margin-bottom: 0; }
12       pre   { margin-top: 0; margin-bottom: 0; }
13       table { margin-top: 0; margin-bottom: 0; }
14</style>
15<title>TIFFSetField</title>
16
17</head>
18<body>
19
20<h1 align=center>TIFFSetField</h1>
21
22<a href="#NAME">NAME</a><br>
23<a href="#SYNOPSIS">SYNOPSIS</a><br>
24<a href="#DESCRIPTION">DESCRIPTION</a><br>
25<a href="#RETURN VALUES">RETURN VALUES</a><br>
26<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
27<a href="#SEE ALSO">SEE ALSO</a><br>
28
29<hr>
30
31
32<a name="NAME"></a>
33<h2>NAME</h2>
34
35
36<p style="margin-left:11%; margin-top: 1em">TIFFSetField,
37TIFFVSetField &minus; set the value(s) of a tag in a
38<small>TIFF</small> file open for writing</p>
39
40<a name="SYNOPSIS"></a>
41<h2>SYNOPSIS</h2>
42
43
44<p style="margin-left:11%; margin-top: 1em"><b>#include
45&lt;tiffio.h&gt;</b></p>
46
47<p style="margin-left:11%; margin-top: 1em"><b>int
48TIFFSetField(TIFF *</b><i>tif</i><b>, ttag_t</b>
49<i>tag</i><b>,</b> <i>...</i><b>)</b></p>
50
51<p style="margin-left:11%; margin-top: 1em"><b>#include
52&lt;stdarg.h&gt;</b></p>
53
54<p style="margin-left:11%; margin-top: 1em"><b>int
55TIFFVSetField(TIFF *</b><i>tif</i><b>, ttag_t</b>
56<i>tag</i><b>, va_list</b> <i>ap</i><b>)</b></p>
57
58<a name="DESCRIPTION"></a>
59<h2>DESCRIPTION</h2>
60
61
62
63<p style="margin-left:11%; margin-top: 1em"><i>TIFFSetField</i>
64sets the value of a field or pseudo-tag in the current
65directory associated with the open <small>TIFF</small> file
66<i>tif</i>. (A <i>pseudo-tag</i> is a parameter that is used
67to control the operation of the <small>TIFF</small> library
68but whose value is not read or written to the underlying
69file.) To set the value of a field the file must have been
70previously opened for writing with <i>TIFFOpen</i>(3TIFF);
71pseudo-tags can be set whether the file was opened for
72reading or writing. The field is identified by <i>tag</i>,
73one of the values defined in the include file <b>tiff.h</b>
74(see also the table below). The actual value is specified
75using a variable argument list, as prescribed by the
76<i>stdarg</i>(3) interface (or, on some machines, the
77<i>varargs</i>(3) interface.)</p>
78
79
80<p style="margin-left:11%; margin-top: 1em"><i>TIFFVSetField</i>
81is functionally equivalent to <i>TIFFSetField</i> except
82that it takes a pointer to a variable argument list.
83<i>TIFFVSetField</i> is useful for writing routines that are
84layered on top of the functionality provided by
85<i>TIFFSetField</i>.</p>
86
87<p style="margin-left:11%; margin-top: 1em">The tags
88understood by <i>libtiff</i>, the number of parameter
89values, and the expected types for the parameter values are
90shown below. The data types are: <i>char*</i> is
91null-terminated string and corresponds to the
92<small>ASCII</small> data type; <i>uint16</i> is an unsigned
9316-bit value; <i>uint32</i> is an unsigned 32-bit value;
94<i>uint16*</i> is an array of unsigned 16-bit values.
95<i>void*</i> is an array of data values of unspecified
96type.</p>
97
98<p style="margin-left:11%; margin-top: 1em">Consult the
99<small>TIFF</small> specification for information on the
100meaning of each tag.</p>
101
102<table width="100%" border=0 rules="none" frame="void"
103       cellspacing="0" cellpadding="0">
104<tr valign="top" align="left">
105<td width="11%"></td>
106<td width="38%">
107
108
109<p valign="top"><i>Tag Name</i></p></td>
110<td width="11%"></td>
111<td width="29%">
112
113
114<p valign="top"><i>Count</i></p></td>
115<td width="11%">
116</td>
117<tr valign="top" align="left">
118<td width="11%"></td>
119<td width="38%"></td>
120<td width="11%"></td>
121<td width="29%">
122
123
124<p valign="top"><i>Types</i></p></td>
125<td width="11%">
126
127
128<p valign="top"><i>Notes</i></p></td>
129<tr valign="top" align="left">
130<td width="11%"></td>
131<td width="38%">
132
133
134<p valign="top">TIFFTAG_ARTIST</p></td>
135<td width="11%"></td>
136<td width="29%">
137
138
139<p valign="top">1</p></td>
140<td width="11%">
141</td>
142<tr valign="top" align="left">
143<td width="11%"></td>
144<td width="38%"></td>
145<td width="11%"></td>
146<td width="29%">
147
148
149<p valign="top">char*</p></td>
150<td width="11%">
151</td>
152<tr valign="top" align="left">
153<td width="11%"></td>
154<td width="38%">
155
156
157<p valign="top">TIFFTAG_BADFAXLINES</p></td>
158<td width="11%"></td>
159<td width="29%">
160
161
162<p valign="top">1</p></td>
163<td width="11%">
164</td>
165<tr valign="top" align="left">
166<td width="11%"></td>
167<td width="38%"></td>
168<td width="11%"></td>
169<td width="29%">
170
171
172<p valign="top">uint32</p></td>
173<td width="11%">
174</td>
175<tr valign="top" align="left">
176<td width="11%"></td>
177<td width="38%">
178
179
180<p valign="top">TIFFTAG_BITSPERSAMPLE</p></td>
181<td width="11%"></td>
182<td width="29%">
183
184
185<p valign="top">1</p></td>
186<td width="11%">
187</td>
188<tr valign="top" align="left">
189<td width="11%"></td>
190<td width="38%"></td>
191<td width="11%"></td>
192<td width="29%">
193
194
195<p valign="top">uint16</p></td>
196<td width="11%">
197
198
199<p valign="top">&dagger;</p></td>
200<tr valign="top" align="left">
201<td width="11%"></td>
202<td width="38%">
203
204
205<p valign="top">TIFFTAG_CLEANFAXDATA</p></td>
206<td width="11%"></td>
207<td width="29%">
208
209
210<p valign="top">1</p></td>
211<td width="11%">
212</td>
213<tr valign="top" align="left">
214<td width="11%"></td>
215<td width="38%"></td>
216<td width="11%"></td>
217<td width="29%">
218
219
220<p valign="top">uint16</p></td>
221<td width="11%">
222</td>
223<tr valign="top" align="left">
224<td width="11%"></td>
225<td width="38%">
226
227
228<p valign="top">TIFFTAG_COLORMAP</p></td>
229<td width="11%"></td>
230<td width="29%">
231
232
233<p valign="top">3</p></td>
234<td width="11%">
235</td>
236<tr valign="top" align="left">
237<td width="11%"></td>
238<td width="38%"></td>
239<td width="11%"></td>
240<td width="29%">
241
242
243<p valign="top">uint16*</p></td>
244<td width="11%">
245
246
247<p valign="top">1&lt;&lt;BitsPerSample arrays</p></td>
248<tr valign="top" align="left">
249<td width="11%"></td>
250<td width="38%">
251
252
253<p valign="top">TIFFTAG_COMPRESSION</p></td>
254<td width="11%"></td>
255<td width="29%">
256
257
258<p valign="top">1</p></td>
259<td width="11%">
260</td>
261<tr valign="top" align="left">
262<td width="11%"></td>
263<td width="38%"></td>
264<td width="11%"></td>
265<td width="29%">
266
267
268<p valign="top">uint16</p></td>
269<td width="11%">
270
271
272<p valign="top">&dagger;</p></td>
273<tr valign="top" align="left">
274<td width="11%"></td>
275<td width="38%">
276
277
278<p valign="top">TIFFTAG_CONSECUTIVEBADFAXLINES</p></td>
279<td width="11%"></td>
280<td width="29%">
281
282
283<p valign="top">1</p></td>
284<td width="11%">
285</td>
286<tr valign="top" align="left">
287<td width="11%"></td>
288<td width="38%"></td>
289<td width="11%"></td>
290<td width="29%">
291
292
293<p valign="top">uint32</p></td>
294<td width="11%">
295</td>
296<tr valign="top" align="left">
297<td width="11%"></td>
298<td width="38%">
299
300
301<p valign="top">TIFFTAG_COPYRIGHT</p></td>
302<td width="11%"></td>
303<td width="29%">
304
305
306<p valign="top">1</p></td>
307<td width="11%">
308</td>
309<tr valign="top" align="left">
310<td width="11%"></td>
311<td width="38%"></td>
312<td width="11%"></td>
313<td width="29%">
314
315
316<p valign="top">char*</p></td>
317<td width="11%">
318</td>
319<tr valign="top" align="left">
320<td width="11%"></td>
321<td width="38%">
322
323
324<p valign="top">TIFFTAG_DATETIME</p></td>
325<td width="11%"></td>
326<td width="29%">
327
328
329<p valign="top">1</p></td>
330<td width="11%">
331</td>
332<tr valign="top" align="left">
333<td width="11%"></td>
334<td width="38%"></td>
335<td width="11%"></td>
336<td width="29%">
337
338
339<p valign="top">char*</p></td>
340<td width="11%">
341</td>
342<tr valign="top" align="left">
343<td width="11%"></td>
344<td width="38%">
345
346
347<p valign="top">TIFFTAG_DOCUMENTNAME</p></td>
348<td width="11%"></td>
349<td width="29%">
350
351
352<p valign="top">1</p></td>
353<td width="11%">
354</td>
355<tr valign="top" align="left">
356<td width="11%"></td>
357<td width="38%"></td>
358<td width="11%"></td>
359<td width="29%">
360
361
362<p valign="top">char*</p></td>
363<td width="11%">
364</td>
365<tr valign="top" align="left">
366<td width="11%"></td>
367<td width="38%">
368
369
370<p valign="top">TIFFTAG_DOTRANGE</p></td>
371<td width="11%"></td>
372<td width="29%">
373
374
375<p valign="top">2</p></td>
376<td width="11%">
377</td>
378<tr valign="top" align="left">
379<td width="11%"></td>
380<td width="38%"></td>
381<td width="11%"></td>
382<td width="29%">
383
384
385<p valign="top">uint16</p></td>
386<td width="11%">
387</td>
388<tr valign="top" align="left">
389<td width="11%"></td>
390<td width="38%">
391
392
393<p valign="top">TIFFTAG_EXTRASAMPLES</p></td>
394<td width="11%"></td>
395<td width="29%">
396
397
398<p valign="top">2</p></td>
399<td width="11%">
400</td>
401<tr valign="top" align="left">
402<td width="11%"></td>
403<td width="38%"></td>
404<td width="11%"></td>
405<td width="29%">
406
407
408<p valign="top">uint16,uint16*</p></td>
409<td width="11%">
410
411
412<p valign="top">&dagger; count &amp; types array</p></td>
413<tr valign="top" align="left">
414<td width="11%"></td>
415<td width="38%">
416
417
418<p valign="top">TIFFTAG_FAXFILLFUNC</p></td>
419<td width="11%"></td>
420<td width="29%">
421
422
423<p valign="top">1</p></td>
424<td width="11%">
425</td>
426<tr valign="top" align="left">
427<td width="11%"></td>
428<td width="38%"></td>
429<td width="11%"></td>
430<td width="29%">
431
432
433<p valign="top">TIFFFaxFillFunc</p></td>
434<td width="11%">
435
436
437<p valign="top">G3/G4 compression pseudo-tag</p></td>
438<tr valign="top" align="left">
439<td width="11%"></td>
440<td width="38%">
441
442
443<p valign="top">TIFFTAG_FAXMODE</p></td>
444<td width="11%"></td>
445<td width="29%">
446
447
448<p valign="top">1</p></td>
449<td width="11%">
450</td>
451<tr valign="top" align="left">
452<td width="11%"></td>
453<td width="38%"></td>
454<td width="11%"></td>
455<td width="29%">
456
457
458<p valign="top">int</p></td>
459<td width="11%">
460
461
462<p valign="top">&dagger; G3/G4 compression pseudo-tag</p></td>
463<tr valign="top" align="left">
464<td width="11%"></td>
465<td width="38%">
466
467
468<p valign="top">TIFFTAG_FILLORDER</p></td>
469<td width="11%"></td>
470<td width="29%">
471
472
473<p valign="top">1</p></td>
474<td width="11%">
475</td>
476<tr valign="top" align="left">
477<td width="11%"></td>
478<td width="38%"></td>
479<td width="11%"></td>
480<td width="29%">
481
482
483<p valign="top">uint16</p></td>
484<td width="11%">
485
486
487<p valign="top">&dagger;</p></td>
488<tr valign="top" align="left">
489<td width="11%"></td>
490<td width="38%">
491
492
493<p valign="top">TIFFTAG_GROUP3OPTIONS</p></td>
494<td width="11%"></td>
495<td width="29%">
496
497
498<p valign="top">1</p></td>
499<td width="11%">
500</td>
501<tr valign="top" align="left">
502<td width="11%"></td>
503<td width="38%"></td>
504<td width="11%"></td>
505<td width="29%">
506
507
508<p valign="top">uint32</p></td>
509<td width="11%">
510
511
512<p valign="top">&dagger;</p></td>
513<tr valign="top" align="left">
514<td width="11%"></td>
515<td width="38%">
516
517
518<p valign="top">TIFFTAG_GROUP4OPTIONS</p></td>
519<td width="11%"></td>
520<td width="29%">
521
522
523<p valign="top">1</p></td>
524<td width="11%">
525</td>
526<tr valign="top" align="left">
527<td width="11%"></td>
528<td width="38%"></td>
529<td width="11%"></td>
530<td width="29%">
531
532
533<p valign="top">uint32</p></td>
534<td width="11%">
535
536
537<p valign="top">&dagger;</p></td>
538<tr valign="top" align="left">
539<td width="11%"></td>
540<td width="38%">
541
542
543<p valign="top">TIFFTAG_HALFTONEHINTS</p></td>
544<td width="11%"></td>
545<td width="29%">
546
547
548<p valign="top">2</p></td>
549<td width="11%">
550</td>
551<tr valign="top" align="left">
552<td width="11%"></td>
553<td width="38%"></td>
554<td width="11%"></td>
555<td width="29%">
556
557
558<p valign="top">uint16</p></td>
559<td width="11%">
560</td>
561<tr valign="top" align="left">
562<td width="11%"></td>
563<td width="38%">
564
565
566<p valign="top">TIFFTAG_HOSTCOMPUTER</p></td>
567<td width="11%"></td>
568<td width="29%">
569
570
571<p valign="top">1</p></td>
572<td width="11%">
573</td>
574<tr valign="top" align="left">
575<td width="11%"></td>
576<td width="38%"></td>
577<td width="11%"></td>
578<td width="29%">
579
580
581<p valign="top">char*</p></td>
582<td width="11%">
583</td>
584<tr valign="top" align="left">
585<td width="11%"></td>
586<td width="38%">
587
588
589<p valign="top">TIFFTAG_ICCPROFILE</p></td>
590<td width="11%"></td>
591<td width="29%">
592
593
594<p valign="top">2</p></td>
595<td width="11%">
596</td>
597<tr valign="top" align="left">
598<td width="11%"></td>
599<td width="38%"></td>
600<td width="11%"></td>
601<td width="29%">
602
603
604<p valign="top">uint32,void*</p></td>
605<td width="11%">
606
607
608<p valign="top">count, profile data</p></td>
609<tr valign="top" align="left">
610<td width="11%"></td>
611<td width="38%">
612
613
614<p valign="top">TIFFTAG_IMAGEDEPTH</p></td>
615<td width="11%"></td>
616<td width="29%">
617
618
619<p valign="top">1</p></td>
620<td width="11%">
621</td>
622<tr valign="top" align="left">
623<td width="11%"></td>
624<td width="38%"></td>
625<td width="11%"></td>
626<td width="29%">
627
628
629<p valign="top">uint32</p></td>
630<td width="11%">
631
632
633<p valign="top">&dagger;</p></td>
634<tr valign="top" align="left">
635<td width="11%"></td>
636<td width="38%">
637
638
639<p valign="top">TIFFTAG_IMAGEDESCRIPTION</p></td>
640<td width="11%"></td>
641<td width="29%">
642
643
644<p valign="top">1</p></td>
645<td width="11%">
646</td>
647<tr valign="top" align="left">
648<td width="11%"></td>
649<td width="38%"></td>
650<td width="11%"></td>
651<td width="29%">
652
653
654<p valign="top">char*</p></td>
655<td width="11%">
656</td>
657<tr valign="top" align="left">
658<td width="11%"></td>
659<td width="38%">
660
661
662<p valign="top">TIFFTAG_IMAGELENGTH</p></td>
663<td width="11%"></td>
664<td width="29%">
665
666
667<p valign="top">1</p></td>
668<td width="11%">
669</td>
670<tr valign="top" align="left">
671<td width="11%"></td>
672<td width="38%"></td>
673<td width="11%"></td>
674<td width="29%">
675
676
677<p valign="top">uint32</p></td>
678<td width="11%">
679</td>
680<tr valign="top" align="left">
681<td width="11%"></td>
682<td width="38%">
683
684
685<p valign="top">TIFFTAG_IMAGEWIDTH</p></td>
686<td width="11%"></td>
687<td width="29%">
688
689
690<p valign="top">1</p></td>
691<td width="11%">
692</td>
693<tr valign="top" align="left">
694<td width="11%"></td>
695<td width="38%"></td>
696<td width="11%"></td>
697<td width="29%">
698
699
700<p valign="top">uint32</p></td>
701<td width="11%">
702
703
704<p valign="top">&dagger;</p></td>
705<tr valign="top" align="left">
706<td width="11%"></td>
707<td width="38%">
708
709
710<p valign="top">TIFFTAG_INKNAMES</p></td>
711<td width="11%"></td>
712<td width="29%">
713
714
715<p valign="top">2</p></td>
716<td width="11%">
717</td>
718<tr valign="top" align="left">
719<td width="11%"></td>
720<td width="38%"></td>
721<td width="11%"></td>
722<td width="29%">
723
724
725<p valign="top">uint16, char*</p></td>
726<td width="11%">
727</td>
728<tr valign="top" align="left">
729<td width="11%"></td>
730<td width="38%">
731
732
733<p valign="top">TIFFTAG_INKSET</p></td>
734<td width="11%"></td>
735<td width="29%">
736
737
738<p valign="top">1</p></td>
739<td width="11%">
740</td>
741<tr valign="top" align="left">
742<td width="11%"></td>
743<td width="38%"></td>
744<td width="11%"></td>
745<td width="29%">
746
747
748<p valign="top">uint16</p></td>
749<td width="11%">
750
751
752<p valign="top">&dagger;</p></td>
753<tr valign="top" align="left">
754<td width="11%"></td>
755<td width="38%">
756
757
758<p valign="top">TIFFTAG_JPEGCOLORMODE</p></td>
759<td width="11%"></td>
760<td width="29%">
761
762
763<p valign="top">1</p></td>
764<td width="11%">
765</td>
766<tr valign="top" align="left">
767<td width="11%"></td>
768<td width="38%"></td>
769<td width="11%"></td>
770<td width="29%">
771
772
773<p valign="top">int</p></td>
774<td width="11%">
775
776
777<p valign="top">&dagger; JPEG pseudo-tag</p></td>
778<tr valign="top" align="left">
779<td width="11%"></td>
780<td width="38%">
781
782
783<p valign="top">TIFFTAG_JPEGQUALITY</p></td>
784<td width="11%"></td>
785<td width="29%">
786
787
788<p valign="top">1</p></td>
789<td width="11%">
790</td>
791<tr valign="top" align="left">
792<td width="11%"></td>
793<td width="38%"></td>
794<td width="11%"></td>
795<td width="29%">
796
797
798<p valign="top">int</p></td>
799<td width="11%">
800
801
802<p valign="top">JPEG pseudo-tag</p></td>
803<tr valign="top" align="left">
804<td width="11%"></td>
805<td width="38%">
806
807
808<p valign="top">TIFFTAG_JPEGTABLES</p></td>
809<td width="11%"></td>
810<td width="29%">
811
812
813<p valign="top">2</p></td>
814<td width="11%">
815</td>
816<tr valign="top" align="left">
817<td width="11%"></td>
818<td width="38%"></td>
819<td width="11%"></td>
820<td width="29%">
821
822
823<p valign="top">uint32*,void*</p></td>
824<td width="11%">
825
826
827<p valign="top">&dagger; count &amp; tables</p></td>
828<tr valign="top" align="left">
829<td width="11%"></td>
830<td width="38%">
831
832
833<p valign="top">TIFFTAG_JPEGTABLESMODE</p></td>
834<td width="11%"></td>
835<td width="29%">
836
837
838<p valign="top">1</p></td>
839<td width="11%">
840</td>
841<tr valign="top" align="left">
842<td width="11%"></td>
843<td width="38%"></td>
844<td width="11%"></td>
845<td width="29%">
846
847
848<p valign="top">int</p></td>
849<td width="11%">
850
851
852<p valign="top">&dagger; JPEG pseudo-tag</p></td>
853<tr valign="top" align="left">
854<td width="11%"></td>
855<td width="38%">
856
857
858<p valign="top">TIFFTAG_MAKE</p></td>
859<td width="11%"></td>
860<td width="29%">
861
862
863<p valign="top">1</p></td>
864<td width="11%">
865</td>
866<tr valign="top" align="left">
867<td width="11%"></td>
868<td width="38%"></td>
869<td width="11%"></td>
870<td width="29%">
871
872
873<p valign="top">char*</p></td>
874<td width="11%">
875</td>
876<tr valign="top" align="left">
877<td width="11%"></td>
878<td width="38%">
879
880
881<p valign="top">TIFFTAG_MATTEING</p></td>
882<td width="11%"></td>
883<td width="29%">
884
885
886<p valign="top">1</p></td>
887<td width="11%">
888</td>
889<tr valign="top" align="left">
890<td width="11%"></td>
891<td width="38%"></td>
892<td width="11%"></td>
893<td width="29%">
894
895
896<p valign="top">uint16</p></td>
897<td width="11%">
898
899
900<p valign="top">&dagger;</p></td>
901<tr valign="top" align="left">
902<td width="11%"></td>
903<td width="38%">
904
905
906<p valign="top">TIFFTAG_MAXSAMPLEVALUE</p></td>
907<td width="11%"></td>
908<td width="29%">
909
910
911<p valign="top">1</p></td>
912<td width="11%">
913</td>
914<tr valign="top" align="left">
915<td width="11%"></td>
916<td width="38%"></td>
917<td width="11%"></td>
918<td width="29%">
919
920
921<p valign="top">uint16</p></td>
922<td width="11%">
923</td>
924<tr valign="top" align="left">
925<td width="11%"></td>
926<td width="38%">
927
928
929<p valign="top">TIFFTAG_MINSAMPLEVALUE</p></td>
930<td width="11%"></td>
931<td width="29%">
932
933
934<p valign="top">1</p></td>
935<td width="11%">
936</td>
937<tr valign="top" align="left">
938<td width="11%"></td>
939<td width="38%"></td>
940<td width="11%"></td>
941<td width="29%">
942
943
944<p valign="top">uint16</p></td>
945<td width="11%">
946</td>
947<tr valign="top" align="left">
948<td width="11%"></td>
949<td width="38%">
950
951
952<p valign="top">TIFFTAG_MODEL</p></td>
953<td width="11%"></td>
954<td width="29%">
955
956
957<p valign="top">1</p></td>
958<td width="11%">
959</td>
960<tr valign="top" align="left">
961<td width="11%"></td>
962<td width="38%"></td>
963<td width="11%"></td>
964<td width="29%">
965
966
967<p valign="top">char*</p></td>
968<td width="11%">
969</td>
970<tr valign="top" align="left">
971<td width="11%"></td>
972<td width="38%">
973
974
975<p valign="top">TIFFTAG_ORIENTATION</p></td>
976<td width="11%"></td>
977<td width="29%">
978
979
980<p valign="top">1</p></td>
981<td width="11%">
982</td>
983<tr valign="top" align="left">
984<td width="11%"></td>
985<td width="38%"></td>
986<td width="11%"></td>
987<td width="29%">
988
989
990<p valign="top">uint16</p></td>
991<td width="11%">
992</td>
993<tr valign="top" align="left">
994<td width="11%"></td>
995<td width="38%">
996
997
998<p valign="top">TIFFTAG_PAGENAME</p></td>
999<td width="11%"></td>
1000<td width="29%">
1001
1002
1003<p valign="top">1</p></td>
1004<td width="11%">
1005</td>
1006<tr valign="top" align="left">
1007<td width="11%"></td>
1008<td width="38%"></td>
1009<td width="11%"></td>
1010<td width="29%">
1011
1012
1013<p valign="top">char*</p></td>
1014<td width="11%">
1015</td>
1016<tr valign="top" align="left">
1017<td width="11%"></td>
1018<td width="38%">
1019
1020
1021<p valign="top">TIFFTAG_PAGENUMBER</p></td>
1022<td width="11%"></td>
1023<td width="29%">
1024
1025
1026<p valign="top">2</p></td>
1027<td width="11%">
1028</td>
1029<tr valign="top" align="left">
1030<td width="11%"></td>
1031<td width="38%"></td>
1032<td width="11%"></td>
1033<td width="29%">
1034
1035
1036<p valign="top">uint16</p></td>
1037<td width="11%">
1038</td>
1039<tr valign="top" align="left">
1040<td width="11%"></td>
1041<td width="38%">
1042
1043
1044<p valign="top">TIFFTAG_PHOTOMETRIC</p></td>
1045<td width="11%"></td>
1046<td width="29%">
1047
1048
1049<p valign="top">1</p></td>
1050<td width="11%">
1051</td>
1052<tr valign="top" align="left">
1053<td width="11%"></td>
1054<td width="38%"></td>
1055<td width="11%"></td>
1056<td width="29%">
1057
1058
1059<p valign="top">uint16</p></td>
1060<td width="11%">
1061</td>
1062<tr valign="top" align="left">
1063<td width="11%"></td>
1064<td width="38%">
1065
1066
1067<p valign="top">TIFFTAG_PHOTOSHOP</p></td>
1068<td width="11%"></td>
1069<td width="29%">
1070
1071
1072<p valign="top">?</p></td>
1073<td width="11%">
1074</td>
1075<tr valign="top" align="left">
1076<td width="11%"></td>
1077<td width="38%"></td>
1078<td width="11%"></td>
1079<td width="29%">
1080
1081
1082<p valign="top">uint32,void*</p></td>
1083<td width="11%">
1084
1085
1086<p valign="top">count, data</p></td>
1087<tr valign="top" align="left">
1088<td width="11%"></td>
1089<td width="38%">
1090
1091
1092<p valign="top">TIFFTAG_PLANARCONFIG</p></td>
1093<td width="11%"></td>
1094<td width="29%">
1095
1096
1097<p valign="top">1</p></td>
1098<td width="11%">
1099</td>
1100<tr valign="top" align="left">
1101<td width="11%"></td>
1102<td width="38%"></td>
1103<td width="11%"></td>
1104<td width="29%">
1105
1106
1107<p valign="top">uint16</p></td>
1108<td width="11%">
1109
1110
1111<p valign="top">&dagger;</p></td>
1112<tr valign="top" align="left">
1113<td width="11%"></td>
1114<td width="38%">
1115
1116
1117<p valign="top">TIFFTAG_PREDICTOR</p></td>
1118<td width="11%"></td>
1119<td width="29%">
1120
1121
1122<p valign="top">1</p></td>
1123<td width="11%">
1124</td>
1125<tr valign="top" align="left">
1126<td width="11%"></td>
1127<td width="38%"></td>
1128<td width="11%"></td>
1129<td width="29%">
1130
1131
1132<p valign="top">uint16</p></td>
1133<td width="11%">
1134
1135
1136<p valign="top">&dagger;</p></td>
1137<tr valign="top" align="left">
1138<td width="11%"></td>
1139<td width="38%">
1140
1141
1142<p valign="top">TIFFTAG_PRIMARYCHROMATICITIES</p></td>
1143<td width="11%"></td>
1144<td width="29%">
1145
1146
1147<p valign="top">1</p></td>
1148<td width="11%">
1149</td>
1150<tr valign="top" align="left">
1151<td width="11%"></td>
1152<td width="38%"></td>
1153<td width="11%"></td>
1154<td width="29%">
1155
1156
1157<p valign="top">float*</p></td>
1158<td width="11%">
1159
1160
1161<p valign="top">6-entry array</p></td>
1162<tr valign="top" align="left">
1163<td width="11%"></td>
1164<td width="38%">
1165
1166
1167<p valign="top">TIFFTAG_REFERENCEBLACKWHITE</p></td>
1168<td width="11%"></td>
1169<td width="29%">
1170
1171
1172<p valign="top">1</p></td>
1173<td width="11%">
1174</td>
1175<tr valign="top" align="left">
1176<td width="11%"></td>
1177<td width="38%"></td>
1178<td width="11%"></td>
1179<td width="29%">
1180
1181
1182<p valign="top">float*</p></td>
1183<td width="11%">
1184
1185
1186<p valign="top">&dagger; 2*SamplesPerPixel array</p></td>
1187<tr valign="top" align="left">
1188<td width="11%"></td>
1189<td width="38%">
1190
1191
1192<p valign="top">TIFFTAG_RESOLUTIONUNIT</p></td>
1193<td width="11%"></td>
1194<td width="29%">
1195
1196
1197<p valign="top">1</p></td>
1198<td width="11%">
1199</td>
1200<tr valign="top" align="left">
1201<td width="11%"></td>
1202<td width="38%"></td>
1203<td width="11%"></td>
1204<td width="29%">
1205
1206
1207<p valign="top">uint16</p></td>
1208<td width="11%">
1209</td>
1210<tr valign="top" align="left">
1211<td width="11%"></td>
1212<td width="38%">
1213
1214
1215<p valign="top">TIFFTAG_RICHTIFFIPTC</p></td>
1216<td width="11%"></td>
1217<td width="29%">
1218
1219
1220<p valign="top">2</p></td>
1221<td width="11%">
1222</td>
1223<tr valign="top" align="left">
1224<td width="11%"></td>
1225<td width="38%"></td>
1226<td width="11%"></td>
1227<td width="29%">
1228
1229
1230<p valign="top">uint32,void*</p></td>
1231<td width="11%">
1232
1233
1234<p valign="top">count, data</p></td>
1235<tr valign="top" align="left">
1236<td width="11%"></td>
1237<td width="38%">
1238
1239
1240<p valign="top">TIFFTAG_ROWSPERSTRIP</p></td>
1241<td width="11%"></td>
1242<td width="29%">
1243
1244
1245<p valign="top">1</p></td>
1246<td width="11%">
1247</td>
1248<tr valign="top" align="left">
1249<td width="11%"></td>
1250<td width="38%"></td>
1251<td width="11%"></td>
1252<td width="29%">
1253
1254
1255<p valign="top">uint32</p></td>
1256<td width="11%">
1257
1258
1259<p valign="top">&dagger; must be &gt; 0</p></td>
1260<tr valign="top" align="left">
1261<td width="11%"></td>
1262<td width="38%">
1263
1264
1265<p valign="top">TIFFTAG_SAMPLEFORMAT</p></td>
1266<td width="11%"></td>
1267<td width="29%">
1268
1269
1270<p valign="top">1</p></td>
1271<td width="11%">
1272</td>
1273<tr valign="top" align="left">
1274<td width="11%"></td>
1275<td width="38%"></td>
1276<td width="11%"></td>
1277<td width="29%">
1278
1279
1280<p valign="top">uint16</p></td>
1281<td width="11%">
1282
1283
1284<p valign="top">&dagger;</p></td>
1285<tr valign="top" align="left">
1286<td width="11%"></td>
1287<td width="38%">
1288
1289
1290<p valign="top">TIFFTAG_SAMPLESPERPIXEL</p></td>
1291<td width="11%"></td>
1292<td width="29%">
1293
1294
1295<p valign="top">1</p></td>
1296<td width="11%">
1297</td>
1298<tr valign="top" align="left">
1299<td width="11%"></td>
1300<td width="38%"></td>
1301<td width="11%"></td>
1302<td width="29%">
1303
1304
1305<p valign="top">uint16</p></td>
1306<td width="11%">
1307
1308
1309<p valign="top">&dagger; value must be &lt;= 4</p></td>
1310<tr valign="top" align="left">
1311<td width="11%"></td>
1312<td width="38%">
1313
1314
1315<p valign="top">TIFFTAG_SMAXSAMPLEVALUE</p></td>
1316<td width="11%"></td>
1317<td width="29%">
1318
1319
1320<p valign="top">1</p></td>
1321<td width="11%">
1322</td>
1323<tr valign="top" align="left">
1324<td width="11%"></td>
1325<td width="38%"></td>
1326<td width="11%"></td>
1327<td width="29%">
1328
1329
1330<p valign="top">double</p></td>
1331<td width="11%">
1332</td>
1333<tr valign="top" align="left">
1334<td width="11%"></td>
1335<td width="38%">
1336
1337
1338<p valign="top">TIFFTAG_SMINSAMPLEVALUE</p></td>
1339<td width="11%"></td>
1340<td width="29%">
1341
1342
1343<p valign="top">1</p></td>
1344<td width="11%">
1345</td>
1346<tr valign="top" align="left">
1347<td width="11%"></td>
1348<td width="38%"></td>
1349<td width="11%"></td>
1350<td width="29%">
1351
1352
1353<p valign="top">double</p></td>
1354<td width="11%">
1355</td>
1356<tr valign="top" align="left">
1357<td width="11%"></td>
1358<td width="38%">
1359
1360
1361<p valign="top">TIFFTAG_SOFTWARE</p></td>
1362<td width="11%"></td>
1363<td width="29%">
1364
1365
1366<p valign="top">1</p></td>
1367<td width="11%">
1368</td>
1369<tr valign="top" align="left">
1370<td width="11%"></td>
1371<td width="38%"></td>
1372<td width="11%"></td>
1373<td width="29%">
1374
1375
1376<p valign="top">char*</p></td>
1377<td width="11%">
1378</td>
1379<tr valign="top" align="left">
1380<td width="11%"></td>
1381<td width="38%">
1382
1383
1384<p valign="top">TIFFTAG_STONITS</p></td>
1385<td width="11%"></td>
1386<td width="29%">
1387
1388
1389<p valign="top">1</p></td>
1390<td width="11%">
1391</td>
1392<tr valign="top" align="left">
1393<td width="11%"></td>
1394<td width="38%"></td>
1395<td width="11%"></td>
1396<td width="29%">
1397
1398
1399<p valign="top">double</p></td>
1400<td width="11%">
1401
1402
1403<p valign="top">&dagger;</p></td>
1404<tr valign="top" align="left">
1405<td width="11%"></td>
1406<td width="38%">
1407
1408
1409<p valign="top">TIFFTAG_SUBFILETYPE</p></td>
1410<td width="11%"></td>
1411<td width="29%">
1412
1413
1414<p valign="top">1</p></td>
1415<td width="11%">
1416</td>
1417<tr valign="top" align="left">
1418<td width="11%"></td>
1419<td width="38%"></td>
1420<td width="11%"></td>
1421<td width="29%">
1422
1423
1424<p valign="top">uint32</p></td>
1425<td width="11%">
1426</td>
1427<tr valign="top" align="left">
1428<td width="11%"></td>
1429<td width="38%">
1430
1431
1432<p valign="top">TIFFTAG_SUBIFD</p></td>
1433<td width="11%"></td>
1434<td width="29%">
1435
1436
1437<p valign="top">2</p></td>
1438<td width="11%">
1439</td>
1440<tr valign="top" align="left">
1441<td width="11%"></td>
1442<td width="38%"></td>
1443<td width="11%"></td>
1444<td width="29%">
1445
1446
1447<p valign="top">uint16,uint32*</p></td>
1448<td width="11%">
1449
1450
1451<p valign="top">count &amp; offsets array</p></td>
1452<tr valign="top" align="left">
1453<td width="11%"></td>
1454<td width="38%">
1455
1456
1457<p valign="top">TIFFTAG_TARGETPRINTER</p></td>
1458<td width="11%"></td>
1459<td width="29%">
1460
1461
1462<p valign="top">1</p></td>
1463<td width="11%">
1464</td>
1465<tr valign="top" align="left">
1466<td width="11%"></td>
1467<td width="38%"></td>
1468<td width="11%"></td>
1469<td width="29%">
1470
1471
1472<p valign="top">char*</p></td>
1473<td width="11%">
1474</td>
1475<tr valign="top" align="left">
1476<td width="11%"></td>
1477<td width="38%">
1478
1479
1480<p valign="top">TIFFTAG_THRESHHOLDING</p></td>
1481<td width="11%"></td>
1482<td width="29%">
1483
1484
1485<p valign="top">1</p></td>
1486<td width="11%">
1487</td>
1488<tr valign="top" align="left">
1489<td width="11%"></td>
1490<td width="38%"></td>
1491<td width="11%"></td>
1492<td width="29%">
1493
1494
1495<p valign="top">uint16</p></td>
1496<td width="11%">
1497</td>
1498<tr valign="top" align="left">
1499<td width="11%"></td>
1500<td width="38%">
1501
1502
1503<p valign="top">TIFFTAG_TILEDEPTH</p></td>
1504<td width="11%"></td>
1505<td width="29%">
1506
1507
1508<p valign="top">1</p></td>
1509<td width="11%">
1510</td>
1511<tr valign="top" align="left">
1512<td width="11%"></td>
1513<td width="38%"></td>
1514<td width="11%"></td>
1515<td width="29%">
1516
1517
1518<p valign="top">uint32</p></td>
1519<td width="11%">
1520
1521
1522<p valign="top">&dagger;</p></td>
1523<tr valign="top" align="left">
1524<td width="11%"></td>
1525<td width="38%">
1526
1527
1528<p valign="top">TIFFTAG_TILELENGTH</p></td>
1529<td width="11%"></td>
1530<td width="29%">
1531
1532
1533<p valign="top">1</p></td>
1534<td width="11%">
1535</td>
1536<tr valign="top" align="left">
1537<td width="11%"></td>
1538<td width="38%"></td>
1539<td width="11%"></td>
1540<td width="29%">
1541
1542
1543<p valign="top">uint32</p></td>
1544<td width="11%">
1545
1546
1547<p valign="top">&dagger; must be a multiple of 8</p></td>
1548<tr valign="top" align="left">
1549<td width="11%"></td>
1550<td width="38%">
1551
1552
1553<p valign="top">TIFFTAG_TILEWIDTH</p></td>
1554<td width="11%"></td>
1555<td width="29%">
1556
1557
1558<p valign="top">1</p></td>
1559<td width="11%">
1560</td>
1561<tr valign="top" align="left">
1562<td width="11%"></td>
1563<td width="38%"></td>
1564<td width="11%"></td>
1565<td width="29%">
1566
1567
1568<p valign="top">uint32</p></td>
1569<td width="11%">
1570
1571
1572<p valign="top">&dagger; must be a multiple of 8</p></td>
1573<tr valign="top" align="left">
1574<td width="11%"></td>
1575<td width="38%">
1576
1577
1578<p valign="top">TIFFTAG_TRANSFERFUNCTION</p></td>
1579<td width="11%"></td>
1580<td width="29%">
1581
1582
1583<p valign="top">1 or 3&Dagger; uint16*</p></td>
1584<td width="11%">
1585
1586
1587<p valign="top">1&lt;&lt;BitsPerSample entry arrays</p></td>
1588<tr valign="top" align="left">
1589<td width="11%"></td>
1590<td width="38%">
1591
1592
1593<p valign="top">TIFFTAG_WHITEPOINT</p></td>
1594<td width="11%"></td>
1595<td width="29%">
1596
1597
1598<p valign="top">1</p></td>
1599<td width="11%">
1600</td>
1601<tr valign="top" align="left">
1602<td width="11%"></td>
1603<td width="38%"></td>
1604<td width="11%"></td>
1605<td width="29%">
1606
1607
1608<p valign="top">float*</p></td>
1609<td width="11%">
1610
1611
1612<p valign="top">2-entry array</p></td>
1613<tr valign="top" align="left">
1614<td width="11%"></td>
1615<td width="38%">
1616
1617
1618<p valign="top">TIFFTAG_XMLPACKET</p></td>
1619<td width="11%"></td>
1620<td width="29%">
1621
1622
1623<p valign="top">2</p></td>
1624<td width="11%">
1625</td>
1626<tr valign="top" align="left">
1627<td width="11%"></td>
1628<td width="38%"></td>
1629<td width="11%"></td>
1630<td width="29%">
1631
1632
1633<p valign="top">uint32,void*</p></td>
1634<td width="11%">
1635
1636
1637<p valign="top">count, data</p></td>
1638<tr valign="top" align="left">
1639<td width="11%"></td>
1640<td width="38%">
1641
1642
1643<p valign="top">TIFFTAG_XPOSITION</p></td>
1644<td width="11%"></td>
1645<td width="29%">
1646
1647
1648<p valign="top">1</p></td>
1649<td width="11%">
1650</td>
1651<tr valign="top" align="left">
1652<td width="11%"></td>
1653<td width="38%"></td>
1654<td width="11%"></td>
1655<td width="29%">
1656
1657
1658<p valign="top">float</p></td>
1659<td width="11%">
1660</td>
1661<tr valign="top" align="left">
1662<td width="11%"></td>
1663<td width="38%">
1664
1665
1666<p valign="top">TIFFTAG_XRESOLUTION</p></td>
1667<td width="11%"></td>
1668<td width="29%">
1669
1670
1671<p valign="top">1</p></td>
1672<td width="11%">
1673</td>
1674<tr valign="top" align="left">
1675<td width="11%"></td>
1676<td width="38%"></td>
1677<td width="11%"></td>
1678<td width="29%">
1679
1680
1681<p valign="top">float</p></td>
1682<td width="11%">
1683</td>
1684<tr valign="top" align="left">
1685<td width="11%"></td>
1686<td width="38%">
1687
1688
1689<p valign="top">TIFFTAG_YCBCRCOEFFICIENTS</p></td>
1690<td width="11%"></td>
1691<td width="29%">
1692
1693
1694<p valign="top">1</p></td>
1695<td width="11%">
1696</td>
1697<tr valign="top" align="left">
1698<td width="11%"></td>
1699<td width="38%"></td>
1700<td width="11%"></td>
1701<td width="29%">
1702
1703
1704<p valign="top">float*</p></td>
1705<td width="11%">
1706
1707
1708<p valign="top">&dagger; 3-entry array</p></td>
1709<tr valign="top" align="left">
1710<td width="11%"></td>
1711<td width="38%">
1712
1713
1714<p valign="top">TIFFTAG_YCBCRPOSITIONING</p></td>
1715<td width="11%"></td>
1716<td width="29%">
1717
1718
1719<p valign="top">1</p></td>
1720<td width="11%">
1721</td>
1722<tr valign="top" align="left">
1723<td width="11%"></td>
1724<td width="38%"></td>
1725<td width="11%"></td>
1726<td width="29%">
1727
1728
1729<p valign="top">uint16</p></td>
1730<td width="11%">
1731
1732
1733<p valign="top">&dagger;</p></td>
1734<tr valign="top" align="left">
1735<td width="11%"></td>
1736<td width="38%">
1737
1738
1739<p valign="top">TIFFTAG_YCBCRSAMPLING</p></td>
1740<td width="11%"></td>
1741<td width="29%">
1742
1743
1744<p valign="top">2</p></td>
1745<td width="11%">
1746</td>
1747<tr valign="top" align="left">
1748<td width="11%"></td>
1749<td width="38%"></td>
1750<td width="11%"></td>
1751<td width="29%">
1752
1753
1754<p valign="top">uint16</p></td>
1755<td width="11%">
1756
1757
1758<p valign="top">&dagger;</p></td>
1759<tr valign="top" align="left">
1760<td width="11%"></td>
1761<td width="38%">
1762
1763
1764<p valign="top">TIFFTAG_YPOSITION</p></td>
1765<td width="11%"></td>
1766<td width="29%">
1767
1768
1769<p valign="top">1</p></td>
1770<td width="11%">
1771</td>
1772<tr valign="top" align="left">
1773<td width="11%"></td>
1774<td width="38%"></td>
1775<td width="11%"></td>
1776<td width="29%">
1777
1778
1779<p valign="top">float</p></td>
1780<td width="11%">
1781</td>
1782<tr valign="top" align="left">
1783<td width="11%"></td>
1784<td width="38%">
1785
1786
1787<p valign="top">TIFFTAG_YRESOLUTION</p></td>
1788<td width="11%"></td>
1789<td width="29%">
1790
1791
1792<p valign="top">1</p></td>
1793<td width="11%">
1794</td>
1795<tr valign="top" align="left">
1796<td width="11%"></td>
1797<td width="38%"></td>
1798<td width="11%"></td>
1799<td width="29%">
1800
1801
1802<p valign="top">float</p></td>
1803<td width="11%">
1804</td>
1805</table>
1806
1807<p style="margin-left:11%;">&dagger; Tag may not have its
1808values changed once data is written. <br>
1809&Dagger; If <i>SamplesPerPixel</i> is one, then a single
1810array is passed; otherwise three arrays should be passed.
1811<br>
1812* The contents of this field are quite complex. See <b>The
1813ICC Profile Format Specification</b>, Annex B.3
1814&quot;Embedding ICC Profiles in TIFF Files&quot; (available
1815at http://www.color.org) for an explanation.</p>
1816
1817<a name="RETURN VALUES"></a>
1818<h2>RETURN VALUES</h2>
1819
1820
1821<p style="margin-left:11%; margin-top: 1em">1 is returned
1822if the operation was successful. Otherwise, 0 is returned if
1823an error was detected.</p>
1824
1825<a name="DIAGNOSTICS"></a>
1826<h2>DIAGNOSTICS</h2>
1827
1828
1829<p style="margin-left:11%; margin-top: 1em">All error
1830messages are directed to the <b>TIFFError</b>(3TIFF)
1831routine.</p>
1832
1833<p style="margin-left:11%; margin-top: 1em"><b>%s: Cannot
1834modify tag &quot;%s&quot; while writing</b>. Data has
1835already been written to the file, so the specified
1836tag&rsquo;s value can not be changed. This restriction is
1837applied to all tags that affect the format of written
1838data.</p>
1839
1840<p style="margin-left:11%; margin-top: 1em"><b>%d: Bad
1841value for &quot;%s&quot;</b>. An invalid value was supplied
1842for the named tag.</p>
1843
1844<a name="SEE ALSO"></a>
1845<h2>SEE ALSO</h2>
1846
1847
1848
1849<p style="margin-left:11%; margin-top: 1em"><b>TIFFOpen</b>(3TIFF),
1850<b>TIFFGetField</b>(3TIFF), <b>TIFFSetDirectory</b>(3TIFF),
1851<b>TIFFWriteDirectory</b>(3TIFF),
1852<b>TIFFReadDirectory</b>(3TIFF), <b>libtiff</b>(3TIFF)</p>
1853
1854<p style="margin-left:11%; margin-top: 1em">Libtiff library
1855home page: <b>http://www.remotesensing.org/libtiff/</b></p>
1856<hr>
1857</body>
1858</html>
1859