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