QGIS API Documentation 3.39.0-Master (93ce9bf5c90)
Loading...
Searching...
No Matches
qgs3dutils.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgs3dutils.cpp
3 --------------------------------------
4 Date : July 2017
5 Copyright : (C) 2017 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
16#include "qgs3dutils.h"
17
18#include "qgslinestring.h"
19#include "qgspolygon.h"
20#include "qgsfeaturerequest.h"
21#include "qgsfeatureiterator.h"
22#include "qgsfeature.h"
23#include "qgsabstractgeometry.h"
24#include "qgsvectorlayer.h"
26#include "qgsfeedback.h"
28#include "qgs3dmapscene.h"
29#include "qgsabstract3dengine.h"
30#include "qgsterraingenerator.h"
31#include "qgscameracontroller.h"
32#include "qgschunkedentity.h"
33#include "qgsterrainentity.h"
41
42#include <QtMath>
43#include <Qt3DExtras/QPhongMaterial>
44#include <Qt3DRender/QRenderSettings>
45
46#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
47#include <Qt3DRender/QBuffer>
48typedef Qt3DRender::QBuffer Qt3DQBuffer;
49#else
50#include <Qt3DCore/QBuffer>
51typedef Qt3DCore::QBuffer Qt3DQBuffer;
52#endif
53
54// declared here as Qgs3DTypes has no cpp file
55const char *Qgs3DTypes::PROP_NAME_3D_RENDERER_FLAG = "PROP_NAME_3D_RENDERER_FLAG";
56
58{
59 QImage resImage;
60 QEventLoop evLoop;
61
62 // We need to change render policy to RenderPolicy::Always, since otherwise render capture node won't work
63 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::Always );
64
65 auto requestImageFcn = [&engine, scene]
66 {
67 if ( scene->sceneState() == Qgs3DMapScene::Ready )
68 {
69 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::OnDemand );
70 engine.requestCaptureImage();
71 }
72 };
73
74 auto saveImageFcn = [&evLoop, &resImage]( const QImage & img )
75 {
76 resImage = img;
77 evLoop.quit();
78 };
79
80 const QMetaObject::Connection conn1 = QObject::connect( &engine, &QgsAbstract3DEngine::imageCaptured, saveImageFcn );
81 QMetaObject::Connection conn2;
82
83 if ( scene->sceneState() == Qgs3DMapScene::Ready )
84 {
85 requestImageFcn();
86 }
87 else
88 {
89 // first wait until scene is loaded
90 conn2 = QObject::connect( scene, &Qgs3DMapScene::sceneStateChanged, requestImageFcn );
91 }
92
93 evLoop.exec();
94
95 QObject::disconnect( conn1 );
96 if ( conn2 )
97 QObject::disconnect( conn2 );
98
99 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::OnDemand );
100 return resImage;
101}
102
104{
105 QImage resImage;
106 QEventLoop evLoop;
107
108 // We need to change render policy to RenderPolicy::Always, since otherwise render capture node won't work
109 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::Always );
110
111 auto requestImageFcn = [&engine, scene]
112 {
113 if ( scene->sceneState() == Qgs3DMapScene::Ready )
114 {
115 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::OnDemand );
117 }
118 };
119
120 auto saveImageFcn = [&evLoop, &resImage]( const QImage & img )
121 {
122 resImage = img;
123 evLoop.quit();
124 };
125
126 QMetaObject::Connection conn1 = QObject::connect( &engine, &QgsAbstract3DEngine::depthBufferCaptured, saveImageFcn );
127 QMetaObject::Connection conn2;
128
129 if ( scene->sceneState() == Qgs3DMapScene::Ready )
130 {
131 requestImageFcn();
132 }
133 else
134 {
135 // first wait until scene is loaded
136 conn2 = QObject::connect( scene, &Qgs3DMapScene::sceneStateChanged, requestImageFcn );
137 }
138
139 evLoop.exec();
140
141 QObject::disconnect( conn1 );
142 if ( conn2 )
143 QObject::disconnect( conn2 );
144
145 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::OnDemand );
146 return resImage;
147}
148
149
150double Qgs3DUtils::calculateEntityGpuMemorySize( Qt3DCore::QEntity *entity )
151{
152 long long usedGpuMemory = 0;
153 for ( Qt3DQBuffer *buffer : entity->findChildren<Qt3DQBuffer *>() )
154 {
155 usedGpuMemory += buffer->data().size();
156 }
157 for ( Qt3DRender::QTexture2D *tex : entity->findChildren<Qt3DRender::QTexture2D *>() )
158 {
159 // TODO : lift the assumption that the texture is RGBA
160 usedGpuMemory += tex->width() * tex->height() * 4;
161 }
162 return usedGpuMemory / 1024.0 / 1024.0;
163}
164
165
167 Qgs3DMapSettings &mapSettings,
168 int framesPerSecond,
169 const QString &outputDirectory,
170 const QString &fileNameTemplate,
171 const QSize &outputSize,
172 QString &error,
173 QgsFeedback *feedback
174 )
175{
176 if ( animationSettings.keyFrames().size() < 2 )
177 {
178 error = QObject::tr( "Unable to export 3D animation. Add at least 2 keyframes" );
179 return false;
180 }
181
182 const float duration = animationSettings.duration(); //in seconds
183 if ( duration <= 0 )
184 {
185 error = QObject::tr( "Unable to export 3D animation (invalid duration)." );
186 return false;
187 }
188
189 float time = 0;
190 int frameNo = 0;
191 const int totalFrames = static_cast<int>( duration * framesPerSecond );
192
193 if ( fileNameTemplate.isEmpty() )
194 {
195 error = QObject::tr( "Filename template is empty" );
196 return false;
197 }
198
199 const int numberOfDigits = fileNameTemplate.count( QLatin1Char( '#' ) );
200 if ( numberOfDigits < 0 )
201 {
202 error = QObject::tr( "Wrong filename template format (must contain #)" );
203 return false;
204 }
205 const QString token( numberOfDigits, QLatin1Char( '#' ) );
206 if ( !fileNameTemplate.contains( token ) )
207 {
208 error = QObject::tr( "Filename template must contain all # placeholders in one continuous group." );
209 return false;
210 }
211
212 if ( !QDir().exists( outputDirectory ) )
213 {
214 if ( !QDir().mkpath( outputDirectory ) )
215 {
216 error = QObject::tr( "Output directory could not be created." );
217 return false;
218 }
219 }
220
222 engine.setSize( outputSize );
223 Qgs3DMapScene *scene = new Qgs3DMapScene( mapSettings, &engine );
224 engine.setRootEntity( scene );
225 // We need to change render policy to RenderPolicy::Always, since otherwise render capture node won't work
226 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::Always );
227
228 while ( time <= duration )
229 {
230
231 if ( feedback )
232 {
233 if ( feedback->isCanceled() )
234 {
235 error = QObject::tr( "Export canceled" );
236 return false;
237 }
238 feedback->setProgress( frameNo / static_cast<double>( totalFrames ) * 100 );
239 }
240 ++frameNo;
241
242 const Qgs3DAnimationSettings::Keyframe kf = animationSettings.interpolate( time );
243 scene->cameraController()->setLookingAtPoint( kf.point, kf.dist, kf.pitch, kf.yaw );
244
245 QString fileName( fileNameTemplate );
246 const QString frameNoPaddedLeft( QStringLiteral( "%1" ).arg( frameNo, numberOfDigits, 10, QChar( '0' ) ) ); // e.g. 0001
247 fileName.replace( token, frameNoPaddedLeft );
248 const QString path = QDir( outputDirectory ).filePath( fileName );
249
250 const QImage img = Qgs3DUtils::captureSceneImage( engine, scene );
251
252 img.save( path );
253
254 time += 1.0f / static_cast<float>( framesPerSecond );
255 }
256
257 return true;
258}
259
260
261int Qgs3DUtils::maxZoomLevel( double tile0width, double tileResolution, double maxError )
262{
263 if ( maxError <= 0 || tileResolution <= 0 || tile0width <= 0 )
264 return 0; // invalid input
265
266 // derived from:
267 // tile width [map units] = tile0width / 2^zoomlevel
268 // tile error [map units] = tile width / tile resolution
269 // + re-arranging to get zoom level if we know tile error we want to get
270 const double zoomLevel = -log( tileResolution * maxError / tile0width ) / log( 2 );
271 return round( zoomLevel ); // we could use ceil() here if we wanted to always get to the desired error
272}
273
275{
276 switch ( altClamp )
277 {
279 return QStringLiteral( "absolute" );
281 return QStringLiteral( "relative" );
283 return QStringLiteral( "terrain" );
284 }
286}
287
288
290{
291 if ( str == QLatin1String( "absolute" ) )
293 else if ( str == QLatin1String( "terrain" ) )
295 else // "relative" (default)
297}
298
299
301{
302 switch ( altBind )
303 {
305 return QStringLiteral( "vertex" );
307 return QStringLiteral( "centroid" );
308 }
310}
311
312
314{
315 if ( str == QLatin1String( "vertex" ) )
317 else // "centroid" (default)
319}
320
322{
323 switch ( mode )
324 {
326 return QStringLiteral( "no-culling" );
328 return QStringLiteral( "front" );
329 case Qgs3DTypes::Back:
330 return QStringLiteral( "back" );
332 return QStringLiteral( "front-and-back" );
333 }
335}
336
338{
339 if ( str == QLatin1String( "front" ) )
340 return Qgs3DTypes::Front;
341 else if ( str == QLatin1String( "back" ) )
342 return Qgs3DTypes::Back;
343 else if ( str == QLatin1String( "front-and-back" ) )
345 else
347}
348
349float Qgs3DUtils::clampAltitude( const QgsPoint &p, Qgis::AltitudeClamping altClamp, Qgis::AltitudeBinding altBind, float offset, const QgsPoint &centroid, const Qgs3DRenderContext &context )
350{
351 float terrainZ = 0;
352 switch ( altClamp )
353 {
356 {
357 const QgsPointXY pt = altBind == Qgis::AltitudeBinding::Vertex ? p : centroid;
358 terrainZ = context.terrainRenderingEnabled() && context.terrainGenerator() ? context.terrainGenerator()->heightAt( pt.x(), pt.y(), context ) : 0;
359 break;
360 }
361
363 break;
364 }
365
366 float geomZ = 0;
367 if ( p.is3D() )
368 {
369 switch ( altClamp )
370 {
373 geomZ = p.z();
374 break;
375
377 break;
378 }
379 }
380
381 const float z = ( terrainZ + geomZ ) * static_cast<float>( context.terrainVerticalScale() ) + offset;
382 return z;
383}
384
385void Qgs3DUtils::clampAltitudes( QgsLineString *lineString, Qgis::AltitudeClamping altClamp, Qgis::AltitudeBinding altBind, const QgsPoint &centroid, float offset, const Qgs3DRenderContext &context )
386{
387 for ( int i = 0; i < lineString->nCoordinates(); ++i )
388 {
389 float terrainZ = 0;
390 switch ( altClamp )
391 {
394 {
395 QgsPointXY pt;
396 switch ( altBind )
397 {
399 pt.setX( lineString->xAt( i ) );
400 pt.setY( lineString->yAt( i ) );
401 break;
402
404 pt.set( centroid.x(), centroid.y() );
405 break;
406 }
407
408 terrainZ = context.terrainRenderingEnabled() && context.terrainGenerator() ? context.terrainGenerator()->heightAt( pt.x(), pt.y(), context ) : 0;
409 break;
410 }
411
413 break;
414 }
415
416 float geomZ = 0;
417
418 switch ( altClamp )
419 {
422 geomZ = lineString->zAt( i );
423 break;
424
426 break;
427 }
428
429 const float z = ( terrainZ + geomZ ) * static_cast<float>( context.terrainVerticalScale() ) + offset;
430 lineString->setZAt( i, z );
431 }
432}
433
434
435bool Qgs3DUtils::clampAltitudes( QgsPolygon *polygon, Qgis::AltitudeClamping altClamp, Qgis::AltitudeBinding altBind, float offset, const Qgs3DRenderContext &context )
436{
437 if ( !polygon->is3D() )
438 polygon->addZValue( 0 );
439
440 QgsPoint centroid;
441 switch ( altBind )
442 {
444 break;
445
447 centroid = polygon->centroid();
448 break;
449 }
450
451 QgsCurve *curve = const_cast<QgsCurve *>( polygon->exteriorRing() );
452 QgsLineString *lineString = qgsgeometry_cast<QgsLineString *>( curve );
453 if ( !lineString )
454 return false;
455
456 clampAltitudes( lineString, altClamp, altBind, centroid, offset, context );
457
458 for ( int i = 0; i < polygon->numInteriorRings(); ++i )
459 {
460 QgsCurve *curve = const_cast<QgsCurve *>( polygon->interiorRing( i ) );
461 QgsLineString *lineString = qgsgeometry_cast<QgsLineString *>( curve );
462 if ( !lineString )
463 return false;
464
465 clampAltitudes( lineString, altClamp, altBind, centroid, offset, context );
466 }
467 return true;
468}
469
470
471QString Qgs3DUtils::matrix4x4toString( const QMatrix4x4 &m )
472{
473 const float *d = m.constData();
474 QStringList elems;
475 elems.reserve( 16 );
476 for ( int i = 0; i < 16; ++i )
477 elems << QString::number( d[i] );
478 return elems.join( ' ' );
479}
480
481QMatrix4x4 Qgs3DUtils::stringToMatrix4x4( const QString &str )
482{
483 QMatrix4x4 m;
484 float *d = m.data();
485 QStringList elems = str.split( ' ' );
486 for ( int i = 0; i < 16; ++i )
487 d[i] = elems[i].toFloat();
488 return m;
489}
490
491void Qgs3DUtils::extractPointPositions( const QgsFeature &f, const Qgs3DRenderContext &context, Qgis::AltitudeClamping altClamp, QVector<QVector3D> &positions )
492{
493 const QgsAbstractGeometry *g = f.geometry().constGet();
494 for ( auto it = g->vertices_begin(); it != g->vertices_end(); ++it )
495 {
496 const QgsPoint pt = *it;
497 float geomZ = 0;
498 if ( pt.is3D() )
499 {
500 geomZ = pt.z();
501 }
502 const float terrainZ = context.terrainRenderingEnabled() && context.terrainGenerator() ? context.terrainGenerator()->heightAt( pt.x(), pt.y(), context ) * context.terrainVerticalScale() : 0;
503 float h = 0.0f;
504 switch ( altClamp )
505 {
507 h = geomZ;
508 break;
510 h = terrainZ;
511 break;
513 h = terrainZ + geomZ;
514 break;
515 }
516 positions.append( QVector3D( pt.x() - context.origin().x(), h, -( pt.y() - context.origin().y() ) ) );
517 QgsDebugMsgLevel( QStringLiteral( "%1 %2 %3" ).arg( positions.last().x() ).arg( positions.last().y() ).arg( positions.last().z() ), 2 );
518 }
519}
520
526static inline uint outcode( QVector4D v )
527{
528 // For a discussion of outcodes see pg 388 Dunn & Parberry.
529 // For why you can't just test if the point is in a bounding box
530 // consider the case where a view frustum with view-size 1.5 x 1.5
531 // is tested against a 2x2 box which encloses the near-plane, while
532 // all the points in the box are outside the frustum.
533 // TODO: optimise this with assembler - according to D&P this can
534 // be done in one line of assembler on some platforms
535 uint code = 0;
536 if ( v.x() < -v.w() ) code |= 0x01;
537 if ( v.x() > v.w() ) code |= 0x02;
538 if ( v.y() < -v.w() ) code |= 0x04;
539 if ( v.y() > v.w() ) code |= 0x08;
540 if ( v.z() < -v.w() ) code |= 0x10;
541 if ( v.z() > v.w() ) code |= 0x20;
542 return code;
543}
544
545
556bool Qgs3DUtils::isCullable( const QgsAABB &bbox, const QMatrix4x4 &viewProjectionMatrix )
557{
558 uint out = 0xff;
559
560 for ( int i = 0; i < 8; ++i )
561 {
562 const QVector4D p( ( ( i >> 0 ) & 1 ) ? bbox.xMin : bbox.xMax,
563 ( ( i >> 1 ) & 1 ) ? bbox.yMin : bbox.yMax,
564 ( ( i >> 2 ) & 1 ) ? bbox.zMin : bbox.zMax, 1 );
565 const QVector4D pc = viewProjectionMatrix * p;
566
567 // if the logical AND of all the outcodes is non-zero then the BB is
568 // definitely outside the view frustum.
569 out = out & outcode( pc );
570 }
571 return out;
572}
573
575{
576 return QgsVector3D( mapCoords.x() - origin.x(),
577 mapCoords.z() - origin.z(),
578 -( mapCoords.y() - origin.y() ) );
579
580}
581
583{
584 return QgsVector3D( worldCoords.x() + origin.x(),
585 -worldCoords.z() + origin.y(),
586 worldCoords.y() + origin.z() );
587}
588
590{
591 QgsRectangle extentMapCrs( extent );
592 if ( crs1 != crs2 )
593 {
594 // reproject if necessary
595 QgsCoordinateTransform ct( crs1, crs2, context );
597 try
598 {
599 extentMapCrs = ct.transformBoundingBox( extentMapCrs );
600 }
601 catch ( const QgsCsException & )
602 {
603 // bad luck, can't reproject for some reason
604 QgsDebugError( QStringLiteral( "3D utils: transformation of extent failed: " ) + extentMapCrs.toString( -1 ) );
605 }
606 }
607 return extentMapCrs;
608}
609
610QgsAABB Qgs3DUtils::layerToWorldExtent( const QgsRectangle &extent, double zMin, double zMax, const QgsCoordinateReferenceSystem &layerCrs, const QgsVector3D &mapOrigin, const QgsCoordinateReferenceSystem &mapCrs, const QgsCoordinateTransformContext &context )
611{
612 const QgsRectangle extentMapCrs( Qgs3DUtils::tryReprojectExtent2D( extent, layerCrs, mapCrs, context ) );
613 return mapToWorldExtent( extentMapCrs, zMin, zMax, mapOrigin );
614}
615
617{
618 const QgsRectangle extentMap = worldToMapExtent( bbox, mapOrigin );
619 return Qgs3DUtils::tryReprojectExtent2D( extentMap, mapCrs, layerCrs, context );
620}
621
622QgsAABB Qgs3DUtils::mapToWorldExtent( const QgsRectangle &extent, double zMin, double zMax, const QgsVector3D &mapOrigin )
623{
624 const QgsVector3D extentMin3D( extent.xMinimum(), extent.yMinimum(), zMin );
625 const QgsVector3D extentMax3D( extent.xMaximum(), extent.yMaximum(), zMax );
626 const QgsVector3D worldExtentMin3D = mapToWorldCoordinates( extentMin3D, mapOrigin );
627 const QgsVector3D worldExtentMax3D = mapToWorldCoordinates( extentMax3D, mapOrigin );
628 QgsAABB rootBbox( worldExtentMin3D.x(), worldExtentMin3D.y(), worldExtentMin3D.z(),
629 worldExtentMax3D.x(), worldExtentMax3D.y(), worldExtentMax3D.z() );
630 return rootBbox;
631}
632
634{
635 const QgsVector3D worldExtentMin3D = Qgs3DUtils::worldToMapCoordinates( QgsVector3D( bbox.xMin, bbox.yMin, bbox.zMin ), mapOrigin );
636 const QgsVector3D worldExtentMax3D = Qgs3DUtils::worldToMapCoordinates( QgsVector3D( bbox.xMax, bbox.yMax, bbox.zMax ), mapOrigin );
637 const QgsRectangle extentMap( worldExtentMin3D.x(), worldExtentMin3D.y(), worldExtentMax3D.x(), worldExtentMax3D.y() );
638 // we discard zMin/zMax here because we don't need it
639 return extentMap;
640}
641
642
644{
645 const QgsVector3D mapPoint1 = worldToMapCoordinates( worldPoint1, origin1 );
646 QgsVector3D mapPoint2 = mapPoint1;
647 if ( crs1 != crs2 )
648 {
649 // reproject if necessary
650 const QgsCoordinateTransform ct( crs1, crs2, context );
651 try
652 {
653 const QgsPointXY pt = ct.transform( QgsPointXY( mapPoint1.x(), mapPoint1.y() ) );
654 mapPoint2.set( pt.x(), pt.y(), mapPoint1.z() );
655 }
656 catch ( const QgsCsException & )
657 {
658 // bad luck, can't reproject for some reason
659 }
660 }
661 return mapToWorldCoordinates( mapPoint2, origin2 );
662}
663
664void Qgs3DUtils::estimateVectorLayerZRange( QgsVectorLayer *layer, double &zMin, double &zMax )
665{
666 if ( !QgsWkbTypes::hasZ( layer->wkbType() ) )
667 {
668 zMin = 0;
669 zMax = 0;
670 return;
671 }
672
673 zMin = std::numeric_limits<double>::max();
674 zMax = std::numeric_limits<double>::lowest();
675
676 QgsFeature f;
677 QgsFeatureIterator it = layer->getFeatures( QgsFeatureRequest().setNoAttributes().setLimit( 100 ) );
678 while ( it.nextFeature( f ) )
679 {
680 const QgsGeometry g = f.geometry();
681 for ( auto vit = g.vertices_begin(); vit != g.vertices_end(); ++vit )
682 {
683 const double z = ( *vit ).z();
684 if ( z < zMin ) zMin = z;
685 if ( z > zMax ) zMax = z;
686 }
687 }
688
689 if ( zMin == std::numeric_limits<double>::max() && zMax == std::numeric_limits<double>::lowest() )
690 {
691 zMin = 0;
692 zMax = 0;
693 }
694}
695
704
706{
708 settings.setAmbient( material->ambient() );
709 settings.setDiffuse( material->diffuse() );
710 settings.setSpecular( material->specular() );
711 settings.setShininess( material->shininess() );
712 return settings;
713}
714
715QgsRay3D Qgs3DUtils::rayFromScreenPoint( const QPoint &point, const QSize &windowSize, Qt3DRender::QCamera *camera )
716{
717 const QVector3D deviceCoords( point.x(), point.y(), 0.0 );
718 // normalized device coordinates
719 const QVector3D normDeviceCoords( 2.0 * deviceCoords.x() / windowSize.width() - 1.0f, 1.0f - 2.0 * deviceCoords.y() / windowSize.height(), camera->nearPlane() );
720 // clip coordinates
721 const QVector4D rayClip( normDeviceCoords.x(), normDeviceCoords.y(), -1.0, 0.0 );
722
723 const QMatrix4x4 invertedProjMatrix = camera->projectionMatrix().inverted();
724 const QMatrix4x4 invertedViewMatrix = camera->viewMatrix().inverted();
725
726 // ray direction in view coordinates
727 QVector4D rayDirView = invertedProjMatrix * rayClip;
728 // ray origin in world coordinates
729 const QVector4D rayOriginWorld = invertedViewMatrix * QVector4D( 0.0f, 0.0f, 0.0f, 1.0f );
730
731 // ray direction in world coordinates
732 rayDirView.setZ( -1.0f );
733 rayDirView.setW( 0.0f );
734 const QVector4D rayDirWorld4D = invertedViewMatrix * rayDirView;
735 QVector3D rayDirWorld( rayDirWorld4D.x(), rayDirWorld4D.y(), rayDirWorld4D.z() );
736 rayDirWorld = rayDirWorld.normalized();
737
738 return QgsRay3D( QVector3D( rayOriginWorld ), rayDirWorld );
739}
740
741QVector3D Qgs3DUtils::screenPointToWorldPos( const QPoint &screenPoint, double depth, const QSize &screenSize, Qt3DRender::QCamera *camera )
742{
743 double dNear = camera->nearPlane();
744 double dFar = camera->farPlane();
745 double distance = ( 2.0 * dNear * dFar ) / ( dFar + dNear - ( depth * 2 - 1 ) * ( dFar - dNear ) );
746
747 QgsRay3D ray = Qgs3DUtils::rayFromScreenPoint( screenPoint, screenSize, camera );
748 double dot = QVector3D::dotProduct( ray.direction(), camera->viewVector().normalized() );
749 distance /= dot;
750
751 return ray.origin() + distance * ray.direction();
752}
753
754void Qgs3DUtils::pitchAndYawFromViewVector( QVector3D vect, double &pitch, double &yaw )
755{
756 vect.normalize();
757
758 pitch = qRadiansToDegrees( qAcos( vect.y() ) );
759 yaw = qRadiansToDegrees( qAtan2( -vect.z(), vect.x() ) ) + 90;
760}
761
762QVector2D Qgs3DUtils::screenToTextureCoordinates( QVector2D screenXY, QSize winSize )
763{
764 return QVector2D( screenXY.x() / winSize.width(), 1 - screenXY.y() / winSize.width() );
765}
766
767QVector2D Qgs3DUtils::textureToScreenCoordinates( QVector2D textureXY, QSize winSize )
768{
769 return QVector2D( textureXY.x() * winSize.width(), ( 1 - textureXY.y() ) * winSize.height() );
770}
771
772std::unique_ptr<QgsPointCloudLayer3DRenderer> Qgs3DUtils::convert2DPointCloudRendererTo3D( QgsPointCloudRenderer *renderer )
773{
774 if ( !renderer )
775 return nullptr;
776
777 std::unique_ptr< QgsPointCloud3DSymbol > symbol3D;
778 if ( renderer->type() == QLatin1String( "ramp" ) )
779 {
780 const QgsPointCloudAttributeByRampRenderer *renderer2D = dynamic_cast< const QgsPointCloudAttributeByRampRenderer * >( renderer );
781 symbol3D = std::make_unique< QgsColorRampPointCloud3DSymbol >();
782 QgsColorRampPointCloud3DSymbol *symbol = static_cast< QgsColorRampPointCloud3DSymbol * >( symbol3D.get() );
783 symbol->setAttribute( renderer2D->attribute() );
784 symbol->setColorRampShaderMinMax( renderer2D->minimum(), renderer2D->maximum() );
785 symbol->setColorRampShader( renderer2D->colorRampShader() );
786 }
787 else if ( renderer->type() == QLatin1String( "rgb" ) )
788 {
789 const QgsPointCloudRgbRenderer *renderer2D = dynamic_cast< const QgsPointCloudRgbRenderer * >( renderer );
790 symbol3D = std::make_unique< QgsRgbPointCloud3DSymbol >();
791 QgsRgbPointCloud3DSymbol *symbol = static_cast< QgsRgbPointCloud3DSymbol * >( symbol3D.get() );
792 symbol->setRedAttribute( renderer2D->redAttribute() );
793 symbol->setGreenAttribute( renderer2D->greenAttribute() );
794 symbol->setBlueAttribute( renderer2D->blueAttribute() );
795
796 symbol->setRedContrastEnhancement( renderer2D->redContrastEnhancement() ? new QgsContrastEnhancement( *renderer2D->redContrastEnhancement() ) : nullptr );
797 symbol->setGreenContrastEnhancement( renderer2D->greenContrastEnhancement() ? new QgsContrastEnhancement( *renderer2D->greenContrastEnhancement() ) : nullptr );
798 symbol->setBlueContrastEnhancement( renderer2D->blueContrastEnhancement() ? new QgsContrastEnhancement( *renderer2D->blueContrastEnhancement() ) : nullptr );
799 }
800 else if ( renderer->type() == QLatin1String( "classified" ) )
801 {
802
803 const QgsPointCloudClassifiedRenderer *renderer2D = dynamic_cast< const QgsPointCloudClassifiedRenderer * >( renderer );
804 symbol3D = std::make_unique< QgsClassificationPointCloud3DSymbol >();
805 QgsClassificationPointCloud3DSymbol *symbol = static_cast< QgsClassificationPointCloud3DSymbol * >( symbol3D.get() );
806 symbol->setAttribute( renderer2D->attribute() );
807 symbol->setCategoriesList( renderer2D->categories() );
808 }
809
810 if ( symbol3D )
811 {
812 std::unique_ptr< QgsPointCloudLayer3DRenderer > renderer3D = std::make_unique< QgsPointCloudLayer3DRenderer >();
813 renderer3D->setSymbol( symbol3D.release() );
814 return renderer3D;
815 }
816 return nullptr;
817}
818
819QHash<QgsMapLayer *, QVector<QgsRayCastingUtils::RayHit>> Qgs3DUtils::castRay( Qgs3DMapScene *scene, const QgsRay3D &ray, const QgsRayCastingUtils::RayCastContext &context )
820{
821 QgsRayCastingUtils::Ray3D r( ray.origin(), ray.direction(), context.maxDistance );
822 QHash<QgsMapLayer *, QVector<QgsRayCastingUtils:: RayHit>> results;
823 const QList<QgsMapLayer *> keys = scene->layers();
824 for ( QgsMapLayer *layer : keys )
825 {
826 Qt3DCore::QEntity *entity = scene->layerEntity( layer );
827
828 if ( QgsChunkedEntity *chunkedEntity = qobject_cast<QgsChunkedEntity *>( entity ) )
829 {
830 const QVector<QgsRayCastingUtils::RayHit> result = chunkedEntity->rayIntersection( r, context );
831 if ( !result.isEmpty() )
832 results[ layer ] = result;
833 }
834 }
835 if ( QgsTerrainEntity *terrain = scene->terrainEntity() )
836 {
837 const QVector<QgsRayCastingUtils::RayHit> result = terrain->rayIntersection( r, context );
838 if ( !result.isEmpty() )
839 results[ nullptr ] = result; // Terrain hits are not tied to a layer so we use nullptr as their key here
840 }
841 return results;
842}
843
844float Qgs3DUtils::screenSpaceError( float epsilon, float distance, int screenSize, float fov )
845{
846 /* This routine approximately calculates how an error (epsilon) of an object in world coordinates
847 * at given distance (between camera and the object) will look like in screen coordinates.
848 *
849 * the math below simply uses triangle similarity:
850 *
851 * epsilon phi
852 * ----------------------------- = ----------------
853 * [ frustum width at distance ] [ screen width ]
854 *
855 * Then we solve for phi, substituting [frustum width at distance] = 2 * distance * tan(fov / 2)
856 *
857 * ________xxx__ xxx = real world error (epsilon)
858 * \ | / x = screen space error (phi)
859 * \ | /
860 * \___|_x_/ near plane (screen space)
861 * \ | /
862 * \ | /
863 * \|/ angle = field of view
864 * camera
865 */
866 float phi = epsilon * static_cast<float>( screenSize ) / static_cast<float>( 2 * distance * tan( fov * M_PI / ( 2 * 180 ) ) );
867 return phi;
868}
869
870void Qgs3DUtils::computeBoundingBoxNearFarPlanes( const QgsAABB &bbox, const QMatrix4x4 &viewMatrix, float &fnear, float &ffar )
871{
872 fnear = 1e9;
873 ffar = 0;
874
875 for ( int i = 0; i < 8; ++i )
876 {
877 const QVector4D p( ( ( i >> 0 ) & 1 ) ? bbox.xMin : bbox.xMax,
878 ( ( i >> 1 ) & 1 ) ? bbox.yMin : bbox.yMax,
879 ( ( i >> 2 ) & 1 ) ? bbox.zMin : bbox.zMax, 1 );
880
881 const QVector4D pc = viewMatrix * p;
882
883 const float dst = -pc.z(); // in camera coordinates, x grows right, y grows down, z grows to the back
884 fnear = std::min( fnear, dst );
885 ffar = std::max( ffar, dst );
886 }
887}
888
889Qt3DRender::QCullFace::CullingMode Qgs3DUtils::qt3DcullingMode( Qgs3DTypes::CullingMode mode )
890{
891 switch ( mode )
892 {
893 case Qgs3DTypes::NoCulling: return Qt3DRender::QCullFace::NoCulling;
894 case Qgs3DTypes::Front: return Qt3DRender::QCullFace::Front;
895 case Qgs3DTypes::Back: return Qt3DRender::QCullFace::Back;
896 case Qgs3DTypes::FrontAndBack: return Qt3DRender::QCullFace::FrontAndBack;
897 }
898 return Qt3DRender::QCullFace::NoCulling;
899}
900
901
902QByteArray Qgs3DUtils::addDefinesToShaderCode( const QByteArray &shaderCode, const QStringList &defines )
903{
904 // There is one caveat to take care of - GLSL source code needs to start with #version as
905 // a first directive, otherwise we get the old GLSL 100 version. So we can't just prepend the
906 // shader source code, but insert our defines at the right place.
907
908 QStringList defineLines;
909 for ( const QString &define : defines )
910 defineLines += "#define " + define + "\n";
911
912 QString definesText = defineLines.join( QString() );
913
914 QByteArray newShaderCode = shaderCode;
915 int versionIndex = shaderCode.indexOf( "#version " );
916 int insertionIndex = versionIndex == -1 ? 0 : shaderCode.indexOf( '\n', versionIndex + 1 ) + 1;
917 newShaderCode.insert( insertionIndex, definesText.toLatin1() );
918 return newShaderCode;
919}
AltitudeClamping
Altitude clamping.
Definition qgis.h:3671
@ Relative
Elevation is relative to terrain height (final elevation = terrain elevation + feature elevation)
@ Terrain
Elevation is clamped to terrain (final elevation = terrain elevation)
@ Absolute
Elevation is taken directly from feature and is independent of terrain height (final elevation = feat...
AltitudeBinding
Altitude binding.
Definition qgis.h:3684
@ Centroid
Clamp just centroid of feature.
@ Vertex
Clamp every vertex of feature.
Keyframe interpolate(float time) const
Interpolates camera position and rotation at the given point in time.
float duration() const
Returns duration of the whole animation in seconds.
Keyframes keyFrames() const
Returns keyframes of the animation.
QgsCameraController * cameraController() const
Returns camera controller.
@ Ready
The scene is fully loaded/updated.
QgsTerrainEntity * terrainEntity()
Returns terrain entity (may be temporarily nullptr)
Qt3DCore::QEntity * layerEntity(QgsMapLayer *layer) const
Returns the entity belonging to layer.
void sceneStateChanged()
Emitted when the scene's state has changed.
SceneState sceneState() const
Returns the current state of the scene.
QList< QgsMapLayer * > layers() const
Returns the layers that contain chunked entities.
QgsTerrainGenerator * terrainGenerator() const
Returns the terrain generator.
QgsVector3D origin() const
Returns coordinates in map CRS at which 3D scene has origin (0,0,0)
bool terrainRenderingEnabled() const
Returns whether the 2D terrain surface will be rendered.
double terrainVerticalScale() const
Returns vertical scale (exaggeration) of terrain.
static const char * PROP_NAME_3D_RENDERER_FLAG
Qt property name to hold the 3D geometry renderer flag.
Definition qgs3dtypes.h:44
CullingMode
Triangle culling mode.
Definition qgs3dtypes.h:36
@ FrontAndBack
Will not render anything.
Definition qgs3dtypes.h:40
@ NoCulling
Will render both front and back faces of triangles.
Definition qgs3dtypes.h:37
@ Front
Will render only back faces of triangles.
Definition qgs3dtypes.h:38
@ Back
Will render only front faces of triangles (recommended when input data are consistent)
Definition qgs3dtypes.h:39
static QgsVector3D transformWorldCoordinates(const QgsVector3D &worldPoint1, const QgsVector3D &origin1, const QgsCoordinateReferenceSystem &crs1, const QgsVector3D &origin2, const QgsCoordinateReferenceSystem &crs2, const QgsCoordinateTransformContext &context)
Transforms a world point from (origin1, crs1) to (origin2, crs2)
static Qt3DRender::QCullFace::CullingMode qt3DcullingMode(Qgs3DTypes::CullingMode mode)
Converts Qgs3DTypes::CullingMode mode into its Qt3D equivalent.
static Qgs3DTypes::CullingMode cullingModeFromString(const QString &str)
Converts a string to a value from CullingMode enum.
static Qgis::AltitudeClamping altClampingFromString(const QString &str)
Converts a string to a value from AltitudeClamping enum.
static QString matrix4x4toString(const QMatrix4x4 &m)
Converts a 4x4 transform matrix to a string.
static QgsRectangle worldToMapExtent(const QgsAABB &bbox, const QgsVector3D &mapOrigin)
Converts axis aligned bounding box in 3D world coordinates to extent in map coordinates.
static QgsRectangle worldToLayerExtent(const QgsAABB &bbox, const QgsCoordinateReferenceSystem &layerCrs, const QgsVector3D &mapOrigin, const QgsCoordinateReferenceSystem &mapCrs, const QgsCoordinateTransformContext &context)
Converts axis aligned bounding box in 3D world coordinates to extent in map layer CRS.
static void pitchAndYawFromViewVector(QVector3D vect, double &pitch, double &yaw)
Function used to extract the pitch and yaw (also known as heading) angles in degrees from the view ve...
static int maxZoomLevel(double tile0width, double tileResolution, double maxError)
Calculates the highest needed zoom level for tiles in quad-tree given width of the base tile (zoom le...
static QgsAABB mapToWorldExtent(const QgsRectangle &extent, double zMin, double zMax, const QgsVector3D &mapOrigin)
Converts map extent to axis aligned bounding box in 3D world coordinates.
static QgsAABB layerToWorldExtent(const QgsRectangle &extent, double zMin, double zMax, const QgsCoordinateReferenceSystem &layerCrs, const QgsVector3D &mapOrigin, const QgsCoordinateReferenceSystem &mapCrs, const QgsCoordinateTransformContext &context)
Converts extent (in map layer's CRS) to axis aligned bounding box in 3D world coordinates.
static Qgis::AltitudeBinding altBindingFromString(const QString &str)
Converts a string to a value from AltitudeBinding enum.
static double calculateEntityGpuMemorySize(Qt3DCore::QEntity *entity)
Calculates approximate usage of GPU memory by an entity.
static QString cullingModeToString(Qgs3DTypes::CullingMode mode)
Converts a value from CullingMode enum to a string.
static QHash< QgsMapLayer *, QVector< QgsRayCastingUtils::RayHit > > castRay(Qgs3DMapScene *scene, const QgsRay3D &ray, const QgsRayCastingUtils::RayCastContext &context)
Casts a ray through the scene and returns information about the intersecting entities (ray uses World...
static bool isCullable(const QgsAABB &bbox, const QMatrix4x4 &viewProjectionMatrix)
Returns true if bbox is completely outside the current viewing volume.
static QVector2D screenToTextureCoordinates(QVector2D screenXY, QSize winSize)
Converts from screen coordinates to texture coordinates.
static float screenSpaceError(float epsilon, float distance, int screenSize, float fov)
This routine approximately calculates how an error (epsilon) of an object in world coordinates at giv...
static void estimateVectorLayerZRange(QgsVectorLayer *layer, double &zMin, double &zMax)
Try to estimate range of Z values used in the given vector layer and store that in zMin and zMax.
static QgsPhongMaterialSettings phongMaterialFromQt3DComponent(Qt3DExtras::QPhongMaterial *material)
Returns phong material settings object based on the Qt3D material.
static QString altClampingToString(Qgis::AltitudeClamping altClamp)
Converts a value from AltitudeClamping enum to a string.
static QgsRectangle tryReprojectExtent2D(const QgsRectangle &extent, const QgsCoordinateReferenceSystem &crs1, const QgsCoordinateReferenceSystem &crs2, const QgsCoordinateTransformContext &context)
Reprojects extent from crs1 to crs2 coordinate reference system with context context.
static QByteArray addDefinesToShaderCode(const QByteArray &shaderCode, const QStringList &defines)
Inserts some define macros into a shader source code.
static QMatrix4x4 stringToMatrix4x4(const QString &str)
Convert a string to a 4x4 transform matrix.
static QgsVector3D worldToMapCoordinates(const QgsVector3D &worldCoords, const QgsVector3D &origin)
Converts 3D world coordinates to map coordinates (applies offset and turns (x,y,z) into (x,...
static QgsVector3D mapToWorldCoordinates(const QgsVector3D &mapCoords, const QgsVector3D &origin)
Converts map coordinates to 3D world coordinates (applies offset and turns (x,y,z) into (x,...
static QVector2D textureToScreenCoordinates(QVector2D textureXY, QSize winSize)
Converts from texture coordinates coordinates to screen coordinates.
static void computeBoundingBoxNearFarPlanes(const QgsAABB &bbox, const QMatrix4x4 &viewMatrix, float &fnear, float &ffar)
This routine computes nearPlane farPlane from the closest and farthest corners point of bounding box ...
static bool exportAnimation(const Qgs3DAnimationSettings &animationSettings, Qgs3DMapSettings &mapSettings, int framesPerSecond, const QString &outputDirectory, const QString &fileNameTemplate, const QSize &outputSize, QString &error, QgsFeedback *feedback=nullptr)
Captures 3D animation frames to the selected folder.
static QVector3D screenPointToWorldPos(const QPoint &screenPoint, double depth, const QSize &screenSize, Qt3DRender::QCamera *camera)
Converts the clicked mouse position to the corresponding 3D world coordinates.
static float clampAltitude(const QgsPoint &p, Qgis::AltitudeClamping altClamp, Qgis::AltitudeBinding altBind, float offset, const QgsPoint &centroid, const Qgs3DRenderContext &context)
Clamps altitude of a vertex according to the settings, returns Z value.
static QString altBindingToString(Qgis::AltitudeBinding altBind)
Converts a value from AltitudeBinding enum to a string.
static void clampAltitudes(QgsLineString *lineString, Qgis::AltitudeClamping altClamp, Qgis::AltitudeBinding altBind, const QgsPoint &centroid, float offset, const Qgs3DRenderContext &context)
Clamps altitude of vertices of a linestring according to the settings.
static void extractPointPositions(const QgsFeature &f, const Qgs3DRenderContext &context, Qgis::AltitudeClamping altClamp, QVector< QVector3D > &positions)
Calculates (x,y,z) positions of (multi)point from the given feature.
static QgsRay3D rayFromScreenPoint(const QPoint &point, const QSize &windowSize, Qt3DRender::QCamera *camera)
Convert from clicked point on the screen to a ray in world coordinates.
static QImage captureSceneImage(QgsAbstract3DEngine &engine, Qgs3DMapScene *scene)
Captures image of the current 3D scene of a 3D engine.
static std::unique_ptr< QgsPointCloudLayer3DRenderer > convert2DPointCloudRendererTo3D(QgsPointCloudRenderer *renderer)
Creates a QgsPointCloudLayer3DRenderer matching the symbol settings of a given QgsPointCloudRenderer.
static QImage captureSceneDepthBuffer(QgsAbstract3DEngine &engine, Qgs3DMapScene *scene)
Captures the depth buffer of the current 3D scene of a 3D engine.
static QgsExpressionContext globalProjectLayerExpressionContext(QgsVectorLayer *layer)
Returns expression context for use in preparation of 3D data of a layer.
float yMax
Definition qgsaabb.h:90
float xMax
Definition qgsaabb.h:89
float xMin
Definition qgsaabb.h:86
float zMax
Definition qgsaabb.h:91
float yMin
Definition qgsaabb.h:87
float zMin
Definition qgsaabb.h:88
void requestCaptureImage()
Starts a request for an image rendered by the engine.
void requestDepthBufferCapture()
Starts a request for an image containing the depth buffer data of the engine.
void imageCaptured(const QImage &image)
Emitted after a call to requestCaptureImage() to return the captured image.
void depthBufferCaptured(const QImage &image)
Emitted after a call to requestDepthBufferCapture() to return the captured depth buffer.
virtual Qt3DRender::QRenderSettings * renderSettings()=0
Returns access to the engine's render settings (the frame graph can be accessed from here)
Abstract base class for all geometries.
vertex_iterator vertices_end() const
Returns STL-style iterator pointing to the imaginary vertex after the last vertex of the geometry.
bool is3D() const
Returns true if the geometry is 3D and contains a z-value.
vertex_iterator vertices_begin() const
Returns STL-style iterator pointing to the first vertex of the geometry.
virtual QgsPoint centroid() const
Returns the centroid of the geometry.
void setLookingAtPoint(const QgsVector3D &point, float distance, float pitch, float yaw)
Sets the complete camera configuration: the point towards it is looking (in 3D world coordinates),...
void setCategoriesList(const QgsPointCloudCategoryList &categories)
Sets the list of categories of the classification.
void setAttribute(const QString &attribute)
Sets the attribute used to select the color of the point cloud.
void setAttribute(const QString &attribute)
Sets the attribute used to select the color of the point cloud.
void setColorRampShaderMinMax(double min, double max)
Sets the minimum and maximum values used when classifying colors in the color ramp shader.
void setColorRampShader(const QgsColorRampShader &colorRampShader)
Sets the color ramp shader used to render the point cloud.
Manipulates raster or point cloud pixel values so that they enhanceContrast or clip into a specified ...
This class represents a coordinate reference system (CRS).
Contains information about the context in which a coordinate transform is executed.
Class for doing transforms between two map coordinate systems.
void setBallparkTransformsAreAppropriate(bool appropriate)
Sets whether approximate "ballpark" results are appropriate for this coordinate transform.
QgsPointXY transform(const QgsPointXY &point, Qgis::TransformDirection direction=Qgis::TransformDirection::Forward) const
Transform the point from the source CRS to the destination CRS.
QgsRectangle transformBoundingBox(const QgsRectangle &rectangle, Qgis::TransformDirection direction=Qgis::TransformDirection::Forward, bool handle180Crossover=false) const
Transforms a rectangle from the source CRS to the destination CRS.
Custom exception class for Coordinate Reference System related exceptions.
int numInteriorRings() const
Returns the number of interior rings contained with the curve polygon.
bool addZValue(double zValue=0) override
Adds a z-dimension to the geometry, initialized to a preset value.
const QgsCurve * exteriorRing() const
Returns the curve polygon's exterior ring.
const QgsCurve * interiorRing(int i) const
Retrieves an interior ring from the curve polygon.
Abstract base class for curved geometry type.
Definition qgscurve.h:35
static QgsExpressionContextScope * projectScope(const QgsProject *project)
Creates a new scope which contains variables and functions relating to a QGIS project.
static QgsExpressionContextScope * layerScope(const QgsMapLayer *layer)
Creates a new scope which contains variables and functions relating to a QgsMapLayer.
static QgsExpressionContextScope * globalScope()
Creates a new scope which contains variables and functions relating to the global QGIS context.
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
Wrapper for iterator of features from vector data provider or vector layer.
bool nextFeature(QgsFeature &f)
Fetch next feature and stores in f, returns true on success.
This class wraps a request for features to a vector layer (or directly its vector data provider).
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:58
QgsGeometry geometry
Definition qgsfeature.h:69
Base class for feedback objects to be used for cancellation of something running in a worker thread.
Definition qgsfeedback.h:44
bool isCanceled() const
Tells whether the operation has been canceled already.
Definition qgsfeedback.h:53
void setProgress(double progress)
Sets the current progress for the feedback object.
Definition qgsfeedback.h:61
A geometry is the spatial representation of a feature.
const QgsAbstractGeometry * constGet() const
Returns a non-modifiable (const) reference to the underlying abstract geometry primitive.
QgsAbstractGeometry::vertex_iterator vertices_begin() const
Returns STL-style iterator pointing to the first vertex of the geometry.
QgsAbstractGeometry::vertex_iterator vertices_end() const
Returns STL-style iterator pointing to the imaginary vertex after the last vertex of the geometry.
Line string geometry type, with support for z-dimension and m-values.
int nCoordinates() const override
Returns the number of nodes contained in the geometry.
double yAt(int index) const override
Returns the y-coordinate of the specified node in the line string.
void setZAt(int index, double z)
Sets the z-coordinate of the specified node in the line string.
double zAt(int index) const override
Returns the z-coordinate of the specified node in the line string.
double xAt(int index) const override
Returns the x-coordinate of the specified node in the line string.
Base class for all map layer types.
Definition qgsmaplayer.h:76
void setSize(QSize s) override
Sets the size of the rendering area (in pixels)
void setRootEntity(Qt3DCore::QEntity *root) override
Sets root entity of the 3D scene.
Qt3DRender::QRenderSettings * renderSettings() override
Returns access to the engine's render settings (the frame graph can be accessed from here)
void setDiffuse(const QColor &diffuse)
Sets diffuse color component.
void setShininess(double shininess)
Sets shininess of the surface.
void setAmbient(const QColor &ambient)
Sets ambient color component.
void setSpecular(const QColor &specular)
Sets specular color component.
An RGB renderer for 2d visualisation of point clouds using embedded red, green and blue attributes.
double maximum() const
Returns the maximum value for attributes which will be used by the color ramp shader.
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.
Renders point clouds by a classification attribute.
QString attribute() const
Returns the attribute to use for the renderer.
QgsPointCloudCategoryList categories() const
Returns the classification categories used for rendering.
Abstract base class for 2d point cloud renderers.
virtual QString type() const =0
Returns the identifier of the renderer type.
An RGB renderer for 2d visualisation of point clouds using embedded red, green and blue attributes.
QString redAttribute() const
Returns the attribute to use for the red channel.
QString greenAttribute() const
Returns the attribute to use for the green channel.
const QgsContrastEnhancement * greenContrastEnhancement() const
Returns the contrast enhancement to use for the green channel.
QString blueAttribute() const
Returns the attribute to use for the blue channel.
const QgsContrastEnhancement * blueContrastEnhancement() const
Returns the contrast enhancement to use for the blue channel.
const QgsContrastEnhancement * redContrastEnhancement() const
Returns the contrast enhancement to use for the red channel.
A class to represent a 2D point.
Definition qgspointxy.h:60
void setY(double y)
Sets the y value of the point.
Definition qgspointxy.h:129
void set(double x, double y)
Sets the x and y value of the point.
Definition qgspointxy.h:136
double y
Definition qgspointxy.h:64
double x
Definition qgspointxy.h:63
void setX(double x)
Sets the x value of the point.
Definition qgspointxy.h:119
Point geometry type, with support for z-dimension and m-values.
Definition qgspoint.h:49
double z
Definition qgspoint.h:54
double x
Definition qgspoint.h:52
double y
Definition qgspoint.h:53
Polygon geometry type.
Definition qgspolygon.h:33
static QgsProject * instance()
Returns the QgsProject singleton instance.
A representation of a ray in 3D.
Definition qgsray3d.h:31
QVector3D origin() const
Returns the origin of the ray.
Definition qgsray3d.h:44
QVector3D direction() const
Returns the direction of the ray see setDirection()
Definition qgsray3d.h:50
A rectangle specified with double values.
QString toString(int precision=16) const
Returns a string representation of form xmin,ymin : xmax,ymax Coordinates will be truncated to the sp...
double xMinimum() const
Returns the x minimum value (left side of rectangle).
double yMinimum() const
Returns the y minimum value (bottom side of rectangle).
double xMaximum() const
Returns the x maximum value (right side of rectangle).
double yMaximum() const
Returns the y maximum value (top side of rectangle).
void setBlueAttribute(const QString &attribute)
Sets the attribute to use for the blue channel.
void setGreenContrastEnhancement(QgsContrastEnhancement *enhancement SIP_TRANSFER)
Sets the contrast enhancement to use for the green channel.
void setGreenAttribute(const QString &attribute)
Sets the attribute to use for the green channel.
void setBlueContrastEnhancement(QgsContrastEnhancement *enhancement SIP_TRANSFER)
Sets the contrast enhancement to use for the blue channel.
void setRedContrastEnhancement(QgsContrastEnhancement *enhancement SIP_TRANSFER)
Sets the contrast enhancement to use for the red channel.
void setRedAttribute(const QString &attribute)
Sets the attribute to use for the red channel.
virtual float heightAt(double x, double y, const Qgs3DRenderContext &context) const
Returns height at (x,y) in map's CRS.
Class for storage of 3D vectors similar to QVector3D, with the difference that it uses double precisi...
Definition qgsvector3d.h:31
double y() const
Returns Y coordinate.
Definition qgsvector3d.h:50
double z() const
Returns Z coordinate.
Definition qgsvector3d.h:52
double x() const
Returns X coordinate.
Definition qgsvector3d.h:48
void set(double x, double y, double z)
Sets vector coordinates.
Definition qgsvector3d.h:73
Represents a vector layer which manages a vector based data sets.
QgsFeatureIterator getFeatures(const QgsFeatureRequest &request=QgsFeatureRequest()) const FINAL
Queries the layer for features specified in request.
Q_INVOKABLE Qgis::WkbType wkbType() const FINAL
Returns the WKBType or WKBUnknown in case of error.
static bool hasZ(Qgis::WkbType type)
Tests whether a WKB type contains the z-dimension.
#define str(x)
Definition qgis.cpp:38
#define BUILTIN_UNREACHABLE
Definition qgis.h:6535
Qt3DCore::QBuffer Qt3DQBuffer
Qt3DCore::QBuffer Qt3DQBuffer
#define QgsDebugMsgLevel(str, level)
Definition qgslogger.h:39
#define QgsDebugError(str)
Definition qgslogger.h:38
float pitch
Tilt of the camera in degrees (0 = looking from the top, 90 = looking from the side,...
float yaw
Horizontal rotation around the focal point in degrees.
QgsVector3D point
Point towards which the camera is looking in 3D world coords.
float dist
Distance of the camera from the focal point.
Helper struct to store ray casting parameters.
float maxDistance
The maximum distance from ray origin to look for hits when casting a ray.