1<!-- Creator     : groff version 1.18.1 -->
2<!-- CreationDate: Fri Dec 30 00:55:57 2005 -->
3<html>
4<head>
5<meta name="generator" content="groff -Thtml, see www.gnu.org">
6<meta name="Content-Style" content="text/css">
7<title>TIFFSetField</title>
8</head>
9<body>
10
11<h1 align=center>TIFFSetField</h1>
12<a href="#NAME">NAME</a><br>
13<a href="#SYNOPSIS">SYNOPSIS</a><br>
14<a href="#DESCRIPTION">DESCRIPTION</a><br>
15<a href="#RETURN VALUES">RETURN VALUES</a><br>
16<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
17<a href="#SEE ALSO">SEE ALSO</a><br>
18
19<hr>
20<a name="NAME"></a>
21<h2>NAME</h2>
22<!-- INDENTATION -->
23<table width="100%" border=0 rules="none" frame="void"
24       cols="2" cellspacing="0" cellpadding="0">
25<tr valign="top" align="left">
26<td width="8%"></td>
27<td width="91%">
28<p>TIFFSetField, TIFFVSetField &minus; set the value(s) of a
29tag in a <small>TIFF</small> file open for writing</p>
30</td>
31</table>
32<a name="SYNOPSIS"></a>
33<h2>SYNOPSIS</h2>
34<!-- INDENTATION -->
35<table width="100%" border=0 rules="none" frame="void"
36       cols="2" cellspacing="0" cellpadding="0">
37<tr valign="top" align="left">
38<td width="8%"></td>
39<td width="91%">
40<p><b>#include &lt;tiffio.h&gt;</b></p>
41<!-- INDENTATION -->
42<p><b>int TIFFSetField(TIFF *</b><i>tif</i><b>, ttag_t</b>
43<i>tag</i><b>,</b> <i>...</i><b>)</b></p>
44<!-- INDENTATION -->
45<p><b>#include &lt;stdarg.h&gt;</b></p>
46<!-- INDENTATION -->
47<p><b>int TIFFVSetField(TIFF *</b><i>tif</i><b>, ttag_t</b>
48<i>tag</i><b>, va_list</b> <i>ap</i><b>)</b></p>
49</td>
50</table>
51<a name="DESCRIPTION"></a>
52<h2>DESCRIPTION</h2>
53<!-- INDENTATION -->
54<table width="100%" border=0 rules="none" frame="void"
55       cols="2" cellspacing="0" cellpadding="0">
56<tr valign="top" align="left">
57<td width="8%"></td>
58<td width="91%">
59<p><i>TIFFSetField</i> sets the value of a field or
60pseudo-tag in the current directory associated with the open
61<small>TIFF</small> file <i>tif</i>. (A <i>pseudo-tag</i> is
62a parameter that is used to control the operation of the
63<small>TIFF</small> library but whose value is not read or
64written to the underlying file.) To set the value of a field
65the file must have been previously opened for writing with
66<i>TIFFOpen</i>(3TIFF); pseudo-tags can be set whether the
67file was opened for reading or writing. The field is
68identified by <i>tag</i>, one of the values defined in the
69include file <b>tiff.h</b> (see also the table below). The
70actual value is specified using a variable argument list, as
71prescribed by the <i>stdarg</i>(3) interface (or, on some
72machines, the <i>varargs</i>(3) interface.)</p>
73<!-- INDENTATION -->
74<p><i>TIFFVSetField</i> is functionally equivalent to
75<i>TIFFSetField</i> except that it takes a pointer to a
76variable argument list. <i>TIFFVSetField</i> is useful for
77writing routines that are layered on top of the
78functionality provided by <i>TIFFSetField</i>.</p>
79<!-- INDENTATION -->
80<p>The tags understood by <i>libtiff</i>, the number of
81parameter values, and the expected types for the parameter
82values are shown below. The data types are: <i>char*</i> is
83null-terminated string and corresponds to the
84<small>ASCII</small> data type; <i>uint16</i> is an unsigned
8516-bit value; <i>uint32</i> is an unsigned 32-bit value;
86<i>uint16*</i> is an array of unsigned 16-bit values.
87<i>void*</i> is an array of data values of unspecified
88type.</p>
89<!-- INDENTATION -->
90<p>Consult the <small>TIFF</small> specification for
91information on the meaning of each tag.</p></td>
92</table>
93<!-- TABS -->
94
95<p><i>Tag Name Count Types Notes</i></p>
96<!-- TABS -->
97<table width="100%" border=0 rules="none" frame="void"
98       cols="5" cellspacing="0" cellpadding="0">
99<tr valign="top" align="left">
100<td width="8%"></td>
101<td width="41%">
102
103<p>TIFFTAG_ARTIST</p>
104</td>
105<td width="8%">
106
107<p>1</p>
108</td>
109<td width="24%">
110
111<p>char*</p>
112</td>
113<td width="16%">
114</td>
115<tr valign="top" align="left">
116<td width="8%"></td>
117<td width="41%">
118
119<p>TIFFTAG_BADFAXLINES</p>
120</td>
121<td width="8%">
122
123<p>1</p>
124</td>
125<td width="24%">
126
127<p>uint32</p>
128</td>
129<td width="16%">
130</td>
131<tr valign="top" align="left">
132<td width="8%"></td>
133<td width="41%">
134
135<p>TIFFTAG_BITSPERSAMPLE</p>
136</td>
137<td width="8%">
138
139<p>1</p>
140</td>
141<td width="24%">
142
143<p>uint16</p>
144</td>
145<td width="16%">
146
147<p>&dagger;</p>
148</td>
149<tr valign="top" align="left">
150<td width="8%"></td>
151<td width="41%">
152
153<p>TIFFTAG_CLEANFAXDATA</p>
154</td>
155<td width="8%">
156
157<p>1</p>
158</td>
159<td width="24%">
160
161<p>uint16</p>
162</td>
163<td width="16%">
164</td>
165<tr valign="top" align="left">
166<td width="8%"></td>
167<td width="41%">
168
169<p>TIFFTAG_COLORMAP</p>
170</td>
171<td width="8%">
172
173<p>3</p>
174</td>
175<td width="24%">
176
177<p>uint16*</p>
178</td>
179<td width="16%">
180
181<p>1&lt;&lt;BitsPerSample arrays</p>
182</td>
183<tr valign="top" align="left">
184<td width="8%"></td>
185<td width="41%">
186
187<p>TIFFTAG_COMPRESSION</p>
188</td>
189<td width="8%">
190
191<p>1</p>
192</td>
193<td width="24%">
194
195<p>uint16</p>
196</td>
197<td width="16%">
198
199<p>&dagger;</p>
200</td>
201<tr valign="top" align="left">
202<td width="8%"></td>
203<td width="41%">
204
205<p>TIFFTAG_CONSECUTIVEBADFAXLINES</p>
206</td>
207<td width="8%">
208
209<p>1</p>
210</td>
211<td width="24%">
212
213<p>uint32</p>
214</td>
215<td width="16%">
216</td>
217<tr valign="top" align="left">
218<td width="8%"></td>
219<td width="41%">
220
221<p>TIFFTAG_COPYRIGHT</p>
222</td>
223<td width="8%">
224
225<p>1</p>
226</td>
227<td width="24%">
228
229<p>char*</p>
230</td>
231<td width="16%">
232</td>
233<tr valign="top" align="left">
234<td width="8%"></td>
235<td width="41%">
236
237<p>TIFFTAG_DATETIME</p>
238</td>
239<td width="8%">
240
241<p>1</p>
242</td>
243<td width="24%">
244
245<p>char*</p>
246</td>
247<td width="16%">
248</td>
249<tr valign="top" align="left">
250<td width="8%"></td>
251<td width="41%">
252
253<p>TIFFTAG_DOCUMENTNAME</p>
254</td>
255<td width="8%">
256
257<p>1</p>
258</td>
259<td width="24%">
260
261<p>char*</p>
262</td>
263<td width="16%">
264</td>
265<tr valign="top" align="left">
266<td width="8%"></td>
267<td width="41%">
268
269<p>TIFFTAG_DOTRANGE</p>
270</td>
271<td width="8%">
272
273<p>2</p>
274</td>
275<td width="24%">
276
277<p>uint16</p>
278</td>
279<td width="16%">
280</td>
281<tr valign="top" align="left">
282<td width="8%"></td>
283<td width="41%">
284
285<p>TIFFTAG_EXTRASAMPLES</p>
286</td>
287<td width="8%">
288
289<p>2</p>
290</td>
291<td width="24%">
292
293<p>uint16,uint16*</p>
294</td>
295<td width="16%">
296
297<p>&dagger; count &amp; types array</p>
298</td>
299<tr valign="top" align="left">
300<td width="8%"></td>
301<td width="41%">
302
303<p>TIFFTAG_FAXMODE</p>
304</td>
305<td width="8%">
306
307<p>1</p>
308</td>
309<td width="24%">
310
311<p>int</p>
312</td>
313<td width="16%">
314
315<p>&dagger; G3/G4 compression pseudo-tag</p>
316</td>
317<tr valign="top" align="left">
318<td width="8%"></td>
319<td width="41%">
320
321<p>TIFFTAG_FAXFILLFUNC</p>
322</td>
323<td width="8%">
324
325<p>1</p>
326</td>
327<td width="24%">
328
329<p>TIFFFaxFillFunc</p>
330</td>
331<td width="16%">
332
333<p>G3/G4 compression pseudo-tag</p>
334</td>
335<tr valign="top" align="left">
336<td width="8%"></td>
337<td width="41%">
338
339<p>TIFFTAG_FILLORDER</p>
340</td>
341<td width="8%">
342
343<p>1</p>
344</td>
345<td width="24%">
346
347<p>uint16</p>
348</td>
349<td width="16%">
350
351<p>&dagger;</p>
352</td>
353<tr valign="top" align="left">
354<td width="8%"></td>
355<td width="41%">
356
357<p>TIFFTAG_GROUP3OPTIONS</p>
358</td>
359<td width="8%">
360
361<p>1</p>
362</td>
363<td width="24%">
364
365<p>uint32</p>
366</td>
367<td width="16%">
368
369<p>&dagger;</p>
370</td>
371<tr valign="top" align="left">
372<td width="8%"></td>
373<td width="41%">
374
375<p>TIFFTAG_GROUP4OPTIONS</p>
376</td>
377<td width="8%">
378
379<p>1</p>
380</td>
381<td width="24%">
382
383<p>uint32</p>
384</td>
385<td width="16%">
386
387<p>&dagger;</p>
388</td>
389<tr valign="top" align="left">
390<td width="8%"></td>
391<td width="41%">
392
393<p>TIFFTAG_HALFTONEHINTS</p>
394</td>
395<td width="8%">
396
397<p>2</p>
398</td>
399<td width="24%">
400
401<p>uint16</p>
402</td>
403<td width="16%">
404</td>
405<tr valign="top" align="left">
406<td width="8%"></td>
407<td width="41%">
408
409<p>TIFFTAG_HOSTCOMPUTER</p>
410</td>
411<td width="8%">
412
413<p>1</p>
414</td>
415<td width="24%">
416
417<p>char*</p>
418</td>
419<td width="16%">
420</td>
421<tr valign="top" align="left">
422<td width="8%"></td>
423<td width="41%">
424
425<p>TIFFTAG_IMAGEDESCRIPTION</p>
426</td>
427<td width="8%">
428
429<p>1</p>
430</td>
431<td width="24%">
432
433<p>char*</p>
434</td>
435<td width="16%">
436</td>
437<tr valign="top" align="left">
438<td width="8%"></td>
439<td width="41%">
440
441<p>TIFFTAG_IMAGEDEPTH</p>
442</td>
443<td width="8%">
444
445<p>1</p>
446</td>
447<td width="24%">
448
449<p>uint32</p>
450</td>
451<td width="16%">
452
453<p>&dagger;</p>
454</td>
455<tr valign="top" align="left">
456<td width="8%"></td>
457<td width="41%">
458
459<p>TIFFTAG_IMAGELENGTH</p>
460</td>
461<td width="8%">
462
463<p>1</p>
464</td>
465<td width="24%">
466
467<p>uint32</p>
468</td>
469<td width="16%">
470</td>
471<tr valign="top" align="left">
472<td width="8%"></td>
473<td width="41%">
474
475<p>TIFFTAG_IMAGEWIDTH</p>
476</td>
477<td width="8%">
478
479<p>1</p>
480</td>
481<td width="24%">
482
483<p>uint32</p>
484</td>
485<td width="16%">
486
487<p>&dagger;</p>
488</td>
489<tr valign="top" align="left">
490<td width="8%"></td>
491<td width="41%">
492
493<p>TIFFTAG_INKNAMES</p>
494</td>
495<td width="8%">
496
497<p>2</p>
498</td>
499<td width="24%">
500
501<p>uint16, char*</p>
502</td>
503<td width="16%">
504</td>
505<tr valign="top" align="left">
506<td width="8%"></td>
507<td width="41%">
508
509<p>TIFFTAG_INKSET</p>
510</td>
511<td width="8%">
512
513<p>1</p>
514</td>
515<td width="24%">
516
517<p>uint16</p>
518</td>
519<td width="16%">
520
521<p>&dagger;</p>
522</td>
523<tr valign="top" align="left">
524<td width="8%"></td>
525<td width="41%">
526
527<p>TIFFTAG_JPEGTABLES</p>
528</td>
529<td width="8%">
530
531<p>2</p>
532</td>
533<td width="24%">
534
535<p>uint32*,void*</p>
536</td>
537<td width="16%">
538
539<p>&dagger; count &amp; tables</p>
540</td>
541<tr valign="top" align="left">
542<td width="8%"></td>
543<td width="41%">
544
545<p>TIFFTAG_JPEGQUALITY</p>
546</td>
547<td width="8%">
548
549<p>1</p>
550</td>
551<td width="24%">
552
553<p>int</p>
554</td>
555<td width="16%">
556
557<p>JPEG pseudo-tag</p>
558</td>
559<tr valign="top" align="left">
560<td width="8%"></td>
561<td width="41%">
562
563<p>TIFFTAG_JPEGCOLORMODE</p>
564</td>
565<td width="8%">
566
567<p>1</p>
568</td>
569<td width="24%">
570
571<p>int</p>
572</td>
573<td width="16%">
574
575<p>&dagger; JPEG pseudo-tag</p>
576</td>
577<tr valign="top" align="left">
578<td width="8%"></td>
579<td width="41%">
580
581<p>TIFFTAG_JPEGTABLESMODE</p>
582</td>
583<td width="8%">
584
585<p>1</p>
586</td>
587<td width="24%">
588
589<p>int</p>
590</td>
591<td width="16%">
592
593<p>&dagger; JPEG pseudo-tag</p>
594</td>
595<tr valign="top" align="left">
596<td width="8%"></td>
597<td width="41%">
598
599<p>TIFFTAG_MAKE</p>
600</td>
601<td width="8%">
602
603<p>1</p>
604</td>
605<td width="24%">
606
607<p>char*</p>
608</td>
609<td width="16%">
610</td>
611<tr valign="top" align="left">
612<td width="8%"></td>
613<td width="41%">
614
615<p>TIFFTAG_MATTEING</p>
616</td>
617<td width="8%">
618
619<p>1</p>
620</td>
621<td width="24%">
622
623<p>uint16</p>
624</td>
625<td width="16%">
626
627<p>&dagger;</p>
628</td>
629<tr valign="top" align="left">
630<td width="8%"></td>
631<td width="41%">
632
633<p>TIFFTAG_MAXSAMPLEVALUE</p>
634</td>
635<td width="8%">
636
637<p>1</p>
638</td>
639<td width="24%">
640
641<p>uint16</p>
642</td>
643<td width="16%">
644</td>
645<tr valign="top" align="left">
646<td width="8%"></td>
647<td width="41%">
648
649<p>TIFFTAG_MINSAMPLEVALUE</p>
650</td>
651<td width="8%">
652
653<p>1</p>
654</td>
655<td width="24%">
656
657<p>uint16</p>
658</td>
659<td width="16%">
660</td>
661<tr valign="top" align="left">
662<td width="8%"></td>
663<td width="41%">
664
665<p>TIFFTAG_MODEL</p>
666</td>
667<td width="8%">
668
669<p>1</p>
670</td>
671<td width="24%">
672
673<p>char*</p>
674</td>
675<td width="16%">
676</td>
677<tr valign="top" align="left">
678<td width="8%"></td>
679<td width="41%">
680
681<p>TIFFTAG_ORIENTATION</p>
682</td>
683<td width="8%">
684
685<p>1</p>
686</td>
687<td width="24%">
688
689<p>uint16</p>
690</td>
691<td width="16%">
692</td>
693<tr valign="top" align="left">
694<td width="8%"></td>
695<td width="41%">
696
697<p>TIFFTAG_PAGENAME</p>
698</td>
699<td width="8%">
700
701<p>1</p>
702</td>
703<td width="24%">
704
705<p>char*</p>
706</td>
707<td width="16%">
708</td>
709<tr valign="top" align="left">
710<td width="8%"></td>
711<td width="41%">
712
713<p>TIFFTAG_PAGENUMBER</p>
714</td>
715<td width="8%">
716
717<p>2</p>
718</td>
719<td width="24%">
720
721<p>uint16</p>
722</td>
723<td width="16%">
724</td>
725<tr valign="top" align="left">
726<td width="8%"></td>
727<td width="41%">
728
729<p>TIFFTAG_PHOTOMETRIC</p>
730</td>
731<td width="8%">
732
733<p>1</p>
734</td>
735<td width="24%">
736
737<p>uint16</p>
738</td>
739<td width="16%">
740</td>
741<tr valign="top" align="left">
742<td width="8%"></td>
743<td width="41%">
744
745<p>TIFFTAG_PLANARCONFIG</p>
746</td>
747<td width="8%">
748
749<p>1</p>
750</td>
751<td width="24%">
752
753<p>uint16</p>
754</td>
755<td width="16%">
756
757<p>&dagger;</p>
758</td>
759<tr valign="top" align="left">
760<td width="8%"></td>
761<td width="41%">
762
763<p>TIFFTAG_PREDICTOR</p>
764</td>
765<td width="8%">
766
767<p>1</p>
768</td>
769<td width="24%">
770
771<p>uint16</p>
772</td>
773<td width="16%">
774
775<p>&dagger;</p>
776</td>
777<tr valign="top" align="left">
778<td width="8%"></td>
779<td width="41%">
780
781<p>TIFFTAG_PRIMARYCHROMATICITIES</p>
782</td>
783<td width="8%">
784
785<p>1</p>
786</td>
787<td width="24%">
788
789<p>float*</p>
790</td>
791<td width="16%">
792
793<p>6-entry array</p>
794</td>
795<tr valign="top" align="left">
796<td width="8%"></td>
797<td width="41%">
798
799<p>TIFFTAG_REFERENCEBLACKWHITE</p>
800</td>
801<td width="8%">
802
803<p>1</p>
804</td>
805<td width="24%">
806
807<p>float*</p>
808</td>
809<td width="16%">
810
811<p>&dagger; 2*SamplesPerPixel array</p>
812</td>
813<tr valign="top" align="left">
814<td width="8%"></td>
815<td width="41%">
816
817<p>TIFFTAG_RESOLUTIONUNIT</p>
818</td>
819<td width="8%">
820
821<p>1</p>
822</td>
823<td width="24%">
824
825<p>uint16</p>
826</td>
827<td width="16%">
828</td>
829<tr valign="top" align="left">
830<td width="8%"></td>
831<td width="41%">
832
833<p>TIFFTAG_ROWSPERSTRIP</p>
834</td>
835<td width="8%">
836
837<p>1</p>
838</td>
839<td width="24%">
840
841<p>uint32</p>
842</td>
843<td width="16%">
844
845<p>&dagger; must be &gt; 0</p>
846</td>
847<tr valign="top" align="left">
848<td width="8%"></td>
849<td width="41%">
850
851<p>TIFFTAG_SAMPLEFORMAT</p>
852</td>
853<td width="8%">
854
855<p>1</p>
856</td>
857<td width="24%">
858
859<p>uint16</p>
860</td>
861<td width="16%">
862
863<p>&dagger;</p>
864</td>
865<tr valign="top" align="left">
866<td width="8%"></td>
867<td width="41%">
868
869<p>TIFFTAG_SAMPLESPERPIXEL</p>
870</td>
871<td width="8%">
872
873<p>1</p>
874</td>
875<td width="24%">
876
877<p>uint16</p>
878</td>
879<td width="16%">
880
881<p>&dagger; value must be &lt;= 4</p>
882</td>
883<tr valign="top" align="left">
884<td width="8%"></td>
885<td width="41%">
886
887<p>TIFFTAG_SMAXSAMPLEVALUE</p>
888</td>
889<td width="8%">
890
891<p>1</p>
892</td>
893<td width="24%">
894
895<p>double</p>
896</td>
897<td width="16%">
898</td>
899<tr valign="top" align="left">
900<td width="8%"></td>
901<td width="41%">
902
903<p>TIFFTAG_SMINSAMPLEVALUE</p>
904</td>
905<td width="8%">
906
907<p>1</p>
908</td>
909<td width="24%">
910
911<p>double</p>
912</td>
913<td width="16%">
914</td>
915<tr valign="top" align="left">
916<td width="8%"></td>
917<td width="41%">
918
919<p>TIFFTAG_SOFTWARE</p>
920</td>
921<td width="8%">
922
923<p>1</p>
924</td>
925<td width="24%">
926
927<p>char*</p>
928</td>
929<td width="16%">
930</td>
931<tr valign="top" align="left">
932<td width="8%"></td>
933<td width="41%">
934
935<p>TIFFTAG_STONITS</p>
936</td>
937<td width="8%">
938
939<p>1</p>
940</td>
941<td width="24%">
942
943<p>double</p>
944</td>
945<td width="16%">
946
947<p>&dagger;</p>
948</td>
949<tr valign="top" align="left">
950<td width="8%"></td>
951<td width="41%">
952
953<p>TIFFTAG_SUBFILETYPE</p>
954</td>
955<td width="8%">
956
957<p>1</p>
958</td>
959<td width="24%">
960
961<p>uint32</p>
962</td>
963<td width="16%">
964</td>
965<tr valign="top" align="left">
966<td width="8%"></td>
967<td width="41%">
968
969<p>TIFFTAG_SUBIFD</p>
970</td>
971<td width="8%">
972
973<p>2</p>
974</td>
975<td width="24%">
976
977<p>uint16,uint32*</p>
978</td>
979<td width="16%">
980
981<p>count &amp; offsets array</p>
982</td>
983<tr valign="top" align="left">
984<td width="8%"></td>
985<td width="41%">
986
987<p>TIFFTAG_TARGETPRINTER</p>
988</td>
989<td width="8%">
990
991<p>1</p>
992</td>
993<td width="24%">
994
995<p>char*</p>
996</td>
997<td width="16%">
998</td>
999<tr valign="top" align="left">
1000<td width="8%"></td>
1001<td width="41%">
1002
1003<p>TIFFTAG_THRESHHOLDING</p>
1004</td>
1005<td width="8%">
1006
1007<p>1</p>
1008</td>
1009<td width="24%">
1010
1011<p>uint16</p>
1012</td>
1013<td width="16%">
1014</td>
1015<tr valign="top" align="left">
1016<td width="8%"></td>
1017<td width="41%">
1018
1019<p>TIFFTAG_TILEDEPTH</p>
1020</td>
1021<td width="8%">
1022
1023<p>1</p>
1024</td>
1025<td width="24%">
1026
1027<p>uint32</p>
1028</td>
1029<td width="16%">
1030
1031<p>&dagger;</p>
1032</td>
1033<tr valign="top" align="left">
1034<td width="8%"></td>
1035<td width="41%">
1036
1037<p>TIFFTAG_TILELENGTH</p>
1038</td>
1039<td width="8%">
1040
1041<p>1</p>
1042</td>
1043<td width="24%">
1044
1045<p>uint32</p>
1046</td>
1047<td width="16%">
1048
1049<p>&dagger; must be a multiple of 8</p>
1050</td>
1051<tr valign="top" align="left">
1052<td width="8%"></td>
1053<td width="41%">
1054
1055<p>TIFFTAG_TILEWIDTH</p>
1056</td>
1057<td width="8%">
1058
1059<p>1</p>
1060</td>
1061<td width="24%">
1062
1063<p>uint32</p>
1064</td>
1065<td width="16%">
1066
1067<p>&dagger; must be a multiple of 8</p>
1068</td>
1069<tr valign="top" align="left">
1070<td width="8%"></td>
1071<td width="41%">
1072
1073<p>TIFFTAG_TRANSFERFUNCTION</p>
1074</td>
1075<td width="8%">
1076
1077<p>1 or 3&Dagger; uint16*</p>
1078</td>
1079<td width="24%"></td>
1080<td width="16%">
1081
1082<p>1&lt;&lt;BitsPerSample entry arrays</p>
1083</td>
1084<tr valign="top" align="left">
1085<td width="8%"></td>
1086<td width="41%">
1087
1088<p>TIFFTAG_XPOSITION</p>
1089</td>
1090<td width="8%">
1091
1092<p>1</p>
1093</td>
1094<td width="24%">
1095
1096<p>float</p>
1097</td>
1098<td width="16%">
1099</td>
1100<tr valign="top" align="left">
1101<td width="8%"></td>
1102<td width="41%">
1103
1104<p>TIFFTAG_XRESOLUTION</p>
1105</td>
1106<td width="8%">
1107
1108<p>1</p>
1109</td>
1110<td width="24%">
1111
1112<p>float</p>
1113</td>
1114<td width="16%">
1115</td>
1116<tr valign="top" align="left">
1117<td width="8%"></td>
1118<td width="41%">
1119
1120<p>TIFFTAG_WHITEPOINT</p>
1121</td>
1122<td width="8%">
1123
1124<p>1</p>
1125</td>
1126<td width="24%">
1127
1128<p>float*</p>
1129</td>
1130<td width="16%">
1131
1132<p>2-entry array</p>
1133</td>
1134<tr valign="top" align="left">
1135<td width="8%"></td>
1136<td width="41%">
1137
1138<p>TIFFTAG_YCBCRCOEFFICIENTS</p>
1139</td>
1140<td width="8%">
1141
1142<p>1</p>
1143</td>
1144<td width="24%">
1145
1146<p>float*</p>
1147</td>
1148<td width="16%">
1149
1150<p>&dagger; 3-entry array</p>
1151</td>
1152<tr valign="top" align="left">
1153<td width="8%"></td>
1154<td width="41%">
1155
1156<p>TIFFTAG_YCBCRPOSITIONING</p>
1157</td>
1158<td width="8%">
1159
1160<p>1</p>
1161</td>
1162<td width="24%">
1163
1164<p>uint16</p>
1165</td>
1166<td width="16%">
1167
1168<p>&dagger;</p>
1169</td>
1170<tr valign="top" align="left">
1171<td width="8%"></td>
1172<td width="41%">
1173
1174<p>TIFFTAG_YCBCRSAMPLING</p>
1175</td>
1176<td width="8%">
1177
1178<p>2</p>
1179</td>
1180<td width="24%">
1181
1182<p>uint16</p>
1183</td>
1184<td width="16%">
1185
1186<p>&dagger;</p>
1187</td>
1188<tr valign="top" align="left">
1189<td width="8%"></td>
1190<td width="41%">
1191
1192<p>TIFFTAG_YPOSITION</p>
1193</td>
1194<td width="8%">
1195
1196<p>1</p>
1197</td>
1198<td width="24%">
1199
1200<p>float</p>
1201</td>
1202<td width="16%">
1203</td>
1204<tr valign="top" align="left">
1205<td width="8%"></td>
1206<td width="41%">
1207
1208<p>TIFFTAG_YRESOLUTION</p>
1209</td>
1210<td width="8%">
1211
1212<p>1</p>
1213</td>
1214<td width="24%">
1215
1216<p>float</p>
1217</td>
1218<td width="16%">
1219</td>
1220<tr valign="top" align="left">
1221<td width="8%"></td>
1222<td width="41%">
1223
1224<p>TIFFTAG_PHOTOSHOP</p>
1225</td>
1226<td width="8%">
1227
1228<p>?</p>
1229</td>
1230<td width="24%">
1231
1232<p>uint32,void*</p>
1233</td>
1234<td width="16%">
1235
1236<p>count, data</p>
1237</td>
1238<tr valign="top" align="left">
1239<td width="8%"></td>
1240<td width="41%">
1241
1242<p>TIFFTAG_ICCPROFILE</p>
1243</td>
1244<td width="8%">
1245
1246<p>2</p>
1247</td>
1248<td width="24%">
1249
1250<p>uint32,void*</p>
1251</td>
1252<td width="16%">
1253
1254<p>count, profile data*</p>
1255</td>
1256</table>
1257<!-- INDENTATION -->
1258<table width="100%" border=0 rules="none" frame="void"
1259       cols="2" cellspacing="0" cellpadding="0">
1260<tr valign="top" align="left">
1261<td width="8%"></td>
1262<td width="91%">
1263<p>&dagger; Tag may not have its values changed once data is
1264written.<br>
1265&Dagger; If <i>SamplesPerPixel</i> is one, then a single
1266array is passed; otherwise three arrays should be
1267passed.<br>
1268* The contents of this field are quite complex. See <b>The
1269ICC Profile Format Specification</b>, Annex B.3
1270&quot;Embedding ICC Profiles in TIFF Files&quot; (available
1271at http://www.color.org) for an explanation.</p>
1272</td>
1273</table>
1274<a name="RETURN VALUES"></a>
1275<h2>RETURN VALUES</h2>
1276<!-- INDENTATION -->
1277<table width="100%" border=0 rules="none" frame="void"
1278       cols="2" cellspacing="0" cellpadding="0">
1279<tr valign="top" align="left">
1280<td width="8%"></td>
1281<td width="91%">
1282<p>1 is returned if the operation was successful. Otherwise,
12830 is returned if an error was detected.</p>
1284</td>
1285</table>
1286<a name="DIAGNOSTICS"></a>
1287<h2>DIAGNOSTICS</h2>
1288<!-- INDENTATION -->
1289<table width="100%" border=0 rules="none" frame="void"
1290       cols="2" cellspacing="0" cellpadding="0">
1291<tr valign="top" align="left">
1292<td width="8%"></td>
1293<td width="91%">
1294<p>All error messages are directed to the
1295<b>TIFFError</b>(3TIFF) routine.</p>
1296<!-- INDENTATION -->
1297<p><b>%s: Cannot modify tag &quot;%s&quot; while
1298writing</b>. Data has already been written to the file, so
1299the specified tag&rsquo;s value can not be changed. This
1300restriction is applied to all tags that affect the format of
1301written data.</p>
1302<!-- INDENTATION -->
1303<p><b>%d: Bad value for &quot;%s&quot;</b>. An invalid value
1304was supplied for the named tag.</p>
1305</td>
1306</table>
1307<a name="SEE ALSO"></a>
1308<h2>SEE ALSO</h2>
1309<!-- INDENTATION -->
1310<table width="100%" border=0 rules="none" frame="void"
1311       cols="2" cellspacing="0" cellpadding="0">
1312<tr valign="top" align="left">
1313<td width="8%"></td>
1314<td width="91%">
1315<p><b>TIFFOpen</b>(3TIFF), <b>TIFFGetField</b>(3TIFF),
1316<b>TIFFSetDirectory</b>(3TIFF),
1317<b>TIFFWriteDirectory</b>(3TIFF),
1318<b>TIFFReadDirectory</b>(3TIFF), <b>libtiff</b>(3TIFF)</p>
1319<!-- INDENTATION -->
1320<p>Libtiff library home page:
1321<b>http://www.remotesensing.org/libtiff/</b></p>
1322</td>
1323</table>
1324<hr>
1325</body>
1326</html>
1327