1<!-- Creator     : groff version 1.18.1 -->
2<!-- CreationDate: Sat Feb 24 17:59:58 2007 -->
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_FAXFILLFUNC</p>
304</td>
305<td width="8%">
306
307<p>1</p>
308</td>
309<td width="24%">
310
311<p>TIFFFaxFillFunc</p>
312</td>
313<td width="16%">
314
315<p>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_FAXMODE</p>
322</td>
323<td width="8%">
324
325<p>1</p>
326</td>
327<td width="24%">
328
329<p>int</p>
330</td>
331<td width="16%">
332
333<p>&dagger; 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_ICCPROFILE</p>
426</td>
427<td width="8%">
428
429<p>2</p>
430</td>
431<td width="24%">
432
433<p>uint32,void*</p>
434</td>
435<td width="16%">
436
437<p>count, profile data</p>
438</td>
439<tr valign="top" align="left">
440<td width="8%"></td>
441<td width="41%">
442
443<p>TIFFTAG_IMAGEDEPTH</p>
444</td>
445<td width="8%">
446
447<p>1</p>
448</td>
449<td width="24%">
450
451<p>uint32</p>
452</td>
453<td width="16%">
454
455<p>&dagger;</p>
456</td>
457<tr valign="top" align="left">
458<td width="8%"></td>
459<td width="41%">
460
461<p>TIFFTAG_IMAGEDESCRIPTION</p>
462</td>
463<td width="8%">
464
465<p>1</p>
466</td>
467<td width="24%">
468
469<p>char*</p>
470</td>
471<td width="16%">
472</td>
473<tr valign="top" align="left">
474<td width="8%"></td>
475<td width="41%">
476
477<p>TIFFTAG_IMAGELENGTH</p>
478</td>
479<td width="8%">
480
481<p>1</p>
482</td>
483<td width="24%">
484
485<p>uint32</p>
486</td>
487<td width="16%">
488</td>
489<tr valign="top" align="left">
490<td width="8%"></td>
491<td width="41%">
492
493<p>TIFFTAG_IMAGEWIDTH</p>
494</td>
495<td width="8%">
496
497<p>1</p>
498</td>
499<td width="24%">
500
501<p>uint32</p>
502</td>
503<td width="16%">
504
505<p>&dagger;</p>
506</td>
507<tr valign="top" align="left">
508<td width="8%"></td>
509<td width="41%">
510
511<p>TIFFTAG_INKNAMES</p>
512</td>
513<td width="8%">
514
515<p>2</p>
516</td>
517<td width="24%">
518
519<p>uint16, char*</p>
520</td>
521<td width="16%">
522</td>
523<tr valign="top" align="left">
524<td width="8%"></td>
525<td width="41%">
526
527<p>TIFFTAG_INKSET</p>
528</td>
529<td width="8%">
530
531<p>1</p>
532</td>
533<td width="24%">
534
535<p>uint16</p>
536</td>
537<td width="16%">
538
539<p>&dagger;</p>
540</td>
541<tr valign="top" align="left">
542<td width="8%"></td>
543<td width="41%">
544
545<p>TIFFTAG_JPEGCOLORMODE</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>&dagger; 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_JPEGQUALITY</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>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_JPEGTABLES</p>
582</td>
583<td width="8%">
584
585<p>2</p>
586</td>
587<td width="24%">
588
589<p>uint32*,void*</p>
590</td>
591<td width="16%">
592
593<p>&dagger; count &amp; tables</p>
594</td>
595<tr valign="top" align="left">
596<td width="8%"></td>
597<td width="41%">
598
599<p>TIFFTAG_JPEGTABLESMODE</p>
600</td>
601<td width="8%">
602
603<p>1</p>
604</td>
605<td width="24%">
606
607<p>int</p>
608</td>
609<td width="16%">
610
611<p>&dagger; JPEG pseudo-tag</p>
612</td>
613<tr valign="top" align="left">
614<td width="8%"></td>
615<td width="41%">
616
617<p>TIFFTAG_MAKE</p>
618</td>
619<td width="8%">
620
621<p>1</p>
622</td>
623<td width="24%">
624
625<p>char*</p>
626</td>
627<td width="16%">
628</td>
629<tr valign="top" align="left">
630<td width="8%"></td>
631<td width="41%">
632
633<p>TIFFTAG_MATTEING</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
645<p>&dagger;</p>
646</td>
647<tr valign="top" align="left">
648<td width="8%"></td>
649<td width="41%">
650
651<p>TIFFTAG_MAXSAMPLEVALUE</p>
652</td>
653<td width="8%">
654
655<p>1</p>
656</td>
657<td width="24%">
658
659<p>uint16</p>
660</td>
661<td width="16%">
662</td>
663<tr valign="top" align="left">
664<td width="8%"></td>
665<td width="41%">
666
667<p>TIFFTAG_MINSAMPLEVALUE</p>
668</td>
669<td width="8%">
670
671<p>1</p>
672</td>
673<td width="24%">
674
675<p>uint16</p>
676</td>
677<td width="16%">
678</td>
679<tr valign="top" align="left">
680<td width="8%"></td>
681<td width="41%">
682
683<p>TIFFTAG_MODEL</p>
684</td>
685<td width="8%">
686
687<p>1</p>
688</td>
689<td width="24%">
690
691<p>char*</p>
692</td>
693<td width="16%">
694</td>
695<tr valign="top" align="left">
696<td width="8%"></td>
697<td width="41%">
698
699<p>TIFFTAG_ORIENTATION</p>
700</td>
701<td width="8%">
702
703<p>1</p>
704</td>
705<td width="24%">
706
707<p>uint16</p>
708</td>
709<td width="16%">
710</td>
711<tr valign="top" align="left">
712<td width="8%"></td>
713<td width="41%">
714
715<p>TIFFTAG_PAGENAME</p>
716</td>
717<td width="8%">
718
719<p>1</p>
720</td>
721<td width="24%">
722
723<p>char*</p>
724</td>
725<td width="16%">
726</td>
727<tr valign="top" align="left">
728<td width="8%"></td>
729<td width="41%">
730
731<p>TIFFTAG_PAGENUMBER</p>
732</td>
733<td width="8%">
734
735<p>2</p>
736</td>
737<td width="24%">
738
739<p>uint16</p>
740</td>
741<td width="16%">
742</td>
743<tr valign="top" align="left">
744<td width="8%"></td>
745<td width="41%">
746
747<p>TIFFTAG_PHOTOMETRIC</p>
748</td>
749<td width="8%">
750
751<p>1</p>
752</td>
753<td width="24%">
754
755<p>uint16</p>
756</td>
757<td width="16%">
758</td>
759<tr valign="top" align="left">
760<td width="8%"></td>
761<td width="41%">
762
763<p>TIFFTAG_PHOTOSHOP</p>
764</td>
765<td width="8%">
766
767<p>?</p>
768</td>
769<td width="24%">
770
771<p>uint32,void*</p>
772</td>
773<td width="16%">
774
775<p>count, data</p>
776</td>
777<tr valign="top" align="left">
778<td width="8%"></td>
779<td width="41%">
780
781<p>TIFFTAG_PLANARCONFIG</p>
782</td>
783<td width="8%">
784
785<p>1</p>
786</td>
787<td width="24%">
788
789<p>uint16</p>
790</td>
791<td width="16%">
792
793<p>&dagger;</p>
794</td>
795<tr valign="top" align="left">
796<td width="8%"></td>
797<td width="41%">
798
799<p>TIFFTAG_PREDICTOR</p>
800</td>
801<td width="8%">
802
803<p>1</p>
804</td>
805<td width="24%">
806
807<p>uint16</p>
808</td>
809<td width="16%">
810
811<p>&dagger;</p>
812</td>
813<tr valign="top" align="left">
814<td width="8%"></td>
815<td width="41%">
816
817<p>TIFFTAG_PRIMARYCHROMATICITIES</p>
818</td>
819<td width="8%">
820
821<p>1</p>
822</td>
823<td width="24%">
824
825<p>float*</p>
826</td>
827<td width="16%">
828
829<p>6-entry array</p>
830</td>
831<tr valign="top" align="left">
832<td width="8%"></td>
833<td width="41%">
834
835<p>TIFFTAG_REFERENCEBLACKWHITE</p>
836</td>
837<td width="8%">
838
839<p>1</p>
840</td>
841<td width="24%">
842
843<p>float*</p>
844</td>
845<td width="16%">
846
847<p>&dagger; 2*SamplesPerPixel array</p>
848</td>
849<tr valign="top" align="left">
850<td width="8%"></td>
851<td width="41%">
852
853<p>TIFFTAG_RESOLUTIONUNIT</p>
854</td>
855<td width="8%">
856
857<p>1</p>
858</td>
859<td width="24%">
860
861<p>uint16</p>
862</td>
863<td width="16%">
864</td>
865<tr valign="top" align="left">
866<td width="8%"></td>
867<td width="41%">
868
869<p>TIFFTAG_RICHTIFFIPTC</p>
870</td>
871<td width="8%">
872
873<p>2</p>
874</td>
875<td width="24%">
876
877<p>uint32,void*</p>
878</td>
879<td width="16%">
880
881<p>count, data</p>
882</td>
883<tr valign="top" align="left">
884<td width="8%"></td>
885<td width="41%">
886
887<p>TIFFTAG_ROWSPERSTRIP</p>
888</td>
889<td width="8%">
890
891<p>1</p>
892</td>
893<td width="24%">
894
895<p>uint32</p>
896</td>
897<td width="16%">
898
899<p>&dagger; must be &gt; 0</p>
900</td>
901<tr valign="top" align="left">
902<td width="8%"></td>
903<td width="41%">
904
905<p>TIFFTAG_SAMPLEFORMAT</p>
906</td>
907<td width="8%">
908
909<p>1</p>
910</td>
911<td width="24%">
912
913<p>uint16</p>
914</td>
915<td width="16%">
916
917<p>&dagger;</p>
918</td>
919<tr valign="top" align="left">
920<td width="8%"></td>
921<td width="41%">
922
923<p>TIFFTAG_SAMPLESPERPIXEL</p>
924</td>
925<td width="8%">
926
927<p>1</p>
928</td>
929<td width="24%">
930
931<p>uint16</p>
932</td>
933<td width="16%">
934
935<p>&dagger; value must be &lt;= 4</p>
936</td>
937<tr valign="top" align="left">
938<td width="8%"></td>
939<td width="41%">
940
941<p>TIFFTAG_SMAXSAMPLEVALUE</p>
942</td>
943<td width="8%">
944
945<p>1</p>
946</td>
947<td width="24%">
948
949<p>double</p>
950</td>
951<td width="16%">
952</td>
953<tr valign="top" align="left">
954<td width="8%"></td>
955<td width="41%">
956
957<p>TIFFTAG_SMINSAMPLEVALUE</p>
958</td>
959<td width="8%">
960
961<p>1</p>
962</td>
963<td width="24%">
964
965<p>double</p>
966</td>
967<td width="16%">
968</td>
969<tr valign="top" align="left">
970<td width="8%"></td>
971<td width="41%">
972
973<p>TIFFTAG_SOFTWARE</p>
974</td>
975<td width="8%">
976
977<p>1</p>
978</td>
979<td width="24%">
980
981<p>char*</p>
982</td>
983<td width="16%">
984</td>
985<tr valign="top" align="left">
986<td width="8%"></td>
987<td width="41%">
988
989<p>TIFFTAG_STONITS</p>
990</td>
991<td width="8%">
992
993<p>1</p>
994</td>
995<td width="24%">
996
997<p>double</p>
998</td>
999<td width="16%">
1000
1001<p>&dagger;</p>
1002</td>
1003<tr valign="top" align="left">
1004<td width="8%"></td>
1005<td width="41%">
1006
1007<p>TIFFTAG_SUBFILETYPE</p>
1008</td>
1009<td width="8%">
1010
1011<p>1</p>
1012</td>
1013<td width="24%">
1014
1015<p>uint32</p>
1016</td>
1017<td width="16%">
1018</td>
1019<tr valign="top" align="left">
1020<td width="8%"></td>
1021<td width="41%">
1022
1023<p>TIFFTAG_SUBIFD</p>
1024</td>
1025<td width="8%">
1026
1027<p>2</p>
1028</td>
1029<td width="24%">
1030
1031<p>uint16,uint32*</p>
1032</td>
1033<td width="16%">
1034
1035<p>count &amp; offsets array</p>
1036</td>
1037<tr valign="top" align="left">
1038<td width="8%"></td>
1039<td width="41%">
1040
1041<p>TIFFTAG_TARGETPRINTER</p>
1042</td>
1043<td width="8%">
1044
1045<p>1</p>
1046</td>
1047<td width="24%">
1048
1049<p>char*</p>
1050</td>
1051<td width="16%">
1052</td>
1053<tr valign="top" align="left">
1054<td width="8%"></td>
1055<td width="41%">
1056
1057<p>TIFFTAG_THRESHHOLDING</p>
1058</td>
1059<td width="8%">
1060
1061<p>1</p>
1062</td>
1063<td width="24%">
1064
1065<p>uint16</p>
1066</td>
1067<td width="16%">
1068</td>
1069<tr valign="top" align="left">
1070<td width="8%"></td>
1071<td width="41%">
1072
1073<p>TIFFTAG_TILEDEPTH</p>
1074</td>
1075<td width="8%">
1076
1077<p>1</p>
1078</td>
1079<td width="24%">
1080
1081<p>uint32</p>
1082</td>
1083<td width="16%">
1084
1085<p>&dagger;</p>
1086</td>
1087<tr valign="top" align="left">
1088<td width="8%"></td>
1089<td width="41%">
1090
1091<p>TIFFTAG_TILELENGTH</p>
1092</td>
1093<td width="8%">
1094
1095<p>1</p>
1096</td>
1097<td width="24%">
1098
1099<p>uint32</p>
1100</td>
1101<td width="16%">
1102
1103<p>&dagger; must be a multiple of 8</p>
1104</td>
1105<tr valign="top" align="left">
1106<td width="8%"></td>
1107<td width="41%">
1108
1109<p>TIFFTAG_TILEWIDTH</p>
1110</td>
1111<td width="8%">
1112
1113<p>1</p>
1114</td>
1115<td width="24%">
1116
1117<p>uint32</p>
1118</td>
1119<td width="16%">
1120
1121<p>&dagger; must be a multiple of 8</p>
1122</td>
1123<tr valign="top" align="left">
1124<td width="8%"></td>
1125<td width="41%">
1126
1127<p>TIFFTAG_TRANSFERFUNCTION</p>
1128</td>
1129<td width="8%">
1130
1131<p>1 or 3&Dagger; uint16*</p>
1132</td>
1133<td width="24%"></td>
1134<td width="16%">
1135
1136<p>1&lt;&lt;BitsPerSample entry arrays</p>
1137</td>
1138<tr valign="top" align="left">
1139<td width="8%"></td>
1140<td width="41%">
1141
1142<p>TIFFTAG_WHITEPOINT</p>
1143</td>
1144<td width="8%">
1145
1146<p>1</p>
1147</td>
1148<td width="24%">
1149
1150<p>float*</p>
1151</td>
1152<td width="16%">
1153
1154<p>2-entry array</p>
1155</td>
1156<tr valign="top" align="left">
1157<td width="8%"></td>
1158<td width="41%">
1159
1160<p>TIFFTAG_XMLPACKET</p>
1161</td>
1162<td width="8%">
1163
1164<p>2</p>
1165</td>
1166<td width="24%">
1167
1168<p>uint32,void*</p>
1169</td>
1170<td width="16%">
1171
1172<p>count, data</p>
1173</td>
1174<tr valign="top" align="left">
1175<td width="8%"></td>
1176<td width="41%">
1177
1178<p>TIFFTAG_XPOSITION</p>
1179</td>
1180<td width="8%">
1181
1182<p>1</p>
1183</td>
1184<td width="24%">
1185
1186<p>float</p>
1187</td>
1188<td width="16%">
1189</td>
1190<tr valign="top" align="left">
1191<td width="8%"></td>
1192<td width="41%">
1193
1194<p>TIFFTAG_XRESOLUTION</p>
1195</td>
1196<td width="8%">
1197
1198<p>1</p>
1199</td>
1200<td width="24%">
1201
1202<p>float</p>
1203</td>
1204<td width="16%">
1205</td>
1206<tr valign="top" align="left">
1207<td width="8%"></td>
1208<td width="41%">
1209
1210<p>TIFFTAG_YCBCRCOEFFICIENTS</p>
1211</td>
1212<td width="8%">
1213
1214<p>1</p>
1215</td>
1216<td width="24%">
1217
1218<p>float*</p>
1219</td>
1220<td width="16%">
1221
1222<p>&dagger; 3-entry array</p>
1223</td>
1224<tr valign="top" align="left">
1225<td width="8%"></td>
1226<td width="41%">
1227
1228<p>TIFFTAG_YCBCRPOSITIONING</p>
1229</td>
1230<td width="8%">
1231
1232<p>1</p>
1233</td>
1234<td width="24%">
1235
1236<p>uint16</p>
1237</td>
1238<td width="16%">
1239
1240<p>&dagger;</p>
1241</td>
1242<tr valign="top" align="left">
1243<td width="8%"></td>
1244<td width="41%">
1245
1246<p>TIFFTAG_YCBCRSAMPLING</p>
1247</td>
1248<td width="8%">
1249
1250<p>2</p>
1251</td>
1252<td width="24%">
1253
1254<p>uint16</p>
1255</td>
1256<td width="16%">
1257
1258<p>&dagger;</p>
1259</td>
1260<tr valign="top" align="left">
1261<td width="8%"></td>
1262<td width="41%">
1263
1264<p>TIFFTAG_YPOSITION</p>
1265</td>
1266<td width="8%">
1267
1268<p>1</p>
1269</td>
1270<td width="24%">
1271
1272<p>float</p>
1273</td>
1274<td width="16%">
1275</td>
1276<tr valign="top" align="left">
1277<td width="8%"></td>
1278<td width="41%">
1279
1280<p>TIFFTAG_YRESOLUTION</p>
1281</td>
1282<td width="8%">
1283
1284<p>1</p>
1285</td>
1286<td width="24%">
1287
1288<p>float</p>
1289</td>
1290<td width="16%">
1291</td>
1292</table>
1293<!-- INDENTATION -->
1294<table width="100%" border=0 rules="none" frame="void"
1295       cols="2" cellspacing="0" cellpadding="0">
1296<tr valign="top" align="left">
1297<td width="8%"></td>
1298<td width="91%">
1299<p>&dagger; Tag may not have its values changed once data is
1300written.<br>
1301&Dagger; If <i>SamplesPerPixel</i> is one, then a single
1302array is passed; otherwise three arrays should be
1303passed.<br>
1304* The contents of this field are quite complex. See <b>The
1305ICC Profile Format Specification</b>, Annex B.3
1306&quot;Embedding ICC Profiles in TIFF Files&quot; (available
1307at http://www.color.org) for an explanation.</p>
1308</td>
1309</table>
1310<a name="RETURN VALUES"></a>
1311<h2>RETURN VALUES</h2>
1312<!-- INDENTATION -->
1313<table width="100%" border=0 rules="none" frame="void"
1314       cols="2" cellspacing="0" cellpadding="0">
1315<tr valign="top" align="left">
1316<td width="8%"></td>
1317<td width="91%">
1318<p>1 is returned if the operation was successful. Otherwise,
13190 is returned if an error was detected.</p>
1320</td>
1321</table>
1322<a name="DIAGNOSTICS"></a>
1323<h2>DIAGNOSTICS</h2>
1324<!-- INDENTATION -->
1325<table width="100%" border=0 rules="none" frame="void"
1326       cols="2" cellspacing="0" cellpadding="0">
1327<tr valign="top" align="left">
1328<td width="8%"></td>
1329<td width="91%">
1330<p>All error messages are directed to the
1331<b>TIFFError</b>(3TIFF) routine.</p>
1332<!-- INDENTATION -->
1333<p><b>%s: Cannot modify tag &quot;%s&quot; while
1334writing</b>. Data has already been written to the file, so
1335the specified tag&rsquo;s value can not be changed. This
1336restriction is applied to all tags that affect the format of
1337written data.</p>
1338<!-- INDENTATION -->
1339<p><b>%d: Bad value for &quot;%s&quot;</b>. An invalid value
1340was supplied for the named tag.</p>
1341</td>
1342</table>
1343<a name="SEE ALSO"></a>
1344<h2>SEE ALSO</h2>
1345<!-- INDENTATION -->
1346<table width="100%" border=0 rules="none" frame="void"
1347       cols="2" cellspacing="0" cellpadding="0">
1348<tr valign="top" align="left">
1349<td width="8%"></td>
1350<td width="91%">
1351<p><b>TIFFOpen</b>(3TIFF), <b>TIFFGetField</b>(3TIFF),
1352<b>TIFFSetDirectory</b>(3TIFF),
1353<b>TIFFWriteDirectory</b>(3TIFF),
1354<b>TIFFReadDirectory</b>(3TIFF), <b>libtiff</b>(3TIFF)</p>
1355<!-- INDENTATION -->
1356<p>Libtiff library home page:
1357<b>http://www.remotesensing.org/libtiff/</b></p>
1358</td>
1359</table>
1360<hr>
1361</body>
1362</html>
1363