| /* $Header: /cvsroot/osrs/libtiff/libtiff/tiffio.h,v 1.11 2001/09/26 17:42:18 warmerda Exp $ */ |
| |
| /* |
| * Copyright (c) 1988-1997 Sam Leffler |
| * Copyright (c) 1991-1997 Silicon Graphics, Inc. |
| * |
| * Permission to use, copy, modify, distribute, and sell this software and |
| * its documentation for any purpose is hereby granted without fee, provided |
| * that (i) the above copyright notices and this permission notice appear in |
| * all copies of the software and related documentation, and (ii) the names of |
| * Sam Leffler and Silicon Graphics may not be used in any advertising or |
| * publicity relating to the software without the specific, prior written |
| * permission of Sam Leffler and Silicon Graphics. |
| * |
| * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, |
| * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY |
| * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. |
| * |
| * IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR |
| * ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, |
| * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, |
| * WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF |
| * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE |
| * OF THIS SOFTWARE. |
| */ |
| |
| #ifndef _TIFFIO_ |
| #define _TIFFIO_ |
| |
| /* |
| * TIFF I/O Library Definitions. |
| */ |
| #include "tiff.h" |
| |
| /* |
| * TIFF is defined as an incomplete type to hide the |
| * library's internal data structures from clients. |
| */ |
| typedef struct tiff TIFF; |
| |
| /* |
| * The following typedefs define the intrinsic size of |
| * data types used in the *exported* interfaces. These |
| * definitions depend on the proper definition of types |
| * in tiff.h. Note also that the varargs interface used |
| * to pass tag types and values uses the types defined in |
| * tiff.h directly. |
| * |
| * NB: ttag_t is unsigned int and not unsigned short because |
| * ANSI C requires that the type before the ellipsis be a |
| * promoted type (i.e. one of int, unsigned int, pointer, |
| * or double) and because we defined pseudo-tags that are |
| * outside the range of legal Aldus-assigned tags. |
| * NB: tsize_t is int32 and not uint32 because some functions |
| * return -1. |
| * NB: toff_t is not off_t for many reasons; TIFFs max out at |
| * 32-bit file offsets being the most important, and to ensure |
| * that it is unsigned, rather than signed. |
| */ |
| typedef uint32 ttag_t; /* directory tag */ |
| typedef uint16 tdir_t; /* directory index */ |
| typedef uint16 tsample_t; /* sample number */ |
| typedef uint32 tstrip_t; /* strip number */ |
| typedef uint32 ttile_t; /* tile number */ |
| typedef int32 tsize_t; /* i/o size in bytes */ |
| typedef void* tdata_t; /* image data ref */ |
| typedef uint32 toff_t; /* file offset */ |
| |
| #if !defined(__WIN32__) && (defined(_WIN32) || defined(WIN32)) |
| #define __WIN32__ |
| #endif |
| |
| /* |
| * On windows you should define USE_WIN32_FILEIO if you are using tif_win32.c |
| * or AVOID_WIN32_FILEIO if you are using something else (like tif_unix.c). |
| * |
| * By default tif_win32.c is assumed on windows if not using the cygwin |
| * environment. |
| */ |
| |
| #if defined(_WINDOWS) || defined(__WIN32__) || defined(_Windows) |
| # if !defined(__CYGWIN) && !defined(AVOID_WIN32_FILEIO) && !defined(USE_WIN32_FILIO) |
| # define USE_WIN32_FILEIO |
| # endif |
| #endif |
| |
| #if defined(USE_WIN32_FILEIO) |
| #include <windows.h> |
| #ifdef __WIN32__ |
| DECLARE_HANDLE(thandle_t); /* Win32 file handle */ |
| #else |
| typedef HFILE thandle_t; /* client data handle */ |
| #endif |
| #else |
| typedef void* thandle_t; /* client data handle */ |
| #endif |
| |
| #ifndef NULL |
| #define NULL 0 |
| #endif |
| |
| /* |
| * Flags to pass to TIFFPrintDirectory to control |
| * printing of data structures that are potentially |
| * very large. Bit-or these flags to enable printing |
| * multiple items. |
| */ |
| #define TIFFPRINT_NONE 0x0 /* no extra info */ |
| #define TIFFPRINT_STRIPS 0x1 /* strips/tiles info */ |
| #define TIFFPRINT_CURVES 0x2 /* color/gray response curves */ |
| #define TIFFPRINT_COLORMAP 0x4 /* colormap */ |
| #define TIFFPRINT_JPEGQTABLES 0x100 /* JPEG Q matrices */ |
| #define TIFFPRINT_JPEGACTABLES 0x200 /* JPEG AC tables */ |
| #define TIFFPRINT_JPEGDCTABLES 0x200 /* JPEG DC tables */ |
| |
| /* |
| * RGBA-style image support. |
| */ |
| typedef unsigned char TIFFRGBValue; /* 8-bit samples */ |
| typedef struct _TIFFRGBAImage TIFFRGBAImage; |
| /* |
| * The image reading and conversion routines invoke |
| * ``put routines'' to copy/image/whatever tiles of |
| * raw image data. A default set of routines are |
| * provided to convert/copy raw image data to 8-bit |
| * packed ABGR format rasters. Applications can supply |
| * alternate routines that unpack the data into a |
| * different format or, for example, unpack the data |
| * and draw the unpacked raster on the display. |
| */ |
| typedef void (*tileContigRoutine) |
| (TIFFRGBAImage*, uint32*, uint32, uint32, uint32, uint32, int32, int32, |
| unsigned char*); |
| typedef void (*tileSeparateRoutine) |
| (TIFFRGBAImage*, uint32*, uint32, uint32, uint32, uint32, int32, int32, |
| unsigned char*, unsigned char*, unsigned char*, unsigned char*); |
| /* |
| * RGBA-reader state. |
| */ |
| typedef struct { /* YCbCr->RGB support */ |
| TIFFRGBValue* clamptab; /* range clamping table */ |
| int* Cr_r_tab; |
| int* Cb_b_tab; |
| int32* Cr_g_tab; |
| int32* Cb_g_tab; |
| float coeffs[3]; /* cached for repeated use */ |
| } TIFFYCbCrToRGB; |
| |
| struct _TIFFRGBAImage { |
| TIFF* tif; /* image handle */ |
| int stoponerr; /* stop on read error */ |
| int isContig; /* data is packed/separate */ |
| int alpha; /* type of alpha data present */ |
| uint32 width; /* image width */ |
| uint32 height; /* image height */ |
| uint16 bitspersample; /* image bits/sample */ |
| uint16 samplesperpixel; /* image samples/pixel */ |
| uint16 orientation; /* image orientation */ |
| uint16 photometric; /* image photometric interp */ |
| uint16* redcmap; /* colormap pallete */ |
| uint16* greencmap; |
| uint16* bluecmap; |
| /* get image data routine */ |
| int (*get)(TIFFRGBAImage*, uint32*, uint32, uint32); |
| union { |
| void (*any)(TIFFRGBAImage*); |
| tileContigRoutine contig; |
| tileSeparateRoutine separate; |
| } put; /* put decoded strip/tile */ |
| TIFFRGBValue* Map; /* sample mapping array */ |
| uint32** BWmap; /* black&white map */ |
| uint32** PALmap; /* palette image map */ |
| TIFFYCbCrToRGB* ycbcr; /* YCbCr conversion state */ |
| |
| int row_offset; |
| int col_offset; |
| }; |
| |
| /* |
| * Macros for extracting components from the |
| * packed ABGR form returned by TIFFReadRGBAImage. |
| */ |
| #define TIFFGetR(abgr) ((abgr) & 0xff) |
| #define TIFFGetG(abgr) (((abgr) >> 8) & 0xff) |
| #define TIFFGetB(abgr) (((abgr) >> 16) & 0xff) |
| #define TIFFGetA(abgr) (((abgr) >> 24) & 0xff) |
| |
| /* |
| * A CODEC is a software package that implements decoding, |
| * encoding, or decoding+encoding of a compression algorithm. |
| * The library provides a collection of builtin codecs. |
| * More codecs may be registered through calls to the library |
| * and/or the builtin implementations may be overridden. |
| */ |
| typedef int (*TIFFInitMethod)(TIFF*, int); |
| typedef struct { |
| char* name; |
| uint16 scheme; |
| TIFFInitMethod init; |
| } TIFFCodec; |
| |
| #include <stdio.h> |
| #include <stdarg.h> |
| |
| /* share internal LogLuv conversion routines? */ |
| #ifndef LOGLUV_PUBLIC |
| #define LOGLUV_PUBLIC 1 |
| #endif |
| |
| #if defined(__cplusplus) |
| extern "C" { |
| #endif |
| typedef void (*TIFFErrorHandler)(const char*, const char*, va_list); |
| typedef tsize_t (*TIFFReadWriteProc)(thandle_t, tdata_t, tsize_t); |
| typedef toff_t (*TIFFSeekProc)(thandle_t, toff_t, int); |
| typedef int (*TIFFCloseProc)(thandle_t); |
| typedef toff_t (*TIFFSizeProc)(thandle_t); |
| typedef int (*TIFFMapFileProc)(thandle_t, tdata_t*, toff_t*); |
| typedef void (*TIFFUnmapFileProc)(thandle_t, tdata_t, toff_t); |
| typedef void (*TIFFExtendProc)(TIFF*); |
| |
| extern const char* TIFFGetVersion(void); |
| |
| extern const TIFFCodec* TIFFFindCODEC(uint16); |
| extern TIFFCodec* TIFFRegisterCODEC(uint16, const char*, TIFFInitMethod); |
| extern void TIFFUnRegisterCODEC(TIFFCodec*); |
| |
| extern tdata_t _TIFFmalloc(tsize_t); |
| extern tdata_t _TIFFrealloc(tdata_t, tsize_t); |
| extern void _TIFFmemset(tdata_t, int, tsize_t); |
| extern void _TIFFmemcpy(tdata_t, const tdata_t, tsize_t); |
| extern int _TIFFmemcmp(const tdata_t, const tdata_t, tsize_t); |
| extern void _TIFFfree(tdata_t); |
| |
| extern void TIFFClose(TIFF*); |
| extern int TIFFFlush(TIFF*); |
| extern int TIFFFlushData(TIFF*); |
| extern int TIFFGetField(TIFF*, ttag_t, ...); |
| extern int TIFFVGetField(TIFF*, ttag_t, va_list); |
| extern int TIFFGetFieldDefaulted(TIFF*, ttag_t, ...); |
| extern int TIFFVGetFieldDefaulted(TIFF*, ttag_t, va_list); |
| extern int TIFFReadDirectory(TIFF*); |
| extern tsize_t TIFFScanlineSize(TIFF*); |
| extern tsize_t TIFFRasterScanlineSize(TIFF*); |
| extern tsize_t TIFFStripSize(TIFF*); |
| extern tsize_t TIFFVStripSize(TIFF*, uint32); |
| extern tsize_t TIFFTileRowSize(TIFF*); |
| extern tsize_t TIFFTileSize(TIFF*); |
| extern tsize_t TIFFVTileSize(TIFF*, uint32); |
| extern uint32 TIFFDefaultStripSize(TIFF*, uint32); |
| extern void TIFFDefaultTileSize(TIFF*, uint32*, uint32*); |
| extern int TIFFFileno(TIFF*); |
| extern int TIFFGetMode(TIFF*); |
| extern int TIFFIsTiled(TIFF*); |
| extern int TIFFIsByteSwapped(TIFF*); |
| extern int TIFFIsUpSampled(TIFF*); |
| extern int TIFFIsMSB2LSB(TIFF*); |
| extern uint32 TIFFCurrentRow(TIFF*); |
| extern tdir_t TIFFCurrentDirectory(TIFF*); |
| extern tdir_t TIFFNumberOfDirectories(TIFF*); |
| extern uint32 TIFFCurrentDirOffset(TIFF*); |
| extern tstrip_t TIFFCurrentStrip(TIFF*); |
| extern ttile_t TIFFCurrentTile(TIFF*); |
| extern int TIFFReadBufferSetup(TIFF*, tdata_t, tsize_t); |
| extern int TIFFWriteBufferSetup(TIFF*, tdata_t, tsize_t); |
| extern int TIFFWriteCheck(TIFF*, int, const char *); |
| extern int TIFFCreateDirectory(TIFF*); |
| extern int TIFFLastDirectory(TIFF*); |
| extern int TIFFSetDirectory(TIFF*, tdir_t); |
| extern int TIFFSetSubDirectory(TIFF*, uint32); |
| extern int TIFFUnlinkDirectory(TIFF*, tdir_t); |
| extern int TIFFSetField(TIFF*, ttag_t, ...); |
| extern int TIFFVSetField(TIFF*, ttag_t, va_list); |
| extern int TIFFWriteDirectory(TIFF *); |
| extern int TIFFRewriteDirectory(TIFF *); |
| extern int TIFFReassignTagToIgnore(enum TIFFIgnoreSense, int); |
| |
| #if defined(c_plusplus) || defined(__cplusplus) |
| extern void TIFFPrintDirectory(TIFF*, FILE*, long = 0); |
| extern int TIFFReadScanline(TIFF*, tdata_t, uint32, tsample_t = 0); |
| extern int TIFFWriteScanline(TIFF*, tdata_t, uint32, tsample_t = 0); |
| extern int TIFFReadRGBAImage(TIFF*, uint32, uint32, uint32*, int = 0); |
| #else |
| extern void TIFFPrintDirectory(TIFF*, FILE*, long); |
| extern int TIFFReadScanline(TIFF*, tdata_t, uint32, tsample_t); |
| extern int TIFFWriteScanline(TIFF*, tdata_t, uint32, tsample_t); |
| extern int TIFFReadRGBAImage(TIFF*, uint32, uint32, uint32*, int); |
| #endif |
| |
| extern int TIFFReadRGBAStrip(TIFF*, tstrip_t, uint32 * ); |
| extern int TIFFReadRGBATile(TIFF*, uint32, uint32, uint32 * ); |
| extern int TIFFRGBAImageOK(TIFF*, char [1024]); |
| extern int TIFFRGBAImageBegin(TIFFRGBAImage*, TIFF*, int, char [1024]); |
| extern int TIFFRGBAImageGet(TIFFRGBAImage*, uint32*, uint32, uint32); |
| extern void TIFFRGBAImageEnd(TIFFRGBAImage*); |
| extern TIFF* TIFFOpen(const char*, const char*); |
| extern TIFF* TIFFFdOpen(int, const char*, const char*); |
| extern TIFF* TIFFClientOpen(const char*, const char*, |
| thandle_t, |
| TIFFReadWriteProc, TIFFReadWriteProc, |
| TIFFSeekProc, TIFFCloseProc, |
| TIFFSizeProc, |
| TIFFMapFileProc, TIFFUnmapFileProc); |
| extern const char* TIFFFileName(TIFF*); |
| extern void TIFFError(const char*, const char*, ...); |
| extern void TIFFWarning(const char*, const char*, ...); |
| extern TIFFErrorHandler TIFFSetErrorHandler(TIFFErrorHandler); |
| extern TIFFErrorHandler TIFFSetWarningHandler(TIFFErrorHandler); |
| extern TIFFExtendProc TIFFSetTagExtender(TIFFExtendProc); |
| extern ttile_t TIFFComputeTile(TIFF*, uint32, uint32, uint32, tsample_t); |
| extern int TIFFCheckTile(TIFF*, uint32, uint32, uint32, tsample_t); |
| extern ttile_t TIFFNumberOfTiles(TIFF*); |
| extern tsize_t TIFFReadTile(TIFF*, |
| tdata_t, uint32, uint32, uint32, tsample_t); |
| extern tsize_t TIFFWriteTile(TIFF*, |
| tdata_t, uint32, uint32, uint32, tsample_t); |
| extern tstrip_t TIFFComputeStrip(TIFF*, uint32, tsample_t); |
| extern tstrip_t TIFFNumberOfStrips(TIFF*); |
| extern tsize_t TIFFReadEncodedStrip(TIFF*, tstrip_t, tdata_t, tsize_t); |
| extern tsize_t TIFFReadRawStrip(TIFF*, tstrip_t, tdata_t, tsize_t); |
| extern tsize_t TIFFReadEncodedTile(TIFF*, ttile_t, tdata_t, tsize_t); |
| extern tsize_t TIFFReadRawTile(TIFF*, ttile_t, tdata_t, tsize_t); |
| extern tsize_t TIFFWriteEncodedStrip(TIFF*, tstrip_t, tdata_t, tsize_t); |
| extern tsize_t TIFFWriteRawStrip(TIFF*, tstrip_t, tdata_t, tsize_t); |
| extern tsize_t TIFFWriteEncodedTile(TIFF*, ttile_t, tdata_t, tsize_t); |
| extern tsize_t TIFFWriteRawTile(TIFF*, ttile_t, tdata_t, tsize_t); |
| extern void TIFFSetWriteOffset(TIFF*, toff_t); |
| extern void TIFFSwabShort(uint16*); |
| extern void TIFFSwabLong(uint32*); |
| extern void TIFFSwabDouble(double*); |
| extern void TIFFSwabArrayOfShort(uint16*, unsigned long); |
| extern void TIFFSwabArrayOfLong(uint32*, unsigned long); |
| extern void TIFFSwabArrayOfDouble(double*, unsigned long); |
| extern void TIFFReverseBits(unsigned char *, unsigned long); |
| extern const unsigned char* TIFFGetBitRevTable(int); |
| |
| #ifdef LOGLUV_PUBLIC |
| #define U_NEU 0.210526316 |
| #define V_NEU 0.473684211 |
| #define UVSCALE 410. |
| extern double LogL16toY(int); |
| extern double LogL10toY(int); |
| extern void XYZtoRGB24(float*, uint8*); |
| extern int uv_decode(double*, double*, int); |
| extern void LogLuv24toXYZ(uint32, float*); |
| extern void LogLuv32toXYZ(uint32, float*); |
| #if defined(c_plusplus) || defined(__cplusplus) |
| extern int LogL16fromY(double, int = SGILOGENCODE_NODITHER); |
| extern int LogL10fromY(double, int = SGILOGENCODE_NODITHER); |
| extern int uv_encode(double, double, int = SGILOGENCODE_NODITHER); |
| extern uint32 LogLuv24fromXYZ(float*, int = SGILOGENCODE_NODITHER); |
| extern uint32 LogLuv32fromXYZ(float*, int = SGILOGENCODE_NODITHER); |
| #else |
| extern int LogL16fromY(double, int); |
| extern int LogL10fromY(double, int); |
| extern int uv_encode(double, double, int); |
| extern uint32 LogLuv24fromXYZ(float*, int); |
| extern uint32 LogLuv32fromXYZ(float*, int); |
| #endif |
| #endif /* LOGLUV_PUBLIC */ |
| #if defined(__cplusplus) |
| } |
| #endif |
| #endif /* _TIFFIO_ */ |