GDAL
ogrsf_frmts.h
Go to the documentation of this file.
1/******************************************************************************
2 * $Id: ogrsf_frmts.h d9f7fa611bf09986ea4695f4c5b36be798bf9a17 2019-01-13 13:53:53 +0100 Even Rouault $
3 *
4 * Project: OpenGIS Simple Features Reference Implementation
5 * Purpose: Classes related to format registration, and file opening.
6 * Author: Frank Warmerdam, warmerda@home.com
7 *
8 ******************************************************************************
9 * Copyright (c) 1999, Les Technologies SoftMap Inc.
10 * Copyright (c) 2007-2014, Even Rouault <even dot rouault at mines-paris dot org>
11 *
12 * Permission is hereby granted, free of charge, to any person obtaining a
13 * copy of this software and associated documentation files (the "Software"),
14 * to deal in the Software without restriction, including without limitation
15 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
16 * and/or sell copies of the Software, and to permit persons to whom the
17 * Software is furnished to do so, subject to the following conditions:
18 *
19 * The above copyright notice and this permission notice shall be included
20 * in all copies or substantial portions of the Software.
21 *
22 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
23 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
24 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
25 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
26 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
27 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
28 * DEALINGS IN THE SOFTWARE.
29 ****************************************************************************/
30
31#ifndef OGRSF_FRMTS_H_INCLUDED
32#define OGRSF_FRMTS_H_INCLUDED
33
34#include "cpl_progress.h"
35#include "ogr_feature.h"
36#include "ogr_featurestyle.h"
37#include "gdal_priv.h"
38
39#include <memory>
40
48#if !defined(GDAL_COMPILATION) && !defined(SUPPRESS_DEPRECATION_WARNINGS)
49#define OGR_DEPRECATED(x) CPL_WARN_DEPRECATED(x)
50#else
51#define OGR_DEPRECATED(x)
52#endif
54
55class OGRLayerAttrIndex;
56class OGRSFDriver;
57
58/************************************************************************/
59/* OGRLayer */
60/************************************************************************/
61
67/* Note: any virtual method added to this class must also be added in the */
68/* OGRLayerDecorator and OGRMutexedLayer classes. */
69
70class CPL_DLL OGRLayer : public GDALMajorObject
71{
72 private:
73 struct Private;
74 std::unique_ptr<Private> m_poPrivate;
75
76 void ConvertGeomsIfNecessary( OGRFeature *poFeature );
77
78 class CPL_DLL FeatureIterator
79 {
80 struct Private;
81 std::unique_ptr<Private> m_poPrivate;
82 public:
83 FeatureIterator(OGRLayer* poLayer, bool bStart);
84 FeatureIterator(FeatureIterator&& oOther) noexcept; // declared but not defined. Needed for gcc 5.4 at least
85 ~FeatureIterator();
86 OGRFeatureUniquePtr& operator*();
87 FeatureIterator& operator++();
88 bool operator!=(const FeatureIterator& it) const;
89 };
90
91 friend inline FeatureIterator begin(OGRLayer* poLayer);
92 friend inline FeatureIterator end(OGRLayer* poLayer);
93
95
96 protected:
98 int m_bFilterIsEnvelope;
99 OGRGeometry *m_poFilterGeom;
100 OGRPreparedGeometry *m_pPreparedFilterGeom; /* m_poFilterGeom compiled as a prepared geometry */
101 OGREnvelope m_sFilterEnvelope;
102 int m_iGeomFieldFilter; // specify the index on which the spatial
103 // filter is active.
104
105 int FilterGeometry( OGRGeometry * );
106 //int FilterGeometry( OGRGeometry *, OGREnvelope* psGeometryEnvelope);
107 int InstallFilter( OGRGeometry * );
108
109 OGRErr GetExtentInternal(int iGeomField, OGREnvelope *psExtent, int bForce );
111
112 virtual OGRErr ISetFeature( OGRFeature *poFeature ) CPL_WARN_UNUSED_RESULT;
113 virtual OGRErr ICreateFeature( OGRFeature *poFeature ) CPL_WARN_UNUSED_RESULT;
114
115 public:
116 OGRLayer();
117 virtual ~OGRLayer();
118
129 FeatureIterator begin();
130
132 FeatureIterator end();
133
134 virtual OGRGeometry *GetSpatialFilter();
135 virtual void SetSpatialFilter( OGRGeometry * );
136 virtual void SetSpatialFilterRect( double dfMinX, double dfMinY,
137 double dfMaxX, double dfMaxY );
138
139 virtual void SetSpatialFilter( int iGeomField, OGRGeometry * );
140 virtual void SetSpatialFilterRect( int iGeomField,
141 double dfMinX, double dfMinY,
142 double dfMaxX, double dfMaxY );
143
144 virtual OGRErr SetAttributeFilter( const char * );
145
146 virtual void ResetReading() = 0;
148 virtual OGRErr SetNextByIndex( GIntBig nIndex );
149 virtual OGRFeature *GetFeature( GIntBig nFID ) CPL_WARN_UNUSED_RESULT;
150
151 OGRErr SetFeature( OGRFeature *poFeature ) CPL_WARN_UNUSED_RESULT;
152 OGRErr CreateFeature( OGRFeature *poFeature ) CPL_WARN_UNUSED_RESULT;
153
154 virtual OGRErr DeleteFeature( GIntBig nFID ) CPL_WARN_UNUSED_RESULT;
155
156 virtual const char *GetName();
157 virtual OGRwkbGeometryType GetGeomType();
158 virtual OGRFeatureDefn *GetLayerDefn() = 0;
159 virtual int FindFieldIndex( const char *pszFieldName, int bExactMatch );
160
161 virtual OGRSpatialReference *GetSpatialRef();
162
163 virtual GIntBig GetFeatureCount( int bForce = TRUE );
164 virtual OGRErr GetExtent(OGREnvelope *psExtent, int bForce = TRUE) CPL_WARN_UNUSED_RESULT;
165 virtual OGRErr GetExtent(int iGeomField, OGREnvelope *psExtent,
166 int bForce = TRUE) CPL_WARN_UNUSED_RESULT;
167
168 virtual int TestCapability( const char * ) = 0;
169
170 virtual OGRErr CreateField( OGRFieldDefn *poField,
171 int bApproxOK = TRUE );
172 virtual OGRErr DeleteField( int iField );
173 virtual OGRErr ReorderFields( int* panMap );
174 virtual OGRErr AlterFieldDefn( int iField, OGRFieldDefn* poNewFieldDefn, int nFlagsIn );
175
176 virtual OGRErr CreateGeomField( OGRGeomFieldDefn *poField,
177 int bApproxOK = TRUE );
178
179 virtual OGRErr SyncToDisk();
180
181 virtual OGRStyleTable *GetStyleTable();
182 virtual void SetStyleTableDirectly( OGRStyleTable *poStyleTable );
183
184 virtual void SetStyleTable(OGRStyleTable *poStyleTable);
185
186 virtual OGRErr StartTransaction() CPL_WARN_UNUSED_RESULT;
187 virtual OGRErr CommitTransaction() CPL_WARN_UNUSED_RESULT;
188 virtual OGRErr RollbackTransaction();
189
190 virtual const char *GetFIDColumn();
191 virtual const char *GetGeometryColumn();
192
193 virtual OGRErr SetIgnoredFields( const char **papszFields );
194
195 OGRErr Intersection( OGRLayer *pLayerMethod,
196 OGRLayer *pLayerResult,
197 char** papszOptions = nullptr,
198 GDALProgressFunc pfnProgress = nullptr,
199 void * pProgressArg = nullptr );
200 OGRErr Union( OGRLayer *pLayerMethod,
201 OGRLayer *pLayerResult,
202 char** papszOptions = nullptr,
203 GDALProgressFunc pfnProgress = nullptr,
204 void * pProgressArg = nullptr );
205 OGRErr SymDifference( OGRLayer *pLayerMethod,
206 OGRLayer *pLayerResult,
207 char** papszOptions,
208 GDALProgressFunc pfnProgress,
209 void * pProgressArg );
210 OGRErr Identity( OGRLayer *pLayerMethod,
211 OGRLayer *pLayerResult,
212 char** papszOptions = nullptr,
213 GDALProgressFunc pfnProgress = nullptr,
214 void * pProgressArg = nullptr );
215 OGRErr Update( OGRLayer *pLayerMethod,
216 OGRLayer *pLayerResult,
217 char** papszOptions = nullptr,
218 GDALProgressFunc pfnProgress = nullptr,
219 void * pProgressArg = nullptr );
220 OGRErr Clip( OGRLayer *pLayerMethod,
221 OGRLayer *pLayerResult,
222 char** papszOptions = nullptr,
223 GDALProgressFunc pfnProgress = nullptr,
224 void * pProgressArg = nullptr );
225 OGRErr Erase( OGRLayer *pLayerMethod,
226 OGRLayer *pLayerResult,
227 char** papszOptions = nullptr,
228 GDALProgressFunc pfnProgress = nullptr,
229 void * pProgressArg = nullptr );
230
231 int Reference();
232 int Dereference();
233 int GetRefCount() const;
235 GIntBig GetFeaturesRead();
237
238 /* non virtual : convenience wrapper for ReorderFields() */
239 OGRErr ReorderField( int iOldFieldPos, int iNewFieldPos );
240
242 int AttributeFilterEvaluationNeedsGeometry();
243
244 /* consider these private */
245 OGRErr InitializeIndexSupport( const char * );
246 OGRLayerAttrIndex *GetIndex() { return m_poAttrIndex; }
247 int GetGeomFieldFilter() const { return m_iGeomFieldFilter; }
248 const char *GetAttrQueryString() const { return m_pszAttrQueryString; }
250
254 static inline OGRLayerH ToHandle(OGRLayer* poLayer)
255 { return reinterpret_cast<OGRLayerH>(poLayer); }
256
260 static inline OGRLayer* FromHandle(OGRLayerH hLayer)
261 { return reinterpret_cast<OGRLayer*>(hLayer); }
262
263 protected:
265 OGRStyleTable *m_poStyleTable;
266 OGRFeatureQuery *m_poAttrQuery;
267 char *m_pszAttrQueryString;
268 OGRLayerAttrIndex *m_poAttrIndex;
269
270 int m_nRefCount;
271
272 GIntBig m_nFeaturesRead;
274};
275
287inline OGRLayer::FeatureIterator begin(OGRLayer* poLayer) { return poLayer->begin(); }
288
292inline OGRLayer::FeatureIterator end(OGRLayer* poLayer) { return poLayer->end(); }
293
294/************************************************************************/
295/* OGRDataSource */
296/************************************************************************/
297
317class CPL_DLL OGRDataSource : public GDALDataset
318{
319public:
322 virtual const char *GetName() OGR_DEPRECATED("Use GDALDataset class instead") = 0;
323
324 static void DestroyDataSource( OGRDataSource * ) OGR_DEPRECATED("Use GDALDataset class instead");
326};
327
328/************************************************************************/
329/* OGRSFDriver */
330/************************************************************************/
331
350class CPL_DLL OGRSFDriver : public GDALDriver
351{
352 public:
354 virtual ~OGRSFDriver();
355
356 virtual const char *GetName() OGR_DEPRECATED("Use GDALDriver class instead") = 0;
357
358 virtual OGRDataSource *Open( const char *pszName, int bUpdate=FALSE ) OGR_DEPRECATED("Use GDALDriver class instead") = 0;
359
360 virtual int TestCapability( const char *pszCap ) OGR_DEPRECATED("Use GDALDriver class instead") = 0;
361
362 virtual OGRDataSource *CreateDataSource( const char *pszName,
363 char ** = nullptr ) OGR_DEPRECATED("Use GDALDriver class instead");
364 virtual OGRErr DeleteDataSource( const char *pszName ) OGR_DEPRECATED("Use GDALDriver class instead");
366};
367
368/************************************************************************/
369/* OGRSFDriverRegistrar */
370/************************************************************************/
371
386{
387
390
391 static GDALDataset* OpenWithDriverArg(GDALDriver* poDriver,
392 GDALOpenInfo* poOpenInfo);
393 static GDALDataset* CreateVectorOnly( GDALDriver* poDriver,
394 const char * pszName,
395 char ** papszOptions );
396 static CPLErr DeleteDataSource( GDALDriver* poDriver,
397 const char * pszName );
398
399 public:
401 static OGRSFDriverRegistrar *GetRegistrar() OGR_DEPRECATED("Use GDALDriverManager class instead");
402
403 // cppcheck-suppress functionStatic
404 void RegisterDriver( OGRSFDriver * poDriver ) OGR_DEPRECATED("Use GDALDriverManager class instead");
405
406 // cppcheck-suppress functionStatic
407 int GetDriverCount( void ) OGR_DEPRECATED("Use GDALDriverManager class instead");
408 // cppcheck-suppress functionStatic
409 GDALDriver *GetDriver( int iDriver ) OGR_DEPRECATED("Use GDALDriverManager class instead");
410 // cppcheck-suppress functionStatic
411 GDALDriver *GetDriverByName( const char * ) OGR_DEPRECATED("Use GDALDriverManager class instead");
412
413 // cppcheck-suppress functionStatic
414 int GetOpenDSCount() OGR_DEPRECATED("Use GDALDriverManager class instead");
415 // cppcheck-suppress functionStatic
416 OGRDataSource *GetOpenDS( int ) OGR_DEPRECATED("Use GDALDriverManager class instead");
418};
419
420/* -------------------------------------------------------------------- */
421/* Various available registration methods. */
422/* -------------------------------------------------------------------- */
424
426void OGRRegisterAllInternal();
427
428void CPL_DLL RegisterOGRFileGDB();
429void CPL_DLL RegisterOGRShape();
430void CPL_DLL RegisterOGRDB2();
431void CPL_DLL RegisterOGRNTF();
432void CPL_DLL RegisterOGRFME();
433void CPL_DLL RegisterOGRSDTS();
434void CPL_DLL RegisterOGRTiger();
435void CPL_DLL RegisterOGRS57();
436void CPL_DLL RegisterOGRTAB();
437void CPL_DLL RegisterOGRMIF();
438void CPL_DLL RegisterOGROGDI();
439void CPL_DLL RegisterOGRODBC();
440void CPL_DLL RegisterOGRWAsP();
441void CPL_DLL RegisterOGRPG();
442void CPL_DLL RegisterOGRMSSQLSpatial();
443void CPL_DLL RegisterOGRMySQL();
444void CPL_DLL RegisterOGROCI();
445void CPL_DLL RegisterOGRDGN();
446void CPL_DLL RegisterOGRGML();
447void CPL_DLL RegisterOGRLIBKML();
448void CPL_DLL RegisterOGRKML();
449void CPL_DLL RegisterOGRGeoJSON();
450void CPL_DLL RegisterOGRGeoJSONSeq();
451void CPL_DLL RegisterOGRESRIJSON();
452void CPL_DLL RegisterOGRTopoJSON();
453void CPL_DLL RegisterOGRAVCBin();
454void CPL_DLL RegisterOGRAVCE00();
455void CPL_DLL RegisterOGRREC();
456void CPL_DLL RegisterOGRMEM();
457void CPL_DLL RegisterOGRVRT();
458void CPL_DLL RegisterOGRDODS();
459void CPL_DLL RegisterOGRSQLite();
460void CPL_DLL RegisterOGRCSV();
461void CPL_DLL RegisterOGRILI1();
462void CPL_DLL RegisterOGRILI2();
463void CPL_DLL RegisterOGRGRASS();
464void CPL_DLL RegisterOGRPGeo();
465void CPL_DLL RegisterOGRDXF();
466void CPL_DLL RegisterOGRCAD();
467void CPL_DLL RegisterOGRDWG();
468void CPL_DLL RegisterOGRDGNV8();
469void CPL_DLL RegisterOGRSDE();
470void CPL_DLL RegisterOGRIDB();
471void CPL_DLL RegisterOGRGMT();
472void CPL_DLL RegisterOGRBNA();
473void CPL_DLL RegisterOGRGPX();
474void CPL_DLL RegisterOGRGeoconcept();
475void CPL_DLL RegisterOGRIngres();
476void CPL_DLL RegisterOGRXPlane();
477void CPL_DLL RegisterOGRNAS();
478void CPL_DLL RegisterOGRGeoRSS();
479void CPL_DLL RegisterOGRGTM();
480void CPL_DLL RegisterOGRVFK();
481void CPL_DLL RegisterOGRPGDump();
482void CPL_DLL RegisterOGROSM();
483void CPL_DLL RegisterOGRGPSBabel();
484void CPL_DLL RegisterOGRSUA();
485void CPL_DLL RegisterOGROpenAir();
486void CPL_DLL RegisterOGRPDS();
487void CPL_DLL RegisterOGRWFS();
488void CPL_DLL RegisterOGRWFS3();
489void CPL_DLL RegisterOGRSOSI();
490void CPL_DLL RegisterOGRHTF();
491void CPL_DLL RegisterOGRAeronavFAA();
492void CPL_DLL RegisterOGRGeomedia();
493void CPL_DLL RegisterOGRMDB();
494void CPL_DLL RegisterOGREDIGEO();
495void CPL_DLL RegisterOGRGFT();
496void CPL_DLL RegisterOGRSVG();
497void CPL_DLL RegisterOGRCouchDB();
498void CPL_DLL RegisterOGRCloudant();
499void CPL_DLL RegisterOGRIdrisi();
500void CPL_DLL RegisterOGRARCGEN();
501void CPL_DLL RegisterOGRSEGUKOOA();
502void CPL_DLL RegisterOGRSEGY();
503void CPL_DLL RegisterOGRXLS();
504void CPL_DLL RegisterOGRODS();
505void CPL_DLL RegisterOGRXLSX();
506void CPL_DLL RegisterOGRElastic();
507void CPL_DLL RegisterOGRGeoPackage();
508void CPL_DLL RegisterOGRWalk();
509void CPL_DLL RegisterOGRCarto();
510void CPL_DLL RegisterOGRAmigoCloud();
511void CPL_DLL RegisterOGRSXF();
512void CPL_DLL RegisterOGROpenFileGDB();
513void CPL_DLL RegisterOGRSelafin();
514void CPL_DLL RegisterOGRJML();
515void CPL_DLL RegisterOGRPLSCENES();
516void CPL_DLL RegisterOGRCSW();
517void CPL_DLL RegisterOGRMongoDBv3();
518void CPL_DLL RegisterOGRMongoDB();
519void CPL_DLL RegisterOGRVDV();
520void CPL_DLL RegisterOGRGMLAS();
521void CPL_DLL RegisterOGRMVT();
522void CPL_DLL RegisterOGRNGW();
523// @endcond
524
526
527#endif /* ndef OGRSF_FRMTS_H_INCLUDED */
A set of associated raster bands, usually from one file.
Definition: gdal_priv.h:336
Format specific driver.
Definition: gdal_priv.h:1424
Object with metadata.
Definition: gdal_priv.h:133
Class for dataset open functions.
Definition: gdal_priv.h:266
LEGACY class.
Definition: ogrsf_frmts.h:318
Definition of a feature class or feature layer.
Definition: ogr_feature.h:260
A simple feature, including geometry and attributes.
Definition: ogr_feature.h:355
Definition of an attribute of an OGRFeatureDefn.
Definition: ogr_feature.h:93
Definition of a geometry field of an OGRFeatureDefn.
Definition: ogr_feature.h:183
Abstract base class for all geometry classes.
Definition: ogr_geometry.h:287
This class represents a layer of simple features, with access methods.
Definition: ogrsf_frmts.h:71
friend FeatureIterator begin(OGRLayer *poLayer)
Return begin of feature iterator.
Definition: ogrsf_frmts.h:287
virtual OGRFeature * GetNextFeature() CPL_WARN_UNUSED_RESULT=0
Fetch the next available feature from this layer.
static OGRLayerH ToHandle(OGRLayer *poLayer)
Convert a OGRLayer* to a OGRLayerH.
Definition: ogrsf_frmts.h:254
friend FeatureIterator end(OGRLayer *poLayer)
Return end of feature iterator.
Definition: ogrsf_frmts.h:292
virtual void ResetReading()=0
Reset feature reading to start on the first feature.
static OGRLayer * FromHandle(OGRLayerH hLayer)
Convert a OGRLayerH to a OGRLayer*.
Definition: ogrsf_frmts.h:260
LEGACY class.
Definition: ogrsf_frmts.h:386
LEGACY class.
Definition: ogrsf_frmts.h:351
This class represents an OpenGIS Spatial Reference System, and contains methods for converting betwee...
Definition: ogr_spatialref.h:157
This class represents a style table.
Definition: ogr_featurestyle.h:85
CPLErr
Error category.
Definition: cpl_error.h:53
#define CPL_C_END
Macro to end a block of C symbols.
Definition: cpl_port.h:339
#define CPL_C_START
Macro to start a block of C symbols.
Definition: cpl_port.h:337
#define CPL_DISALLOW_COPY_ASSIGN(ClassName)
Helper to remove the copy and assignment constructors so that the compiler will not generate the defa...
Definition: cpl_port.h:997
#define CPL_WARN_UNUSED_RESULT
Qualifier to warn when the return value of a function is not used.
Definition: cpl_port.h:939
long long GIntBig
Large signed integer type (generally 64-bit integer type).
Definition: cpl_port.h:248
C++ GDAL entry points.
void * OGRLayerH
Opaque type for a layer (OGRLayer)
Definition: ogr_api.h:509
OGRwkbGeometryType
List of well known binary geometry types.
Definition: ogr_core.h:318
int OGRErr
Simple container for a bounding region.
Definition: ogr_core.h:290
Simple feature classes.
std::unique_ptr< OGRFeature, OGRFeatureUniquePtrDeleter > OGRFeatureUniquePtr
Unique pointer type for OGRFeature.
Definition: ogr_feature.h:780
Simple feature style classes.
struct _OGRPreparedGeometry OGRPreparedGeometry
Prepared geometry API (needs GEOS >= 3.1.0)
Definition: ogr_geometry.h:2924
OGRLayer::FeatureIterator begin(OGRLayer *poLayer)
Return begin of feature iterator.
Definition: ogrsf_frmts.h:287
OGRLayer::FeatureIterator end(OGRLayer *poLayer)
Return end of feature iterator.
Definition: ogrsf_frmts.h:292

Generated for GDAL by doxygen 1.9.4.