QGIS API Documentation  3.18.1-Zürich (202f1bf7e5)
qgspointcloudrenderer.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgspointcloudrenderer.cpp
3  --------------------
4  begin : October 2020
5  copyright : (C) 2020 by Peter Petrik
6  email : zilolv at gmail dot com
7  ***************************************************************************/
8 
9 /***************************************************************************
10  * *
11  * This program is free software; you can redistribute it and/or modify *
12  * it under the terms of the GNU General Public License as published by *
13  * the Free Software Foundation; either version 2 of the License, or *
14  * (at your option) any later version. *
15  * *
16  ***************************************************************************/
17 
18 #include "qgspointcloudrenderer.h"
20 #include "qgsapplication.h"
21 #include "qgssymbollayerutils.h"
22 #include "qgspointcloudlayer.h"
23 #include "qgspointcloudindex.h"
25 #include "qgslogger.h"
26 #include "qgscircle.h"
27 #include <QThread>
28 #include <QPointer>
29 
30 QgsPointCloudRenderContext::QgsPointCloudRenderContext( QgsRenderContext &context, const QgsVector3D &scale, const QgsVector3D &offset, double zValueScale, double zValueFixedOffset )
31  : mRenderContext( context )
32  , mScale( scale )
33  , mOffset( offset )
34  , mZValueScale( zValueScale )
35  , mZValueFixedOffset( zValueFixedOffset )
36 {
37 
38 }
39 
41 {
42  return mPointsRendered;
43 }
44 
46 {
47  mPointsRendered += count;
48 }
49 
51 {
52  mAttributes = attributes;
53  mPointRecordSize = mAttributes.pointRecordSize();
54 
55  // fetch offset for x/y/z attributes
56  attributes.find( QStringLiteral( "X" ), mXOffset );
57  attributes.find( QStringLiteral( "Y" ), mYOffset );
58  attributes.find( QStringLiteral( "Z" ), mZOffset );
59 }
60 
62 {
63  if ( element.isNull() )
64  return nullptr;
65 
66  // load renderer
67  const QString rendererType = element.attribute( QStringLiteral( "type" ) );
68 
70  if ( !m )
71  return nullptr;
72 
73  std::unique_ptr< QgsPointCloudRenderer > r( m->createRenderer( element, context ) );
74  return r.release();
75 }
76 
78 {
79  return QSet< QString >();
80 }
81 
83 {
84 #ifdef QGISDEBUG
85  if ( !mThread )
86  {
87  mThread = QThread::currentThread();
88  }
89  else
90  {
91  Q_ASSERT_X( mThread == QThread::currentThread(), "QgsPointCloudRenderer::startRender", "startRender called in a different thread - use a cloned renderer instead" );
92  }
93 #endif
94 
96 
97  switch ( mPointSymbol )
98  {
99  case Square:
100  // for square point we always disable antialiasing -- it's not critical here and we benefit from the performance boost disabling it gives
101  context.renderContext().painter()->setRenderHint( QPainter::Antialiasing, false );
102  break;
103 
104  case Circle:
105  break;
106  }
107 }
108 
110 {
111 #ifdef QGISDEBUG
112  Q_ASSERT_X( mThread == QThread::currentThread(), "QgsPointCloudRenderer::stopRender", "stopRender called in a different thread - use a cloned renderer instead" );
113 #endif
114 }
115 
117 {
118  return false;
119 }
120 
121 void QgsPointCloudRenderer::checkLegendItem( const QString &, bool )
122 {
123 
124 }
125 
127 {
128  return mMaximumScreenError;
129 }
130 
132 {
133  mMaximumScreenError = error;
134 }
135 
137 {
138  return mMaximumScreenErrorUnit;
139 }
140 
142 {
143  mMaximumScreenErrorUnit = unit;
144 }
145 
146 QList<QgsLayerTreeModelLegendNode *> QgsPointCloudRenderer::createLegendNodes( QgsLayerTreeLayer * )
147 {
148  return QList<QgsLayerTreeModelLegendNode *>();
149 }
150 
152 {
153  return QStringList();
154 }
155 
157 {
158  destination->setPointSize( mPointSize );
159  destination->setPointSizeUnit( mPointSizeUnit );
160  destination->setPointSizeMapUnitScale( mPointSizeMapUnitScale );
161  destination->setMaximumScreenError( mMaximumScreenError );
162  destination->setMaximumScreenErrorUnit( mMaximumScreenErrorUnit );
163  destination->setPointSymbol( mPointSymbol );
164 }
165 
166 void QgsPointCloudRenderer::restoreCommonProperties( const QDomElement &element, const QgsReadWriteContext & )
167 {
168  mPointSize = element.attribute( QStringLiteral( "pointSize" ), QStringLiteral( "1" ) ).toDouble();
169  mPointSizeUnit = QgsUnitTypes::decodeRenderUnit( element.attribute( QStringLiteral( "pointSizeUnit" ), QStringLiteral( "MM" ) ) );
170  mPointSizeMapUnitScale = QgsSymbolLayerUtils::decodeMapUnitScale( element.attribute( QStringLiteral( "pointSizeMapUnitScale" ), QString() ) );
171 
172  mMaximumScreenError = element.attribute( QStringLiteral( "maximumScreenError" ), QStringLiteral( "0.3" ) ).toDouble();
173  mMaximumScreenErrorUnit = QgsUnitTypes::decodeRenderUnit( element.attribute( QStringLiteral( "maximumScreenErrorUnit" ), QStringLiteral( "MM" ) ) );
174  mPointSymbol = static_cast< PointSymbol >( element.attribute( QStringLiteral( "pointSymbol" ), QStringLiteral( "0" ) ).toInt() );
175 }
176 
177 void QgsPointCloudRenderer::saveCommonProperties( QDomElement &element, const QgsReadWriteContext & ) const
178 {
179  element.setAttribute( QStringLiteral( "pointSize" ), qgsDoubleToString( mPointSize ) );
180  element.setAttribute( QStringLiteral( "pointSizeUnit" ), QgsUnitTypes::encodeUnit( mPointSizeUnit ) );
181  element.setAttribute( QStringLiteral( "pointSizeMapUnitScale" ), QgsSymbolLayerUtils::encodeMapUnitScale( mPointSizeMapUnitScale ) );
182 
183  element.setAttribute( QStringLiteral( "maximumScreenError" ), qgsDoubleToString( mMaximumScreenError ) );
184  element.setAttribute( QStringLiteral( "maximumScreenErrorUnit" ), QgsUnitTypes::encodeUnit( mMaximumScreenErrorUnit ) );
185  element.setAttribute( QStringLiteral( "pointSymbol" ), QString::number( mPointSymbol ) );
186 }
187 
189 {
190  return mPointSymbol;
191 }
192 
194 {
195  mPointSymbol = symbol;
196 }
197 
198 QVector<QVariantMap> QgsPointCloudRenderer::identify( QgsPointCloudLayer *layer, const QgsRenderContext &renderContext, const QgsGeometry &geometry, double toleranceForPointIdentification )
199 {
200  QVector<QVariantMap> selectedPoints;
201 
202  QgsPointCloudIndex *index = layer->dataProvider()->index();
203  const IndexedPointCloudNode root = index->root();
204 
205  const double maxErrorPixels = renderContext.convertToPainterUnits( maximumScreenError(), maximumScreenErrorUnit() );// in pixels
206 
207  const QgsRectangle rootNodeExtentLayerCoords = index->nodeMapExtent( root );
208  QgsRectangle rootNodeExtentMapCoords;
209  try
210  {
211  rootNodeExtentMapCoords = renderContext.coordinateTransform().transformBoundingBox( rootNodeExtentLayerCoords );
212  }
213  catch ( QgsCsException & )
214  {
215  QgsDebugMsg( QStringLiteral( "Could not transform node extent to map CRS" ) );
216  rootNodeExtentMapCoords = rootNodeExtentLayerCoords;
217  }
218 
219  const double rootErrorInMapCoordinates = rootNodeExtentMapCoords.width() / index->span();
220  const double rootErrorInLayerCoordinates = rootNodeExtentLayerCoords.width() / index->span();
221 
222  double mapUnitsPerPixel = renderContext.mapToPixel().mapUnitsPerPixel();
223  if ( ( rootErrorInMapCoordinates < 0.0 ) || ( mapUnitsPerPixel < 0.0 ) || ( maxErrorPixels < 0.0 ) )
224  {
225  QgsDebugMsg( QStringLiteral( "invalid screen error" ) );
226  return selectedPoints;
227  }
228 
229  const double maxErrorInMapCoordinates = maxErrorPixels * mapUnitsPerPixel;
230  const double maxErrorInLayerCoordinates = maxErrorInMapCoordinates * rootErrorInLayerCoordinates / rootErrorInMapCoordinates;
231 
232  QgsGeometry selectionGeometry = geometry;
233  if ( geometry.type() == QgsWkbTypes::PointGeometry )
234  {
235  double x = geometry.asPoint().x();
236  double y = geometry.asPoint().y();
237  const double toleranceInPixels = toleranceForPointIdentification / renderContext.mapToPixel().mapUnitsPerPixel();
238  const double pointSizePixels = renderContext.convertToPainterUnits( mPointSize, mPointSizeUnit, mPointSizeMapUnitScale );
239  switch ( pointSymbol() )
240  {
241  case QgsPointCloudRenderer::PointSymbol::Square:
242  {
243  QgsPointXY deviceCoords = renderContext.mapToPixel().transform( QgsPointXY( x, y ) );
244  QgsPointXY point1( deviceCoords.x() - std::max( toleranceInPixels, pointSizePixels / 2.0 ), deviceCoords.y() - std::max( toleranceInPixels, pointSizePixels / 2.0 ) );
245  QgsPointXY point2( deviceCoords.x() + std::max( toleranceInPixels, pointSizePixels / 2.0 ), deviceCoords.y() + std::max( toleranceInPixels, pointSizePixels / 2.0 ) );
246  QgsPointXY point1MapCoords = renderContext.mapToPixel().toMapCoordinates( point1.x(), point1.y() );
247  QgsPointXY point2MapCoords = renderContext.mapToPixel().toMapCoordinates( point2.x(), point2.y() );
248  QgsRectangle pointRect( point1MapCoords, point2MapCoords );
249  selectionGeometry = QgsGeometry::fromRect( pointRect );
250  break;
251  }
252  case QgsPointCloudRenderer::PointSymbol::Circle:
253  {
254  QgsPoint centerMapCoords( x, y );
255  QgsPointXY deviceCoords = renderContext.mapToPixel().transform( centerMapCoords );
256  QgsPoint point1( deviceCoords.x(), deviceCoords.y() - std::max( toleranceInPixels, pointSizePixels / 2.0 ) );
257  QgsPoint point2( deviceCoords.x(), deviceCoords.y() + std::max( toleranceInPixels, pointSizePixels / 2.0 ) );
258  QgsPointXY point1MapCoords = renderContext.mapToPixel().toMapCoordinates( point1.x(), point1.y() );
259  QgsPointXY point2MapCoords = renderContext.mapToPixel().toMapCoordinates( point2.x(), point2.y() );
260  QgsCircle circle = QgsCircle::from2Points( QgsPoint( point1MapCoords ), QgsPoint( point2MapCoords ) );
261  std::unique_ptr<QgsPolygon> polygon( circle.toPolygon( 6 ) );
262  QgsGeometry circleGeometry( std::move( polygon ) );
263  selectionGeometry = circleGeometry;
264  break;
265  }
266  }
267  }
268 
269  // selection geometry must be in layer CRS for QgsPointCloudDataProvider::identify
270  try
271  {
272  selectionGeometry.transform( renderContext.coordinateTransform(), QgsCoordinateTransform::ReverseTransform );
273  }
274  catch ( QgsCsException & )
275  {
276  QgsDebugMsg( QStringLiteral( "Could not transform geometry to layer CRS" ) );
277  return selectedPoints;
278  }
279 
280  selectedPoints = layer->dataProvider()->identify( maxErrorInLayerCoordinates, selectionGeometry, renderContext.zRange() );
281 
282  selectedPoints.erase( std::remove_if( selectedPoints.begin(), selectedPoints.end(), [this]( const QMap<QString, QVariant> &point ) { return !this->willRenderPoint( point ); } ), selectedPoints.end() );
283 
284  return selectedPoints;
285 }
Represents a indexed point cloud node in octree.
static QgsPointCloudRendererRegistry * pointCloudRendererRegistry()
Returns the application's point cloud renderer registry, used for managing point cloud layer 2D rende...
Circle geometry type.
Definition: qgscircle.h:44
static QgsCircle from2Points(const QgsPoint &pt1, const QgsPoint &pt2) SIP_HOLDGIL
Constructs a circle by 2 points on the circle.
Definition: qgscircle.cpp:37
@ ReverseTransform
Transform from destination to source CRS.
QgsRectangle transformBoundingBox(const QgsRectangle &rectangle, TransformDirection direction=ForwardTransform, bool handle180Crossover=false) const SIP_THROW(QgsCsException)
Transforms a rectangle from the source CRS to the destination CRS.
Custom exception class for Coordinate Reference System related exceptions.
Definition: qgsexception.h:66
virtual QgsPolygon * toPolygon(unsigned int segments=36) const
Returns a segmented polygon.
Definition: qgsellipse.cpp:224
A geometry is the spatial representation of a feature.
Definition: qgsgeometry.h:124
static QgsGeometry fromRect(const QgsRectangle &rect) SIP_HOLDGIL
Creates a new geometry from a QgsRectangle.
QgsPointXY asPoint() const
Returns the contents of the geometry as a 2-dimensional point.
QgsWkbTypes::GeometryType type
Definition: qgsgeometry.h:127
OperationResult transform(const QgsCoordinateTransform &ct, QgsCoordinateTransform::TransformDirection direction=QgsCoordinateTransform::ForwardTransform, bool transformZ=false) SIP_THROW(QgsCsException)
Transforms this geometry as described by the coordinate transform ct.
Layer tree node points to a map layer.
double mapUnitsPerPixel() const
Returns current map units per pixel.
QgsPointXY toMapCoordinates(int x, int y) const
Transform device coordinates to map (world) coordinates.
QgsPointXY transform(const QgsPointXY &p) const
Transform the point p from map (world) coordinates to device coordinates.
Definition: qgsmaptopixel.h:82
Collection of point cloud attributes.
int pointRecordSize() const
Returns total size of record.
const QgsPointCloudAttribute * find(const QString &attributeName, int &offset) const
Finds the attribute with the name.
QVector< QVariantMap > identify(double maxError, const QgsGeometry &extentGeometry, const QgsDoubleRange &extentZRange=QgsDoubleRange(), int pointsLimit=1000)
Returns the list of points of the point cloud according to a zoom level defined by maxError (in layer...
virtual QgsPointCloudIndex * index() const
Returns the point cloud index associated with the provider.
Represents a indexed point clouds data in octree.
int span() const
Returns the number of points in one direction in a single node.
QgsRectangle nodeMapExtent(const IndexedPointCloudNode &node) const
Returns the extent of a node in map coordinates.
IndexedPointCloudNode root()
Returns root node of the index.
Represents a map layer supporting display of point clouds.
QgsPointCloudDataProvider * dataProvider() override
Returns the layer's data provider, it may be nullptr.
Encapsulates the render context for a 2D point cloud rendering operation.
QgsPointCloudRenderContext(QgsRenderContext &context, const QgsVector3D &scale, const QgsVector3D &offset, double zValueScale, double zValueFixedOffset)
Constructor for QgsPointCloudRenderContext.
void incrementPointsRendered(long count)
Increments the count of points rendered by the specified amount.
long pointsRendered() const
Returns the total number of points rendered.
QgsPointCloudAttributeCollection attributes() const
Returns the attributes associated with the rendered block.
QgsRenderContext & renderContext()
Returns a reference to the context's render context.
void setAttributes(const QgsPointCloudAttributeCollection &attributes)
Sets the attributes associated with the rendered block.
Stores metadata about one point cloud renderer class.
virtual QgsPointCloudRenderer * createRenderer(QDomElement &elem, const QgsReadWriteContext &context)=0
Returns new instance of the renderer given the DOM element.
QgsPointCloudRendererAbstractMetadata * rendererMetadata(const QString &rendererName)
Returns the metadata for a specified renderer.
Abstract base class for 2d point cloud renderers.
const QgsMapUnitScale & pointSizeMapUnitScale() const
Returns the map unit scale used for the point size.
virtual void checkLegendItem(const QString &key, bool state=true)
Called when the check state of the legend item with the specified key is changed.
void setMaximumScreenError(double error)
Sets the maximum screen error allowed when rendering the point cloud.
void setPointSizeUnit(const QgsUnitTypes::RenderUnit units)
Sets the units used for the point size.
void restoreCommonProperties(const QDomElement &element, const QgsReadWriteContext &context)
Restores common renderer properties (such as point size and screen error) from the specified DOM elem...
PointSymbol pointSymbol() const
Returns the symbol used by the renderer for drawing points.
void saveCommonProperties(QDomElement &element, const QgsReadWriteContext &context) const
Saves common renderer properties (such as point size and screen error) to the specified DOM element.
void setPointSizeMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale used for the point size.
virtual QSet< QString > usedAttributes(const QgsPointCloudRenderContext &context) const
Returns a list of attributes required by this renderer.
virtual bool legendItemChecked(const QString &key)
Returns true if the legend item with the specified key is checked.
void setPointSize(double size)
Sets the point size.
PointSymbol
Rendering symbols for points.
@ Square
Renders points as squares.
@ Circle
Renders points as circles.
void setPointSymbol(PointSymbol symbol)
Sets the symbol used by the renderer for drawing points.
static QgsPointCloudRenderer * load(QDomElement &element, const QgsReadWriteContext &context)
Creates a renderer from an XML element.
QgsUnitTypes::RenderUnit maximumScreenErrorUnit() const
Returns the unit for the maximum screen error allowed when rendering the point cloud.
virtual QStringList legendRuleKeys() const
Returns a list of all rule keys for legend nodes created by the renderer.
QgsUnitTypes::RenderUnit pointSizeUnit() const
Returns the units used for the point size.
QVector< QVariantMap > identify(QgsPointCloudLayer *layer, const QgsRenderContext &context, const QgsGeometry &geometry, double toleranceForPointIdentification=0)
Returns the list of visible points of the point cloud layer layer and an extent defined by a geometry...
void copyCommonProperties(QgsPointCloudRenderer *destination) const
Copies common point cloud properties (such as point size and screen error) to the destination rendere...
double maximumScreenError() const
Returns the maximum screen error allowed when rendering the point cloud.
void setMaximumScreenErrorUnit(QgsUnitTypes::RenderUnit unit)
Sets the unit for the maximum screen error allowed when rendering the point cloud.
virtual void startRender(QgsPointCloudRenderContext &context)
Must be called when a new render cycle is started.
virtual void stopRender(QgsPointCloudRenderContext &context)
Must be called when a render cycle has finished, to allow the renderer to clean up.
virtual QList< QgsLayerTreeModelLegendNode * > createLegendNodes(QgsLayerTreeLayer *nodeLayer)
Creates a set of legend nodes representing the renderer.
double pointSize() const
Returns the point size.
A class to represent a 2D point.
Definition: qgspointxy.h:44
double y
Definition: qgspointxy.h:48
Q_GADGET double x
Definition: qgspointxy.h:47
Point geometry type, with support for z-dimension and m-values.
Definition: qgspoint.h:38
Q_GADGET double x
Definition: qgspoint.h:41
double y
Definition: qgspoint.h:42
The class is used as a container of context for various read/write operations on other objects.
A rectangle specified with double values.
Definition: qgsrectangle.h:42
double width() const SIP_HOLDGIL
Returns the width of the rectangle.
Definition: qgsrectangle.h:202
Contains information about the context of a rendering operation.
QPainter * painter()
Returns the destination QPainter for the render operation.
const QgsMapToPixel & mapToPixel() const
Returns the context's map to pixel transform, which transforms between map coordinates and device coo...
QgsDoubleRange zRange() const
Returns the range of z-values which should be rendered.
double convertToPainterUnits(double size, QgsUnitTypes::RenderUnit unit, const QgsMapUnitScale &scale=QgsMapUnitScale()) const
Converts a size from the specified units to painter units (pixels).
QgsCoordinateTransform coordinateTransform() const
Returns the current coordinate transform for the context.
static QString encodeMapUnitScale(const QgsMapUnitScale &mapUnitScale)
static QgsMapUnitScale decodeMapUnitScale(const QString &str)
static Q_INVOKABLE QString encodeUnit(QgsUnitTypes::DistanceUnit unit)
Encodes a distance unit to a string.
static Q_INVOKABLE QgsUnitTypes::RenderUnit decodeRenderUnit(const QString &string, bool *ok=nullptr)
Decodes a render unit from a string.
RenderUnit
Rendering size units.
Definition: qgsunittypes.h:167
QString qgsDoubleToString(double a, int precision=17)
Returns a string representation of a double.
Definition: qgis.h:276
#define QgsDebugMsg(str)
Definition: qgslogger.h:38