home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / NETWORK / netpbm_src.lzh / NETPBM / LIBTIFF / tiffiop.h < prev   
Text File  |  1996-11-18  |  15KB  |  405 lines

  1. /* $Header: /usr/people/sam/tiff/libtiff/RCS/tiffiop.h,v 1.44 93/08/26 14:29:34 sam Exp $ */
  2.  
  3. /*
  4.  * Copyright (c) 1988, 1989, 1990, 1991, 1992 Sam Leffler
  5.  * Copyright (c) 1991, 1992 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. #include "tiffconf.h"
  33. #include "tiffcomp.h"
  34. #include "tiffio.h"
  35.  
  36. /*
  37.  * Internal format of a TIFF directory entry.
  38.  */
  39. typedef    struct {
  40. #define    FIELD_SETLONGS    2
  41.     /* bit vector of fields that are set */
  42.     u_long    td_fieldsset[FIELD_SETLONGS];
  43.  
  44.     uint32    td_imagewidth, td_imagelength, td_imagedepth;
  45.     uint32    td_tilewidth, td_tilelength, td_tiledepth;
  46.     uint16    td_subfiletype;
  47.     uint16    td_bitspersample;
  48.     uint16    td_sampleformat;
  49.     uint16    td_compression;
  50.     uint16    td_photometric;
  51.     uint16    td_threshholding;
  52.     uint16    td_fillorder;
  53.     uint16    td_orientation;
  54.     uint16    td_samplesperpixel;
  55.     uint16    td_predictor;
  56.     uint32    td_rowsperstrip;
  57.     u_long    td_minsamplevalue, td_maxsamplevalue;    /* XXX */
  58.     float    td_xresolution, td_yresolution;
  59.     uint16    td_resolutionunit;
  60.     uint16    td_planarconfig;
  61.     float    td_xposition, td_yposition;
  62.     uint32    td_group3options;
  63.     uint32    td_group4options;
  64.     uint16    td_pagenumber[2];
  65.     uint16    td_cleanfaxdata;
  66.     uint16    td_badfaxrun;
  67.     uint32    td_badfaxlines;
  68.     uint16    *td_colormap[3];
  69.     uint16    td_halftonehints[2];
  70.     uint16    td_extrasamples, *td_sampleinfo;
  71.     char    *td_documentname;
  72.     char    *td_artist;
  73.     char    *td_datetime;
  74.     char    *td_hostcomputer;
  75.     char    *td_imagedescription;
  76.     char    *td_make;
  77.     char    *td_model;
  78.     char    *td_software;
  79.     char    *td_pagename;
  80.     tstrip_t td_stripsperimage;
  81.     tstrip_t td_nstrips;        /* size of offset & bytecount arrays */
  82.     uint32    *td_stripoffset;
  83.     uint32    *td_stripbytecount;
  84. #ifdef YCBCR_SUPPORT
  85.     float    *td_ycbcrcoeffs;
  86.     uint16    td_ycbcrsubsampling[2];
  87.     uint16    td_ycbcrpositioning;
  88. #endif
  89. #ifdef JPEG_SUPPORT
  90.     uint16    td_jpegproc;
  91.     uint16    td_jpegrestartinterval;
  92.     u_char    **td_qtab;
  93.     u_char    **td_dctab;
  94.     u_char    **td_actab;
  95. #endif
  96. #ifdef COLORIMETRY_SUPPORT
  97.     float    *td_whitepoint;
  98.     float    *td_primarychromas;
  99.     float    *td_refblackwhite;
  100.     uint16    *td_transferfunction[3];
  101. #endif
  102. #ifdef CMYK_SUPPORT
  103.     uint16    td_inkset;
  104.     uint16    td_dotrange[2];
  105.     char    *td_inknames;
  106.     char    *td_targetprinter;
  107. #endif
  108. } TIFFDirectory;
  109.  
  110. /*
  111.  * Field flags used to indicate fields that have
  112.  * been set in a directory, and to reference fields
  113.  * when manipulating a directory.
  114.  */
  115. /* multi-entry fields */
  116. #define    FIELD_IMAGEDIMENSIONS        0
  117. #define FIELD_TILEDIMENSIONS        1
  118. #define    FIELD_CELLDIMENSIONS        2        /* XXX */
  119. #define    FIELD_RESOLUTION        3
  120. #define    FIELD_POSITION            4
  121. /* single-entry fields */
  122. #define    FIELD_SUBFILETYPE        5
  123. #define    FIELD_BITSPERSAMPLE        6
  124. #define    FIELD_COMPRESSION        7
  125. #define    FIELD_PHOTOMETRIC        8
  126. #define    FIELD_THRESHHOLDING        9
  127. #define    FIELD_FILLORDER            10
  128. #define    FIELD_DOCUMENTNAME        11
  129. #define    FIELD_IMAGEDESCRIPTION        12
  130. #define    FIELD_MAKE            13
  131. #define    FIELD_MODEL            14
  132. #define    FIELD_ORIENTATION        15
  133. #define    FIELD_SAMPLESPERPIXEL        16
  134. #define    FIELD_ROWSPERSTRIP        17
  135. #define    FIELD_MINSAMPLEVALUE        18
  136. #define    FIELD_MAXSAMPLEVALUE        19
  137. #define    FIELD_PLANARCONFIG        20
  138. #define    FIELD_PAGENAME            21
  139. #define    FIELD_GROUP3OPTIONS        22
  140. #define    FIELD_GROUP4OPTIONS        23
  141. #define    FIELD_RESOLUTIONUNIT        24
  142. #define    FIELD_PAGENUMBER        25
  143. #define    FIELD_STRIPBYTECOUNTS        26
  144. #define    FIELD_STRIPOFFSETS        27
  145. #define    FIELD_COLORMAP            28
  146. #define FIELD_PREDICTOR            29
  147. #define FIELD_ARTIST            30
  148. #define FIELD_DATETIME            31
  149. #define FIELD_HOSTCOMPUTER        32
  150. #define FIELD_SOFTWARE            33
  151. #define    FIELD_EXTRASAMPLES        34
  152. #define    FIELD_BADFAXLINES        35
  153. #define    FIELD_CLEANFAXDATA        36
  154. #define    FIELD_BADFAXRUN            37
  155. #define FIELD_SAMPLEFORMAT        38
  156. #define    FIELD_SMINSAMPLEVALUE        39
  157. #define    FIELD_SMAXSAMPLEVALUE        40
  158. #define FIELD_IMAGEDEPTH        41
  159. #define FIELD_TILEDEPTH            42
  160. #define    FIELD_HALFTONEHINTS        43
  161. #ifdef YCBCR_SUPPORT
  162. #define FIELD_YCBCRCOEFFICIENTS        44
  163. #define FIELD_YCBCRSUBSAMPLING        45
  164. #define FIELD_YCBCRPOSITIONING        46
  165. #endif
  166. #ifdef JPEG_SUPPORT
  167. #define FIELD_JPEGPROC            47
  168. #define FIELD_JPEGRESTARTINTERVAL    48
  169. #define FIELD_JPEGQTABLES        49
  170. #define FIELD_JPEGDCTABLES        50
  171. #define FIELD_JPEGACTABLES        51
  172. #endif
  173. #ifdef COLORIMETRY_SUPPORT
  174. #define    FIELD_REFBLACKWHITE        52
  175. #define    FIELD_WHITEPOINT        53
  176. #define    FIELD_PRIMARYCHROMAS        54
  177. #define    FIELD_TRANSFERFUNCTION        55
  178. #endif
  179. #ifdef CMYK_SUPPORT
  180. #define    FIELD_INKSET            56
  181. #define    FIELD_INKNAMES            57
  182. #define    FIELD_DOTRANGE            58
  183. #define    FIELD_TARGETPRINTER        59
  184. #endif
  185. #define    FIELD_LAST            59
  186.  
  187. #define    TIFFExtractData(tif, type, v) \
  188.     ((tif)->tif_header.tiff_magic == TIFF_BIGENDIAN ? \
  189.         ((v) >> (tif)->tif_typeshift[type]) & (tif)->tif_typemask[type] : \
  190.     (v) & (tif)->tif_typemask[type])
  191. #define    TIFFInsertData(tif, type, v) \
  192.     ((tif)->tif_header.tiff_magic == TIFF_BIGENDIAN ? \
  193.         ((v) & (tif)->tif_typemask[type]) << (tif)->tif_typeshift[type] : \
  194.     (v) & (tif)->tif_typemask[type])
  195.  
  196. typedef    struct {
  197.     ttag_t    field_tag;        /* field's tag */
  198.     short    field_readcount;    /* read count (-1 for unknown) */
  199.     short    field_writecount;    /* write count (-1 for unknown) */
  200.     TIFFDataType field_type;    /* type of associated data */
  201.     u_short    field_bit;        /* bit in fieldsset bit vector */
  202.     u_short    field_oktochange;    /* if true, can change while writing */
  203.     char    *field_name;        /* ASCII name */
  204. } TIFFFieldInfo;
  205.  
  206. #define    FIELD_IGNORE    ((u_short)-1)    /* tags processed but ignored */
  207.  
  208. #define    TIFF_ANY    TIFF_NOTYPE    /* for field descriptor searching */
  209. #define    TIFF_VARIABLE    -1        /* marker for variable length tags */
  210. #define    TIFF_SPP    -2        /* marker for SamplesPerPixel tags */
  211.  
  212. extern    const TIFFFieldInfo tiffFieldInfo[];/* table of field descriptors */
  213. extern    const int tiffDataWidth[];    /* table of tag datatype widths */
  214.  
  215. #define BITn(n)                (((u_long)1L)<<((n)&0x1f)) 
  216. #define BITFIELDn(tif, n)        ((tif)->tif_dir.td_fieldsset[(n)/32]) 
  217. #define TIFFFieldSet(tif, field)    (BITFIELDn(tif, field) & BITn(field)) 
  218. #define TIFFSetFieldBit(tif, field)    (BITFIELDn(tif, field) |= BITn(field))
  219. #define TIFFClrFieldBit(tif, field)    (BITFIELDn(tif, field) &= ~BITn(field))
  220.  
  221. #define    FieldSet(fields, f)        (fields[(f)/32] & BITn(f))
  222. #define    ResetFieldBit(fields, f)    (fields[(f)/32] &= ~BITn(f))
  223.  
  224. /*
  225.  * Typedefs for ``method pointers'' used internally.
  226.  */
  227. typedef    unsigned char* tidata_t;    /* internal image data type */
  228.  
  229. typedef    void (*TIFFVoidMethod)(TIFF*);
  230. typedef    int (*TIFFBoolMethod)(TIFF*);
  231. typedef    int (*TIFFCodeMethod)(TIFF*, tidata_t, tsize_t, tsample_t);
  232. typedef    int (*TIFFSeekMethod)(TIFF*, uint32);
  233. typedef    void (*TIFFPostMethod)(TIFF*, tidata_t, tsize_t);
  234.  
  235. struct tiff {
  236.     char*        tif_name;    /* name of open file */
  237.     short        tif_fd;        /* open file descriptor */
  238.     short        tif_mode;    /* open mode (O_*) */
  239.     char        tif_fillorder;    /* natural bit fill order for machine */
  240.     char        tif_options;    /* compression-specific options */
  241.     short        tif_flags;
  242. #define    TIFF_DIRTYHEADER    0x1    /* header must be written on close */
  243. #define    TIFF_DIRTYDIRECT    0x2    /* current directory must be written */
  244. #define    TIFF_BUFFERSETUP    0x4    /* data buffers setup */
  245. #define    TIFF_BEENWRITING    0x8    /* written 1+ scanlines to file */
  246. #define    TIFF_SWAB        0x10    /* byte swap file information */
  247. #define    TIFF_NOBITREV        0x20    /* inhibit bit reversal logic */
  248. #define    TIFF_MYBUFFER        0x40    /* my raw data buffer; free on close */
  249. #define    TIFF_ISTILED        0x80    /* file is tile, not strip- based */
  250. #define    TIFF_MAPPED        0x100    /* file is mapped into memory */
  251. #define    TIFF_POSTENCODE        0x200    /* need call to postencode routine */
  252.     toff_t        tif_diroff;    /* file offset of current directory */
  253.     toff_t        tif_nextdiroff;    /* file offset of following directory */
  254.     TIFFDirectory    tif_dir;    /* internal rep of current directory */
  255.     TIFFHeader    tif_header;    /* file's header block */
  256.     const int*    tif_typeshift;    /* data type shift counts */
  257.     const long*    tif_typemask;    /* data type masks */
  258.     uint32        tif_row;    /* current scanline */
  259.     tdir_t        tif_curdir;    /* current directory (index) */
  260.     tstrip_t    tif_curstrip;    /* current strip for read/write */
  261.     toff_t        tif_curoff;    /* current offset for read/write */
  262.     toff_t        tif_dataoff;    /* current offset for writing dir */
  263. /* tiling support */
  264.     uint32         tif_col;    /* current column (offset by row too) */
  265.     ttile_t        tif_curtile;    /* current tile for read/write */
  266.     tsize_t        tif_tilesize;    /* # of bytes in a tile */
  267. /* compression scheme hooks */
  268.     TIFFBoolMethod    tif_predecode;    /* pre row/strip/tile decoding */
  269.     TIFFBoolMethod    tif_preencode;    /* pre row/strip/tile encoding */
  270.     TIFFBoolMethod    tif_postencode;    /* post row/strip/tile encoding */
  271.     TIFFCodeMethod    tif_decoderow;    /* scanline decoding routine */
  272.     TIFFCodeMethod    tif_encoderow;    /* scanline encoding routine */
  273.     TIFFCodeMethod    tif_decodestrip;/* strip decoding routine */
  274.     TIFFCodeMethod    tif_encodestrip;/* strip encoding routine */
  275.     TIFFCodeMethod    tif_decodetile;    /* tile decoding routine */
  276.     TIFFCodeMethod    tif_encodetile;    /* tile encoding routine */
  277.     TIFFVoidMethod    tif_close;    /* cleanup-on-close routine */
  278.     TIFFSeekMethod    tif_seek;    /* position within a strip routine */
  279.     TIFFVoidMethod    tif_cleanup;    /* routine called to cleanup state */
  280.     tidata_t    tif_data;    /* compression scheme private data */
  281. /* input/output buffering */
  282.     tsize_t        tif_scanlinesize;/* # of bytes in a scanline */
  283.     tsize_t        tif_scanlineskew;/* scanline skew for reading strips */
  284.     tidata_t    tif_rawdata;    /* raw data buffer */
  285.     tsize_t        tif_rawdatasize;/* # of bytes in raw data buffer */
  286.     tidata_t    tif_rawcp;    /* current spot in raw buffer */
  287.     tsize_t        tif_rawcc;    /* bytes unread from raw buffer */
  288. /* memory-mapped file support */
  289.     tidata_t    tif_base;    /* base of mapped file */
  290.     toff_t        tif_size;    /* size of mapped file region (bytes) */
  291.     TIFFMapFileProc    tif_mapproc;    /* map file method */
  292.     TIFFUnmapFileProc tif_unmapproc;/* unmap file method */
  293. /* input/output callback methods */
  294.     thandle_t    tif_clientdata;    /* callback parameter */
  295.     TIFFReadWriteProc tif_readproc;    /* read method */
  296.     TIFFReadWriteProc tif_writeproc;/* write method */
  297.     TIFFSeekProc    tif_seekproc;    /* lseek method */
  298.     TIFFCloseProc    tif_closeproc;    /* close method */
  299.     TIFFSizeProc    tif_sizeproc;    /* filesize method */
  300. /* post-decoding support */
  301.     TIFFPostMethod    tif_postdecode;/* post decoding routine */
  302. };
  303.  
  304. #define    isTiled(tif)    (((tif)->tif_flags & TIFF_ISTILED) != 0)
  305. #define    isMapped(tif)    (((tif)->tif_flags & TIFF_MAPPED) != 0)
  306. #define    TIFFReadFile(tif, buf, size) \
  307.     ((*(tif)->tif_readproc)((tif)->tif_clientdata,buf,size))
  308. #define    TIFFWriteFile(tif, buf, size) \
  309.     ((*(tif)->tif_writeproc)((tif)->tif_clientdata,buf,size))
  310. #define    TIFFSeekFile(tif, off, whence) \
  311.     ((*(tif)->tif_seekproc)((tif)->tif_clientdata,off,whence))
  312. #define    TIFFCloseFile(tif) \
  313.     ((*(tif)->tif_closeproc)((tif)->tif_clientdata))
  314. #define    TIFFGetFileSize(tif) \
  315.     ((*(tif)->tif_sizeproc)((tif)->tif_clientdata))
  316. #define    TIFFMapFileContents(tif, paddr, psize) \
  317.     ((*(tif)->tif_mapproc)((tif)->tif_clientdata,paddr,psize))
  318. #define    TIFFUnmapFileContents(tif, addr, size) \
  319.     ((*(tif)->tif_unmapproc)((tif)->tif_clientdata,addr,size))
  320.  
  321. /*
  322.  * Default Read/Seek/Write definitions.
  323.  */
  324. #ifndef ReadOK
  325. #define    ReadOK(tif, buf, size) \
  326.     (TIFFReadFile(tif, (tdata_t) buf, (tsize_t) size) == size)
  327. #endif
  328. #ifndef SeekOK
  329. #define    SeekOK(tif, off) \
  330.     (TIFFSeekFile(tif, (toff_t) off, L_SET) == (toff_t) off)
  331. #endif
  332. #ifndef WriteOK
  333. #define    WriteOK(tif, buf, size) \
  334.     (TIFFWriteFile(tif, (tdata_t) buf, (tsize_t) size) == (tsize_t) size)
  335. #endif
  336.  
  337. /* generic option bit names */
  338. #define    TIFF_OPT0    0x1
  339. #define    TIFF_OPT1    0x2
  340. #define    TIFF_OPT2    0x4
  341. #define    TIFF_OPT3    0x8
  342. #define    TIFF_OPT4    0x10
  343. #define    TIFF_OPT5    0x20
  344. #define    TIFF_OPT6    0x40
  345. #define    TIFF_OPT7    0x80
  346.  
  347. /* NB: the u_long casts are to silence certain ANSI-C compilers */
  348. #ifdef howmany
  349. #undef howmany
  350. #endif
  351. #define    howmany(x, y)    ((((u_long)(x))+(((u_long)(y))-1))/((u_long)(y)))
  352. #ifdef roundup
  353. #undef roundup
  354. #endif
  355. #define    roundup(x, y)    (howmany(x,y)*((u_long)(y)))
  356.  
  357. #if defined(__cplusplus)
  358. extern "C" {
  359. #endif
  360. extern    void* _TIFFmalloc(size_t);
  361. extern    void* _TIFFrealloc(void*, size_t);
  362. extern    void _TIFFfree(void*);
  363. extern    int _TIFFgetMode(const char* mode, const char* module);
  364. extern    const TIFFFieldInfo *TIFFFindFieldInfo(ttag_t, TIFFDataType);
  365. extern    const TIFFFieldInfo *TIFFFieldWithTag(ttag_t);
  366. extern    void _TIFFgetfield(TIFFDirectory*, ttag_t, ...);
  367. extern    int TIFFNoRowEncode(TIFF*, tidata_t, tsize_t, tsample_t);
  368. extern    int TIFFNoStripEncode(TIFF*, tidata_t, tsize_t, tsample_t);
  369. extern    int TIFFNoTileEncode(TIFF*, tidata_t, tsize_t, tsample_t);
  370. extern    int TIFFNoRowDecode(TIFF*, tidata_t, tsize_t, tsample_t);
  371. extern    int TIFFNoStripDecode(TIFF*, tidata_t, tsize_t, tsample_t);
  372. extern    int TIFFNoTileDecode(TIFF*, tidata_t, tsize_t, tsample_t);
  373. extern    void TIFFNoPostDecode(TIFF*, tidata_t, tsize_t);
  374. extern    void TIFFSwab16BitData(TIFF*, tidata_t, tsize_t);
  375. extern    void TIFFSwab32BitData(TIFF*, tidata_t, tsize_t);
  376. extern    int TIFFFlushData1(TIFF*);
  377. extern    void TIFFFreeDirectory(TIFF*);
  378. extern    int TIFFDefaultDirectory(TIFF*);
  379. extern    int TIFFSetCompressionScheme(TIFF *, int);
  380.  
  381. extern    int TIFFInitDumpMode(TIFF*);
  382. #ifdef PACKBITS_SUPPORT
  383. extern    int TIFFInitPackBits(TIFF*);
  384. #endif
  385. #ifdef CCITT_SUPPORT
  386. extern    int TIFFInitCCITTRLE(TIFF*), TIFFInitCCITTRLEW(TIFF*);
  387. extern    int TIFFInitCCITTFax3(TIFF*), TIFFInitCCITTFax4(TIFF*);
  388. #endif
  389. #ifdef THUNDER_SUPPORT
  390. extern    int TIFFInitThunderScan(TIFF*);
  391. #endif
  392. #ifdef NEXT_SUPPORT
  393. extern    int TIFFInitNeXT(TIFF*);
  394. #endif
  395. #ifdef LZW_SUPPORT
  396. extern    int TIFFInitLZW(TIFF*);
  397. #endif
  398. #ifdef JPEG_SUPPORT
  399. extern    int TIFFInitJPEG(TIFF*);
  400. #endif
  401. #if defined(__cplusplus)
  402. }
  403. #endif
  404. #endif /* _TIFFIOP_ */
  405.