/* $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:

 */