QGIS API Documentation 3.99.0-Master (d270888f95f)
Loading...
Searching...
No Matches
qgspointcloudclassifiedrenderer.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgspointcloudclassifiedrenderer.h
3 --------------------
4 begin : October 2020
5 copyright : (C) 2020 by Nyall Dawson
6 email : nyall dot dawson 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
19
20#include "qgscolorramp.h"
21#include "qgscolorutils.h"
23#include "qgspointcloudblock.h"
25#include "qgsstyle.h"
26
27#include <QString>
28
29using namespace Qt::StringLiterals;
30
31QgsPointCloudCategory::QgsPointCloudCategory( const int value, const QColor &color, const QString &label, bool render, double pointSize )
32 : mValue( value )
33 , mColor( color )
35 , mLabel( label )
36 , mRender( render )
37{
38}
39
41{
42 return mValue == other.value() &&
43 mColor == other.color() &&
44 mPointSize == other.pointSize() &&
45 mLabel == other.label() &&
46 mRender == other.renderState();
47}
48
49//
50// QgsPointCloudClassifiedRenderer
51//
52
54 : mAttribute( attributeName )
55 , mCategories( categories )
56{
57}
58
60{
61 return u"classified"_s;
62}
63
65{
66 auto res = std::make_unique< QgsPointCloudClassifiedRenderer >();
67 res->mAttribute = mAttribute;
68 res->mCategories = mCategories;
69
70 copyCommonProperties( res.get() );
71
72 return res.release();
73}
74
76{
77 QgsRectangle visibleExtent = context.renderContext().extent();
78 if ( renderAsTriangles() )
79 {
80 // we need to include also points slightly outside of the visible extent,
81 // otherwise the triangulation may be missing triangles near the edges and corners
82 visibleExtent.grow( std::max( visibleExtent.width(), visibleExtent.height() ) * 0.05 );
83 }
84
85 const char *ptr = block->data();
86 int count = block->pointCount();
87 const QgsPointCloudAttributeCollection request = block->attributes();
88
89 const std::size_t recordSize = request.pointRecordSize();
90 int attributeOffset = 0;
91 const QgsPointCloudAttribute *attribute = request.find( mAttribute, attributeOffset );
92 if ( !attribute )
93 return;
94 const QgsPointCloudAttribute::DataType attributeType = attribute->type();
95
96 const bool renderElevation = context.renderContext().elevationMap();
97 const QgsDoubleRange zRange = context.renderContext().zRange();
98 const bool considerZ = !zRange.isInfinite() || renderElevation;
99
100 int rendered = 0;
101 double x = 0;
102 double y = 0;
103 double z = 0;
105 const bool reproject = ct.isValid();
106
107 QHash< int, QColor > colors;
108 QHash< int, int > pointSizes;
109 for ( const QgsPointCloudCategory &category : std::as_const( mCategories ) )
110 {
111 if ( !category.renderState() )
112 continue;
113
114 colors.insert( category.value(), category.color() );
115
116 const double size = category.pointSize() > 0 ? category.pointSize() : pointSize();
117 pointSizes.insert( category.value(), context.renderContext().convertToPainterUnits( size, pointSizeUnit(), pointSizeMapUnitScale() ) );
118 }
119
120 for ( int i = 0; i < count; ++i )
121 {
122 if ( context.renderContext().renderingStopped() )
123 {
124 break;
125 }
126
127 // z value filtering is cheapest, if we're doing it...
128 if ( considerZ )
129 {
130 z = pointZ( context, ptr, i );
131 if ( !zRange.contains( z ) )
132 continue;
133 }
134
135 int attributeValue = 0;
136 context.getAttribute( ptr, i * recordSize + attributeOffset, attributeType, attributeValue );
137 const QColor color = colors.value( attributeValue );
138 if ( !color.isValid() )
139 continue;
140
141 pointXY( context, ptr, i, x, y );
142 if ( visibleExtent.contains( x, y ) )
143 {
144 if ( reproject )
145 {
146 try
147 {
148 ct.transformInPlace( x, y, z );
149 }
150 catch ( QgsCsException & )
151 {
152 continue;
153 }
154 }
155
156 if ( renderAsTriangles() )
157 {
158 addPointToTriangulation( x, y, z, color, context );
159
160 // We don't want to render any points if we're rendering triangles and there is no preview painter
161 if ( !context.renderContext().previewRenderPainter() )
162 continue;
163 }
164
165 const double size = pointSizes.value( attributeValue );
166 drawPoint( x, y, color, size, context );
167 if ( renderElevation )
168 drawPointToElevationMap( x, y, z, size, context );
169
170 rendered++;
171 }
172 }
173 context.incrementPointsRendered( rendered );
174}
175
176bool QgsPointCloudClassifiedRenderer::willRenderPoint( const QVariantMap &pointAttributes )
177{
178 if ( !pointAttributes.contains( mAttribute ) )
179 return false;
180 bool parsedCorrectly;
181 int attributeInt = pointAttributes[ mAttribute ].toInt( &parsedCorrectly );
182 if ( !parsedCorrectly )
183 return false;
184 for ( const QgsPointCloudCategory &category : std::as_const( mCategories ) )
185 {
186 if ( category.value() == attributeInt )
187 return category.renderState();
188 }
189 return false;
190}
191
193{
194 auto r = std::make_unique< QgsPointCloudClassifiedRenderer >();
195
196 r->setAttribute( element.attribute( u"attribute"_s, u"Classification"_s ) );
197
199 const QDomElement catsElem = element.firstChildElement( u"categories"_s );
200 if ( !catsElem.isNull() )
201 {
202 QDomElement catElem = catsElem.firstChildElement();
203 while ( !catElem.isNull() )
204 {
205 if ( catElem.tagName() == "category"_L1 )
206 {
207 const int value = catElem.attribute( u"value"_s ).toInt();
208 const double size = catElem.attribute( u"pointSize"_s, u"0"_s ).toDouble();
209 const QString label = context.projectTranslator()->translate( u"project:layers:%1:legendsymbollabels"_s.arg( context.currentLayerId() ), catElem.attribute( u"label"_s ) );
210 QgsDebugMsgLevel( "context" + u"project:layers:%1:legendsymbollabels"_s.arg( context.currentLayerId() ) + " source " + catElem.attribute( u"label"_s ), 3 );
211
212 const bool render = catElem.attribute( u"render"_s ) != "false"_L1;
213 const QColor color = QgsColorUtils::colorFromString( catElem.attribute( u"color"_s ) );
214 categories.append( QgsPointCloudCategory( value, color, label, render, size ) );
215 }
216 catElem = catElem.nextSiblingElement();
217 }
218 r->setCategories( categories );
219 }
220
221 r->restoreCommonProperties( element, context );
222
223 return r.release();
224}
225
227{
247}
248
249QDomElement QgsPointCloudClassifiedRenderer::save( QDomDocument &doc, const QgsReadWriteContext &context ) const
250{
251 QDomElement rendererElem = doc.createElement( u"renderer"_s );
252
253 rendererElem.setAttribute( u"type"_s, u"classified"_s );
254 rendererElem.setAttribute( u"attribute"_s, mAttribute );
255
256 // categories
257 QDomElement catsElem = doc.createElement( u"categories"_s );
258 for ( const QgsPointCloudCategory &category : mCategories )
259 {
260 QDomElement catElem = doc.createElement( u"category"_s );
261 catElem.setAttribute( u"value"_s, QString::number( category.value() ) );
262 catElem.setAttribute( u"pointSize"_s, QString::number( category.pointSize() ) );
263 catElem.setAttribute( u"label"_s, category.label() );
264 catElem.setAttribute( u"color"_s, QgsColorUtils::colorToString( category.color() ) );
265 catElem.setAttribute( u"render"_s, category.renderState() ? "true" : "false" );
266 catsElem.appendChild( catElem );
267 }
268 rendererElem.appendChild( catsElem );
269
270 saveCommonProperties( rendererElem, context );
271
272 return rendererElem;
273}
274
276{
277 QSet<QString> res;
278 res << mAttribute;
279 return res;
280}
281
282QList<QgsLayerTreeModelLegendNode *> QgsPointCloudClassifiedRenderer::createLegendNodes( QgsLayerTreeLayer *nodeLayer )
283{
284 QList<QgsLayerTreeModelLegendNode *> nodes;
285
286 for ( const QgsPointCloudCategory &category : std::as_const( mCategories ) )
287 {
288 nodes << new QgsRasterSymbolLegendNode( nodeLayer, category.color(), category.label(), nullptr, true, QString::number( category.value() ) );
289 }
290
291 return nodes;
292}
293
295{
296 QStringList res;
297 for ( const QgsPointCloudCategory &category : std::as_const( mCategories ) )
298 {
299 res << QString::number( category.value() );
300 }
301 return res;
302}
303
305{
306 bool ok = false;
307 const int value = key.toInt( &ok );
308 if ( !ok )
309 return false;
310
311 for ( const QgsPointCloudCategory &category : std::as_const( mCategories ) )
312 {
313 if ( category.value() == value )
314 return category.renderState();
315 }
316 return false;
317}
318
319void QgsPointCloudClassifiedRenderer::checkLegendItem( const QString &key, bool state )
320{
321 bool ok = false;
322 const int value = key.toInt( &ok );
323 if ( !ok )
324 return;
325
326 for ( auto it = mCategories.begin(); it != mCategories.end(); ++it )
327 {
328 if ( it->value() == value )
329 {
330 it->setRenderState( state );
331 return;
332 }
333 }
334}
335
337{
338 return mAttribute;
339}
340
342{
343 mAttribute = attribute;
344}
345
350
355
357{
358 mCategories.append( category );
359}
360
361std::unique_ptr<QgsPreparedPointCloudRendererData> QgsPointCloudClassifiedRenderer::prepare()
362{
363 auto data = std::make_unique< QgsPointCloudClassifiedRendererPreparedData >();
364 data->attributeName = mAttribute;
365
366 for ( const QgsPointCloudCategory &category : std::as_const( mCategories ) )
367 {
368 if ( !category.renderState() )
369 continue;
370
371 data->colors.insert( category.value(), category.color() );
372 }
373
374 return data;
375}
376
381
383{
384 const QgsPointCloudAttributeCollection attributes = block->attributes();
385 const QgsPointCloudAttribute *attribute = attributes.find( attributeName, attributeOffset );
386 if ( !attribute )
387 return false;
388
389 attributeType = attribute->type();
390 return true;
391}
392
394{
395 int attributeValue = 0;
397 return colors.value( attributeValue );
398}
399
400
static QColor colorFromString(const QString &string)
Decodes a string into a color value.
static QString colorToString(const QColor &color)
Encodes a color into a string value.
Handles coordinate transforms between two coordinate systems.
void transformInPlace(double &x, double &y, double &z, Qgis::TransformDirection direction=Qgis::TransformDirection::Forward) const
Transforms an array of x, y and z double coordinates in place, from the source CRS to the destination...
bool isValid() const
Returns true if the coordinate transform is valid, ie both the source and destination CRS have been s...
Custom exception class for Coordinate Reference System related exceptions.
QgsRange which stores a range of double values.
Definition qgsrange.h:236
bool isInfinite() const
Returns true if the range consists of all possible values.
Definition qgsrange.h:290
Layer tree node points to a map layer.
A 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.
Attribute for point cloud data pair of name and size in bytes.
DataType
Systems of unit measurement.
DataType type() const
Returns the data type.
Base class for storing raw data from point cloud nodes.
const char * data() const
Returns raw pointer to data.
QgsPointCloudAttributeCollection attributes() const
Returns the attributes that are stored in the data block, along with their size.
int pointCount() const
Returns number of points that are stored in the block.
int pointRecordSize() const
Returns the total size of each individual point record.
Represents an individual category (class) from a QgsPointCloudClassifiedRenderer.
QgsPointCloudCategory()=default
int value() const
Returns the value corresponding to this category.
bool renderState() const
Returns true if the category is currently enabled and should be rendered.
QColor color() const
Returns the color which will be used to render this category.
double pointSize() const
Returns the point size for this category.
bool operator==(const QgsPointCloudCategory &other) const
Equality operator.
QString label() const
Returns the label for this category, which is used to represent the category within legends and the l...
QColor pointColor(const QgsPointCloudBlock *block, int i, double z) override
An optimised method of retrieving the color of a point from a point cloud block.
QSet< QString > usedAttributes() const override
Returns the set of attributes used by the prepared point cloud renderer.
bool prepareBlock(const QgsPointCloudBlock *block) override
Prepares the renderer for using the specified block.
void addCategory(const QgsPointCloudCategory &category)
Adds a category to the renderer.
QString attribute() const
Returns the attribute to use for the renderer.
QgsPointCloudClassifiedRenderer(const QString &attributeName=QString(), const QgsPointCloudCategoryList &categories=QgsPointCloudCategoryList())
Constructor for QgsPointCloudClassifiedRenderer.
bool willRenderPoint(const QVariantMap &pointAttributes) override
QDomElement save(QDomDocument &doc, const QgsReadWriteContext &context) const override
Saves the renderer configuration to an XML element.
void checkLegendItem(const QString &key, bool state=true) override
Called when the check state of the legend item with the specified key is changed.
QSet< QString > usedAttributes(const QgsPointCloudRenderContext &context) const override
Returns a list of attributes required by this renderer.
static QgsPointCloudRenderer * create(QDomElement &element, const QgsReadWriteContext &context)
Creates an RGB renderer from an XML element.
QgsPointCloudCategoryList categories() const
Returns the classification categories used for rendering.
static QgsPointCloudCategoryList defaultCategories()
Returns the default list of categories.
bool legendItemChecked(const QString &key) override
Returns true if the legend item with the specified key is checked.
QgsPointCloudRenderer * clone() const override
Create a deep copy of this renderer.
void setCategories(const QgsPointCloudCategoryList &categories)
Sets the classification categories used for rendering.
QList< QgsLayerTreeModelLegendNode * > createLegendNodes(QgsLayerTreeLayer *nodeLayer) override
Creates a set of legend nodes representing the renderer.
void renderBlock(const QgsPointCloudBlock *block, QgsPointCloudRenderContext &context) override
Renders a block of point cloud data using the specified render context.
std::unique_ptr< QgsPreparedPointCloudRendererData > prepare() override
Returns prepared data container for bulk point color retrieval.
QStringList legendRuleKeys() const override
Returns a list of all rule keys for legend nodes created by the renderer.
void setAttribute(const QString &attribute)
Sets the attribute to use for the renderer.
QString type() const override
Returns the identifier of the renderer type.
static QMap< int, QString > translatedLasClassificationCodes()
Returns the map of LAS classification code to translated string value, corresponding to the ASPRS Sta...
Encapsulates the render context for a 2D point cloud rendering operation.
QgsRenderContext & renderContext()
Returns a reference to the context's render context.
void incrementPointsRendered(long count)
Increments the count of points rendered by the specified amount.
static void getAttribute(const char *data, std::size_t offset, QgsPointCloudAttribute::DataType type, T &value)
Retrieves the attribute value from data at the specified offset, where type indicates the original da...
bool renderAsTriangles() const
Returns whether points are triangulated to render solid surface.
void drawPointToElevationMap(double x, double y, double z, QgsPointCloudRenderContext &context) const
Draws a point at the elevation z using at the specified x and y (in map coordinates) on the elevation...
void saveCommonProperties(QDomElement &element, const QgsReadWriteContext &context) const
Saves common renderer properties (such as point size and screen error) to the specified DOM element.
const QgsMapUnitScale & pointSizeMapUnitScale() const
Returns the map unit scale used for the point size.
void addPointToTriangulation(double x, double y, double z, const QColor &color, QgsPointCloudRenderContext &context)
Adds a point to the list of points to be triangulated (only used when renderAsTriangles() is enabled)...
void copyCommonProperties(QgsPointCloudRenderer *destination) const
Copies common point cloud properties (such as point size and screen error) to the destination rendere...
void drawPoint(double x, double y, const QColor &color, QgsPointCloudRenderContext &context) const
Draws a point using a color at the specified x and y (in map coordinates).
Qgis::RenderUnit pointSizeUnit() const
Returns the units used for the point size.
double pointSize() const
Returns the point size.
static double pointZ(QgsPointCloudRenderContext &context, const char *ptr, int i)
Retrieves the z value for the point at index i.
static void pointXY(QgsPointCloudRenderContext &context, const char *ptr, int i, double &x, double &y)
Retrieves the x and y coordinate for the point at index i.
virtual QString translate(const QString &context, const QString &sourceText, const char *disambiguation=nullptr, int n=-1) const =0
Translates a string using the Qt QTranslator mechanism.
bool contains(const QgsRange< T > &other) const
Returns true if this range contains another range.
Definition qgsrange.h:140
Implementation of legend node interface for displaying raster legend entries.
A container for the context for various read/write operations on objects.
const QgsProjectTranslator * projectTranslator() const
Returns the project translator.
const QString currentLayerId() const
Returns the currently used layer id as string.
A rectangle specified with double values.
bool contains(const QgsRectangle &rect) const
Returns true when rectangle contains other rectangle.
void grow(double delta)
Grows the rectangle in place by the specified amount.
double convertToPainterUnits(double size, Qgis::RenderUnit unit, const QgsMapUnitScale &scale=QgsMapUnitScale(), Qgis::RenderSubcomponentProperty property=Qgis::RenderSubcomponentProperty::Generic) const
Converts a size from the specified units to painter units (pixels).
QgsElevationMap * elevationMap() const
Returns the destination elevation map for the render operation.
const QgsRectangle & extent() const
When rendering a map layer, calling this method returns the "clipping" extent for the layer (in the l...
QgsDoubleRange zRange() const
Returns the range of z-values which should be rendered.
bool renderingStopped() const
Returns true if the rendering operation has been stopped and any ongoing rendering should be canceled...
QPainter * previewRenderPainter()
Returns the const destination QPainter for temporary in-progress preview renders.
QgsCoordinateTransform coordinateTransform() const
Returns the current coordinate transform for the context.
#define QgsDebugMsgLevel(str, level)
Definition qgslogger.h:63
QList< QgsPointCloudCategory > QgsPointCloudCategoryList