File: tiffio.h

package info (click to toggle)
vtk 5.0.4-1.1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 51,084 kB
  • ctags: 70,426
  • sloc: cpp: 524,166; ansic: 220,276; tcl: 43,377; python: 14,037; perl: 3,102; java: 1,436; yacc: 1,033; sh: 339; lex: 248; makefile: 197; asm: 154
file content (367 lines) | stat: -rw-r--r-- 15,364 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
/* $Header: /cvsroot/VTK/VTK/Utilities/vtktiff/tiffio.h,v 1.5 2005/02/28 18:49:39 malaterre 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"
#include "tiffvers.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

#include "tconf.h"

#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*);

TEXTERN tdata_t TEXPORT _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);
TEXTERN void TEXPORT _TIFFfree(tdata_t);

TEXTERN void TEXPORT TIFFClose(TIFF*);
extern  int TIFFFlush(TIFF*);
extern  int TIFFFlushData(TIFF*);
TEXTERN int TEXPORT 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*);
TEXTERN tsize_t TEXPORT TIFFScanlineSize(TIFF*);
extern  tsize_t TIFFRasterScanlineSize(TIFF*);
extern  tsize_t TIFFStripSize(TIFF*);
extern  tsize_t TIFFVStripSize(TIFF*, uint32);
extern  tsize_t TIFFTileRowSize(TIFF*);
TEXTERN tsize_t TEXPORT TIFFTileSize(TIFF*);
extern  tsize_t TIFFVTileSize(TIFF*, uint32);
TEXTERN uint32 TEXPORT TIFFDefaultStripSize(TIFF*, uint32);
extern  void TIFFDefaultTileSize(TIFF*, uint32*, uint32*);
extern  int TIFFFileno(TIFF*);
extern  int TIFFGetMode(TIFF*);
TEXTERN int TEXPORT 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);
TEXTERN int TEXPORT 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)
TEXTERN void TEXPORT TIFFPrintDirectory(TIFF*, FILE*, long = 0);
TEXTERN int TEXPORT TIFFReadScanline(TIFF*, tdata_t, uint32, tsample_t = 0);
TEXTERN int TEXPORT TIFFWriteScanline(TIFF*, tdata_t, uint32, tsample_t = 0);
TEXTERN int TEXPORT TIFFReadRGBAImage(TIFF*, uint32, uint32, uint32*, int = 0);
#else
TEXTERN void TEXPORT TIFFPrintDirectory(TIFF*, FILE*, long);
TEXTERN int TEXPORT TIFFReadScanline(TIFF*, tdata_t, uint32, tsample_t);
TEXTERN int TEXPORT TIFFWriteScanline(TIFF*, tdata_t, uint32, tsample_t);
TEXTERN int TEXPORT 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*);
TEXTERN  TIFF* TEXPORT TIFFOpen(const char*, const char*);
extern  TIFF* TIFFFdOpen(int, const char*, const char*);
TEXTERN TIFF* TEXPORT 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*, ...);
TEXTERN TIFFErrorHandler TEXPORT TIFFSetErrorHandler(TIFFErrorHandler);
TEXTERN TIFFErrorHandler TEXPORT 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*);
TEXTERN tsize_t TEXPORT 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_ */