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 − 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 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<<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 & 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 & 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 & 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†</p> 1132</td> 1133<td width="23%"></td> 1134<td width="17%"> 1135 1136<p>uint16**1<<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‡</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>† If <i>SamplesPerPixel</i> is one, then a single 1296array is returned; otherwise three arrays are returned.<br> 1297‡ The contents of this field are quite complex. See 1298<i>The ICC Profile Format Specification</i>, Annex B.3 1299"Embedding ICC Profiles in TIFF Files" (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’t find the tag in the table above that 1312means this is unsupported tag. But you still be able to read 1313it’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, &count, &data); 1329printf("Tag %d: %d, count %d0, 33424, *(uint32 *)data, count); 1330TIFFGetField(tiff, 36867, &count, &data); 1331printf("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