8bcd0c172c08af04fb703e21695444f6c86566c1
[platform/upstream/tiff.git] / libtiff / tiffiop.h
1 /* $Id: tiffiop.h,v 1.89 2016-01-23 21:20:34 erouault Exp $ */
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 _TIFFIOP_
28 #define _TIFFIOP_
29 /*
30  * ``Library-private'' definitions.
31  */
32
33 #include "tif_config.h"
34
35 #ifdef HAVE_FCNTL_H
36 # include <fcntl.h>
37 #endif
38
39 #ifdef HAVE_SYS_TYPES_H
40 # include <sys/types.h>
41 #endif
42
43 #ifdef HAVE_STRING_H
44 # include <string.h>
45 #endif
46
47 #ifdef HAVE_ASSERT_H
48 # include <assert.h>
49 #else
50 # define assert(x) 
51 #endif
52
53 #ifdef HAVE_SEARCH_H
54 # include <search.h>
55 #else
56 extern void *lfind(const void *, const void *, size_t *, size_t,
57                    int (*)(const void *, const void *));
58 #endif
59
60 #if !defined(HAVE_SNPRINTF) && !defined(HAVE__SNPRINTF)
61 #undef snprintf
62 #define snprintf _TIFF_snprintf_f
63 extern int snprintf(char* str, size_t size, const char* format, ...);
64 #endif
65
66 #include "tiffio.h"
67
68 #include "tif_dir.h"
69
70 #ifndef STRIP_SIZE_DEFAULT
71 # define STRIP_SIZE_DEFAULT 8192
72 #endif
73
74 #define    streq(a,b)      (strcmp(a,b) == 0)
75
76 #ifndef TRUE
77 #define TRUE    1
78 #define FALSE   0
79 #endif
80
81 typedef struct client_info {
82     struct client_info *next;
83     void *data;
84     char *name;
85 } TIFFClientInfoLink;
86
87 /*
88  * Typedefs for ``method pointers'' used internally.
89  * these are deprecated and provided only for backwards compatibility.
90  */
91 typedef unsigned char tidataval_t;    /* internal image data value type */
92 typedef tidataval_t* tidata_t;        /* reference to internal image data */
93
94 typedef void (*TIFFVoidMethod)(TIFF*);
95 typedef int (*TIFFBoolMethod)(TIFF*);
96 typedef int (*TIFFPreMethod)(TIFF*, uint16);
97 typedef int (*TIFFCodeMethod)(TIFF* tif, uint8* buf, tmsize_t size, uint16 sample);
98 typedef int (*TIFFSeekMethod)(TIFF*, uint32);
99 typedef void (*TIFFPostMethod)(TIFF* tif, uint8* buf, tmsize_t size);
100 typedef uint32 (*TIFFStripMethod)(TIFF*, uint32);
101 typedef void (*TIFFTileMethod)(TIFF*, uint32*, uint32*);
102
103 struct tiff {
104         char*                tif_name;         /* name of open file */
105         int                  tif_fd;           /* open file descriptor */
106         int                  tif_mode;         /* open mode (O_*) */
107         uint32               tif_flags;
108         #define TIFF_FILLORDER   0x00003U /* natural bit fill order for machine */
109         #define TIFF_DIRTYHEADER 0x00004U /* header must be written on close */
110         #define TIFF_DIRTYDIRECT 0x00008U /* current directory must be written */
111         #define TIFF_BUFFERSETUP 0x00010U /* data buffers setup */
112         #define TIFF_CODERSETUP  0x00020U /* encoder/decoder setup done */
113         #define TIFF_BEENWRITING 0x00040U /* written 1+ scanlines to file */
114         #define TIFF_SWAB        0x00080U /* byte swap file information */
115         #define TIFF_NOBITREV    0x00100U /* inhibit bit reversal logic */
116         #define TIFF_MYBUFFER    0x00200U /* my raw data buffer; free on close */
117         #define TIFF_ISTILED     0x00400U /* file is tile, not strip- based */
118         #define TIFF_MAPPED      0x00800U /* file is mapped into memory */
119         #define TIFF_POSTENCODE  0x01000U /* need call to postencode routine */
120         #define TIFF_INSUBIFD    0x02000U /* currently writing a subifd */
121         #define TIFF_UPSAMPLED   0x04000U /* library is doing data up-sampling */
122         #define TIFF_STRIPCHOP   0x08000U /* enable strip chopping support */
123         #define TIFF_HEADERONLY  0x10000U /* read header only, do not process the first directory */
124         #define TIFF_NOREADRAW   0x20000U /* skip reading of raw uncompressed image data */
125         #define TIFF_INCUSTOMIFD 0x40000U /* currently writing a custom IFD */
126         #define TIFF_BIGTIFF     0x80000U /* read/write bigtiff */
127         #define TIFF_BUF4WRITE  0x100000U /* rawcc bytes are for writing */
128         #define TIFF_DIRTYSTRIP 0x200000U /* stripoffsets/stripbytecount dirty*/
129         #define TIFF_PERSAMPLE  0x400000U /* get/set per sample tags as arrays */
130         #define TIFF_BUFFERMMAP 0x800000U /* read buffer (tif_rawdata) points into mmap() memory */
131         uint64               tif_diroff;       /* file offset of current directory */
132         uint64               tif_nextdiroff;   /* file offset of following directory */
133         uint64*              tif_dirlist;      /* list of offsets to already seen directories to prevent IFD looping */
134         uint16               tif_dirlistsize;  /* number of entries in offset list */
135         uint16               tif_dirnumber;    /* number of already seen directories */
136         TIFFDirectory        tif_dir;          /* internal rep of current directory */
137         TIFFDirectory        tif_customdir;    /* custom IFDs are separated from the main ones */
138         union {
139                 TIFFHeaderCommon common;
140                 TIFFHeaderClassic classic;
141                 TIFFHeaderBig big;
142         } tif_header;
143         uint16               tif_header_size;  /* file's header block and its length */
144         uint32               tif_row;          /* current scanline */
145         uint16               tif_curdir;       /* current directory (index) */
146         uint32               tif_curstrip;     /* current strip for read/write */
147         uint64               tif_curoff;       /* current offset for read/write */
148         uint64               tif_dataoff;      /* current offset for writing dir */
149         /* SubIFD support */
150         uint16               tif_nsubifd;      /* remaining subifds to write */
151         uint64               tif_subifdoff;    /* offset for patching SubIFD link */
152         /* tiling support */
153         uint32               tif_col;          /* current column (offset by row too) */
154         uint32               tif_curtile;      /* current tile for read/write */
155         tmsize_t             tif_tilesize;     /* # of bytes in a tile */
156         /* compression scheme hooks */
157         int                  tif_decodestatus;
158         TIFFBoolMethod       tif_fixuptags;    /* called in TIFFReadDirectory */
159         TIFFBoolMethod       tif_setupdecode;  /* called once before predecode */
160         TIFFPreMethod        tif_predecode;    /* pre- row/strip/tile decoding */
161         TIFFBoolMethod       tif_setupencode;  /* called once before preencode */
162         int                  tif_encodestatus;
163         TIFFPreMethod        tif_preencode;    /* pre- row/strip/tile encoding */
164         TIFFBoolMethod       tif_postencode;   /* post- row/strip/tile encoding */
165         TIFFCodeMethod       tif_decoderow;    /* scanline decoding routine */
166         TIFFCodeMethod       tif_encoderow;    /* scanline encoding routine */
167         TIFFCodeMethod       tif_decodestrip;  /* strip decoding routine */
168         TIFFCodeMethod       tif_encodestrip;  /* strip encoding routine */
169         TIFFCodeMethod       tif_decodetile;   /* tile decoding routine */
170         TIFFCodeMethod       tif_encodetile;   /* tile encoding routine */
171         TIFFVoidMethod       tif_close;        /* cleanup-on-close routine */
172         TIFFSeekMethod       tif_seek;         /* position within a strip routine */
173         TIFFVoidMethod       tif_cleanup;      /* cleanup state routine */
174         TIFFStripMethod      tif_defstripsize; /* calculate/constrain strip size */
175         TIFFTileMethod       tif_deftilesize;  /* calculate/constrain tile size */
176         uint8*               tif_data;         /* compression scheme private data */
177         /* input/output buffering */
178         tmsize_t             tif_scanlinesize; /* # of bytes in a scanline */
179         tmsize_t             tif_scanlineskew; /* scanline skew for reading strips */
180         uint8*               tif_rawdata;      /* raw data buffer */
181         tmsize_t             tif_rawdatasize;  /* # of bytes in raw data buffer */
182         tmsize_t             tif_rawdataoff;   /* rawdata offset within strip */
183         tmsize_t             tif_rawdataloaded;/* amount of data in rawdata */
184         uint8*               tif_rawcp;        /* current spot in raw buffer */
185         tmsize_t             tif_rawcc;        /* bytes unread from raw buffer */
186         /* memory-mapped file support */
187         uint8*               tif_base;         /* base of mapped file */
188         tmsize_t             tif_size;         /* size of mapped file region (bytes, thus tmsize_t) */
189         TIFFMapFileProc      tif_mapproc;      /* map file method */
190         TIFFUnmapFileProc    tif_unmapproc;    /* unmap file method */
191         /* input/output callback methods */
192         thandle_t            tif_clientdata;   /* callback parameter */
193         TIFFReadWriteProc    tif_readproc;     /* read method */
194         TIFFReadWriteProc    tif_writeproc;    /* write method */
195         TIFFSeekProc         tif_seekproc;     /* lseek method */
196         TIFFCloseProc        tif_closeproc;    /* close method */
197         TIFFSizeProc         tif_sizeproc;     /* filesize method */
198         /* post-decoding support */
199         TIFFPostMethod       tif_postdecode;   /* post decoding routine */
200         /* tag support */
201         TIFFField**          tif_fields;       /* sorted table of registered tags */
202         size_t               tif_nfields;      /* # entries in registered tag table */
203         const TIFFField*     tif_foundfield;   /* cached pointer to already found tag */
204         TIFFTagMethods       tif_tagmethods;   /* tag get/set/print routines */
205         TIFFClientInfoLink*  tif_clientinfo;   /* extra client information. */
206         /* Backward compatibility stuff. We need these two fields for
207          * setting up an old tag extension scheme. */
208         TIFFFieldArray*      tif_fieldscompat;
209         size_t               tif_nfieldscompat;
210 };
211
212 #define isPseudoTag(t) (t > 0xffff)            /* is tag value normal or pseudo */
213
214 #define isTiled(tif) (((tif)->tif_flags & TIFF_ISTILED) != 0)
215 #define isMapped(tif) (((tif)->tif_flags & TIFF_MAPPED) != 0)
216 #define isFillOrder(tif, o) (((tif)->tif_flags & (o)) != 0)
217 #define isUpSampled(tif) (((tif)->tif_flags & TIFF_UPSAMPLED) != 0)
218 #define TIFFReadFile(tif, buf, size) \
219         ((*(tif)->tif_readproc)((tif)->tif_clientdata,(buf),(size)))
220 #define TIFFWriteFile(tif, buf, size) \
221         ((*(tif)->tif_writeproc)((tif)->tif_clientdata,(buf),(size)))
222 #define TIFFSeekFile(tif, off, whence) \
223         ((*(tif)->tif_seekproc)((tif)->tif_clientdata,(off),(whence)))
224 #define TIFFCloseFile(tif) \
225         ((*(tif)->tif_closeproc)((tif)->tif_clientdata))
226 #define TIFFGetFileSize(tif) \
227         ((*(tif)->tif_sizeproc)((tif)->tif_clientdata))
228 #define TIFFMapFileContents(tif, paddr, psize) \
229         ((*(tif)->tif_mapproc)((tif)->tif_clientdata,(paddr),(psize)))
230 #define TIFFUnmapFileContents(tif, addr, size) \
231         ((*(tif)->tif_unmapproc)((tif)->tif_clientdata,(addr),(size)))
232
233 /*
234  * Default Read/Seek/Write definitions.
235  */
236 #ifndef ReadOK
237 #define ReadOK(tif, buf, size) \
238         (TIFFReadFile((tif),(buf),(size))==(size))
239 #endif
240 #ifndef SeekOK
241 #define SeekOK(tif, off) \
242         (TIFFSeekFile((tif),(off),SEEK_SET)==(off))
243 #endif
244 #ifndef WriteOK
245 #define WriteOK(tif, buf, size) \
246         (TIFFWriteFile((tif),(buf),(size))==(size))
247 #endif
248
249 /* NB: the uint32 casts are to silence certain ANSI-C compilers */
250 #define TIFFhowmany_32(x, y) (((uint32)x < (0xffffffff - (uint32)(y-1))) ? \
251                            ((((uint32)(x))+(((uint32)(y))-1))/((uint32)(y))) : \
252                            0U)
253 #define TIFFhowmany8_32(x) (((x)&0x07)?((uint32)(x)>>3)+1:(uint32)(x)>>3)
254 #define TIFFroundup_32(x, y) (TIFFhowmany_32(x,y)*(y))
255 #define TIFFhowmany_64(x, y) ((((uint64)(x))+(((uint64)(y))-1))/((uint64)(y)))
256 #define TIFFhowmany8_64(x) (((x)&0x07)?((uint64)(x)>>3)+1:(uint64)(x)>>3)
257 #define TIFFroundup_64(x, y) (TIFFhowmany_64(x,y)*(y))
258
259 /* Safe multiply which returns zero if there is an integer overflow */
260 #define TIFFSafeMultiply(t,v,m) ((((t)(m) != (t)0) && (((t)(((v)*(m))/(m))) == (t)(v))) ? (t)((v)*(m)) : (t)0)
261
262 #define TIFFmax(A,B) ((A)>(B)?(A):(B))
263 #define TIFFmin(A,B) ((A)<(B)?(A):(B))
264
265 #define TIFFArrayCount(a) (sizeof (a) / sizeof ((a)[0]))
266
267 /*
268   Support for large files.
269
270   Windows read/write APIs support only 'unsigned int' rather than 'size_t'.
271   Windows off_t is only 32-bit, even in 64-bit builds.
272 */
273 #if defined(HAVE_FSEEKO)
274 /*
275   Use fseeko() and ftello() if they are available since they use
276   'off_t' rather than 'long'.  It is wrong to use fseeko() and
277   ftello() only on systems with special LFS support since some systems
278   (e.g. FreeBSD) support a 64-bit off_t by default.
279
280   For MinGW, __MSVCRT_VERSION__ must be at least 0x800 to expose these
281   interfaces. The MinGW compiler must support the requested version.  MinGW
282   does not distribute the CRT (it is supplied by Microsoft) so the correct CRT
283   must be available on the target computer in order for the program to run.
284 */
285 #if defined(HAVE_FSEEKO)
286 #  define fseek(stream,offset,whence)  fseeko(stream,offset,whence)
287 #  define ftell(stream,offset,whence)  ftello(stream,offset,whence)
288 #endif
289 #endif
290 #if defined(__WIN32__) && \
291         !(defined(_MSC_VER) && _MSC_VER < 1400) && \
292         !(defined(__MSVCRT_VERSION__) && __MSVCRT_VERSION__ < 0x800)
293 typedef unsigned int TIFFIOSize_t;
294 #define _TIFF_lseek_f(fildes,offset,whence)  _lseeki64(fildes,/* __int64 */ offset,whence)
295 /* #define _TIFF_tell_f(fildes) /\* __int64 *\/ _telli64(fildes) */
296 #define _TIFF_fseek_f(stream,offset,whence) _fseeki64(stream,/* __int64 */ offset,whence)
297 #define _TIFF_fstat_f(fildes,stat_buff) _fstati64(fildes,/* struct _stati64 */ stat_buff)
298 /* #define _TIFF_ftell_f(stream) /\* __int64 *\/ _ftelli64(stream) */
299 /* #define _TIFF_stat_f(path,stat_buff) _stati64(path,/\* struct _stati64 *\/ stat_buff) */
300 #define _TIFF_stat_s struct _stati64
301 #define _TIFF_off_t __int64
302 #else
303 typedef size_t TIFFIOSize_t;
304 #define _TIFF_lseek_f(fildes,offset,whence) lseek(fildes,offset,whence)
305 /* #define _TIFF_tell_f(fildes) (_TIFF_lseek_f(fildes,0,SEEK_CUR)) */
306 #define _TIFF_fseek_f(stream,offset,whence) fseek(stream,offset,whence)
307 #define _TIFF_fstat_f(fildes,stat_buff) fstat(fildes,stat_buff)
308 /* #define _TIFF_ftell_f(stream) ftell(stream) */
309 /* #define _TIFF_stat_f(path,stat_buff) stat(path,stat_buff) */
310 #define _TIFF_stat_s struct stat
311 #define _TIFF_off_t off_t
312 #endif
313
314 #if defined(__cplusplus)
315 extern "C" {
316 #endif
317 extern int _TIFFgetMode(const char* mode, const char* module);
318 extern int _TIFFNoRowEncode(TIFF* tif, uint8* pp, tmsize_t cc, uint16 s);
319 extern int _TIFFNoStripEncode(TIFF* tif, uint8* pp, tmsize_t cc, uint16 s);
320 extern int _TIFFNoTileEncode(TIFF*, uint8* pp, tmsize_t cc, uint16 s);
321 extern int _TIFFNoRowDecode(TIFF* tif, uint8* pp, tmsize_t cc, uint16 s);
322 extern int _TIFFNoStripDecode(TIFF* tif, uint8* pp, tmsize_t cc, uint16 s);
323 extern int _TIFFNoTileDecode(TIFF*, uint8* pp, tmsize_t cc, uint16 s);
324 extern void _TIFFNoPostDecode(TIFF* tif, uint8* buf, tmsize_t cc);
325 extern int _TIFFNoPreCode(TIFF* tif, uint16 s);
326 extern int _TIFFNoSeek(TIFF* tif, uint32 off);
327 extern void _TIFFSwab16BitData(TIFF* tif, uint8* buf, tmsize_t cc);
328 extern void _TIFFSwab24BitData(TIFF* tif, uint8* buf, tmsize_t cc);
329 extern void _TIFFSwab32BitData(TIFF* tif, uint8* buf, tmsize_t cc);
330 extern void _TIFFSwab64BitData(TIFF* tif, uint8* buf, tmsize_t cc);
331 extern int TIFFFlushData1(TIFF* tif);
332 extern int TIFFDefaultDirectory(TIFF* tif);
333 extern void _TIFFSetDefaultCompressionState(TIFF* tif);
334 extern int _TIFFRewriteField(TIFF *, uint16, TIFFDataType, tmsize_t, void *);
335 extern int TIFFSetCompressionScheme(TIFF* tif, int scheme);
336 extern int TIFFSetDefaultCompressionState(TIFF* tif);
337 extern uint32 _TIFFDefaultStripSize(TIFF* tif, uint32 s);
338 extern void _TIFFDefaultTileSize(TIFF* tif, uint32* tw, uint32* th);
339 extern int _TIFFDataSize(TIFFDataType type);
340
341 extern void _TIFFsetByteArray(void**, void*, uint32);
342 extern void _TIFFsetString(char**, char*);
343 extern void _TIFFsetShortArray(uint16**, uint16*, uint32);
344 extern void _TIFFsetLongArray(uint32**, uint32*, uint32);
345 extern void _TIFFsetFloatArray(float**, float*, uint32);
346 extern void _TIFFsetDoubleArray(double**, double*, uint32);
347
348 extern void _TIFFprintAscii(FILE*, const char*);
349 extern void _TIFFprintAsciiTag(FILE*, const char*, const char*);
350
351 extern TIFFErrorHandler _TIFFwarningHandler;
352 extern TIFFErrorHandler _TIFFerrorHandler;
353 extern TIFFErrorHandlerExt _TIFFwarningHandlerExt;
354 extern TIFFErrorHandlerExt _TIFFerrorHandlerExt;
355
356 extern uint32 _TIFFMultiply32(TIFF*, uint32, uint32, const char*);
357 extern uint64 _TIFFMultiply64(TIFF*, uint64, uint64, const char*);
358 extern void* _TIFFCheckMalloc(TIFF*, tmsize_t, tmsize_t, const char*);
359 extern void* _TIFFCheckRealloc(TIFF*, void*, tmsize_t, tmsize_t, const char*);
360
361 extern double _TIFFUInt64ToDouble(uint64);
362 extern float _TIFFUInt64ToFloat(uint64);
363
364 extern int TIFFInitDumpMode(TIFF*, int);
365 #ifdef PACKBITS_SUPPORT
366 extern int TIFFInitPackBits(TIFF*, int);
367 #endif
368 #ifdef CCITT_SUPPORT
369 extern int TIFFInitCCITTRLE(TIFF*, int), TIFFInitCCITTRLEW(TIFF*, int);
370 extern int TIFFInitCCITTFax3(TIFF*, int), TIFFInitCCITTFax4(TIFF*, int);
371 #endif
372 #ifdef THUNDER_SUPPORT
373 extern int TIFFInitThunderScan(TIFF*, int);
374 #endif
375 #ifdef NEXT_SUPPORT
376 extern int TIFFInitNeXT(TIFF*, int);
377 #endif
378 #ifdef LZW_SUPPORT
379 extern int TIFFInitLZW(TIFF*, int);
380 #endif
381 #ifdef OJPEG_SUPPORT
382 extern int TIFFInitOJPEG(TIFF*, int);
383 #endif
384 #ifdef JPEG_SUPPORT
385 extern int TIFFInitJPEG(TIFF*, int);
386 #endif
387 #ifdef JBIG_SUPPORT
388 extern int TIFFInitJBIG(TIFF*, int);
389 #endif
390 #ifdef ZIP_SUPPORT
391 extern int TIFFInitZIP(TIFF*, int);
392 #endif
393 #ifdef PIXARLOG_SUPPORT
394 extern int TIFFInitPixarLog(TIFF*, int);
395 #endif
396 #ifdef LOGLUV_SUPPORT
397 extern int TIFFInitSGILog(TIFF*, int);
398 #endif
399 #ifdef LZMA_SUPPORT
400 extern int TIFFInitLZMA(TIFF*, int);
401 #endif
402 #ifdef VMS
403 extern const TIFFCodec _TIFFBuiltinCODECS[];
404 #else
405 extern TIFFCodec _TIFFBuiltinCODECS[];
406 #endif
407
408 #if defined(__cplusplus)
409 }
410 #endif
411 #endif /* _TIFFIOP_ */
412
413 /* vim: set ts=8 sts=8 sw=8 noet: */
414 /*
415  * Local Variables:
416  * mode: c
417  * c-basic-offset: 8
418  * fill-column: 78
419  * End:
420  */