QGIS API Documentation 3.41.0-Master (cea29feecf2)
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"
42
43#include <QtMath>
44#include <Qt3DExtras/QPhongMaterial>
45#include <Qt3DRender/QRenderSettings>
46#include <QOpenGLContext>
47#include <QOpenGLFunctions>
48
49
50#if QT_VERSION < QT_VERSION_CHECK( 6, 0, 0 )
51#include <Qt3DRender/QBuffer>
52typedef Qt3DRender::QBuffer Qt3DQBuffer;
53#else
54#include <Qt3DCore/QBuffer>
55typedef Qt3DCore::QBuffer Qt3DQBuffer;
56#endif
57
58// declared here as Qgs3DTypes has no cpp file
59const char *Qgs3DTypes::PROP_NAME_3D_RENDERER_FLAG = "PROP_NAME_3D_RENDERER_FLAG";
60
62{
63 QImage resImage;
64 QEventLoop evLoop;
65
66 // We need to change render policy to RenderPolicy::Always, since otherwise render capture node won't work
67 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::Always );
68
69 auto requestImageFcn = [&engine, scene] {
70 if ( scene->sceneState() == Qgs3DMapScene::Ready )
71 {
72 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::OnDemand );
73 engine.requestCaptureImage();
74 }
75 };
76
77 auto saveImageFcn = [&evLoop, &resImage]( const QImage &img ) {
78 resImage = img;
79 evLoop.quit();
80 };
81
82 const QMetaObject::Connection conn1 = QObject::connect( &engine, &QgsAbstract3DEngine::imageCaptured, saveImageFcn );
83 QMetaObject::Connection conn2;
84
85 if ( scene->sceneState() == Qgs3DMapScene::Ready )
86 {
87 requestImageFcn();
88 }
89 else
90 {
91 // first wait until scene is loaded
92 conn2 = QObject::connect( scene, &Qgs3DMapScene::sceneStateChanged, requestImageFcn );
93 }
94
95 evLoop.exec();
96
97 QObject::disconnect( conn1 );
98 if ( conn2 )
99 QObject::disconnect( conn2 );
100
101 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::OnDemand );
102 return resImage;
103}
104
106{
107 QImage resImage;
108 QEventLoop evLoop;
109
110 // We need to change render policy to RenderPolicy::Always, since otherwise render capture node won't work
111 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::Always );
112
113 auto requestImageFcn = [&engine, scene] {
114 if ( scene->sceneState() == Qgs3DMapScene::Ready )
115 {
116 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::OnDemand );
118 }
119 };
120
121 auto saveImageFcn = [&evLoop, &resImage]( const QImage &img ) {
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
166bool Qgs3DUtils::exportAnimation( const Qgs3DAnimationSettings &animationSettings, Qgs3DMapSettings &mapSettings, int framesPerSecond, const QString &outputDirectory, const QString &fileNameTemplate, const QSize &outputSize, QString &error, QgsFeedback *feedback )
167{
168 if ( animationSettings.keyFrames().size() < 2 )
169 {
170 error = QObject::tr( "Unable to export 3D animation. Add at least 2 keyframes" );
171 return false;
172 }
173
174 const float duration = animationSettings.duration(); //in seconds
175 if ( duration <= 0 )
176 {
177 error = QObject::tr( "Unable to export 3D animation (invalid duration)." );
178 return false;
179 }
180
181 float time = 0;
182 int frameNo = 0;
183 const int totalFrames = static_cast<int>( duration * framesPerSecond );
184
185 if ( fileNameTemplate.isEmpty() )
186 {
187 error = QObject::tr( "Filename template is empty" );
188 return false;
189 }
190
191 const int numberOfDigits = fileNameTemplate.count( QLatin1Char( '#' ) );
192 if ( numberOfDigits < 0 )
193 {
194 error = QObject::tr( "Wrong filename template format (must contain #)" );
195 return false;
196 }
197 const QString token( numberOfDigits, QLatin1Char( '#' ) );
198 if ( !fileNameTemplate.contains( token ) )
199 {
200 error = QObject::tr( "Filename template must contain all # placeholders in one continuous group." );
201 return false;
202 }
203
204 if ( !QDir().exists( outputDirectory ) )
205 {
206 if ( !QDir().mkpath( outputDirectory ) )
207 {
208 error = QObject::tr( "Output directory could not be created." );
209 return false;
210 }
211 }
212
214 engine.setSize( outputSize );
215 Qgs3DMapScene *scene = new Qgs3DMapScene( mapSettings, &engine );
216 engine.setRootEntity( scene );
217 // We need to change render policy to RenderPolicy::Always, since otherwise render capture node won't work
218 engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::Always );
219
220 while ( time <= duration )
221 {
222 if ( feedback )
223 {
224 if ( feedback->isCanceled() )
225 {
226 error = QObject::tr( "Export canceled" );
227 return false;
228 }
229 feedback->setProgress( frameNo / static_cast<double>( totalFrames ) * 100 );
230 }
231 ++frameNo;
232
233 const Qgs3DAnimationSettings::Keyframe kf = animationSettings.interpolate( time );
234 scene->cameraController()->setLookingAtPoint( kf.point, kf.dist, kf.pitch, kf.yaw );
235
236 QString fileName( fileNameTemplate );
237 const QString frameNoPaddedLeft( QStringLiteral( "%1" ).arg( frameNo, numberOfDigits, 10, QChar( '0' ) ) ); // e.g. 0001
238 fileName.replace( token, frameNoPaddedLeft );
239 const QString path = QDir( outputDirectory ).filePath( fileName );
240
241 const QImage img = Qgs3DUtils::captureSceneImage( engine, scene );
242
243 img.save( path );
244
245 time += 1.0f / static_cast<float>( framesPerSecond );
246 }
247
248 return true;
249}
250
251
252int Qgs3DUtils::maxZoomLevel( double tile0width, double tileResolution, double maxError )
253{
254 if ( maxError <= 0 || tileResolution <= 0 || tile0width <= 0 )
255 return 0; // invalid input
256
257 // derived from:
258 // tile width [map units] = tile0width / 2^zoomlevel
259 // tile error [map units] = tile width / tile resolution
260 // + re-arranging to get zoom level if we know tile error we want to get
261 const double zoomLevel = -log( tileResolution * maxError / tile0width ) / log( 2 );
262 return round( zoomLevel ); // we could use ceil() here if we wanted to always get to the desired error
263}
264
266{
267 switch ( altClamp )
268 {
270 return QStringLiteral( "absolute" );
272 return QStringLiteral( "relative" );
274 return QStringLiteral( "terrain" );
275 }
277}
278
279
281{
282 if ( str == QLatin1String( "absolute" ) )
284 else if ( str == QLatin1String( "terrain" ) )
286 else // "relative" (default)
288}
289
290
292{
293 switch ( altBind )
294 {
296 return QStringLiteral( "vertex" );
298 return QStringLiteral( "centroid" );
299 }
301}
302
303
305{
306 if ( str == QLatin1String( "vertex" ) )
308 else // "centroid" (default)
310}
311
313{
314 switch ( mode )
315 {
317 return QStringLiteral( "no-culling" );
319 return QStringLiteral( "front" );
320 case Qgs3DTypes::Back:
321 return QStringLiteral( "back" );
323 return QStringLiteral( "front-and-back" );
324 }
326}
327
329{
330 if ( str == QLatin1String( "front" ) )
331 return Qgs3DTypes::Front;
332 else if ( str == QLatin1String( "back" ) )
333 return Qgs3DTypes::Back;
334 else if ( str == QLatin1String( "front-and-back" ) )
336 else
338}
339
340float Qgs3DUtils::clampAltitude( const QgsPoint &p, Qgis::AltitudeClamping altClamp, Qgis::AltitudeBinding altBind, float offset, const QgsPoint &centroid, const Qgs3DRenderContext &context )
341{
342 float terrainZ = 0;
343 switch ( altClamp )
344 {
347 {
348 const QgsPointXY pt = altBind == Qgis::AltitudeBinding::Vertex ? p : centroid;
349 terrainZ = context.terrainRenderingEnabled() && context.terrainGenerator() ? context.terrainGenerator()->heightAt( pt.x(), pt.y(), context ) : 0;
350 break;
351 }
352
354 break;
355 }
356
357 float geomZ = 0;
358 if ( p.is3D() )
359 {
360 switch ( altClamp )
361 {
364 geomZ = p.z();
365 break;
366
368 break;
369 }
370 }
371
372 const float z = ( terrainZ + geomZ ) * static_cast<float>( context.terrainSettings()->verticalScale() ) + offset;
373 return z;
374}
375
376void Qgs3DUtils::clampAltitudes( QgsLineString *lineString, Qgis::AltitudeClamping altClamp, Qgis::AltitudeBinding altBind, const QgsPoint &centroid, float offset, const Qgs3DRenderContext &context )
377{
378 for ( int i = 0; i < lineString->nCoordinates(); ++i )
379 {
380 float terrainZ = 0;
381 switch ( altClamp )
382 {
385 {
386 QgsPointXY pt;
387 switch ( altBind )
388 {
390 pt.setX( lineString->xAt( i ) );
391 pt.setY( lineString->yAt( i ) );
392 break;
393
395 pt.set( centroid.x(), centroid.y() );
396 break;
397 }
398
399 terrainZ = context.terrainRenderingEnabled() && context.terrainGenerator() ? context.terrainGenerator()->heightAt( pt.x(), pt.y(), context ) : 0;
400 break;
401 }
402
404 break;
405 }
406
407 float geomZ = 0;
408
409 switch ( altClamp )
410 {
413 geomZ = lineString->zAt( i );
414 break;
415
417 break;
418 }
419
420 const float z = ( terrainZ + geomZ ) * static_cast<float>( context.terrainSettings()->verticalScale() ) + offset;
421 lineString->setZAt( i, z );
422 }
423}
424
425
426bool Qgs3DUtils::clampAltitudes( QgsPolygon *polygon, Qgis::AltitudeClamping altClamp, Qgis::AltitudeBinding altBind, float offset, const Qgs3DRenderContext &context )
427{
428 if ( !polygon->is3D() )
429 polygon->addZValue( 0 );
430
431 QgsPoint centroid;
432 switch ( altBind )
433 {
435 break;
436
438 centroid = polygon->centroid();
439 break;
440 }
441
442 QgsCurve *curve = const_cast<QgsCurve *>( polygon->exteriorRing() );
443 QgsLineString *lineString = qgsgeometry_cast<QgsLineString *>( curve );
444 if ( !lineString )
445 return false;
446
447 clampAltitudes( lineString, altClamp, altBind, centroid, offset, context );
448
449 for ( int i = 0; i < polygon->numInteriorRings(); ++i )
450 {
451 QgsCurve *curve = const_cast<QgsCurve *>( polygon->interiorRing( i ) );
452 QgsLineString *lineString = qgsgeometry_cast<QgsLineString *>( curve );
453 if ( !lineString )
454 return false;
455
456 clampAltitudes( lineString, altClamp, altBind, centroid, offset, context );
457 }
458 return true;
459}
460
461
462QString Qgs3DUtils::matrix4x4toString( const QMatrix4x4 &m )
463{
464 const float *d = m.constData();
465 QStringList elems;
466 elems.reserve( 16 );
467 for ( int i = 0; i < 16; ++i )
468 elems << QString::number( d[i] );
469 return elems.join( ' ' );
470}
471
472QMatrix4x4 Qgs3DUtils::stringToMatrix4x4( const QString &str )
473{
474 QMatrix4x4 m;
475 float *d = m.data();
476 QStringList elems = str.split( ' ' );
477 for ( int i = 0; i < 16; ++i )
478 d[i] = elems[i].toFloat();
479 return m;
480}
481
482void Qgs3DUtils::extractPointPositions( const QgsFeature &f, const Qgs3DRenderContext &context, const QgsVector3D &chunkOrigin, Qgis::AltitudeClamping altClamp, QVector<QVector3D> &positions )
483{
484 const QgsAbstractGeometry *g = f.geometry().constGet();
485 for ( auto it = g->vertices_begin(); it != g->vertices_end(); ++it )
486 {
487 const QgsPoint pt = *it;
488 float geomZ = 0;
489 if ( pt.is3D() )
490 {
491 geomZ = pt.z();
492 }
493 const float terrainZ = context.terrainRenderingEnabled() && context.terrainGenerator() ? static_cast<float>( context.terrainGenerator()->heightAt( pt.x(), pt.y(), context ) * context.terrainSettings()->verticalScale() ) : 0.f;
494 float h = 0.0f;
495 switch ( altClamp )
496 {
498 h = geomZ;
499 break;
501 h = terrainZ;
502 break;
504 h = terrainZ + geomZ;
505 break;
506 }
507 positions.append( QVector3D(
508 static_cast<float>( pt.x() - chunkOrigin.x() ),
509 static_cast<float>( pt.y() - chunkOrigin.y() ),
510 h
511 ) );
512 QgsDebugMsgLevel( QStringLiteral( "%1 %2 %3" ).arg( positions.last().x() ).arg( positions.last().y() ).arg( positions.last().z() ), 2 );
513 }
514}
515
521static inline uint outcode( QVector4D v )
522{
523 // For a discussion of outcodes see pg 388 Dunn & Parberry.
524 // For why you can't just test if the point is in a bounding box
525 // consider the case where a view frustum with view-size 1.5 x 1.5
526 // is tested against a 2x2 box which encloses the near-plane, while
527 // all the points in the box are outside the frustum.
528 // TODO: optimise this with assembler - according to D&P this can
529 // be done in one line of assembler on some platforms
530 uint code = 0;
531 if ( v.x() < -v.w() )
532 code |= 0x01;
533 if ( v.x() > v.w() )
534 code |= 0x02;
535 if ( v.y() < -v.w() )
536 code |= 0x04;
537 if ( v.y() > v.w() )
538 code |= 0x08;
539 if ( v.z() < -v.w() )
540 code |= 0x10;
541 if ( v.z() > v.w() )
542 code |= 0x20;
543 return code;
544}
545
546
557bool Qgs3DUtils::isCullable( const QgsAABB &bbox, const QMatrix4x4 &viewProjectionMatrix )
558{
559 uint out = 0xff;
560
561 for ( int i = 0; i < 8; ++i )
562 {
563 const QVector4D p( ( ( i >> 0 ) & 1 ) ? bbox.xMin : bbox.xMax, ( ( i >> 1 ) & 1 ) ? bbox.yMin : bbox.yMax, ( ( i >> 2 ) & 1 ) ? bbox.zMin : bbox.zMax, 1 );
564 const QVector4D pc = viewProjectionMatrix * p;
565
566 // if the logical AND of all the outcodes is non-zero then the BB is
567 // definitely outside the view frustum.
568 out = out & outcode( pc );
569 }
570 return out;
571}
572
574{
575 return QgsVector3D( mapCoords.x() - origin.x(), mapCoords.y() - origin.y(), mapCoords.z() - origin.z() );
576}
577
579{
580 return QgsVector3D( worldCoords.x() + origin.x(), worldCoords.y() + origin.y(), worldCoords.z() + origin.z() );
581}
582
584{
585 QgsRectangle extentMapCrs( extent );
586 if ( crs1 != crs2 )
587 {
588 // reproject if necessary
589 QgsCoordinateTransform ct( crs1, crs2, context );
591 try
592 {
593 extentMapCrs = ct.transformBoundingBox( extentMapCrs );
594 }
595 catch ( const QgsCsException & )
596 {
597 // bad luck, can't reproject for some reason
598 QgsDebugError( QStringLiteral( "3D utils: transformation of extent failed: " ) + extentMapCrs.toString( -1 ) );
599 }
600 }
601 return extentMapCrs;
602}
603
604QgsAABB Qgs3DUtils::layerToWorldExtent( const QgsRectangle &extent, double zMin, double zMax, const QgsCoordinateReferenceSystem &layerCrs, const QgsVector3D &mapOrigin, const QgsCoordinateReferenceSystem &mapCrs, const QgsCoordinateTransformContext &context )
605{
606 const QgsRectangle extentMapCrs( Qgs3DUtils::tryReprojectExtent2D( extent, layerCrs, mapCrs, context ) );
607 return mapToWorldExtent( extentMapCrs, zMin, zMax, mapOrigin );
608}
609
611{
612 const QgsRectangle extentMap = worldToMapExtent( bbox, mapOrigin );
613 return Qgs3DUtils::tryReprojectExtent2D( extentMap, mapCrs, layerCrs, context );
614}
615
616QgsAABB Qgs3DUtils::mapToWorldExtent( const QgsRectangle &extent, double zMin, double zMax, const QgsVector3D &mapOrigin )
617{
618 const QgsVector3D extentMin3D( extent.xMinimum(), extent.yMinimum(), zMin );
619 const QgsVector3D extentMax3D( extent.xMaximum(), extent.yMaximum(), zMax );
620 const QgsVector3D worldExtentMin3D = mapToWorldCoordinates( extentMin3D, mapOrigin );
621 const QgsVector3D worldExtentMax3D = mapToWorldCoordinates( extentMax3D, mapOrigin );
622 QgsAABB rootBbox( worldExtentMin3D.x(), worldExtentMin3D.y(), worldExtentMin3D.z(), worldExtentMax3D.x(), worldExtentMax3D.y(), worldExtentMax3D.z() );
623 return rootBbox;
624}
625
627{
628 const QgsVector3D extentMin3D( box3D.xMinimum(), box3D.yMinimum(), box3D.zMinimum() );
629 const QgsVector3D extentMax3D( box3D.xMaximum(), box3D.yMaximum(), box3D.zMaximum() );
630 const QgsVector3D worldExtentMin3D = mapToWorldCoordinates( extentMin3D, mapOrigin );
631 const QgsVector3D worldExtentMax3D = mapToWorldCoordinates( extentMax3D, mapOrigin );
632 // casting to float should be ok, assuming that the map origin is not too far from the box
633 return QgsAABB( static_cast<float>( worldExtentMin3D.x() ), static_cast<float>( worldExtentMin3D.y() ), static_cast<float>( worldExtentMin3D.z() ), static_cast<float>( worldExtentMax3D.x() ), static_cast<float>( worldExtentMax3D.y() ), static_cast<float>( worldExtentMax3D.z() ) );
634}
635
637{
638 const QgsVector3D worldExtentMin3D = Qgs3DUtils::worldToMapCoordinates( QgsVector3D( bbox.xMin, bbox.yMin, bbox.zMin ), mapOrigin );
639 const QgsVector3D worldExtentMax3D = Qgs3DUtils::worldToMapCoordinates( QgsVector3D( bbox.xMax, bbox.yMax, bbox.zMax ), mapOrigin );
640 const QgsRectangle extentMap( worldExtentMin3D.x(), worldExtentMin3D.y(), worldExtentMax3D.x(), worldExtentMax3D.y() );
641 // we discard zMin/zMax here because we don't need it
642 return extentMap;
643}
644
645
647{
648 const QgsVector3D mapPoint1 = worldToMapCoordinates( worldPoint1, origin1 );
649 QgsVector3D mapPoint2 = mapPoint1;
650 if ( crs1 != crs2 )
651 {
652 // reproject if necessary
653 const QgsCoordinateTransform ct( crs1, crs2, context );
654 try
655 {
656 const QgsPointXY pt = ct.transform( QgsPointXY( mapPoint1.x(), mapPoint1.y() ) );
657 mapPoint2.set( pt.x(), pt.y(), mapPoint1.z() );
658 }
659 catch ( const QgsCsException & )
660 {
661 // bad luck, can't reproject for some reason
662 }
663 }
664 return mapToWorldCoordinates( mapPoint2, origin2 );
665}
666
667void Qgs3DUtils::estimateVectorLayerZRange( QgsVectorLayer *layer, double &zMin, double &zMax )
668{
669 if ( !QgsWkbTypes::hasZ( layer->wkbType() ) )
670 {
671 zMin = 0;
672 zMax = 0;
673 return;
674 }
675
676 zMin = std::numeric_limits<double>::max();
677 zMax = std::numeric_limits<double>::lowest();
678
679 QgsFeature f;
680 QgsFeatureIterator it = layer->getFeatures( QgsFeatureRequest().setNoAttributes().setLimit( 100 ) );
681 while ( it.nextFeature( f ) )
682 {
683 const QgsGeometry g = f.geometry();
684 for ( auto vit = g.vertices_begin(); vit != g.vertices_end(); ++vit )
685 {
686 const double z = ( *vit ).z();
687 if ( z < zMin )
688 zMin = z;
689 if ( z > zMax )
690 zMax = z;
691 }
692 }
693
694 if ( zMin == std::numeric_limits<double>::max() && zMax == std::numeric_limits<double>::lowest() )
695 {
696 zMin = 0;
697 zMax = 0;
698 }
699}
700
709
711{
713 settings.setAmbient( material->ambient() );
714 settings.setDiffuse( material->diffuse() );
715 settings.setSpecular( material->specular() );
716 settings.setShininess( material->shininess() );
717 return settings;
718}
719
720QgsRay3D Qgs3DUtils::rayFromScreenPoint( const QPoint &point, const QSize &windowSize, Qt3DRender::QCamera *camera )
721{
722 const QVector3D deviceCoords( point.x(), point.y(), 0.0 );
723 // normalized device coordinates
724 const QVector3D normDeviceCoords( 2.0 * deviceCoords.x() / windowSize.width() - 1.0f, 1.0f - 2.0 * deviceCoords.y() / windowSize.height(), camera->nearPlane() );
725 // clip coordinates
726 const QVector4D rayClip( normDeviceCoords.x(), normDeviceCoords.y(), -1.0, 0.0 );
727
728 const QMatrix4x4 invertedProjMatrix = camera->projectionMatrix().inverted();
729 const QMatrix4x4 invertedViewMatrix = camera->viewMatrix().inverted();
730
731 // ray direction in view coordinates
732 QVector4D rayDirView = invertedProjMatrix * rayClip;
733 // ray origin in world coordinates
734 const QVector4D rayOriginWorld = invertedViewMatrix * QVector4D( 0.0f, 0.0f, 0.0f, 1.0f );
735
736 // ray direction in world coordinates
737 rayDirView.setZ( -1.0f );
738 rayDirView.setW( 0.0f );
739 const QVector4D rayDirWorld4D = invertedViewMatrix * rayDirView;
740 QVector3D rayDirWorld( rayDirWorld4D.x(), rayDirWorld4D.y(), rayDirWorld4D.z() );
741 rayDirWorld = rayDirWorld.normalized();
742
743 return QgsRay3D( QVector3D( rayOriginWorld ), rayDirWorld );
744}
745
746QVector3D Qgs3DUtils::screenPointToWorldPos( const QPoint &screenPoint, double depth, const QSize &screenSize, Qt3DRender::QCamera *camera )
747{
748 double dNear = camera->nearPlane();
749 double dFar = camera->farPlane();
750 double distance = ( 2.0 * dNear * dFar ) / ( dFar + dNear - ( depth * 2 - 1 ) * ( dFar - dNear ) );
751
752 QgsRay3D ray = Qgs3DUtils::rayFromScreenPoint( screenPoint, screenSize, camera );
753 double dot = QVector3D::dotProduct( ray.direction(), camera->viewVector().normalized() );
754 distance /= dot;
755
756 return ray.origin() + distance * ray.direction();
757}
758
759void Qgs3DUtils::pitchAndYawFromViewVector( QVector3D vect, double &pitch, double &yaw )
760{
761 vect.normalize();
762
763 pitch = qRadiansToDegrees( qAcos( vect.y() ) );
764 yaw = qRadiansToDegrees( qAtan2( -vect.z(), vect.x() ) ) + 90;
765}
766
767QVector2D Qgs3DUtils::screenToTextureCoordinates( QVector2D screenXY, QSize winSize )
768{
769 return QVector2D( screenXY.x() / winSize.width(), 1 - screenXY.y() / winSize.width() );
770}
771
772QVector2D Qgs3DUtils::textureToScreenCoordinates( QVector2D textureXY, QSize winSize )
773{
774 return QVector2D( textureXY.x() * winSize.width(), ( 1 - textureXY.y() ) * winSize.height() );
775}
776
777std::unique_ptr<QgsPointCloudLayer3DRenderer> Qgs3DUtils::convert2DPointCloudRendererTo3D( QgsPointCloudRenderer *renderer )
778{
779 if ( !renderer )
780 return nullptr;
781
782 std::unique_ptr<QgsPointCloud3DSymbol> symbol3D;
783 if ( renderer->type() == QLatin1String( "ramp" ) )
784 {
785 const QgsPointCloudAttributeByRampRenderer *renderer2D = dynamic_cast<const QgsPointCloudAttributeByRampRenderer *>( renderer );
786 symbol3D = std::make_unique<QgsColorRampPointCloud3DSymbol>();
787 QgsColorRampPointCloud3DSymbol *symbol = static_cast<QgsColorRampPointCloud3DSymbol *>( symbol3D.get() );
788 symbol->setAttribute( renderer2D->attribute() );
789 symbol->setColorRampShaderMinMax( renderer2D->minimum(), renderer2D->maximum() );
790 symbol->setColorRampShader( renderer2D->colorRampShader() );
791 }
792 else if ( renderer->type() == QLatin1String( "rgb" ) )
793 {
794 const QgsPointCloudRgbRenderer *renderer2D = dynamic_cast<const QgsPointCloudRgbRenderer *>( renderer );
795 symbol3D = std::make_unique<QgsRgbPointCloud3DSymbol>();
796 QgsRgbPointCloud3DSymbol *symbol = static_cast<QgsRgbPointCloud3DSymbol *>( symbol3D.get() );
797 symbol->setRedAttribute( renderer2D->redAttribute() );
798 symbol->setGreenAttribute( renderer2D->greenAttribute() );
799 symbol->setBlueAttribute( renderer2D->blueAttribute() );
800
801 symbol->setRedContrastEnhancement( renderer2D->redContrastEnhancement() ? new QgsContrastEnhancement( *renderer2D->redContrastEnhancement() ) : nullptr );
802 symbol->setGreenContrastEnhancement( renderer2D->greenContrastEnhancement() ? new QgsContrastEnhancement( *renderer2D->greenContrastEnhancement() ) : nullptr );
803 symbol->setBlueContrastEnhancement( renderer2D->blueContrastEnhancement() ? new QgsContrastEnhancement( *renderer2D->blueContrastEnhancement() ) : nullptr );
804 }
805 else if ( renderer->type() == QLatin1String( "classified" ) )
806 {
807 const QgsPointCloudClassifiedRenderer *renderer2D = dynamic_cast<const QgsPointCloudClassifiedRenderer *>( renderer );
808 symbol3D = std::make_unique<QgsClassificationPointCloud3DSymbol>();
809 QgsClassificationPointCloud3DSymbol *symbol = static_cast<QgsClassificationPointCloud3DSymbol *>( symbol3D.get() );
810 symbol->setAttribute( renderer2D->attribute() );
811 symbol->setCategoriesList( renderer2D->categories() );
812 }
813
814 if ( symbol3D )
815 {
816 std::unique_ptr<QgsPointCloudLayer3DRenderer> renderer3D = std::make_unique<QgsPointCloudLayer3DRenderer>();
817 renderer3D->setSymbol( symbol3D.release() );
818 return renderer3D;
819 }
820 return nullptr;
821}
822
823QHash<QgsMapLayer *, QVector<QgsRayCastingUtils::RayHit>> Qgs3DUtils::castRay( Qgs3DMapScene *scene, const QgsRay3D &ray, const QgsRayCastingUtils::RayCastContext &context )
824{
825 QgsRayCastingUtils::Ray3D r( ray.origin(), ray.direction(), context.maxDistance );
826 QHash<QgsMapLayer *, QVector<QgsRayCastingUtils::RayHit>> results;
827 const QList<QgsMapLayer *> keys = scene->layers();
828 for ( QgsMapLayer *layer : keys )
829 {
830 Qt3DCore::QEntity *entity = scene->layerEntity( layer );
831
832 if ( QgsChunkedEntity *chunkedEntity = qobject_cast<QgsChunkedEntity *>( entity ) )
833 {
834 const QVector<QgsRayCastingUtils::RayHit> result = chunkedEntity->rayIntersection( r, context );
835 if ( !result.isEmpty() )
836 results[layer] = result;
837 }
838 }
839 if ( QgsTerrainEntity *terrain = scene->terrainEntity() )
840 {
841 const QVector<QgsRayCastingUtils::RayHit> result = terrain->rayIntersection( r, context );
842 if ( !result.isEmpty() )
843 results[nullptr] = result; // Terrain hits are not tied to a layer so we use nullptr as their key here
844 }
845 return results;
846}
847
848float Qgs3DUtils::screenSpaceError( float epsilon, float distance, int screenSize, float fov )
849{
850 /* This routine approximately calculates how an error (epsilon) of an object in world coordinates
851 * at given distance (between camera and the object) will look like in screen coordinates.
852 *
853 * the math below simply uses triangle similarity:
854 *
855 * epsilon phi
856 * ----------------------------- = ----------------
857 * [ frustum width at distance ] [ screen width ]
858 *
859 * Then we solve for phi, substituting [frustum width at distance] = 2 * distance * tan(fov / 2)
860 *
861 * ________xxx__ xxx = real world error (epsilon)
862 * \ | / x = screen space error (phi)
863 * \ | /
864 * \___|_x_/ near plane (screen space)
865 * \ | /
866 * \ | /
867 * \|/ angle = field of view
868 * camera
869 */
870 float phi = epsilon * static_cast<float>( screenSize ) / static_cast<float>( 2 * distance * tan( fov * M_PI / ( 2 * 180 ) ) );
871 return phi;
872}
873
874void Qgs3DUtils::computeBoundingBoxNearFarPlanes( const QgsAABB &bbox, const QMatrix4x4 &viewMatrix, float &fnear, float &ffar )
875{
876 fnear = 1e9;
877 ffar = 0;
878
879 for ( int i = 0; i < 8; ++i )
880 {
881 const QVector4D p( ( ( i >> 0 ) & 1 ) ? bbox.xMin : bbox.xMax, ( ( i >> 1 ) & 1 ) ? bbox.yMin : bbox.yMax, ( ( i >> 2 ) & 1 ) ? bbox.zMin : bbox.zMax, 1 );
882
883 const QVector4D pc = viewMatrix * p;
884
885 const float dst = -pc.z(); // in camera coordinates, x grows right, y grows down, z grows to the back
886 fnear = std::min( fnear, dst );
887 ffar = std::max( ffar, dst );
888 }
889}
890
891Qt3DRender::QCullFace::CullingMode Qgs3DUtils::qt3DcullingMode( Qgs3DTypes::CullingMode mode )
892{
893 switch ( mode )
894 {
896 return Qt3DRender::QCullFace::NoCulling;
898 return Qt3DRender::QCullFace::Front;
899 case Qgs3DTypes::Back:
900 return Qt3DRender::QCullFace::Back;
902 return Qt3DRender::QCullFace::FrontAndBack;
903 }
904 return Qt3DRender::QCullFace::NoCulling;
905}
906
907
908QByteArray Qgs3DUtils::addDefinesToShaderCode( const QByteArray &shaderCode, const QStringList &defines )
909{
910 // There is one caveat to take care of - GLSL source code needs to start with #version as
911 // a first directive, otherwise we get the old GLSL 100 version. So we can't just prepend the
912 // shader source code, but insert our defines at the right place.
913
914 QStringList defineLines;
915 for ( const QString &define : defines )
916 defineLines += "#define " + define + "\n";
917
918 QString definesText = defineLines.join( QString() );
919
920 QByteArray newShaderCode = shaderCode;
921 int versionIndex = shaderCode.indexOf( "#version " );
922 int insertionIndex = versionIndex == -1 ? 0 : shaderCode.indexOf( '\n', versionIndex + 1 ) + 1;
923 newShaderCode.insert( insertionIndex, definesText.toLatin1() );
924 return newShaderCode;
925}
926
927QByteArray Qgs3DUtils::removeDefinesFromShaderCode( const QByteArray &shaderCode, const QStringList &defines )
928{
929 QByteArray newShaderCode = shaderCode;
930
931 for ( const QString &define : defines )
932 {
933 const QString defineLine = "#define " + define + "\n";
934 const int defineLineIndex = newShaderCode.indexOf( defineLine.toUtf8() );
935 if ( defineLineIndex != -1 )
936 {
937 newShaderCode.remove( defineLineIndex, defineLine.size() );
938 }
939 }
940
941 return newShaderCode;
942}
943
944void Qgs3DUtils::decomposeTransformMatrix( const QMatrix4x4 &matrix, QVector3D &translation, QQuaternion &rotation, QVector3D &scale )
945{
946 // decompose the transform matrix
947 // assuming the last row has values [0 0 0 1]
948 // see https://math.stackexchange.com/questions/237369/given-this-transformation-matrix-how-do-i-decompose-it-into-translation-rotati
949 const float *md = matrix.data(); // returns data in column-major order
950 const float sx = QVector3D( md[0], md[1], md[2] ).length();
951 const float sy = QVector3D( md[4], md[5], md[6] ).length();
952 const float sz = QVector3D( md[8], md[9], md[10] ).length();
953 float rd[9] = {
954 md[0] / sx,
955 md[4] / sy,
956 md[8] / sz,
957 md[1] / sx,
958 md[5] / sy,
959 md[9] / sz,
960 md[2] / sx,
961 md[6] / sy,
962 md[10] / sz,
963 };
964 const QMatrix3x3 rot3x3( rd ); // takes data in row-major order
965
966 scale = QVector3D( sx, sy, sz );
967 rotation = QQuaternion::fromRotationMatrix( rot3x3 );
968 translation = QVector3D( md[12], md[13], md[14] );
969}
970
971int Qgs3DUtils::openGlMaxClipPlanes( QSurface *surface )
972{
973 int numPlanes = 6;
974
975 QOpenGLContext context;
976 context.setFormat( QSurfaceFormat::defaultFormat() );
977 if ( context.create() )
978 {
979 context.makeCurrent( surface );
980 QOpenGLFunctions *funcs = context.functions();
981 funcs->glGetIntegerv( GL_MAX_CLIP_PLANES, &numPlanes );
982 }
983
984 return numPlanes;
985}
AltitudeClamping
Altitude clamping.
Definition qgis.h:3744
@ 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:3757
@ 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.
const QgsAbstractTerrainSettings * terrainSettings() const
Returns the terrain settings.
QgsTerrainGenerator * terrainGenerator() const
Returns the terrain generator.
bool terrainRenderingEnabled() const
Returns whether the 2D terrain surface will be rendered.
static const char * PROP_NAME_3D_RENDERER_FLAG
Qt property name to hold the 3D geometry renderer flag.
Definition qgs3dtypes.h:43
CullingMode
Triangle culling mode.
Definition qgs3dtypes.h:35
@ FrontAndBack
Will not render anything.
Definition qgs3dtypes.h:39
@ NoCulling
Will render both front and back faces of triangles.
Definition qgs3dtypes.h:36
@ Front
Will render only back faces of triangles.
Definition qgs3dtypes.h:37
@ Back
Will render only front faces of triangles (recommended when input data are consistent)
Definition qgs3dtypes.h:38
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 QByteArray removeDefinesFromShaderCode(const QByteArray &shaderCode, const QStringList &defines)
Removes some define macros from a shader source code.
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 void decomposeTransformMatrix(const QMatrix4x4 &matrix, QVector3D &translation, QQuaternion &rotation, QVector3D &scale)
Tries to decompose a 4x4 transform matrix into translation, rotation and scale components.
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)
static QgsVector3D mapToWorldCoordinates(const QgsVector3D &mapCoords, const QgsVector3D &origin)
Converts map coordinates to 3D world coordinates (applies offset)
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 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 void extractPointPositions(const QgsFeature &f, const Qgs3DRenderContext &context, const QgsVector3D &chunkOrigin, Qgis::AltitudeClamping altClamp, QVector< QVector3D > &positions)
Calculates (x,y,z) positions of (multi)point from the given feature.
static QImage captureSceneDepthBuffer(QgsAbstract3DEngine &engine, Qgs3DMapScene *scene)
Captures the depth buffer of the current 3D scene of a 3D engine.
static int openGlMaxClipPlanes(QSurface *surface)
Gets the maximum number of clip planes that can be used.
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.
double verticalScale() const
Returns the vertical scale (exaggeration) for terrain.
A 3-dimensional box composed of x, y, z coordinates.
Definition qgsbox3d.h:43
double yMaximum() const
Returns the maximum y value.
Definition qgsbox3d.h:246
double xMinimum() const
Returns the minimum x value.
Definition qgsbox3d.h:211
double zMaximum() const
Returns the maximum z value.
Definition qgsbox3d.h:274
double xMaximum() const
Returns the maximum x value.
Definition qgsbox3d.h:218
double zMinimum() const
Returns the minimum z value.
Definition qgsbox3d.h:267
double yMinimum() const
Returns the minimum y value.
Definition qgsbox3d.h:239
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.
Q_INVOKABLE 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
double yMinimum
double xMaximum
double yMaximum
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 BUILTIN_UNREACHABLE
Definition qgis.h:6678
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.