QGIS API Documentation  2.3.0-Master
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
qgsfeatureiterator.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgsfeatureiterator.cpp
3  ---------------------
4  begin : Juli 2012
5  copyright : (C) 2012 by Martin Dobias
6  email : wonder dot sk at gmail dot com
7  ***************************************************************************
8  * *
9  * This program is free software; you can redistribute it and/or modify *
10  * it under the terms of the GNU General Public License as published by *
11  * the Free Software Foundation; either version 2 of the License, or *
12  * (at your option) any later version. *
13  * *
14  ***************************************************************************/
15 #include "qgsfeatureiterator.h"
16 #include "qgslogger.h"
17 
18 #include "qgsgeometrysimplifier.h"
19 #include "qgssimplifymethod.h"
20 
22  : mRequest( request )
23  , mClosed( false )
24  , refs( 0 )
25  , mGeometrySimplifier( NULL )
26  , mLocalSimplification( false )
27 {
28 }
29 
31 {
32  delete mGeometrySimplifier;
33  mGeometrySimplifier = NULL;
34 }
35 
37 {
38  bool dataOk = false;
39 
40  switch ( mRequest.filterType() )
41  {
43  dataOk = nextFeatureFilterExpression( f );
44  break;
45 
47  dataOk = nextFeatureFilterFids( f );
48  break;
49 
50  default:
51  dataOk = fetchFeature( f );
52  break;
53  }
54 
55  // simplify the geometry using the simplifier configured
56  if ( dataOk && mLocalSimplification )
57  {
58  QgsGeometry* geometry = f.geometry();
59  if ( geometry ) simplify( f );
60  }
61  return dataOk;
62 }
63 
65 {
66  while ( fetchFeature( f ) )
67  {
68  if ( mRequest.filterExpression()->evaluate( f ).toBool() )
69  return true;
70  }
71  return false;
72 }
73 
75 {
76  while ( fetchFeature( f ) )
77  {
78  if ( mRequest.filterFids().contains( f.id() ) )
79  return true;
80  }
81  return false;
82 }
83 
85 {
86  // Prepare if required the simplification of geometries to fetch:
87  // This code runs here because of 'prepareSimplification()' is virtual and it can be overrided
88  // in inherited iterators who change the default behavior.
89  // It would be better to call this method in the constructor enabling virtual-calls as it is described by example at:
90  // http://www.parashift.com/c%2B%2B-faq-lite/calling-virtuals-from-ctor-idiom.html
91  if ( refs == 0 )
92  {
94  }
95  refs++;
96 }
97 
99 {
100  refs--;
101  if ( !refs )
102  delete this;
103 }
104 
106 {
107  mLocalSimplification = false;
108 
109  delete mGeometrySimplifier;
110  mGeometrySimplifier = NULL;
111 
112  // setup the simplification of geometries to fetch
113  if ( !( mRequest.flags() & QgsFeatureRequest::NoGeometry ) && simplifyMethod.methodType() != QgsSimplifyMethod::NoSimplification && ( simplifyMethod.forceLocalOptimization() || !providerCanSimplify( simplifyMethod.methodType() ) ) )
114  {
117  return mLocalSimplification;
118  }
119  return false;
120 }
121 
123 {
124  Q_UNUSED( methodType )
125  return false;
126 }
127 
129 {
130  // simplify locally the geometry using the configured simplifier
131  if ( mGeometrySimplifier )
132  {
133  QgsGeometry* geometry = feature.geometry();
134 
135  QGis::GeometryType geometryType = geometry->type();
136  if ( geometryType == QGis::Line || geometryType == QGis::Polygon ) return mGeometrySimplifier->simplifyGeometry( geometry );
137  }
138  return false;
139 }
140 
142 
144 {
145  if ( this != &other )
146  {
147  if ( mIter )
148  mIter->deref();
149  mIter = other.mIter;
150  if ( mIter )
151  mIter->ref();
152  }
153  return *this;
154 }
QgsFeatureId id() const
Get the feature id for this feature.
Definition: qgsfeature.cpp:100
virtual bool simplify(QgsFeature &feature)
simplify the specified geometry if it was configured
Wrapper for iterator of features from vector data provider or vector layer.
const QgsSimplifyMethod & simplifyMethod() const
Get simplification method for geometries that will be fetched.
const Flags & flags() const
Filter using feature IDs.
GeometryType
Definition: qgis.h:155
QVariant evaluate(const QgsFeature *f=NULL)
Evaluate the feature and return the result.
bool mLocalSimplification
this iterator runs local simplification
virtual bool fetchFeature(QgsFeature &f)=0
If you write a feature iterator for your provider, this is the method you need to implement!! ...
virtual bool providerCanSimplify(QgsSimplifyMethod::MethodType methodType) const
returns whether the iterator supports simplify geometries on provider side
const QgsFeatureIds & filterFids() const
QgsGeometry * geometry() const
Get the geometry object associated with this feature.
Definition: qgsfeature.cpp:112
QGis::GeometryType type()
Returns type of the vector.
The feature class encapsulates a single feature including its id, geometry and a list of field/values...
Definition: qgsfeature.h:114
virtual bool simplifyGeometry(QgsGeometry *geometry) const =0
Simplifies the specified geometry.
virtual bool nextFeature(QgsFeature &f)
fetch next feature, return true on success
QgsFeatureIterator & operator=(const QgsFeatureIterator &other)
virtual bool nextFeatureFilterExpression(QgsFeature &f)
By default, the iterator will fetch all features and check if the feature matches the expression...
This class wraps a request for features to a vector layer (or directly its vector data provider)...
No simplification is applied.
FilterType filterType() const
void deref()
remove reference, delete if refs == 0
virtual bool nextFeatureFilterFids(QgsFeature &f)
By default, the iterator will fetch all features and check if the id is in the request.
QgsFeatureRequest mRequest
A copy of the feature request.
QgsAbstractGeometrySimplifier * mGeometrySimplifier
optional object to locally simplify geometries fetched by this feature iterator
QgsAbstractFeatureIterator * mIter
static QgsAbstractGeometrySimplifier * createGeometrySimplifier(const QgsSimplifyMethod &simplifyMethod)
Creates a geometry simplifier according to specified method.
This class contains information about how to simplify geometries fetched from a QgsFeatureIterator.
int refs
reference counting (to allow seamless copying of QgsFeatureIterator instances)
Geometry is not required. It may still be returned if e.g. required for a filter condition.
virtual bool prepareSimplification(const QgsSimplifyMethod &simplifyMethod)
Setup the simplification of geometries to fetch using the specified simplify method.
virtual ~QgsAbstractFeatureIterator()
destructor makes sure that the iterator is closed properly
QgsAbstractFeatureIterator(const QgsFeatureRequest &request)
base class constructor - stores the iteration parameters
MethodType methodType() const
Gets the simplification type.
bool forceLocalOptimization() const
Gets whether the simplification executes after fetch the geometries from provider, otherwise it executes, when supported, in provider before fetch the geometries.
QgsExpression * filterExpression() const