include/tiff.h

   1 /* $Header: /CVS_DB/Eos/include/tiff.h,v 1.1.1.1 2002/02/01 05:14:00 tacyas Exp $ */
   2
   3 /*
   4  * Copyright (c) 1988, 1989, 1990, 1991, 1992 Sam Leffler
   5  * Copyright (c) 1991, 1992 Silicon Graphics, Inc.
   6  *
   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.
  14  *
  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.
  18  *
  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
  24  * OF THIS SOFTWARE.
  25  */
  26
  27 #ifndef _TIFF_
  28 #define _TIFF_
  29 /*
  30  * Tag Image File Format (TIFF)
  31  *
  32  * Based on Rev 6.0 from:
  33  *    Developer's Desk
  34  *    Aldus Corporation
  35  *    411 First Ave. South
  36  *    Suite 200
  37  *    Seattle, WA  98104
  38  *    206-622-5500
  39  */
  40 #define TIFF_VERSION    42
  41
  42 #define TIFF_BIGENDIAN          0x4d4d
  43 #define TIFF_LITTLEENDIAN       0x4949
  44
  45 typedef struct {
  46         unsigned short tiff_magic;      /* magic number (defines byte order) */
  47         unsigned short tiff_version;    /* TIFF version number */
  48         unsigned long  tiff_diroff;     /* byte offset to first directory */
  49 } TIFFHeader;
  50
  51 /*
  52  * TIFF Image File Directories are comprised of
  53  * a table of field descriptors of the form shown
  54  * below.  The table is sorted in ascending order
  55  * by tag.  The values associated with each entry
  56  * are disjoint and may appear anywhere in the file
  57  * (so long as they are placed on a word boundary).
  58  *
  59  * If the value is 4 bytes or less, then it is placed
  60  * in the offset field to save space.  If the value
  61  * is less than 4 bytes, it is left-justified in the
  62  * offset field.
  63  */
  64 typedef struct {
  65         unsigned short tdir_tag;        /* see below */
  66         unsigned short tdir_type;       /* data type; see below */
  67         unsigned long  tdir_count;      /* number of items; length in spec */
  68         unsigned long  tdir_offset;     /* byte offset to field data */
  69 } TIFFDirEntry;
  70
  71 /*
  72  * NB: In the comments below,
  73  *  - items marked with a + are obsoleted by revision 5.0,
  74  *  - items marked with a ! are introduced in revision 6.0.
  75  *  - items marked with a $ are obsoleted by revision 6.0.
  76  */
  77
  78 /*
  79  * Tag data type information.
  80  *
  81  * Note: RATIONALs are the ratio of two 32-bit integer values.
  82  */
  83 typedef enum {
  84         TIFF_NOTYPE     = 0,    /* placeholder */
  85         TIFF_BYTE       = 1,    /* 8-bit unsigned integer */
  86         TIFF_ASCII      = 2,    /* 8-bit bytes w/ last byte null */
  87         TIFF_SHORT      = 3,    /* 16-bit unsigned integer */
  88         TIFF_LONG       = 4,    /* 32-bit unsigned integer */
  89         TIFF_RATIONAL   = 5,    /* 64-bit unsigned fraction */
  90         TIFF_SBYTE      = 6,    /* !8-bit signed integer */
  91         TIFF_UNDEFINED  = 7,    /* !8-bit untyped data */
  92         TIFF_SSHORT     = 8,    /* !16-bit signed integer */
  93         TIFF_SLONG      = 9,    /* !32-bit signed integer */
  94         TIFF_SRATIONAL  = 10,   /* !64-bit signed fraction */
  95         TIFF_FLOAT      = 11,   /* !32-bit IEEE floating point */
  96         TIFF_DOUBLE     = 12    /* !64-bit IEEE floating point */
  97 } TIFFDataType;
  98
  99 /*
 100  * TIFF Tag Definitions.
 101  */
 102 #define TIFFTAG_SUBFILETYPE             254     /* subfile data descriptor */
 103 #define     FILETYPE_REDUCEDIMAGE       0x1     /* reduced resolution version */
 104 #define     FILETYPE_PAGE               0x2     /* one page of many */
 105 #define     FILETYPE_MASK               0x4     /* transparency mask */
 106 #define TIFFTAG_OSUBFILETYPE            255     /* +kind of data in subfile */
 107 #define     OFILETYPE_IMAGE             1       /* full resolution image data */
 108 #define     OFILETYPE_REDUCEDIMAGE      2       /* reduced size image data */
 109 #define     OFILETYPE_PAGE              3       /* one page of many */
 110 #define TIFFTAG_IMAGEWIDTH              256     /* image width in pixels */
 111 #define TIFFTAG_IMAGELENGTH             257     /* image height in pixels */
 112 #define TIFFTAG_BITSPERSAMPLE           258     /* bits per channel (sample) */
 113 #define TIFFTAG_COMPRESSION             259     /* data compression technique */
 114 #define     COMPRESSION_NONE            1       /* dump mode */
 115 #define     COMPRESSION_CCITTRLE        2       /* CCITT modified Huffman RLE */
 116 #define     COMPRESSION_CCITTFAX3       3       /* CCITT Group 3 fax encoding */
 117 #define     COMPRESSION_CCITTFAX4       4       /* CCITT Group 4 fax encoding */
 118 #define     COMPRESSION_LZW             5       /* Lempel-Ziv  & Welch */
 119 #define     COMPRESSION_JPEG            6       /* !JPEG compression */
 120 #define     COMPRESSION_NEXT            32766   /* NeXT 2-bit RLE */
 121 #define     COMPRESSION_CCITTRLEW       32771   /* #1 w/ word alignment */
 122 #define     COMPRESSION_PACKBITS        32773   /* Macintosh RLE */
 123 #define     COMPRESSION_THUNDERSCAN     32809   /* ThunderScan RLE */
 124 #define TIFFTAG_PHOTOMETRIC             262     /* photometric interpretation */
 125 #define     PHOTOMETRIC_MINISWHITE      0       /* min value is white */
 126 #define     PHOTOMETRIC_MINISBLACK      1       /* min value is black */
 127 #define     PHOTOMETRIC_RGB             2       /* RGB color model */
 128 #define     PHOTOMETRIC_PALETTE         3       /* color map indexed */
 129 #define     PHOTOMETRIC_MASK            4       /* $holdout mask */
 130 #define     PHOTOMETRIC_SEPARATED       5       /* !color separations */
 131 #define     PHOTOMETRIC_YCBCR           6       /* !CCIR 601 */
 132 #define     PHOTOMETRIC_CIELAB          8       /* !1976 CIE L*a*b* */
 133 #define TIFFTAG_THRESHHOLDING           263     /* +thresholding used on data */
 134 #define     THRESHHOLD_BILEVEL          1       /* b&w art scan */
 135 #define     THRESHHOLD_HALFTONE         2       /* or dithered scan */
 136 #define     THRESHHOLD_ERRORDIFFUSE     3       /* usually floyd-steinberg */
 137 #define TIFFTAG_CELLWIDTH               264     /* +dithering matrix width */
 138 #define TIFFTAG_CELLLENGTH              265     /* +dithering matrix height */
 139 #define TIFFTAG_FILLORDER               266     /* data order within a byte */
 140 #define     FILLORDER_MSB2LSB           1       /* most significant -> least */
 141 #define     FILLORDER_LSB2MSB           2       /* least significant -> most */
 142 #define TIFFTAG_DOCUMENTNAME            269     /* name of doc. image is from */
 143 #define TIFFTAG_IMAGEDESCRIPTION        270     /* info about image */
 144 #define TIFFTAG_MAKE                    271     /* scanner manufacturer name */
 145 #define TIFFTAG_MODEL                   272     /* scanner model name/number */
 146 #define TIFFTAG_STRIPOFFSETS            273     /* offsets to data strips */
 147 #define TIFFTAG_ORIENTATION             274     /* +image orientation */
 148 #define     ORIENTATION_TOPLEFT         1       /* row 0 top, col 0 lhs */
 149 #define     ORIENTATION_TOPRIGHT        2       /* row 0 top, col 0 rhs */
 150 #define     ORIENTATION_BOTRIGHT        3       /* row 0 bottom, col 0 rhs */
 151 #define     ORIENTATION_BOTLEFT         4       /* row 0 bottom, col 0 lhs */
 152 #define     ORIENTATION_LEFTTOP         5       /* row 0 lhs, col 0 top */
 153 #define     ORIENTATION_RIGHTTOP        6       /* row 0 rhs, col 0 top */
 154 #define     ORIENTATION_RIGHTBOT        7       /* row 0 rhs, col 0 bottom */
 155 #define     ORIENTATION_LEFTBOT         8       /* row 0 lhs, col 0 bottom */
 156 #define TIFFTAG_SAMPLESPERPIXEL         277     /* samples per pixel */
 157 #define TIFFTAG_ROWSPERSTRIP            278     /* rows per strip of data */
 158 #define TIFFTAG_STRIPBYTECOUNTS         279     /* bytes counts for strips */
 159 #define TIFFTAG_MINSAMPLEVALUE          280     /* +minimum sample value */
 160 #define TIFFTAG_MAXSAMPLEVALUE          281     /* +maximum sample value */
 161 #define TIFFTAG_XRESOLUTION             282     /* pixels/resolution in x */
 162 #define TIFFTAG_YRESOLUTION             283     /* pixels/resolution in y */
 163 #define TIFFTAG_PLANARCONFIG            284     /* storage organization */
 164 #define     PLANARCONFIG_CONTIG         1       /* single image plane */
 165 #define     PLANARCONFIG_SEPARATE       2       /* separate planes of data */
 166 #define TIFFTAG_PAGENAME                285     /* page name image is from */
 167 #define TIFFTAG_XPOSITION               286     /* x page offset of image lhs */
 168 #define TIFFTAG_YPOSITION               287     /* y page offset of image lhs */
 169 #define TIFFTAG_FREEOFFSETS             288     /* +byte offset to free block */
 170 #define TIFFTAG_FREEBYTECOUNTS          289     /* +sizes of free blocks */
 171 #define TIFFTAG_GRAYRESPONSEUNIT        290     /* $gray scale curve accuracy */
 172 #define     GRAYRESPONSEUNIT_10S        1       /* tenths of a unit */
 173 #define     GRAYRESPONSEUNIT_100S       2       /* hundredths of a unit */
 174 #define     GRAYRESPONSEUNIT_1000S      3       /* thousandths of a unit */
 175 #define     GRAYRESPONSEUNIT_10000S     4       /* ten-thousandths of a unit */
 176 #define     GRAYRESPONSEUNIT_100000S    5       /* hundred-thousandths */
 177 #define TIFFTAG_GRAYRESPONSECURVE       291     /* $gray scale response curve */
 178 #define TIFFTAG_GROUP3OPTIONS           292     /* 32 flag bits */
 179 #define     GROUP3OPT_2DENCODING        0x1     /* 2-dimensional coding */
 180 #define     GROUP3OPT_UNCOMPRESSED      0x2     /* data not compressed */
 181 #define     GROUP3OPT_FILLBITS          0x4     /* fill to byte boundary */
 182 #define TIFFTAG_GROUP4OPTIONS           293     /* 32 flag bits */
 183 #define     GROUP4OPT_UNCOMPRESSED      0x2     /* data not compressed */
 184 #define TIFFTAG_RESOLUTIONUNIT          296     /* units of resolutions */
 185 #define     RESUNIT_NONE                1       /* no meaningful units */
 186 #define     RESUNIT_INCH                2       /* english */
 187 #define     RESUNIT_CENTIMETER          3       /* metric */
 188 #define TIFFTAG_PAGENUMBER              297     /* page numbers of multi-page */
 189 #define TIFFTAG_COLORRESPONSEUNIT       300     /* $color curve accuracy */
 190 #define     COLORRESPONSEUNIT_10S       1       /* tenths of a unit */
 191 #define     COLORRESPONSEUNIT_100S      2       /* hundredths of a unit */
 192 #define     COLORRESPONSEUNIT_1000S     3       /* thousandths of a unit */
 193 #define     COLORRESPONSEUNIT_10000S    4       /* ten-thousandths of a unit */
 194 #define     COLORRESPONSEUNIT_100000S   5       /* hundred-thousandths */
 195 #define TIFFTAG_TRANSFERFUNCTION        301     /* !colorimetry info */
 196 #define TIFFTAG_SOFTWARE                305     /* name & release */
 197 #define TIFFTAG_DATETIME                306     /* creation date and time */
 198 #define TIFFTAG_ARTIST                  315     /* creator of image */
 199 #define TIFFTAG_HOSTCOMPUTER            316     /* machine where created */
 200 #define TIFFTAG_PREDICTOR               317     /* prediction scheme w/ LZW */
 201 #define TIFFTAG_WHITEPOINT              318     /* image white point */
 202 #define TIFFTAG_PRIMARYCHROMATICITIES   319     /* !primary chromaticities */
 203 #define TIFFTAG_COLORMAP                320     /* RGB map for pallette image */
 204 #define TIFFTAG_HALFTONEHINTS           321     /* !highlight+shadow info */
 205 #define TIFFTAG_TILEWIDTH               322     /* !rows/data tile */
 206 #define TIFFTAG_TILELENGTH              323     /* !cols/data tile */
 207 #define TIFFTAG_TILEOFFSETS             324     /* !offsets to data tiles */
 208 #define TIFFTAG_TILEBYTECOUNTS          325     /* !byte counts for tiles */
 209 #define TIFFTAG_BADFAXLINES             326     /* lines w/ wrong pixel count */
 210 #define TIFFTAG_CLEANFAXDATA            327     /* regenerated line info */
 211 #define     CLEANFAXDATA_CLEAN          0       /* no errors detected */
 212 #define     CLEANFAXDATA_REGENERATED    1       /* receiver regenerated lines */
 213 #define     CLEANFAXDATA_UNCLEAN        2       /* uncorrected errors exist */
 214 #define TIFFTAG_CONSECUTIVEBADFAXLINES  328     /* max consecutive bad lines */
 215 #define TIFFTAG_INKSET                  332     /* !inks in separated image */
 216 #define     INKSET_CMYK                 1       /* !cyan-magenta-yellow-black */
 217 #define TIFFTAG_INKNAMES                333     /* !ascii names of inks */
 218 #define TIFFTAG_DOTRANGE                336     /* !0% and 100% dot codes */
 219 #define TIFFTAG_TARGETPRINTER           337     /* !separation target */
 220 #define TIFFTAG_EXTRASAMPLES            338     /* !info about extra samples */
 221 #define     EXTRASAMPLE_UNSPECIFIED     0       /* !unspecified data */
 222 #define     EXTRASAMPLE_ASSOCALPHA      1       /* !associated alpha data */
 223 #define     EXTRASAMPLE_UNASSALPHA      2       /* !unassociated alpha data */
 224 #define TIFFTAG_SAMPLEFORMAT            339     /* !data sample format */
 225 #define     SAMPLEFORMAT_INT            1       /* !signed integer data */
 226 #define     SAMPLEFORMAT_UINT           2       /* !unsigned integer data */
 227 #define     SAMPLEFORMAT_IEEEFP         3       /* !IEEE floating point data */
 228 #define     SAMPLEFORMAT_VOID           4       /* !untyped data */
 229 #define TIFFTAG_SMINSAMPLEVALUE         340     /* !variable MinSampleValue */
 230 #define TIFFTAG_SMAXSAMPLEVALUE         341     /* !variable MaxSampleValue */
 231 #define TIFFTAG_JPEGPROC                512     /* !JPEG processing algorithm */
 232 #define     JPEGPROC_BASELINE           1       /* !baseline sequential */
 233 #define     JPEGPROC_LOSSLESS           14      /* !Huffman coded lossless */
 234 #define TIFFTAG_JPEGIFOFFSET            513     /* !pointer to SOI marker */
 235 #define TIFFTAG_JPEGIFBYTECOUNT         514     /* !JFIF stream length */
 236 #define TIFFTAG_JPEGRESTARTINTERVAL     515     /* !restart interval length */
 237 #define TIFFTAG_JPEGLOSSLESSPREDICTORS  517     /* !lossless proc predictor */
 238 #define TIFFTAG_JPEGPOINTTRANSFORM      518     /* !lossless point transform */
 239 #define TIFFTAG_JPEGQTABLES             519     /* !Q matrice offsets */
 240 #define TIFFTAG_JPEGDCTABLES            520     /* !DCT table offsets */
 241 #define TIFFTAG_JPEGACTABLES            521     /* !AC coefficient offsets */
 242 #define TIFFTAG_YCBCRCOEFFICIENTS       529     /* !RGB -> YCbCr transform */
 243 #define TIFFTAG_YCBCRSUBSAMPLING        530     /* !YCbCr subsampling factors */
 244 #define TIFFTAG_YCBCRPOSITIONING        531     /* !subsample positioning */
 245 #define     YCBCRPOSITION_CENTERED      1       /* !as in PostScript Level 2 */
 246 #define     YCBCRPOSITION_COSITED       2       /* !as in CCIR 601-1 */
 247 #define TIFFTAG_REFERENCEBLACKWHITE     532     /* !colorimetry info */
 248 /* tags 32995-32999 are private tags registered to SGI */
 249 #define TIFFTAG_MATTEING                32995   /* $use ExtraSamples */
 250 #define TIFFTAG_DATATYPE                32996   /* $use SampleFormat */
 251 #define TIFFTAG_IMAGEDEPTH              32997   /* z depth of image */
 252 #define TIFFTAG_TILEDEPTH               32998   /* z depth/data tile */
 253 #endif /* _TIFF_ */