~ubuntu-branches/ubuntu/hoary/devil/hoary

« back to all changes in this revision

Viewing changes to test/in/tiff/README

  • Committer: Bazaar Package Importer
  • Author(s): Marcelo E. Magallon
  • Date: 2005-01-03 19:57:42 UTC
  • Revision ID: james.westby@ubuntu.com-20050103195742-4ipkplcwygu3irv0
Tags: upstream-1.6.7
ImportĀ upstreamĀ versionĀ 1.6.7

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
$Header: /cvsroot/openil/DevIL/test/in/tiff/README,v 1.1 2004/06/24 01:43:01 idadesub Exp $
 
2
 
 
3
The following image files are included for testing.  Note that a wide
 
4
variety of images can be generated using the tools provided with the
 
5
library (e.g. tiffcp, tiff2bw, tiffmedian, etc.); see below for some
 
6
hints on this.
 
7
 
 
8
PlanarConfiguration = 1 (packed data)
 
9
-------------------------------------
 
10
caspian.tif     279x220 64-bit floating point (deflate) Caspian Sea from space
 
11
cramps.tif      800x607 8-bit b&w (packbits) "cramps poster"
 
12
cramps-tile.tif 256x256 tiled version of cramps.tif (no compression)
 
13
fax2d.tif       1728x1082 1-bit b&w (G3/2D) facsimile
 
14
g3test.g3       raw Group 3 encoded fax file
 
15
g3test.tif      TIFF equivalent of g3test.g3 created by fax2tiff
 
16
jello.tif       256x192 8-bit RGB (lzw palette) Paul Heckbert "jello"
 
17
off_l16.tif     333x225 8-bit CIE LogL (SGILog) office from Greg Larson
 
18
off_luv24.tif   333x225 8-bit CIE LogLuv (SGILog24) office from " "
 
19
off_luv32.tif   333x225 8-bit CIE LogLuv (SGILog) office from " "
 
20
quad-jpeg.tif   512x384 8-bit YCbCr (jpeg) version of quad-lzw.tif
 
21
quad-lzw.tif    512x384 8-bit RGB (lzw) "quadric surfaces"
 
22
quad-tile.tif   512x384 tiled version of quad-lzw.tif (lzw)
 
23
strike.tif      256x200 8-bit RGBA (lzw) "bowling pins" from Pixar
 
24
text.tif        1512x359 4-bit b&w (thunderscan) am-express credit card
 
25
ycbcr-cat.tif   250x325 8-bit YCbCr (lzw) "kitty" created by rgb2ycbcr
 
26
 
 
27
smallliz.tif    160x160 8-bit YCbCr (OLD jpeg) lizard from HP**
 
28
zackthecat.tif  234x213 8-bit YCbCr (OLD jpeg) tiled "ZackTheCat" from NeXT**
 
29
 
 
30
** These images are in a deprecated format and are included only for testing
 
31
   backwards compatibility.  JPEG-encoded TIFF images use a different scheme
 
32
   described in TIFF Technical Note #2 and implemented by libtiff.
 
33
 
 
34
PlanarConfiguration = 2 (separated samples)
 
35
-------------------------------------------
 
36
oxford.tif      601x81 8-bit RGB (lzw) screendump off oxford
 
37
 
 
38
The other images are from Hewlett Packard and exemplify the use of the
 
39
HalftoneHints tag (in their words):
 
40
 
 
41
The images are all the same subject, and should all appear the same
 
42
after rendering.  Each of the images is slightly different as outlined
 
43
by the following table:
 
44
 
 
45
   FileName        ToneRange  HalftoneHints
 
46
jim___cg.tif            A           Y
 
47
jim___dg.tif            B           N
 
48
jim___gg.tif            B           Y
 
49
 
 
50
The images with tone range A are 0-100% linear reflectance images,
 
51
in other words, fixed full gamut tone range.  The images with tone
 
52
range B are what we call "normalized", meaning that the image has
 
53
been tone adjusted such the Highlight and Shadow are at gray levels
 
54
1 & 2**BitsPerSample-2.
 
55
 
 
56
Each of the three grayscale images should be rendered to look like
 
57
the halftone in pics/jim___ah.tif when printed on a Canon SX engine.
 
58
 
 
59
Generated Images
 
60
----------------
 
61
The file g3test.tif was created from g3test.g3 with the command:
 
62
 
 
63
    fax2tiff -o t.tif -1 -p -M -R 98 g3test.g3
 
64
 
 
65
Tiled images can be created with tiffcp; e.g.
 
66
 
 
67
    tiffcp -t -c none cramps.tif cramps-tile.tif
 
68
 
 
69
(but the tiled images included here were actually generated by the
 
70
Silicon Graphics Image Library).
 
71
 
 
72
The file quad-jpeg.tif was created from quad-lzw.tif with the command:
 
73
 
 
74
    tiffcp -c jpeg quad-lzw.tif quad-jpeg.tif
 
75
 
 
76
To generate a tiled image with separated samples the following might
 
77
be used:
 
78
 
 
79
    tiffcp -t -p separate quad-lzw.tif t.tif
 
80
 
 
81
[ Beware that tiffcp does not handle every format TIFF image.  In particular,
 
82
  when conversion between tiled and strip'd images is reliable only when
 
83
  BitsPerSample is 8. ]
 
84
 
 
85
To generate a G4-encoded image with a single strip the following would work:
 
86
 
 
87
    tiffcp -c g4 -r 1082 fax2d.tif t.tif
 
88
 
 
89
Contributing New Images
 
90
-----------------------
 
91
If you have images that are significantly different from those included
 
92
in this package and that do NOT HAVE A COPYRIGHT; feel free to send them
 
93
to me at sam@engr.sgi.com.  I prefer to receive a URL to a location from
 
94
which I can retrieve the image by public FTP.  However if that is not
 
95
possible you can send it to me in a mail message uuencode'd.  Please do
 
96
not send large images by mail.  Also, please do not send me an image
 
97
unless it is notably unique; e.g. not easily generated using the tools
 
98
I provide.