source: trunk/src/3rdparty/libtiff/html/man/TIFFGetField.3tiff.html

Last change on this file was 846, checked in by Dmitry A. Kuminov, 15 years ago

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