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
|
/**********************************************************************
*
* geotiff.h - Public interface for Geotiff tag parsing.
*
* Written By: Niles D. Ritter
*
* copyright (c) 1995 Niles D. Ritter
*
* Permission granted to use this software, so long as this copyright
* notice accompanies any products derived therefrom.
**********************************************************************/
#ifndef LIBGEOTIFF_GEOTIFF_H_
#define LIBGEOTIFF_GEOTIFF_H_
/**
* \file geotiff.h
*
* Primary libgeotiff include file.
*
* This is the de facto registry for valid GeoTIFF GeoKeys
* and their associated symbolic values. This is also the only file
* of the GeoTIFF library which needs to be included in client source
* code.
*/
/* This Version code should only change if a drastic
* alteration is made to the GeoTIFF key structure. Readers
* encountering a larger value should give up gracefully.
*/
#define GvCurrentVersion 1
/* Versions of GeoTIFF specification and corresponding
* (version, key_revision, minor_revision) triplets.
* At that time, only 2 versions are known: */
/* GEOTIFF_SPEC_1_0 corresponds to the original GeoTIFF specification,
* "Revision 1.0, specification version 1.8.2 in November 1995 (N. Ritter & Ruth, 1995)"
* available at http://geotiff.maptools.org/spec/geotiffhome.html */
#define GEOTIFF_SPEC_1_0_VERSION 1
#define GEOTIFF_SPEC_1_0_KEY_REVISION 1
#define GEOTIFF_SPEC_1_0_MINOR_REVISION 0
/* GEOTIFF_SPEC_1_1 corresponds to the OGC GeoTIFF standard 19-008 */
#define GEOTIFF_SPEC_1_1_VERSION 1
#define GEOTIFF_SPEC_1_1_KEY_REVISION 1
#define GEOTIFF_SPEC_1_1_MINOR_REVISION 1
/* Library version */
#define LIBGEOTIFF_VERSION 1740
#include "geo_config.h"
#include "geokeys.h"
/**********************************************************************
* Do we want to build as a DLL on windows?
**********************************************************************/
#if !defined(GTIF_DLL)
# if defined(_WIN32) && defined(BUILD_AS_DLL)
# define GTIF_DLL __declspec(dllexport)
# else
# define GTIF_DLL
# endif
#endif
/**********************************************************************
*
* Public Structures & Definitions
*
**********************************************************************/
#if defined(__cplusplus)
extern "C" {
#endif
typedef struct gtiff GTIF; /* struct gtiff is private */
typedef struct _TIFFMethod TIFFMethod;
typedef unsigned short tifftag_t;
typedef unsigned short geocode_t;
typedef int (*GTIFPrintMethod)(char *string, void *aux);
typedef int (*GTIFReadMethod)(char *string, void *aux); // string 1024+ in size
typedef enum {
TYPE_BYTE=1,
TYPE_SHORT=2,
TYPE_LONG=3,
TYPE_RATIONAL=4,
TYPE_ASCII=5,
TYPE_FLOAT=6,
TYPE_DOUBLE=7,
TYPE_SBYTE=8,
TYPE_SSHORT=9,
TYPE_SLONG=10,
TYPE_UNKNOWN=11
} tagtype_t;
#define LIBGEOTIFF_WARNING 0
#define LIBGEOTIFF_ERROR 1
#ifndef GTIF_PRINT_FUNC_FORMAT
#if defined(__GNUC__) && __GNUC__ >= 3
#define GTIF_PRINT_FUNC_FORMAT( format_idx, arg_idx ) __attribute__((__format__ (__printf__, format_idx, arg_idx)))
#else
#define GTIF_PRINT_FUNC_FORMAT( format_idx, arg_idx )
#endif
#endif
#ifndef GTERRORCALLBACK_DEFINED
#define GTERRORCALLBACK_DEFINED
/* Defined in both geotiff.h and geo_kep.h */
typedef void (*GTErrorCallback) (struct gtiff*,
int level,
const char* msg, ...) GTIF_PRINT_FUNC_FORMAT(3,4);
#endif
/**********************************************************************
*
* Public Function Declarations
*
**********************************************************************/
/* TIFF-level interface */
GTIF GTIF_DLL *GTIFNew(void *tif);
GTIF GTIF_DLL *GTIFNewEx(void *tif,
GTErrorCallback error_callback, void* user_data);
GTIF GTIF_DLL *GTIFNewSimpleTags(void *tif);
GTIF GTIF_DLL *GTIFNewWithMethods(void *tif, TIFFMethod*);
GTIF GTIF_DLL *GTIFNewWithMethodsEx(void *tif, TIFFMethod* methods,
GTErrorCallback error_callback,
void* user_data);
void GTIF_DLL GTIFFree(GTIF *gtif);
int GTIF_DLL GTIFWriteKeys(GTIF *gtif);
/* versions must be an array of 3 int */
void GTIF_DLL GTIFDirectoryInfo(GTIF *gtif, int versions[3], int *keycount);
void GTIF_DLL *GTIFGetUserData(GTIF *gtif);
int GTIF_DLL GTIFSetVersionNumbers(GTIF* gtif,
unsigned short version,
unsigned short key_revision,
unsigned short minor_revision);
/* GeoKey Access */
int GTIF_DLL GTIFKeyInfo(GTIF *gtif, geokey_t key, int *size, tagtype_t* type);
int GTIF_DLL GTIFKeyGet(GTIF *gtif, geokey_t key, void *val, int index,
int count);
int GTIF_DLL GTIFKeyGetASCII(GTIF *gtif, geokey_t key, char* szStr,
int szStrMaxLen);
int GTIF_DLL GTIFKeyGetSHORT(GTIF *gtif, geokey_t key, unsigned short *val, int index,
int count);
int GTIF_DLL GTIFKeyGetDOUBLE(GTIF *gtif, geokey_t key, double *val, int index,
int count);
int GTIF_DLL GTIFKeySet(GTIF *gtif, geokey_t keyID, tagtype_t type,
int count,...);
/* Metadata Import-Export utilities */
void GTIF_DLL GTIFPrint(GTIF *gtif, GTIFPrintMethod print, void *aux);
int GTIF_DLL GTIFImport(GTIF *gtif, GTIFReadMethod scan, void *aux);
char GTIF_DLL *GTIFKeyName(geokey_t key);
const char GTIF_DLL *GTIFKeyNameEx(GTIF* gtif, geokey_t key);
char GTIF_DLL *GTIFValueName(geokey_t key,int value);
const char GTIF_DLL *GTIFValueNameEx(GTIF* gtif, geokey_t key,int value);
char GTIF_DLL *GTIFTypeName(tagtype_t type);
char GTIF_DLL *GTIFTagName(int tag);
int GTIF_DLL GTIFKeyCode(const char * key);
int GTIF_DLL GTIFValueCode(geokey_t key,const char *value);
int GTIF_DLL GTIFTypeCode(const char *type);
int GTIF_DLL GTIFTagCode(const char *tag);
/* Translation between image/PCS space */
int GTIF_DLL GTIFImageToPCS( GTIF *gtif, double *x, double *y );
int GTIF_DLL GTIFPCSToImage( GTIF *gtif, double *x, double *y );
#if defined(__cplusplus)
}
#endif
#endif /* LIBGEOTIFF_GEOTIFF_H_ */
|
