1<!-- Creator : groff version 1.18.1 --> 2<!-- CreationDate: Mon Mar 13 18:03:08 2006 --> 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 − 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 <tiffio.h></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 <stdarg.h></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<<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 & 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 & 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 & 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†</p> 1187</td> 1188<td width="23%"></td> 1189<td width="17%"> 1190 1191<p>uint16**1<<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*‡</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>† If <i>SamplesPerPixel</i> is one, then a single 1351array is returned; otherwise three arrays are returned.<br> 1352‡ The contents of this field are quite complex. See 1353<i>The ICC Profile Format Specification</i>, Annex B.3 1354"Embedding ICC Profiles in TIFF Files" (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’t find the tag in the table above that 1367means this is unsupported tag. But you still be able to read 1368it’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, &count, &data); 1384printf("Tag %d: %d, count %d0, 33424, *(uint32 *)data, count); 1385TIFFGetField(tiff, 36867, &count, &data); 1386printf("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> 1447