src/tiff/html/man/TIFFGetField.3tiff.html

   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 &minus; get the value(s) of a
  30 tag 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>
  50 int TIFFGetFieldDefaulted(TIFF *</b><i>tif</i><b>,
  51 ttag_t</b> <i>tag</i><b>,</b> <i>...</i><b>)<br>
  52 int TIFFVGetFieldDefaulted(TIFF *</b><i>tif</i><b>,
  53 ttag_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
  65 pseudo-tag associated with the the current directory of the
  66 opened <small>TIFF</small> file <i>tif</i>. (A
  67 <i>pseudo-tag</i> is a parameter that is used to control the
  68 operation of the <small>TIFF</small> library but whose value
  69 is not read or written to the underlying file.) The file
  70 must have been previously opened with
  71 <i>TIFFOpen</i>(3TIFF). The tag is identified by <i>tag</i>,
  72 one of the values defined in the include file <b>tiff.h</b>
  73 (see also the table below). The type and number of values
  74 returned is dependent on the tag being requested. The
  75 programming interface uses a variable argument list as
  76 prescribed by the <i>stdarg</i>(3) interface. The returned
  77 values should only be interpreted if <i>TIFFGetField</i>
  78 returns 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
  82 variable argument list. <i>TIFFVGetField</i> is useful for
  83 layering 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
  89 a tag is not defined in the current directory and it has a
  90 default value, then the default value is returned.</p>
  91 <!-- INDENTATION -->
  92 <p>The tags understood by <i>libtiff(3TIFF),</i> the number
  93 of parameter values, and the types for the returned values
  94 are shown below. The data types are specified as in C and
  95 correspond 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
  98 listed data types are pointers to storage where values
  99 should be returned. Consult the <small>TIFF</small>
 100 specification (or relevant industry specification) for
 101 information on the meaning of each tag and their possible
 102 values.</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
1351 array 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
1355 at 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
1367 means this is unsupported tag. But you still be able to read
1368 it&rsquo;s value if you know the data type of that tag. For
1369 example, if you want to read the LONG value from the tag
1370 33424 and ASCII string from the tag 36867 you can use the
1371 following 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;
1381 void    *data;
1382
1383 TIFFGetField(tiff, 33424, &amp;count, &amp;data);
1384 printf(&quot;Tag %d: %d, count %d0, 33424, *(uint32 *)data, count);
1385 TIFFGetField(tiff, 36867, &amp;count, &amp;data);
1386 printf(&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
1409 directory; 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
1424 supplied.</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>