QGIS API Documentation  3.18.1-Zürich (202f1bf7e5)
qgspointcloudattributebyramprenderer.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgspointcloudattributebyramprenderer.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 #include "qgspointcloudblock.h"
20 #include "qgsstyle.h"
21 #include "qgscolorramp.h"
22 #include "qgssymbollayerutils.h"
24 #include "qgscolorramplegendnode.h"
25 
27 {
28  mColorRampShader.setSourceColorRamp( QgsStyle::defaultStyle()->colorRamp( QStringLiteral( "Viridis" ) ) );
29 }
30 
32 {
33  return QStringLiteral( "ramp" );
34 }
35 
37 {
38  std::unique_ptr< QgsPointCloudAttributeByRampRenderer > res = qgis::make_unique< QgsPointCloudAttributeByRampRenderer >();
39  res->mAttribute = mAttribute;
40  res->mColorRampShader = mColorRampShader;
41  res->mMin = mMin;
42  res->mMax = mMax;
43 
44  copyCommonProperties( res.get() );
45 
46  return res.release();
47 }
48 
50 {
51  const QgsRectangle visibleExtent = context.renderContext().extent();
52 
53  const char *ptr = block->data();
54  int count = block->pointCount();
55  const QgsPointCloudAttributeCollection request = block->attributes();
56 
57  const std::size_t recordSize = request.pointRecordSize();
58  int attributeOffset = 0;
59  const QgsPointCloudAttribute *attribute = request.find( mAttribute, attributeOffset );
60  if ( !attribute )
61  return;
62  const QgsPointCloudAttribute::DataType attributeType = attribute->type();
63 
64  const QgsDoubleRange zRange = context.renderContext().zRange();
65  const bool considerZ = !zRange.isInfinite();
66 
67  const bool applyZOffset = attribute->name() == QLatin1String( "Z" );
68  const bool applyXOffset = attribute->name() == QLatin1String( "X" );
69  const bool applyYOffset = attribute->name() == QLatin1String( "Y" );
70 
71  int rendered = 0;
72  double x = 0;
73  double y = 0;
74  double z = 0;
76  const bool reproject = ct.isValid();
77 
78  int red = 0;
79  int green = 0;
80  int blue = 0;
81  int alpha = 0;
82  for ( int i = 0; i < count; ++i )
83  {
84  if ( context.renderContext().renderingStopped() )
85  {
86  break;
87  }
88 
89  if ( considerZ )
90  {
91  // z value filtering is cheapest, if we're doing it...
92  z = pointZ( context, ptr, i );
93  if ( !zRange.contains( z ) )
94  continue;
95  }
96 
97  pointXY( context, ptr, i, x, y );
98  if ( visibleExtent.contains( QgsPointXY( x, y ) ) )
99  {
100  if ( reproject )
101  {
102  try
103  {
104  ct.transformInPlace( x, y, z );
105  }
106  catch ( QgsCsException & )
107  {
108  continue;
109  }
110  }
111 
112  double attributeValue = 0;
113  context.getAttribute( ptr, i * recordSize + attributeOffset, attributeType, attributeValue );
114 
115  if ( applyXOffset )
116  attributeValue = context.offset().x() + context.scale().x() * attributeValue;
117  if ( applyYOffset )
118  attributeValue = context.offset().y() + context.scale().y() * attributeValue;
119  if ( applyZOffset )
120  attributeValue = ( context.offset().z() + context.scale().z() * attributeValue ) * context.zValueScale() + context.zValueFixedOffset();
121 
122  mColorRampShader.shade( attributeValue, &red, &green, &blue, &alpha );
123  drawPoint( x, y, QColor( red, green, blue, alpha ), context );
124 
125  rendered++;
126  }
127  }
128  context.incrementPointsRendered( rendered );
129 }
130 
131 
133 {
134  std::unique_ptr< QgsPointCloudAttributeByRampRenderer > r = qgis::make_unique< QgsPointCloudAttributeByRampRenderer >();
135 
136  r->setAttribute( element.attribute( QStringLiteral( "attribute" ), QStringLiteral( "Intensity" ) ) );
137 
138  QDomElement elemShader = element.firstChildElement( QStringLiteral( "colorrampshader" ) );
139  r->mColorRampShader.readXml( elemShader, context );
140 
141  r->setMinimum( element.attribute( QStringLiteral( "min" ), QStringLiteral( "0" ) ).toDouble() );
142  r->setMaximum( element.attribute( QStringLiteral( "max" ), QStringLiteral( "100" ) ).toDouble() );
143 
144  r->restoreCommonProperties( element, context );
145 
146  return r.release();
147 }
148 
149 QDomElement QgsPointCloudAttributeByRampRenderer::save( QDomDocument &doc, const QgsReadWriteContext &context ) const
150 {
151  QDomElement rendererElem = doc.createElement( QStringLiteral( "renderer" ) );
152 
153  rendererElem.setAttribute( QStringLiteral( "type" ), QStringLiteral( "ramp" ) );
154  rendererElem.setAttribute( QStringLiteral( "min" ), mMin );
155  rendererElem.setAttribute( QStringLiteral( "max" ), mMax );
156 
157  rendererElem.setAttribute( QStringLiteral( "attribute" ), mAttribute );
158 
159  QDomElement elemShader = mColorRampShader.writeXml( doc, context );
160  rendererElem.appendChild( elemShader );
161 
162  saveCommonProperties( rendererElem, context );
163 
164  return rendererElem;
165 }
166 
168 {
169  QSet<QString> res;
170  res << mAttribute;
171  return res;
172 }
173 
174 QList<QgsLayerTreeModelLegendNode *> QgsPointCloudAttributeByRampRenderer::createLegendNodes( QgsLayerTreeLayer *nodeLayer )
175 {
176  QList<QgsLayerTreeModelLegendNode *> res;
177  res << new QgsSimpleLegendNode( nodeLayer, mAttribute );
178 
179  switch ( mColorRampShader.colorRampType() )
180  {
182  // for interpolated shaders we use a ramp legend node unless the settings flag
183  // to use the continuous legend is not set, in that case we fall through
184  if ( ! mColorRampShader.legendSettings() || mColorRampShader.legendSettings()->useContinuousLegend() )
185  {
186  res << new QgsColorRampLegendNode( nodeLayer, mColorRampShader.sourceColorRamp()->clone(),
187  mColorRampShader.legendSettings() ? *mColorRampShader.legendSettings() : QgsColorRampLegendNodeSettings(),
188  mColorRampShader.minimumValue(),
189  mColorRampShader.maximumValue() );
190  break;
191  }
192  Q_FALLTHROUGH();
195  {
196  // for all others we use itemised lists
197  QList< QPair< QString, QColor > > items;
198  mColorRampShader.legendSymbologyItems( items );
199  res.reserve( items.size() );
200  for ( const QPair< QString, QColor > &item : qgis::as_const( items ) )
201  {
202  res << new QgsRasterSymbolLegendNode( nodeLayer, item.second, item.first );
203  }
204  break;
205  }
206  }
207  return res;
208 }
209 
211 {
212  return mAttribute;
213 }
214 
216 {
217  mAttribute = attribute;
218 }
219 
221 {
222  return mColorRampShader;
223 }
224 
226 {
227  mColorRampShader = shader;
228 }
229 
231 {
232  return mMin;
233 }
234 
236 {
237  mMin = minimum;
238 }
239 
241 {
242  return mMax;
243 }
244 
246 {
247  mMax = value;
248 }
249 
Settings for a color ramp legend node.
bool useContinuousLegend() const
Returns true if a continuous gradient legend will be used.
A legend node which renders a color ramp.
A ramp shader will color a raster pixel based on a list of values ranges in a ramp.
void legendSymbologyItems(QList< QPair< QString, QColor > > &symbolItems) const override
Returns legend symbology items if provided by renderer.
const QgsColorRampLegendNodeSettings * legendSettings() const
Returns the color ramp shader legend settings.
Type colorRampType() const
Returns the color ramp type.
void setSourceColorRamp(QgsColorRamp *colorramp)
Set the source color ramp.
QDomElement writeXml(QDomDocument &doc, const QgsReadWriteContext &context=QgsReadWriteContext()) const
Writes configuration to a new DOM element.
bool shade(double value, int *returnRedValue, int *returnGreenValue, int *returnBlueValue, int *returnAlphaValue) const override
Generates and new RGB value based on one input value.
QgsColorRamp * sourceColorRamp() const
Returns the source color ramp.
@ Interpolated
Interpolates the color between two class breaks linearly.
@ Discrete
Assigns the color of the higher class for every pixel between two class breaks.
@ Exact
Assigns the color of the exact matching value in the color ramp item list.
virtual QgsColorRamp * clone() const =0
Creates a clone of the color ramp.
Class for doing transforms between two map coordinate systems.
void transformInPlace(double &x, double &y, double &z, TransformDirection direction=ForwardTransform) const SIP_THROW(QgsCsException)
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.
Definition: qgsexception.h:66
QgsRange which stores a range of double values.
Definition: qgsrange.h:203
bool isInfinite() const
Returns true if the range consists of all possible values.
Definition: qgsrange.h:247
Layer tree node points to a map layer.
QString type() const override
Returns the identifier of the renderer type.
void setMaximum(double maximum)
Sets the maximum value for attributes which will be used by the color ramp shader.
QgsPointCloudRenderer * clone() const override
Create a deep copy of this renderer.
static QgsPointCloudRenderer * create(QDomElement &element, const QgsReadWriteContext &context)
Creates an RGB renderer from an XML element.
void renderBlock(const QgsPointCloudBlock *block, QgsPointCloudRenderContext &context) override
Renders a block of point cloud data using the specified render context.
void setMinimum(double minimum)
Sets the minimum value for attributes which will be used by the color ramp shader.
QgsPointCloudAttributeByRampRenderer()
Constructor for QgsPointCloudAttributeByRampRenderer.
QDomElement save(QDomDocument &doc, const QgsReadWriteContext &context) const override
Saves the renderer configuration to an XML element.
double maximum() const
Returns the maximum value for attributes which will be used by the color ramp shader.
QList< QgsLayerTreeModelLegendNode * > createLegendNodes(QgsLayerTreeLayer *nodeLayer) override
Creates a set of legend nodes representing the renderer.
void setColorRampShader(const QgsColorRampShader &shader)
Sets the color ramp shader function used to visualize the attribute.
QSet< QString > usedAttributes(const QgsPointCloudRenderContext &context) const override
Returns a list of attributes required by this renderer.
QgsColorRampShader colorRampShader() const
Returns the color ramp shader function used to visualize the attribute.
double minimum() const
Returns the minimum value for attributes which will be used by the color ramp shader.
QString attribute() const
Returns the attribute to use for the renderer.
void setAttribute(const QString &attribute)
Sets the attribute to use for the renderer.
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.
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.
Encapsulates the render context for a 2D point cloud rendering operation.
void getAttribute(const char *data, std::size_t offset, QgsPointCloudAttribute::DataType type, T &value) const
Retrieves the attribute value from data at the specified offset, where type indicates the original da...
double zValueFixedOffset() const
Returns any constant offset which must be applied to z values taken from the point cloud index.
QgsVector3D offset() const
Returns the offset of the layer's int32 coordinates compared to CRS coords.
void incrementPointsRendered(long count)
Increments the count of points rendered by the specified amount.
double zValueScale() const
Returns any constant scaling factor which must be applied to z values taken from the point cloud inde...
QgsVector3D scale() const
Returns the scale of the layer's int32 coordinates compared to CRS coords.
QgsRenderContext & renderContext()
Returns a reference to the context's render context.
Abstract base class for 2d point cloud renderers.
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 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).
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.
A class to represent a 2D point.
Definition: qgspointxy.h:44
bool contains(const QgsRange< T > &other) const
Returns true if this range contains another range.
Definition: qgsrange.h:108
double maximumValue() const
Returns the minimum value for the raster shader.
double minimumValue() const
Returns the maximum value for the raster shader.
Implementation of legend node interface for displaying raster legend entries.
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
bool contains(const QgsRectangle &rect) const
Returns true when rectangle contains other rectangle.
Definition: qgsrectangle.h:342
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...
QgsCoordinateTransform coordinateTransform() const
Returns the current coordinate transform for the context.
const QgsRectangle & extent() const
When rendering a map layer, calling this method returns the "clipping" extent for the layer (in the l...
Implementation of legend node interface for displaying arbitrary label with icon.
static QgsStyle * defaultStyle()
Returns default application-wide style.
Definition: qgsstyle.cpp:128
double y() const
Returns Y coordinate.
Definition: qgsvector3d.h:51
double z() const
Returns Z coordinate.
Definition: qgsvector3d.h:53
double x() const
Returns X coordinate.
Definition: qgsvector3d.h:49