src/tiff/tiffio.h

   1 /* $Header$ */
   2
   3 /*
   4  * Copyright (c) 1988-1997 Sam Leffler
   5  * Copyright (c) 1991-1997 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 _TIFFIO_
  28 #define _TIFFIO_
  29
  30 /*
  31  * TIFF I/O Library Definitions.
  32  */
  33 #include "tiff.h"
  34
  35 /*
  36  * This define can be used in code that requires
  37  * compilation-related definitions specific to a
  38  * version or versions of the library.  Runtime
  39  * version checking should be done based on the
  40  * string returned by TIFFGetVersion.
  41  */
  42 #define TIFFLIB_VERSION 19970127        /* January 27, 1997 */
  43
  44 /*
  45  * TIFF is defined as an incomplete type to hide the
  46  * library's internal data structures from clients.
  47  */
  48 typedef struct tiff TIFF;
  49
  50 /*
  51  * The following typedefs define the intrinsic size of
  52  * data types used in the *exported* interfaces.  These
  53  * definitions depend on the proper definition of types
  54  * in tiff.h.  Note also that the varargs interface used
  55  * to pass tag types and values uses the types defined in
  56  * tiff.h directly.
  57  *
  58  * NB: ttag_t is unsigned int and not unsigned short because
  59  *     ANSI C requires that the type before the ellipsis be a
  60  *     promoted type (i.e. one of int, unsigned int, pointer,
  61  *     or double) and because we defined pseudo-tags that are
  62  *     outside the range of legal Aldus-assigned tags.
  63  * NB: tsize_t is int32 and not uint32 because some functions
  64  *     return -1.
  65  * NB: toff_t is not off_t for many reasons; TIFFs max out at
  66  *     32-bit file offsets being the most important
  67  */
  68 typedef uint32 ttag_t;          /* directory tag */
  69 typedef uint16 tdir_t;          /* directory index */
  70 typedef uint16 tsample_t;       /* sample number */
  71 typedef uint32 tstrip_t;        /* strip number */
  72 typedef uint32 ttile_t;         /* tile number */
  73 typedef int32 tsize_t;          /* i/o size in bytes */
  74 typedef void* tdata_t;          /* image data ref */
  75 typedef int32 toff_t;           /* file offset */
  76
  77 #if !defined(__WIN32__) && (defined(_WIN32) || defined(WIN32))
  78 #define __WIN32__
  79 #endif
  80 #if defined(_WINDOWS) || defined(__WIN32__) || defined(_Windows)
  81 #include <windows.h>
  82 #ifdef __WIN32__
  83 DECLARE_HANDLE(thandle_t);      /* Win32 file handle */
  84 #else
  85 typedef HFILE thandle_t;        /* client data handle */
  86 #endif
  87 #else
  88 typedef void* thandle_t;        /* client data handle */
  89 #endif
  90
  91 #if defined(__VISAGECPP__)
  92 #define LINKAGEMODE _Optlink
  93 #else
  94 #define LINKAGEMODE
  95 #endif
  96
  97 #ifndef NULL
  98 #define NULL    0
  99 #endif
 100
 101 /*
 102  * Flags to pass to TIFFPrintDirectory to control
 103  * printing of data structures that are potentially
 104  * very large.   Bit-or these flags to enable printing
 105  * multiple items.
 106  */
 107 #define TIFFPRINT_NONE          0x0             /* no extra info */
 108 #define TIFFPRINT_STRIPS        0x1             /* strips/tiles info */
 109 #define TIFFPRINT_CURVES        0x2             /* color/gray response curves */
 110 #define TIFFPRINT_COLORMAP      0x4             /* colormap */
 111 #define TIFFPRINT_JPEGQTABLES   0x100           /* JPEG Q matrices */
 112 #define TIFFPRINT_JPEGACTABLES  0x200           /* JPEG AC tables */
 113 #define TIFFPRINT_JPEGDCTABLES  0x200           /* JPEG DC tables */
 114
 115 /*
 116  * RGBA-style image support.
 117  */
 118 typedef unsigned char TIFFRGBValue;             /* 8-bit samples */
 119 typedef struct _TIFFRGBAImage TIFFRGBAImage;
 120 /*
 121  * The image reading and conversion routines invoke
 122  * ``put routines'' to copy/image/whatever tiles of
 123  * raw image data.  A default set of routines are
 124  * provided to convert/copy raw image data to 8-bit
 125  * packed ABGR format rasters.  Applications can supply
 126  * alternate routines that unpack the data into a
 127  * different format or, for example, unpack the data
 128  * and draw the unpacked raster on the display.
 129  */
 130 typedef void (LINKAGEMODE *tileContigRoutine)
 131     (TIFFRGBAImage*, uint32*, uint32, uint32, uint32, uint32, int32, int32,
 132         unsigned char*);
 133 typedef void (LINKAGEMODE *tileSeparateRoutine)
 134     (TIFFRGBAImage*, uint32*, uint32, uint32, uint32, uint32, int32, int32,
 135         unsigned char*, unsigned char*, unsigned char*, unsigned char*);
 136 /*
 137  * RGBA-reader state.
 138  */
 139 typedef struct {                                /* YCbCr->RGB support */
 140         TIFFRGBValue* clamptab;                 /* range clamping table */
 141         int*    Cr_r_tab;
 142         int*    Cb_b_tab;
 143         int32*  Cr_g_tab;
 144         int32*  Cb_g_tab;
 145         float   coeffs[3];                      /* cached for repeated use */
 146 } TIFFYCbCrToRGB;
 147
 148 struct _TIFFRGBAImage {
 149         TIFF*   tif;                            /* image handle */
 150         int     stoponerr;                      /* stop on read error */
 151         int     isContig;                       /* data is packed/separate */
 152         int     alpha;                          /* type of alpha data present */
 153         uint32  width;                          /* image width */
 154         uint32  height;                         /* image height */
 155         uint16  bitspersample;                  /* image bits/sample */
 156         uint16  samplesperpixel;                /* image samples/pixel */
 157         uint16  orientation;                    /* image orientation */
 158         uint16  photometric;                    /* image photometric interp */
 159         uint16* redcmap;                        /* colormap pallete */
 160         uint16* greencmap;
 161         uint16* bluecmap;
 162                                                 /* get image data routine */
 163         int     (LINKAGEMODE *get)(TIFFRGBAImage*, uint32*, uint32, uint32);
 164         union {
 165             void (*any)(TIFFRGBAImage*);
 166             tileContigRoutine   contig;
 167             tileSeparateRoutine separate;
 168         } put;                                  /* put decoded strip/tile */
 169         TIFFRGBValue* Map;                      /* sample mapping array */
 170         uint32** BWmap;                         /* black&white map */
 171         uint32** PALmap;                        /* palette image map */
 172         TIFFYCbCrToRGB* ycbcr;                  /* YCbCr conversion state */
 173
 174         int     row_offset;
 175         int     col_offset;
 176 };
 177
 178 /*
 179  * Macros for extracting components from the
 180  * packed ABGR form returned by TIFFReadRGBAImage.
 181  */
 182 #define TIFFGetR(abgr)  ((abgr) & 0xff)
 183 #define TIFFGetG(abgr)  (((abgr) >> 8) & 0xff)
 184 #define TIFFGetB(abgr)  (((abgr) >> 16) & 0xff)
 185 #define TIFFGetA(abgr)  (((abgr) >> 24) & 0xff)
 186
 187 /*
 188  * A CODEC is a software package that implements decoding,
 189  * encoding, or decoding+encoding of a compression algorithm.
 190  * The library provides a collection of builtin codecs.
 191  * More codecs may be registered through calls to the library
 192  * and/or the builtin implementations may be overridden.
 193  */
 194 typedef int (LINKAGEMODE *TIFFInitMethod)(TIFF*, int);
 195 typedef struct {
 196         char*           name;
 197         uint16          scheme;
 198         TIFFInitMethod  init;
 199 } TIFFCodec;
 200
 201 #include <stdio.h>
 202 #include <stdarg.h>
 203
 204 #if defined(__cplusplus)
 205 extern "C" {
 206 #endif
 207 typedef void (LINKAGEMODE *TIFFErrorHandler)(const char*, const char*, va_list);
 208 typedef tsize_t (LINKAGEMODE *TIFFReadWriteProc)(thandle_t, tdata_t, tsize_t);
 209 typedef toff_t (LINKAGEMODE *TIFFSeekProc)(thandle_t, toff_t, int);
 210 typedef int (LINKAGEMODE *TIFFCloseProc)(thandle_t);
 211 typedef toff_t (LINKAGEMODE *TIFFSizeProc)(thandle_t);
 212 typedef int (LINKAGEMODE *TIFFMapFileProc)(thandle_t, tdata_t*, toff_t*);
 213 typedef void (LINKAGEMODE *TIFFUnmapFileProc)(thandle_t, tdata_t, toff_t);
 214 typedef void (LINKAGEMODE *TIFFExtendProc)(TIFF*);
 215
 216 extern  const char* TIFFGetVersion(void);
 217
 218 extern  const TIFFCodec* TIFFFindCODEC(uint16);
 219 extern  TIFFCodec* TIFFRegisterCODEC(uint16, const char*, TIFFInitMethod);
 220 extern  void TIFFUnRegisterCODEC(TIFFCodec*);
 221
 222 extern  tdata_t _TIFFmalloc(tsize_t);
 223 extern  tdata_t _TIFFrealloc(tdata_t, tsize_t);
 224 extern  void _TIFFmemset(tdata_t, int, tsize_t);
 225 extern  void _TIFFmemcpy(tdata_t, const tdata_t, tsize_t);
 226 extern  int _TIFFmemcmp(const tdata_t, const tdata_t, tsize_t);
 227 extern  void _TIFFfree(tdata_t);
 228
 229 extern  void TIFFClose(TIFF*);
 230 extern  int TIFFFlush(TIFF*);
 231 extern  int TIFFFlushData(TIFF*);
 232 extern  int TIFFGetField(TIFF*, ttag_t, ...);
 233 extern  int TIFFVGetField(TIFF*, ttag_t, va_list);
 234 extern  int TIFFGetFieldDefaulted(TIFF*, ttag_t, ...);
 235 extern  int TIFFVGetFieldDefaulted(TIFF*, ttag_t, va_list);
 236 extern  int TIFFReadDirectory(TIFF*);
 237 extern  tsize_t TIFFScanlineSize(TIFF*);
 238 extern  tsize_t TIFFRasterScanlineSize(TIFF*);
 239 extern  tsize_t TIFFStripSize(TIFF*);
 240 extern  tsize_t TIFFVStripSize(TIFF*, uint32);
 241 extern  tsize_t TIFFTileRowSize(TIFF*);
 242 extern  tsize_t TIFFTileSize(TIFF*);
 243 extern  tsize_t TIFFVTileSize(TIFF*, uint32);
 244 extern  uint32 TIFFDefaultStripSize(TIFF*, uint32);
 245 extern  void TIFFDefaultTileSize(TIFF*, uint32*, uint32*);
 246 extern  int TIFFFileno(TIFF*);
 247 extern  int TIFFGetMode(TIFF*);
 248 extern  int TIFFIsTiled(TIFF*);
 249 extern  int TIFFIsByteSwapped(TIFF*);
 250 extern  int TIFFIsUpSampled(TIFF*);
 251 extern  int TIFFIsMSB2LSB(TIFF*);
 252 extern  uint32 TIFFCurrentRow(TIFF*);
 253 extern  tdir_t TIFFCurrentDirectory(TIFF*);
 254 extern  tdir_t TIFFNumberOfDirectories(TIFF*);
 255 extern  uint32 TIFFCurrentDirOffset(TIFF*);
 256 extern  tstrip_t TIFFCurrentStrip(TIFF*);
 257 extern  ttile_t TIFFCurrentTile(TIFF*);
 258 extern  int TIFFReadBufferSetup(TIFF*, tdata_t, tsize_t);
 259 extern  int TIFFWriteBufferSetup(TIFF*, tdata_t, tsize_t);
 260 extern  int TIFFLastDirectory(TIFF*);
 261 extern  int TIFFSetDirectory(TIFF*, tdir_t);
 262 extern  int TIFFSetSubDirectory(TIFF*, uint32);
 263 extern  int TIFFUnlinkDirectory(TIFF*, tdir_t);
 264 extern  int TIFFSetField(TIFF*, ttag_t, ...);
 265 extern  int TIFFVSetField(TIFF*, ttag_t, va_list);
 266 extern  int TIFFWriteDirectory(TIFF *);
 267 extern  int TIFFReassignTagToIgnore(enum TIFFIgnoreSense, int);
 268
 269 #if defined(c_plusplus) || defined(__cplusplus)
 270 extern  void TIFFPrintDirectory(TIFF*, FILE*, long = 0);
 271 extern  int TIFFReadScanline(TIFF*, tdata_t, uint32, tsample_t = 0);
 272 extern  int TIFFWriteScanline(TIFF*, tdata_t, uint32, tsample_t = 0);
 273 extern  int TIFFReadRGBAImage(TIFF*, uint32, uint32, uint32*, int = 0);
 274 #else
 275 extern  void TIFFPrintDirectory(TIFF*, FILE*, long);
 276 extern  int TIFFReadScanline(TIFF*, tdata_t, uint32, tsample_t);
 277 extern  int TIFFWriteScanline(TIFF*, tdata_t, uint32, tsample_t);
 278 extern  int TIFFReadRGBAImage(TIFF*, uint32, uint32, uint32*, int);
 279 #endif
 280
 281 extern  int TIFFReadRGBAStrip(TIFF*, tstrip_t, uint32 * );
 282 extern  int TIFFReadRGBATile(TIFF*, uint32, uint32, uint32 * );
 283 extern  int TIFFRGBAImageOK(TIFF*, char [1024]);
 284 extern  int TIFFRGBAImageBegin(TIFFRGBAImage*, TIFF*, int, char [1024]);
 285 extern  int TIFFRGBAImageGet(TIFFRGBAImage*, uint32*, uint32, uint32);
 286 extern  void TIFFRGBAImageEnd(TIFFRGBAImage*);
 287 extern  TIFF* TIFFOpen(const char*, const char*);
 288 extern  TIFF* TIFFFdOpen(int, const char*, const char*);
 289 extern  TIFF* TIFFClientOpen(const char*, const char*,
 290             thandle_t,
 291             TIFFReadWriteProc, TIFFReadWriteProc,
 292             TIFFSeekProc, TIFFCloseProc,
 293             TIFFSizeProc,
 294             TIFFMapFileProc, TIFFUnmapFileProc);
 295 extern  const char* TIFFFileName(TIFF*);
 296 extern  void TIFFError(const char*, const char*, ...);
 297 extern  void TIFFWarning(const char*, const char*, ...);
 298 extern  TIFFErrorHandler TIFFSetErrorHandler(TIFFErrorHandler);
 299 extern  TIFFErrorHandler TIFFSetWarningHandler(TIFFErrorHandler);
 300 extern  TIFFExtendProc TIFFSetTagExtender(TIFFExtendProc);
 301 extern  ttile_t TIFFComputeTile(TIFF*, uint32, uint32, uint32, tsample_t);
 302 extern  int TIFFCheckTile(TIFF*, uint32, uint32, uint32, tsample_t);
 303 extern  ttile_t TIFFNumberOfTiles(TIFF*);
 304 extern  tsize_t TIFFReadTile(TIFF*,
 305             tdata_t, uint32, uint32, uint32, tsample_t);
 306 extern  tsize_t TIFFWriteTile(TIFF*,
 307             tdata_t, uint32, uint32, uint32, tsample_t);
 308 extern  tstrip_t TIFFComputeStrip(TIFF*, uint32, tsample_t);
 309 extern  tstrip_t TIFFNumberOfStrips(TIFF*);
 310 extern  tsize_t TIFFReadEncodedStrip(TIFF*, tstrip_t, tdata_t, tsize_t);
 311 extern  tsize_t TIFFReadRawStrip(TIFF*, tstrip_t, tdata_t, tsize_t);
 312 extern  tsize_t TIFFReadEncodedTile(TIFF*, ttile_t, tdata_t, tsize_t);
 313 extern  tsize_t TIFFReadRawTile(TIFF*, ttile_t, tdata_t, tsize_t);
 314 extern  tsize_t TIFFWriteEncodedStrip(TIFF*, tstrip_t, tdata_t, tsize_t);
 315 extern  tsize_t TIFFWriteRawStrip(TIFF*, tstrip_t, tdata_t, tsize_t);
 316 extern  tsize_t TIFFWriteEncodedTile(TIFF*, ttile_t, tdata_t, tsize_t);
 317 extern  tsize_t TIFFWriteRawTile(TIFF*, ttile_t, tdata_t, tsize_t);
 318 extern  void TIFFSetWriteOffset(TIFF*, toff_t);
 319 extern  void TIFFSwabShort(uint16*);
 320 extern  void TIFFSwabLong(uint32*);
 321 extern  void TIFFSwabDouble(double*);
 322 extern  void TIFFSwabArrayOfShort(uint16*, unsigned long);
 323 extern  void TIFFSwabArrayOfLong(uint32*, unsigned long);
 324 extern  void TIFFSwabArrayOfDouble(double*, unsigned long);
 325 extern  void TIFFReverseBits(unsigned char *, unsigned long);
 326 extern  const unsigned char* TIFFGetBitRevTable(int);
 327 #if defined(__cplusplus)
 328 }
 329 #endif
 330 #endif /* _TIFFIO_ */