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