1
/* $Header: /pack/cvsroots/wxwindows/wxWindows/src/tiff/tif_print.c,v 1.4 2004/11/19 22:29:45 VZ Exp $ */
4
* Copyright (c) 1988-1997 Sam Leffler
5
* Copyright (c) 1991-1997 Silicon Graphics, Inc.
7
* Permission to use, copy, modify, distribute, and sell this software and
8
* its documentation for any purpose is hereby granted without fee, provided
9
* that (i) the above copyright notices and this permission notice appear in
10
* all copies of the software and related documentation, and (ii) the names of
11
* Sam Leffler and Silicon Graphics may not be used in any advertising or
12
* publicity relating to the software without the specific, prior written
13
* permission of Sam Leffler and Silicon Graphics.
15
* THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
16
* EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
17
* WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
19
* IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
20
* ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
21
* OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
22
* WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
23
* LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
30
* Directory Printing Support
37
static const char *photoNames[] = {
38
"min-is-white", /* PHOTOMETRIC_MINISWHITE */
39
"min-is-black", /* PHOTOMETRIC_MINISBLACK */
40
"RGB color", /* PHOTOMETRIC_RGB */
41
"palette color (RGB from colormap)", /* PHOTOMETRIC_PALETTE */
42
"transparency mask", /* PHOTOMETRIC_MASK */
43
"separated", /* PHOTOMETRIC_SEPARATED */
44
"YCbCr", /* PHOTOMETRIC_YCBCR */
46
"CIE L*a*b*", /* PHOTOMETRIC_CIELAB */
48
#define NPHOTONAMES (sizeof (photoNames) / sizeof (photoNames[0]))
50
static const char *orientNames[] = {
52
"row 0 top, col 0 lhs", /* ORIENTATION_TOPLEFT */
53
"row 0 top, col 0 rhs", /* ORIENTATION_TOPRIGHT */
54
"row 0 bottom, col 0 rhs", /* ORIENTATION_BOTRIGHT */
55
"row 0 bottom, col 0 lhs", /* ORIENTATION_BOTLEFT */
56
"row 0 lhs, col 0 top", /* ORIENTATION_LEFTTOP */
57
"row 0 rhs, col 0 top", /* ORIENTATION_RIGHTTOP */
58
"row 0 rhs, col 0 bottom", /* ORIENTATION_RIGHTBOT */
59
"row 0 lhs, col 0 bottom", /* ORIENTATION_LEFTBOT */
61
#define NORIENTNAMES (sizeof (orientNames) / sizeof (orientNames[0]))
64
* Print the contents of the current directory
65
* to the specified stdio file stream.
68
TIFFPrintDirectory(TIFF* tif, FILE* fd, long flags)
70
register TIFFDirectory *td;
75
fprintf(fd, "TIFF Directory at offset 0x%lx\n", tif->tif_diroff);
77
if (TIFFFieldSet(tif,FIELD_SUBFILETYPE)) {
78
fprintf(fd, " Subfile Type:");
80
if (td->td_subfiletype & FILETYPE_REDUCEDIMAGE) {
81
fprintf(fd, "%sreduced-resolution image", sep);
84
if (td->td_subfiletype & FILETYPE_PAGE) {
85
fprintf(fd, "%smulti-page document", sep);
88
if (td->td_subfiletype & FILETYPE_MASK)
89
fprintf(fd, "%stransparency mask", sep);
90
fprintf(fd, " (%lu = 0x%lx)\n",
91
(long) td->td_subfiletype, (long) td->td_subfiletype);
93
if (TIFFFieldSet(tif,FIELD_IMAGEDIMENSIONS)) {
94
fprintf(fd, " Image Width: %lu Image Length: %lu",
95
(u_long) td->td_imagewidth, (u_long) td->td_imagelength);
96
if (TIFFFieldSet(tif,FIELD_IMAGEDEPTH))
97
fprintf(fd, " Image Depth: %lu",
98
(u_long) td->td_imagedepth);
103
if (TIFFFieldSet(tif,FIELD_IMAGEFULLWIDTH) ||
104
TIFFFieldSet(tif,FIELD_IMAGEFULLLENGTH)) {
105
fprintf(fd, " Pixar Full Image Width: %lu Full Image Length: %lu\n",
106
(u_long) td->td_imagefullwidth,
107
(u_long) td->td_imagefulllength);
109
if (TIFFFieldSet(tif,FIELD_TEXTUREFORMAT))
110
_TIFFprintAsciiTag(fd, "Texture Format", td->td_textureformat);
111
if (TIFFFieldSet(tif,FIELD_WRAPMODES))
112
_TIFFprintAsciiTag(fd, "Texture Wrap Modes", td->td_wrapmodes);
113
if (TIFFFieldSet(tif,FIELD_FOVCOT))
114
fprintf(fd, " Field of View Cotangent: %g\n", td->td_fovcot);
115
if (TIFFFieldSet(tif,FIELD_MATRIX_WORLDTOSCREEN)) {
116
typedef float Matrix[4][4];
117
Matrix* m = (Matrix*)td->td_matrixWorldToScreen;
119
fprintf(fd, " Matrix NP:\n\t%g %g %g %g\n\t%g %g %g %g\n\t%g %g %g %g\n\t%g %g %g %g\n",
120
(*m)[0][0], (*m)[0][1], (*m)[0][2], (*m)[0][3],
121
(*m)[1][0], (*m)[1][1], (*m)[1][2], (*m)[1][3],
122
(*m)[2][0], (*m)[2][1], (*m)[2][2], (*m)[2][3],
123
(*m)[3][0], (*m)[3][1], (*m)[3][2], (*m)[3][3]);
125
if (TIFFFieldSet(tif,FIELD_MATRIX_WORLDTOCAMERA)) {
126
typedef float Matrix[4][4];
127
Matrix* m = (Matrix*)td->td_matrixWorldToCamera;
129
fprintf(fd, " Matrix Nl:\n\t%g %g %g %g\n\t%g %g %g %g\n\t%g %g %g %g\n\t%g %g %g %g\n",
130
(*m)[0][0], (*m)[0][1], (*m)[0][2], (*m)[0][3],
131
(*m)[1][0], (*m)[1][1], (*m)[1][2], (*m)[1][3],
132
(*m)[2][0], (*m)[2][1], (*m)[2][2], (*m)[2][3],
133
(*m)[3][0], (*m)[3][1], (*m)[3][2], (*m)[3][3]);
137
if (TIFFFieldSet(tif,FIELD_TILEDIMENSIONS)) {
138
fprintf(fd, " Tile Width: %lu Tile Length: %lu",
139
(u_long) td->td_tilewidth, (u_long) td->td_tilelength);
140
if (TIFFFieldSet(tif,FIELD_TILEDEPTH))
141
fprintf(fd, " Tile Depth: %lu",
142
(u_long) td->td_tiledepth);
145
if (TIFFFieldSet(tif,FIELD_RESOLUTION)) {
146
fprintf(fd, " Resolution: %g, %g",
147
td->td_xresolution, td->td_yresolution);
148
if (TIFFFieldSet(tif,FIELD_RESOLUTIONUNIT)) {
149
switch (td->td_resolutionunit) {
151
fprintf(fd, " (unitless)");
154
fprintf(fd, " pixels/inch");
156
case RESUNIT_CENTIMETER:
157
fprintf(fd, " pixels/cm");
160
fprintf(fd, " (unit %u = 0x%x)",
161
td->td_resolutionunit,
162
td->td_resolutionunit);
168
if (TIFFFieldSet(tif,FIELD_POSITION))
169
fprintf(fd, " Position: %g, %g\n",
170
td->td_xposition, td->td_yposition);
171
if (TIFFFieldSet(tif,FIELD_BITSPERSAMPLE))
172
fprintf(fd, " Bits/Sample: %u\n", td->td_bitspersample);
173
if (TIFFFieldSet(tif,FIELD_SAMPLEFORMAT)) {
174
fprintf(fd, " Sample Format: ");
175
switch (td->td_sampleformat) {
176
case SAMPLEFORMAT_VOID:
177
fprintf(fd, "void\n");
179
case SAMPLEFORMAT_INT:
180
fprintf(fd, "signed integer\n");
182
case SAMPLEFORMAT_UINT:
183
fprintf(fd, "unsigned integer\n");
185
case SAMPLEFORMAT_IEEEFP:
186
fprintf(fd, "IEEE floating point\n");
188
case SAMPLEFORMAT_COMPLEXINT:
189
fprintf(fd, "complex signed integer\n");
191
case SAMPLEFORMAT_COMPLEXIEEEFP:
192
fprintf(fd, "complex IEEE floating point\n");
195
fprintf(fd, "%u (0x%x)\n",
196
td->td_sampleformat, td->td_sampleformat);
200
if (TIFFFieldSet(tif,FIELD_COMPRESSION)) {
201
const TIFFCodec* c = TIFFFindCODEC(td->td_compression);
202
fprintf(fd, " Compression Scheme: ");
204
fprintf(fd, "%s\n", c->name);
206
fprintf(fd, "%u (0x%x)\n",
207
td->td_compression, td->td_compression);
209
if (TIFFFieldSet(tif,FIELD_PHOTOMETRIC)) {
210
fprintf(fd, " Photometric Interpretation: ");
211
if (td->td_photometric < NPHOTONAMES)
212
fprintf(fd, "%s\n", photoNames[td->td_photometric]);
214
switch (td->td_photometric) {
215
case PHOTOMETRIC_LOGL:
216
fprintf(fd, "CIE Log2(L)\n");
218
case PHOTOMETRIC_LOGLUV:
219
fprintf(fd, "CIE Log2(L) (u',v')\n");
222
fprintf(fd, "%u (0x%x)\n",
223
td->td_photometric, td->td_photometric);
228
if (TIFFFieldSet(tif,FIELD_EXTRASAMPLES) && td->td_extrasamples) {
229
fprintf(fd, " Extra Samples: %u<", td->td_extrasamples);
231
for (i = 0; i < td->td_extrasamples; i++) {
232
switch (td->td_sampleinfo[i]) {
233
case EXTRASAMPLE_UNSPECIFIED:
234
fprintf(fd, "%sunspecified", sep);
236
case EXTRASAMPLE_ASSOCALPHA:
237
fprintf(fd, "%sassoc-alpha", sep);
239
case EXTRASAMPLE_UNASSALPHA:
240
fprintf(fd, "%sunassoc-alpha", sep);
243
fprintf(fd, "%s%u (0x%x)", sep,
244
td->td_sampleinfo[i], td->td_sampleinfo[i]);
251
if (TIFFFieldSet(tif,FIELD_STONITS)) {
252
fprintf(fd, " Sample to Nits conversion factor: %.4e\n",
256
if (TIFFFieldSet(tif,FIELD_INKSET)) {
257
fprintf(fd, " Ink Set: ");
258
switch (td->td_inkset) {
260
fprintf(fd, "CMYK\n");
263
fprintf(fd, "%u (0x%x)\n",
264
td->td_inkset, td->td_inkset);
268
if (TIFFFieldSet(tif,FIELD_INKNAMES)) {
270
fprintf(fd, " Ink Names: ");
271
i = td->td_samplesperpixel;
273
for (cp = td->td_inknames; i > 0; cp = strchr(cp,'\0')+1, i--) {
274
fprintf(fd, "%s", sep);
275
_TIFFprintAscii(fd, cp);
279
if (TIFFFieldSet(tif,FIELD_NUMBEROFINKS))
280
fprintf(fd, " Number of Inks: %u\n", td->td_ninks);
281
if (TIFFFieldSet(tif,FIELD_DOTRANGE))
282
fprintf(fd, " Dot Range: %u-%u\n",
283
td->td_dotrange[0], td->td_dotrange[1]);
284
if (TIFFFieldSet(tif,FIELD_TARGETPRINTER))
285
_TIFFprintAsciiTag(fd, "Target Printer", td->td_targetprinter);
287
if (TIFFFieldSet(tif,FIELD_THRESHHOLDING)) {
288
fprintf(fd, " Thresholding: ");
289
switch (td->td_threshholding) {
290
case THRESHHOLD_BILEVEL:
291
fprintf(fd, "bilevel art scan\n");
293
case THRESHHOLD_HALFTONE:
294
fprintf(fd, "halftone or dithered scan\n");
296
case THRESHHOLD_ERRORDIFFUSE:
297
fprintf(fd, "error diffused\n");
300
fprintf(fd, "%u (0x%x)\n",
301
td->td_threshholding, td->td_threshholding);
305
if (TIFFFieldSet(tif,FIELD_FILLORDER)) {
306
fprintf(fd, " FillOrder: ");
307
switch (td->td_fillorder) {
308
case FILLORDER_MSB2LSB:
309
fprintf(fd, "msb-to-lsb\n");
311
case FILLORDER_LSB2MSB:
312
fprintf(fd, "lsb-to-msb\n");
315
fprintf(fd, "%u (0x%x)\n",
316
td->td_fillorder, td->td_fillorder);
321
if (TIFFFieldSet(tif,FIELD_YCBCRSUBSAMPLING))
324
* For hacky reasons (see tif_jpeg.c - JPEGFixupTestSubsampling),
325
* we need to fetch this rather than trust what is in our
328
uint16 subsampling[2];
330
TIFFGetField( tif, TIFFTAG_YCBCRSUBSAMPLING,
331
subsampling + 0, subsampling + 1 );
332
fprintf(fd, " YCbCr Subsampling: %u, %u\n",
333
subsampling[0], subsampling[1] );
335
if (TIFFFieldSet(tif,FIELD_YCBCRPOSITIONING)) {
336
fprintf(fd, " YCbCr Positioning: ");
337
switch (td->td_ycbcrpositioning) {
338
case YCBCRPOSITION_CENTERED:
339
fprintf(fd, "centered\n");
341
case YCBCRPOSITION_COSITED:
342
fprintf(fd, "cosited\n");
345
fprintf(fd, "%u (0x%x)\n",
346
td->td_ycbcrpositioning, td->td_ycbcrpositioning);
350
if (TIFFFieldSet(tif,FIELD_YCBCRCOEFFICIENTS))
351
fprintf(fd, " YCbCr Coefficients: %g, %g, %g\n",
352
td->td_ycbcrcoeffs[0],
353
td->td_ycbcrcoeffs[1],
354
td->td_ycbcrcoeffs[2]);
356
if (TIFFFieldSet(tif,FIELD_HALFTONEHINTS))
357
fprintf(fd, " Halftone Hints: light %u dark %u\n",
358
td->td_halftonehints[0], td->td_halftonehints[1]);
359
if (TIFFFieldSet(tif,FIELD_ARTIST))
360
_TIFFprintAsciiTag(fd, "Artist", td->td_artist);
361
if (TIFFFieldSet(tif,FIELD_DATETIME))
362
_TIFFprintAsciiTag(fd, "Date & Time", td->td_datetime);
363
if (TIFFFieldSet(tif,FIELD_HOSTCOMPUTER))
364
_TIFFprintAsciiTag(fd, "Host Computer", td->td_hostcomputer);
365
if (TIFFFieldSet(tif,FIELD_COPYRIGHT))
366
_TIFFprintAsciiTag(fd, "Copyright", td->td_copyright);
367
if (TIFFFieldSet(tif,FIELD_DOCUMENTNAME))
368
_TIFFprintAsciiTag(fd, "Document Name", td->td_documentname);
369
if (TIFFFieldSet(tif,FIELD_IMAGEDESCRIPTION))
370
_TIFFprintAsciiTag(fd, "Image Description", td->td_imagedescription);
371
if (TIFFFieldSet(tif,FIELD_MAKE))
372
_TIFFprintAsciiTag(fd, "Make", td->td_make);
373
if (TIFFFieldSet(tif,FIELD_MODEL))
374
_TIFFprintAsciiTag(fd, "Model", td->td_model);
375
if (TIFFFieldSet(tif,FIELD_ORIENTATION)) {
376
fprintf(fd, " Orientation: ");
377
if (td->td_orientation < NORIENTNAMES)
378
fprintf(fd, "%s\n", orientNames[td->td_orientation]);
380
fprintf(fd, "%u (0x%x)\n",
381
td->td_orientation, td->td_orientation);
383
if (TIFFFieldSet(tif,FIELD_SAMPLESPERPIXEL))
384
fprintf(fd, " Samples/Pixel: %u\n", td->td_samplesperpixel);
385
if (TIFFFieldSet(tif,FIELD_ROWSPERSTRIP)) {
386
fprintf(fd, " Rows/Strip: ");
387
if (td->td_rowsperstrip == (uint32) -1)
388
fprintf(fd, "(infinite)\n");
390
fprintf(fd, "%lu\n", (u_long) td->td_rowsperstrip);
392
if (TIFFFieldSet(tif,FIELD_MINSAMPLEVALUE))
393
fprintf(fd, " Min Sample Value: %u\n", td->td_minsamplevalue);
394
if (TIFFFieldSet(tif,FIELD_MAXSAMPLEVALUE))
395
fprintf(fd, " Max Sample Value: %u\n", td->td_maxsamplevalue);
396
if (TIFFFieldSet(tif,FIELD_SMINSAMPLEVALUE))
397
fprintf(fd, " SMin Sample Value: %g\n",
398
td->td_sminsamplevalue);
399
if (TIFFFieldSet(tif,FIELD_SMAXSAMPLEVALUE))
400
fprintf(fd, " SMax Sample Value: %g\n",
401
td->td_smaxsamplevalue);
402
if (TIFFFieldSet(tif,FIELD_PLANARCONFIG)) {
403
fprintf(fd, " Planar Configuration: ");
404
switch (td->td_planarconfig) {
405
case PLANARCONFIG_CONTIG:
406
fprintf(fd, "single image plane\n");
408
case PLANARCONFIG_SEPARATE:
409
fprintf(fd, "separate image planes\n");
412
fprintf(fd, "%u (0x%x)\n",
413
td->td_planarconfig, td->td_planarconfig);
417
if (TIFFFieldSet(tif,FIELD_PAGENAME))
418
_TIFFprintAsciiTag(fd, "Page Name", td->td_pagename);
419
if (TIFFFieldSet(tif,FIELD_PAGENUMBER))
420
fprintf(fd, " Page Number: %u-%u\n",
421
td->td_pagenumber[0], td->td_pagenumber[1]);
422
if (TIFFFieldSet(tif,FIELD_COLORMAP)) {
423
fprintf(fd, " Color Map: ");
424
if (flags & TIFFPRINT_COLORMAP) {
426
n = 1L<<td->td_bitspersample;
427
for (l = 0; l < n; l++)
428
fprintf(fd, " %5lu: %5u %5u %5u\n",
430
td->td_colormap[0][l],
431
td->td_colormap[1][l],
432
td->td_colormap[2][l]);
434
fprintf(fd, "(present)\n");
436
#ifdef COLORIMETRY_SUPPORT
437
if (TIFFFieldSet(tif,FIELD_WHITEPOINT))
438
fprintf(fd, " White Point: %g-%g\n",
439
td->td_whitepoint[0], td->td_whitepoint[1]);
440
if (TIFFFieldSet(tif,FIELD_PRIMARYCHROMAS))
441
fprintf(fd, " Primary Chromaticities: %g,%g %g,%g %g,%g\n",
442
td->td_primarychromas[0], td->td_primarychromas[1],
443
td->td_primarychromas[2], td->td_primarychromas[3],
444
td->td_primarychromas[4], td->td_primarychromas[5]);
445
if (TIFFFieldSet(tif,FIELD_REFBLACKWHITE)) {
446
fprintf(fd, " Reference Black/White:\n");
447
for (i = 0; i < td->td_samplesperpixel; i++)
448
fprintf(fd, " %2d: %5g %5g\n",
450
td->td_refblackwhite[2*i+0],
451
td->td_refblackwhite[2*i+1]);
453
if (TIFFFieldSet(tif,FIELD_TRANSFERFUNCTION)) {
454
fprintf(fd, " Transfer Function: ");
455
if (flags & TIFFPRINT_CURVES) {
457
n = 1L<<td->td_bitspersample;
458
for (l = 0; l < n; l++) {
459
fprintf(fd, " %2lu: %5u",
460
l, td->td_transferfunction[0][l]);
461
for (i = 1; i < td->td_samplesperpixel; i++)
463
td->td_transferfunction[i][l]);
467
fprintf(fd, "(present)\n");
471
if (TIFFFieldSet(tif,FIELD_ICCPROFILE))
472
fprintf(fd, " ICC Profile: <present>, %lu bytes\n",
473
(u_long) td->td_profileLength);
475
#ifdef PHOTOSHOP_SUPPORT
476
if (TIFFFieldSet(tif,FIELD_PHOTOSHOP))
477
fprintf(fd, " Photoshop Data: <present>, %lu bytes\n",
478
(u_long) td->td_photoshopLength);
481
if (TIFFFieldSet(tif,FIELD_RICHTIFFIPTC))
482
fprintf(fd, " RichTIFFIPTC Data: <present>, %lu bytes\n",
483
(u_long) td->td_richtiffiptcLength);
486
if (TIFFFieldSet(tif, FIELD_SUBIFD)) {
487
fprintf(fd, " SubIFD Offsets:");
488
for (i = 0; i < td->td_nsubifd; i++)
489
fprintf(fd, " %5lu", (long) td->td_subifd[i]);
494
** Custom tag support.
500
count = (short) TIFFGetTagListCount( tif );
501
for( i = 0; i < count; i++ )
503
ttag_t tag = TIFFGetTagListEntry( tif, i );
504
const TIFFFieldInfo *fld;
506
fld = TIFFFieldWithTag( tif, tag );
510
if( fld->field_passcount )
516
if( TIFFGetField( tif, tag, &value_count, &raw_data ) != 1 )
519
fprintf(fd, " %s: ", fld->field_name );
521
for( j = 0; j < value_count; j++ )
523
if( fld->field_type == TIFF_BYTE )
525
(int) ((char *) raw_data)[j] );
526
else if( fld->field_type == TIFF_SHORT )
528
(int) ((short *) raw_data)[j] );
529
else if( fld->field_type == TIFF_LONG )
531
(int) ((long *) raw_data)[j] );
532
else if( fld->field_type == TIFF_RATIONAL )
534
((float *) raw_data)[j] );
535
else if( fld->field_type == TIFF_ASCII )
541
else if( fld->field_type == TIFF_DOUBLE )
543
((double *) raw_data)[j] );
544
else if( fld->field_type == TIFF_FLOAT )
546
((float *) raw_data)[j] );
550
"<unsupported data type in TIFFPrint>" );
554
if( j < value_count-1 )
559
else if( !fld->field_passcount
560
&& fld->field_type == TIFF_ASCII )
564
if( TIFFGetField( tif, tag, &data ) )
565
fprintf(fd, " %s: %s\n", fld->field_name, data );
570
if (tif->tif_tagmethods.printdir)
571
(*tif->tif_tagmethods.printdir)(tif, fd, flags);
572
if ((flags & TIFFPRINT_STRIPS) &&
573
TIFFFieldSet(tif,FIELD_STRIPOFFSETS)) {
576
fprintf(fd, " %lu %s:\n",
577
(long) td->td_nstrips,
578
isTiled(tif) ? "Tiles" : "Strips");
579
for (s = 0; s < td->td_nstrips; s++)
580
fprintf(fd, " %3lu: [%8lu, %8lu]\n",
582
(u_long) td->td_stripoffset[s],
583
(u_long) td->td_stripbytecount[s]);
588
_TIFFprintAscii(FILE* fd, const char* cp)
590
for (; *cp != '\0'; cp++) {
597
for (tp = "\tt\bb\rr\nn\vv"; *tp; tp++)
601
fprintf(fd, "\\%c", *tp);
603
fprintf(fd, "\\%03o", *cp & 0xff);
608
_TIFFprintAsciiTag(FILE* fd, const char* name, const char* value)
610
fprintf(fd, " %s: \"", name);
611
_TIFFprintAscii(fd, value);