309 lines
11 KiB
C
309 lines
11 KiB
C
/* $Id: tif_dir.h,v 1.54 2011-02-18 20:53:05 fwarmerdam 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 _TIFFDIR_
|
|
#define _TIFFDIR_
|
|
/*
|
|
* ``Library-private'' Directory-related Definitions.
|
|
*/
|
|
|
|
typedef struct {
|
|
const TIFFField *info;
|
|
int count;
|
|
void *value;
|
|
} TIFFTagValue;
|
|
|
|
/*
|
|
* TIFF Image File Directories are comprised of a table of field
|
|
* descriptors of the form shown below. The table is sorted in
|
|
* ascending order by tag. The values associated with each entry are
|
|
* disjoint and may appear anywhere in the file (so long as they are
|
|
* placed on a word boundary).
|
|
*
|
|
* If the value is 4 bytes or less, in ClassicTIFF, or 8 bytes or less in
|
|
* BigTIFF, then it is placed in the offset field to save space. If so,
|
|
* it is left-justified in the offset field.
|
|
*/
|
|
typedef struct {
|
|
uint16 tdir_tag; /* see below */
|
|
uint16 tdir_type; /* data type; see below */
|
|
uint64 tdir_count; /* number of items; length in spec */
|
|
union {
|
|
uint16 toff_short;
|
|
uint32 toff_long;
|
|
uint64 toff_long8;
|
|
} tdir_offset; /* either offset or the data itself if fits */
|
|
} TIFFDirEntry;
|
|
|
|
/*
|
|
* Internal format of a TIFF directory entry.
|
|
*/
|
|
typedef struct {
|
|
#define FIELD_SETLONGS 4
|
|
/* bit vector of fields that are set */
|
|
unsigned long td_fieldsset[FIELD_SETLONGS];
|
|
|
|
uint32 td_imagewidth, td_imagelength, td_imagedepth;
|
|
uint32 td_tilewidth, td_tilelength, td_tiledepth;
|
|
uint32 td_subfiletype;
|
|
uint16 td_bitspersample;
|
|
uint16 td_sampleformat;
|
|
uint16 td_compression;
|
|
uint16 td_photometric;
|
|
uint16 td_threshholding;
|
|
uint16 td_fillorder;
|
|
uint16 td_orientation;
|
|
uint16 td_samplesperpixel;
|
|
uint32 td_rowsperstrip;
|
|
uint16 td_minsamplevalue, td_maxsamplevalue;
|
|
double* td_sminsamplevalue;
|
|
double* td_smaxsamplevalue;
|
|
float td_xresolution, td_yresolution;
|
|
uint16 td_resolutionunit;
|
|
uint16 td_planarconfig;
|
|
float td_xposition, td_yposition;
|
|
uint16 td_pagenumber[2];
|
|
uint16* td_colormap[3];
|
|
uint16 td_halftonehints[2];
|
|
uint16 td_extrasamples;
|
|
uint16* td_sampleinfo;
|
|
/* even though the name is misleading, td_stripsperimage is the number
|
|
* of striles (=strips or tiles) per plane, and td_nstrips the total
|
|
* number of striles */
|
|
uint32 td_stripsperimage;
|
|
uint32 td_nstrips; /* size of offset & bytecount arrays */
|
|
uint64* td_stripoffset;
|
|
uint64* td_stripbytecount;
|
|
int td_stripbytecountsorted; /* is the bytecount array sorted ascending? */
|
|
#if defined(DEFER_STRILE_LOAD)
|
|
TIFFDirEntry td_stripoffset_entry; /* for deferred loading */
|
|
TIFFDirEntry td_stripbytecount_entry; /* for deferred loading */
|
|
#endif
|
|
uint16 td_nsubifd;
|
|
uint64* td_subifd;
|
|
/* YCbCr parameters */
|
|
uint16 td_ycbcrsubsampling[2];
|
|
uint16 td_ycbcrpositioning;
|
|
/* Colorimetry parameters */
|
|
uint16* td_transferfunction[3];
|
|
float* td_refblackwhite;
|
|
/* CMYK parameters */
|
|
int td_inknameslen;
|
|
char* td_inknames;
|
|
|
|
int td_customValueCount;
|
|
TIFFTagValue *td_customValues;
|
|
} TIFFDirectory;
|
|
|
|
/*
|
|
* Field flags used to indicate fields that have been set in a directory, and
|
|
* to reference fields when manipulating a directory.
|
|
*/
|
|
|
|
/*
|
|
* FIELD_IGNORE is used to signify tags that are to be processed but otherwise
|
|
* ignored. This permits antiquated tags to be quietly read and discarded.
|
|
* Note that a bit *is* allocated for ignored tags; this is understood by the
|
|
* directory reading logic which uses this fact to avoid special-case handling
|
|
*/
|
|
#define FIELD_IGNORE 0
|
|
|
|
/* multi-item fields */
|
|
#define FIELD_IMAGEDIMENSIONS 1
|
|
#define FIELD_TILEDIMENSIONS 2
|
|
#define FIELD_RESOLUTION 3
|
|
#define FIELD_POSITION 4
|
|
|
|
/* single-item fields */
|
|
#define FIELD_SUBFILETYPE 5
|
|
#define FIELD_BITSPERSAMPLE 6
|
|
#define FIELD_COMPRESSION 7
|
|
#define FIELD_PHOTOMETRIC 8
|
|
#define FIELD_THRESHHOLDING 9
|
|
#define FIELD_FILLORDER 10
|
|
#define FIELD_ORIENTATION 15
|
|
#define FIELD_SAMPLESPERPIXEL 16
|
|
#define FIELD_ROWSPERSTRIP 17
|
|
#define FIELD_MINSAMPLEVALUE 18
|
|
#define FIELD_MAXSAMPLEVALUE 19
|
|
#define FIELD_PLANARCONFIG 20
|
|
#define FIELD_RESOLUTIONUNIT 22
|
|
#define FIELD_PAGENUMBER 23
|
|
#define FIELD_STRIPBYTECOUNTS 24
|
|
#define FIELD_STRIPOFFSETS 25
|
|
#define FIELD_COLORMAP 26
|
|
#define FIELD_EXTRASAMPLES 31
|
|
#define FIELD_SAMPLEFORMAT 32
|
|
#define FIELD_SMINSAMPLEVALUE 33
|
|
#define FIELD_SMAXSAMPLEVALUE 34
|
|
#define FIELD_IMAGEDEPTH 35
|
|
#define FIELD_TILEDEPTH 36
|
|
#define FIELD_HALFTONEHINTS 37
|
|
#define FIELD_YCBCRSUBSAMPLING 39
|
|
#define FIELD_YCBCRPOSITIONING 40
|
|
#define FIELD_REFBLACKWHITE 41
|
|
#define FIELD_TRANSFERFUNCTION 44
|
|
#define FIELD_INKNAMES 46
|
|
#define FIELD_SUBIFD 49
|
|
/* FIELD_CUSTOM (see tiffio.h) 65 */
|
|
/* end of support for well-known tags; codec-private tags follow */
|
|
#define FIELD_CODEC 66 /* base of codec-private tags */
|
|
|
|
|
|
/*
|
|
* Pseudo-tags don't normally need field bits since they are not written to an
|
|
* output file (by definition). The library also has express logic to always
|
|
* query a codec for a pseudo-tag so allocating a field bit for one is a
|
|
* waste. If codec wants to promote the notion of a pseudo-tag being ``set''
|
|
* or ``unset'' then it can do using internal state flags without polluting
|
|
* the field bit space defined for real tags.
|
|
*/
|
|
#define FIELD_PSEUDO 0
|
|
|
|
#define FIELD_LAST (32*FIELD_SETLONGS-1)
|
|
|
|
#define BITn(n) (((unsigned long)1L)<<((n)&0x1f))
|
|
#define BITFIELDn(tif, n) ((tif)->tif_dir.td_fieldsset[(n)/32])
|
|
#define TIFFFieldSet(tif, field) (BITFIELDn(tif, field) & BITn(field))
|
|
#define TIFFSetFieldBit(tif, field) (BITFIELDn(tif, field) |= BITn(field))
|
|
#define TIFFClrFieldBit(tif, field) (BITFIELDn(tif, field) &= ~BITn(field))
|
|
|
|
#define FieldSet(fields, f) (fields[(f)/32] & BITn(f))
|
|
#define ResetFieldBit(fields, f) (fields[(f)/32] &= ~BITn(f))
|
|
|
|
typedef enum {
|
|
TIFF_SETGET_UNDEFINED = 0,
|
|
TIFF_SETGET_ASCII = 1,
|
|
TIFF_SETGET_UINT8 = 2,
|
|
TIFF_SETGET_SINT8 = 3,
|
|
TIFF_SETGET_UINT16 = 4,
|
|
TIFF_SETGET_SINT16 = 5,
|
|
TIFF_SETGET_UINT32 = 6,
|
|
TIFF_SETGET_SINT32 = 7,
|
|
TIFF_SETGET_UINT64 = 8,
|
|
TIFF_SETGET_SINT64 = 9,
|
|
TIFF_SETGET_FLOAT = 10,
|
|
TIFF_SETGET_DOUBLE = 11,
|
|
TIFF_SETGET_IFD8 = 12,
|
|
TIFF_SETGET_INT = 13,
|
|
TIFF_SETGET_UINT16_PAIR = 14,
|
|
TIFF_SETGET_C0_ASCII = 15,
|
|
TIFF_SETGET_C0_UINT8 = 16,
|
|
TIFF_SETGET_C0_SINT8 = 17,
|
|
TIFF_SETGET_C0_UINT16 = 18,
|
|
TIFF_SETGET_C0_SINT16 = 19,
|
|
TIFF_SETGET_C0_UINT32 = 20,
|
|
TIFF_SETGET_C0_SINT32 = 21,
|
|
TIFF_SETGET_C0_UINT64 = 22,
|
|
TIFF_SETGET_C0_SINT64 = 23,
|
|
TIFF_SETGET_C0_FLOAT = 24,
|
|
TIFF_SETGET_C0_DOUBLE = 25,
|
|
TIFF_SETGET_C0_IFD8 = 26,
|
|
TIFF_SETGET_C16_ASCII = 27,
|
|
TIFF_SETGET_C16_UINT8 = 28,
|
|
TIFF_SETGET_C16_SINT8 = 29,
|
|
TIFF_SETGET_C16_UINT16 = 30,
|
|
TIFF_SETGET_C16_SINT16 = 31,
|
|
TIFF_SETGET_C16_UINT32 = 32,
|
|
TIFF_SETGET_C16_SINT32 = 33,
|
|
TIFF_SETGET_C16_UINT64 = 34,
|
|
TIFF_SETGET_C16_SINT64 = 35,
|
|
TIFF_SETGET_C16_FLOAT = 36,
|
|
TIFF_SETGET_C16_DOUBLE = 37,
|
|
TIFF_SETGET_C16_IFD8 = 38,
|
|
TIFF_SETGET_C32_ASCII = 39,
|
|
TIFF_SETGET_C32_UINT8 = 40,
|
|
TIFF_SETGET_C32_SINT8 = 41,
|
|
TIFF_SETGET_C32_UINT16 = 42,
|
|
TIFF_SETGET_C32_SINT16 = 43,
|
|
TIFF_SETGET_C32_UINT32 = 44,
|
|
TIFF_SETGET_C32_SINT32 = 45,
|
|
TIFF_SETGET_C32_UINT64 = 46,
|
|
TIFF_SETGET_C32_SINT64 = 47,
|
|
TIFF_SETGET_C32_FLOAT = 48,
|
|
TIFF_SETGET_C32_DOUBLE = 49,
|
|
TIFF_SETGET_C32_IFD8 = 50,
|
|
TIFF_SETGET_OTHER = 51
|
|
} TIFFSetGetFieldType;
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
extern const TIFFFieldArray* _TIFFGetFields(void);
|
|
extern const TIFFFieldArray* _TIFFGetExifFields(void);
|
|
extern void _TIFFSetupFields(TIFF* tif, const TIFFFieldArray* infoarray);
|
|
extern void _TIFFPrintFieldInfo(TIFF*, FILE*);
|
|
|
|
extern int _TIFFFillStriles(TIFF*);
|
|
|
|
typedef enum {
|
|
tfiatImage,
|
|
tfiatExif,
|
|
tfiatOther
|
|
} TIFFFieldArrayType;
|
|
|
|
struct _TIFFFieldArray {
|
|
TIFFFieldArrayType type; /* array type, will be used to determine if IFD is image and such */
|
|
uint32 allocated_size; /* 0 if array is constant, other if modified by future definition extension support */
|
|
uint32 count; /* number of elements in fields array */
|
|
TIFFField* fields; /* actual field info */
|
|
};
|
|
|
|
struct _TIFFField {
|
|
uint32 field_tag; /* field's tag */
|
|
short field_readcount; /* read count/TIFF_VARIABLE/TIFF_SPP */
|
|
short field_writecount; /* write count/TIFF_VARIABLE */
|
|
TIFFDataType field_type; /* type of associated data */
|
|
uint32 reserved; /* reserved for future extension */
|
|
TIFFSetGetFieldType set_field_type; /* type to be passed to TIFFSetField */
|
|
TIFFSetGetFieldType get_field_type; /* type to be passed to TIFFGetField */
|
|
unsigned short field_bit; /* bit in fieldsset bit vector */
|
|
unsigned char field_oktochange; /* if true, can change while writing */
|
|
unsigned char field_passcount; /* if true, pass dir count on set */
|
|
char* field_name; /* ASCII name */
|
|
TIFFFieldArray* field_subfields; /* if field points to child ifds, child ifd field definition array */
|
|
};
|
|
|
|
extern int _TIFFMergeFields(TIFF*, const TIFFField[], uint32);
|
|
extern const TIFFField* _TIFFFindOrRegisterField(TIFF *, uint32, TIFFDataType);
|
|
extern TIFFField* _TIFFCreateAnonField(TIFF *, uint32, TIFFDataType);
|
|
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
#endif /* _TIFFDIR_ */
|
|
|
|
/* vim: set ts=8 sts=8 sw=8 noet: */
|
|
|
|
/*
|
|
* Local Variables:
|
|
* mode: c
|
|
* c-basic-offset: 8
|
|
* fill-column: 78
|
|
* End:
|
|
*/
|