|
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 − 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 <tiffio.h></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 <stdarg.h></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>†</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<<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>†</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>† count & 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>† 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>†</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>†</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>†</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>†</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>†</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>†</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>† 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>† count & 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>† 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>†</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>†</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>†</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>† 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>† must be > 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>†</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>† value must be <= 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>†</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 & 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>†</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>† 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>† 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‡ uint16*</p> |
|
1132 </td> |
|
1133 <td width="24%"></td> |
|
1134 <td width="16%"> |
|
1135 |
|
1136 <p>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="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>† 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>†</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>†</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>† Tag may not have its values changed once data is |
|
1300 written.<br> |
|
1301 ‡ 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 "Embedding ICC Profiles in TIFF Files" (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 "%s" while |
|
1334 writing</b>. Data has already been written to the file, so |
|
1335 the specified tag’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 "%s"</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> |