src/tiff/html/man/TIFFSetField.3tiff.html

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