GDAL
ograpispy.h
Go to the documentation of this file.
1/******************************************************************************
2 * $Id$
3 *
4 * Project: OpenGIS Simple Features Reference Implementation
5 * Purpose: OGR C API "Spy"
6 * Author: Even Rouault, even.rouault at spatialys.com
7 *
8 ******************************************************************************
9 * Copyright (c) 2014, Even Rouault <even.rouault at spatialys.com>
10 *
11 * Permission is hereby granted, free of charge, to any person obtaining a
12 * copy of this software and associated documentation files (the "Software"),
13 * to deal in the Software without restriction, including without limitation
14 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
15 * and/or sell copies of the Software, and to permit persons to whom the
16 * Software is furnished to do so, subject to the following conditions:
17 *
18 * The above copyright notice and this permission notice shall be included
19 * in all copies or substantial portions of the Software.
20 *
21 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
22 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
24 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
26 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
27 * DEALINGS IN THE SOFTWARE.
28 ****************************************************************************/
29
30#ifndef OGRAPISPY_H_INCLUDED
31#define OGRAPISPY_H_INCLUDED
32
33#include "gdal.h"
34
64#ifdef DEBUG
65#define OGRAPISPY_ENABLED
66#endif
67
68#ifdef OGRAPISPY_ENABLED
69
71
72extern int bOGRAPISpyEnabled;
73
74void OGRAPISpyDestroyMutex();
75
76int OGRAPISpyOpenTakeSnapshot(const char *pszName, int bUpdate);
77void OGRAPISpyOpen(const char *pszName, int bUpdate, int iSnapshot,
78 GDALDatasetH *phDS);
79void OGRAPISpyPreClose(GDALDatasetH hDS);
80void OGRAPISpyPostClose();
81void OGRAPISpyCreateDataSource(GDALDriverH hDriver, const char *pszName,
82 char **papszOptions, GDALDatasetH hDS);
83void OGRAPISpyDeleteDataSource(GDALDriverH hDriver, const char *pszName);
84
85void OGRAPISpy_DS_GetLayerCount(GDALDatasetH hDS);
86void OGRAPISpy_DS_GetLayer(GDALDatasetH hDS, int iLayer, OGRLayerH hLayer);
87void OGRAPISpy_DS_GetLayerByName(GDALDatasetH hDS, const char *pszLayerName,
88 OGRLayerH hLayer);
89void OGRAPISpy_DS_ExecuteSQL(GDALDatasetH hDS, const char *pszStatement,
90 OGRGeometryH hSpatialFilter,
91 const char *pszDialect, OGRLayerH hLayer);
92void OGRAPISpy_DS_ReleaseResultSet(GDALDatasetH hDS, OGRLayerH hLayer);
93
94void OGRAPISpy_DS_CreateLayer(GDALDatasetH hDS, const char *pszName,
95 OGRSpatialReferenceH hSpatialRef,
96 OGRwkbGeometryType eType, char **papszOptions,
97 OGRLayerH hLayer);
98void OGRAPISpy_DS_DeleteLayer(GDALDatasetH hDS, int iLayer);
99
100void OGRAPISpy_Dataset_StartTransaction(GDALDatasetH hDS, int bForce);
101void OGRAPISpy_Dataset_CommitTransaction(GDALDatasetH hDS);
102void OGRAPISpy_Dataset_RollbackTransaction(GDALDatasetH hDS);
103
104void OGRAPISpy_L_GetFeatureCount(OGRLayerH hLayer, int bForce);
105void OGRAPISpy_L_GetExtent(OGRLayerH hLayer, int bForce);
106void OGRAPISpy_L_GetExtentEx(OGRLayerH hLayer, int iGeomField, int bForce);
107void OGRAPISpy_L_GetExtent3D(OGRLayerH hLayer, int iGeomField, int bForce);
108void OGRAPISpy_L_SetAttributeFilter(OGRLayerH hLayer, const char *pszFilter);
109void OGRAPISpy_L_GetFeature(OGRLayerH hLayer, GIntBig nFeatureId);
110void OGRAPISpy_L_SetNextByIndex(OGRLayerH hLayer, GIntBig nIndex);
111void OGRAPISpy_L_GetNextFeature(OGRLayerH hLayer);
112void OGRAPISpy_L_SetFeature(OGRLayerH hLayer, OGRFeatureH hFeat);
113void OGRAPISpy_L_CreateFeature(OGRLayerH hLayer, OGRFeatureH hFeat);
114void OGRAPISpy_L_UpsertFeature(OGRLayerH hLayer, OGRFeatureH hFeat);
115void OGRAPISpy_L_CreateField(OGRLayerH hLayer, OGRFieldDefnH hField,
116 int bApproxOK);
117void OGRAPISpy_L_DeleteField(OGRLayerH hLayer, int iField);
118void OGRAPISpy_L_ReorderFields(OGRLayerH hLayer, int *panMap);
119void OGRAPISpy_L_ReorderField(OGRLayerH hLayer, int iOldFieldPos,
120 int iNewFieldPos);
121void OGRAPISpy_L_AlterFieldDefn(OGRLayerH hLayer, int iField,
122 OGRFieldDefnH hNewFieldDefn, int nFlags);
123void OGRAPISpy_L_CreateGeomField(OGRLayerH hLayer, OGRGeomFieldDefnH hField,
124 int bApproxOK);
125void OGRAPISpy_L_StartTransaction(OGRLayerH hLayer);
126void OGRAPISpy_L_CommitTransaction(OGRLayerH hLayer);
127void OGRAPISpy_L_RollbackTransaction(OGRLayerH hLayer);
128void OGRAPISpy_L_GetLayerDefn(OGRLayerH hLayer);
129void OGRAPISpy_L_FindFieldIndex(OGRLayerH hLayer, const char *pszFieldName,
130 int bExactMatch);
131void OGRAPISpy_L_GetSpatialRef(OGRLayerH hLayer);
132void OGRAPISpy_L_TestCapability(OGRLayerH hLayer, const char *pszCap);
133void OGRAPISpy_L_GetSpatialFilter(OGRLayerH hLayer);
134void OGRAPISpy_L_SetSpatialFilter(OGRLayerH hLayer, OGRGeometryH hGeom);
135void OGRAPISpy_L_SetSpatialFilterEx(OGRLayerH hLayer, int iGeomField,
136 OGRGeometryH hGeom);
137void OGRAPISpy_L_SetSpatialFilterRect(OGRLayerH hLayer, double dfMinX,
138 double dfMinY, double dfMaxX,
139 double dfMaxY);
140void OGRAPISpy_L_SetSpatialFilterRectEx(OGRLayerH hLayer, int iGeomField,
141 double dfMinX, double dfMinY,
142 double dfMaxX, double dfMaxY);
143void OGRAPISpy_L_ResetReading(OGRLayerH hLayer);
144void OGRAPISpy_L_SyncToDisk(OGRLayerH hLayer);
145void OGRAPISpy_L_DeleteFeature(OGRLayerH hLayer, GIntBig nFID);
146void OGRAPISpy_L_GetFIDColumn(OGRLayerH hLayer);
147void OGRAPISpy_L_GetGeometryColumn(OGRLayerH hLayer);
148void OGRAPISpy_L_GetName(OGRLayerH hLayer);
149void OGRAPISpy_L_GetGeomType(OGRLayerH hLayer);
150void OGRAPISpy_L_SetIgnoredFields(OGRLayerH hLayer,
151 const char **papszIgnoredFields);
152
153void OGRAPISpy_FD_GetGeomType(OGRFeatureDefnH hDefn);
154void OGRAPISpy_FD_GetFieldCount(OGRFeatureDefnH hDefn);
155void OGRAPISpy_FD_GetFieldDefn(OGRFeatureDefnH hDefn, int iField,
156 OGRFieldDefnH hGeomField);
157void OGRAPISpy_FD_GetFieldIndex(OGRFeatureDefnH hDefn,
158 const char *pszFieldName);
159
160void OGRAPISpy_Fld_GetXXXX(OGRFieldDefnH hField, const char *pszOp);
161
162void OGRAPISpy_FD_GetGeomFieldCount(OGRFeatureDefnH hDefn);
163void OGRAPISpy_FD_GetGeomFieldDefn(OGRFeatureDefnH hDefn, int iGeomField,
164 OGRGeomFieldDefnH hGeomField);
165void OGRAPISpy_FD_GetGeomFieldIndex(OGRFeatureDefnH hDefn,
166 const char *pszFieldName);
167void OGRAPISpy_GFld_GetXXXX(OGRGeomFieldDefnH hGeomField, const char *pszOp);
168
170
171#endif /* OGRAPISPY_ENABLED */
172
173#endif /* OGRAPISPY_H_INCLUDED */
#define CPL_C_END
Macro to end a block of C symbols.
Definition cpl_port.h:299
#define CPL_C_START
Macro to start a block of C symbols.
Definition cpl_port.h:295
long long GIntBig
Large signed integer type (generally 64-bit integer type).
Definition cpl_port.h:215
Public (C callable) GDAL entry points.
void * GDALDatasetH
Opaque type used for the C bindings of the C++ GDALDataset class.
Definition gdal.h:291
void * GDALDriverH
Opaque type used for the C bindings of the C++ GDALDriver class.
Definition gdal.h:297
void * OGRGeometryH
Opaque type for a geometry.
Definition ogr_api.h:66
void * OGRSpatialReferenceH
Opaque type for a spatial reference system.
Definition ogr_api.h:81
void * OGRFieldDefnH
Opaque type for a field definition (OGRFieldDefn)
Definition ogr_api.h:421
void * OGRLayerH
Opaque type for a layer (OGRLayer)
Definition ogr_api.h:691
void * OGRFeatureDefnH
Opaque type for a feature definition (OGRFeatureDefn)
Definition ogr_api.h:423
void * OGRFeatureH
Opaque type for a feature (OGRFeature)
Definition ogr_api.h:425
struct OGRGeomFieldDefnHS * OGRGeomFieldDefnH
Opaque type for a geometry field definition (OGRGeomFieldDefn)
Definition ogr_api.h:430
OGRwkbGeometryType
List of well known binary geometry types.
Definition ogr_core.h:416