GDAL

ogrunionlayer.h
1/******************************************************************************
2 * $Id$
3 *
4 * Project: OpenGIS Simple Features Reference Implementation
5 * Purpose: Defines OGRUnionLayer class
6 * Author: Even Rouault, even dot rouault at spatialys.com
7 *
8 ******************************************************************************
9 * Copyright (c) 2012-2014, Even Rouault <even dot 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 OGRUNIONLAYER_H_INCLUDED
31#define OGRUNIONLAYER_H_INCLUDED
32
33#ifndef DOXYGEN_SKIP
34
35#include "ogrsf_frmts.h"
36
37/************************************************************************/
38/* OGRUnionLayerGeomFieldDefn */
39/************************************************************************/
40
41class CPL_DLL OGRUnionLayerGeomFieldDefn final : public OGRGeomFieldDefn
42{
43 public:
44 int bGeomTypeSet = false;
45 int bSRSSet = false;
46 OGREnvelope sStaticEnvelope{};
47
48 OGRUnionLayerGeomFieldDefn(const char *pszName, OGRwkbGeometryType eType);
49 explicit OGRUnionLayerGeomFieldDefn(const OGRGeomFieldDefn *poSrc);
50 explicit OGRUnionLayerGeomFieldDefn(
51 const OGRUnionLayerGeomFieldDefn *poSrc);
52 ~OGRUnionLayerGeomFieldDefn();
53};
54
55/************************************************************************/
56/* OGRUnionLayer */
57/************************************************************************/
58
59typedef enum
60{
61 FIELD_FROM_FIRST_LAYER,
62 FIELD_UNION_ALL_LAYERS,
63 FIELD_INTERSECTION_ALL_LAYERS,
64 FIELD_SPECIFIED,
65} FieldUnionStrategy;
66
67class CPL_DLL OGRUnionLayer final : public OGRLayer
68{
69 CPL_DISALLOW_COPY_ASSIGN(OGRUnionLayer)
70
71 protected:
72 CPLString osName;
73 int nSrcLayers;
74 OGRLayer **papoSrcLayers;
75 int bHasLayerOwnership;
76
77 OGRFeatureDefn *poFeatureDefn;
78 int nFields;
79 OGRFieldDefn **papoFields;
80 int nGeomFields;
81 OGRUnionLayerGeomFieldDefn **papoGeomFields;
82 FieldUnionStrategy eFieldStrategy;
83 CPLString osSourceLayerFieldName{};
84
85 int bPreserveSrcFID;
86
87 GIntBig nFeatureCount;
88
89 int iCurLayer;
90 char *pszAttributeFilter;
91 int nNextFID;
92 int *panMap;
93 CPLStringList m_aosIgnoredFields{};
94 int bAttrFilterPassThroughValue;
95 int *pabModifiedLayers;
96 int *pabCheckIfAutoWrap;
97 const OGRSpatialReference *poGlobalSRS;
98
99 void AutoWarpLayerIfNecessary(int iSubLayer);
100 OGRFeature *TranslateFromSrcLayer(OGRFeature *poSrcFeature);
101 void ApplyAttributeFilterToSrcLayer(int iSubLayer);
102 int GetAttrFilterPassThroughValue();
103 void ConfigureActiveLayer();
104 void SetSpatialFilterToSourceLayer(OGRLayer *poSrcLayer);
105
106 public:
107 OGRUnionLayer(
108 const char *pszName, int nSrcLayers, /* must be >= 1 */
109 OGRLayer *
110 *papoSrcLayers, /* array itself ownership always transferred, layer
111 ownership depending on bTakeLayerOwnership */
112 int bTakeLayerOwnership);
113
114 virtual ~OGRUnionLayer();
115
116 /* All the following non virtual methods must be called just after the
117 * constructor */
118 /* and before any virtual method */
119 void SetFields(
120 FieldUnionStrategy eFieldStrategy, int nFields,
121 OGRFieldDefn **papoFields, /* duplicated by the method */
122 int nGeomFields, /* maybe -1 to explicitly disable geometry fields */
123 OGRUnionLayerGeomFieldDefn *
124 *papoGeomFields /* duplicated by the method */);
125 void SetSourceLayerFieldName(const char *pszSourceLayerFieldName);
126 void SetPreserveSrcFID(int bPreserveSrcFID);
127 void SetFeatureCount(int nFeatureCount);
128
129 virtual const char *GetName() override
130 {
131 return osName.c_str();
132 }
133
134 virtual OGRwkbGeometryType GetGeomType() override;
135
136 virtual void ResetReading() override;
137 virtual OGRFeature *GetNextFeature() override;
138
139 virtual OGRFeature *GetFeature(GIntBig nFeatureId) override;
140
141 virtual OGRErr ICreateFeature(OGRFeature *poFeature) override;
142
143 virtual OGRErr ISetFeature(OGRFeature *poFeature) override;
144
145 virtual OGRErr IUpsertFeature(OGRFeature *poFeature) override;
146
147 OGRErr IUpdateFeature(OGRFeature *poFeature, int nUpdatedFieldsCount,
148 const int *panUpdatedFieldsIdx,
149 int nUpdatedGeomFieldsCount,
150 const int *panUpdatedGeomFieldsIdx,
151 bool bUpdateStyleString) override;
152
153 virtual OGRFeatureDefn *GetLayerDefn() override;
154
155 virtual OGRSpatialReference *GetSpatialRef() override;
156
157 virtual GIntBig GetFeatureCount(int) override;
158
159 virtual OGRErr SetAttributeFilter(const char *) override;
160
161 virtual int TestCapability(const char *) override;
162
163 virtual OGRErr GetExtent(int iGeomField, OGREnvelope *psExtent,
164 int bForce = TRUE) override;
165 virtual OGRErr GetExtent(OGREnvelope *psExtent, int bForce) override;
166
167 virtual void SetSpatialFilter(OGRGeometry *poGeomIn) override;
168 virtual void SetSpatialFilter(int iGeomField, OGRGeometry *) override;
169
170 virtual OGRErr SetIgnoredFields(CSLConstList papszFields) override;
171
172 virtual OGRErr SyncToDisk() override;
173};
174
175#endif /* #ifndef DOXYGEN_SKIP */
176
177#endif // OGRUNIONLAYER_H_INCLUDED
CPLStringList
String list class designed around our use of C "char**" string lists.
Definition: cpl_string.h:449
CPLString
Convenient string class based on std::string.
Definition: cpl_string.h:320
OGREnvelope
Simple container for a bounding region (rectangle)
Definition: ogr_core.h:61
OGRFeatureDefn
Definition of a feature class or feature layer.
Definition: ogr_feature.h:517
OGRFeature
A simple feature, including geometry and attributes.
Definition: ogr_feature.h:893
OGRFieldDefn
Definition of an attribute of an OGRFeatureDefn.
Definition: ogr_feature.h:111
OGRGeomFieldDefn
Definition of a geometry field of an OGRFeatureDefn.
Definition: ogr_feature.h:346
OGRGeomFieldDefn::GetSpatialRef
virtual const OGRSpatialReference * GetSpatialRef() const
Fetch spatial reference system of this field.
Definition: ogrgeomfielddefn.cpp:479
OGRGeometry
Abstract base class for all geometry classes.
Definition: ogr_geometry.h:377
OGRLayer
This class represents a layer of simple features, with access methods.
Definition: ogrsf_frmts.h:74
OGRSpatialReference
This class represents an OpenGIS Spatial Reference System, and contains methods for converting betwee...
Definition: ogr_spatialref.h:169
CPL_DISALLOW_COPY_ASSIGN
#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:1042
CSLConstList
char ** CSLConstList
Type of a constant null-terminated list of nul terminated strings.
Definition: cpl_port.h:1183
GIntBig
long long GIntBig
Large signed integer type (generally 64-bit integer type).
Definition: cpl_port.h:215
OGRwkbGeometryType
OGRwkbGeometryType
List of well known binary geometry types.
Definition: ogr_core.h:416
OGRErr
int OGRErr
Type for a OGR error.
Definition: ogr_core.h:387
ogrsf_frmts.h
Classes related to registration of format support, and opening datasets.