tiffio.h
上传用户:shtaya11
上传日期:2021-10-17
资源大小:941k
文件大小:12k
源码类别:

2D图形编程

开发平台:

Visual C++

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