QGIS API Documentation 3.41.0-Master (fda2aa46e9a)
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, const QgsVector3D &chunkOrigin, 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(
517 static_cast<float>( pt.x() - chunkOrigin.x() ),
518 static_cast<float>( pt.y() - chunkOrigin.y() ),
519 h ) );
520 QgsDebugMsgLevel( QStringLiteral( "%1 %2 %3" ).arg( positions.last().x() ).arg( positions.last().y() ).arg( positions.last().z() ), 2 );
521 }
522}
523
529static inline uint outcode( QVector4D v )
530{
531 // For a discussion of outcodes see pg 388 Dunn & Parberry.
532 // For why you can't just test if the point is in a bounding box
533 // consider the case where a view frustum with view-size 1.5 x 1.5
534 // is tested against a 2x2 box which encloses the near-plane, while
535 // all the points in the box are outside the frustum.
536 // TODO: optimise this with assembler - according to D&P this can
537 // be done in one line of assembler on some platforms
538 uint code = 0;
539 if ( v.x() < -v.w() ) code |= 0x01;
540 if ( v.x() > v.w() ) code |= 0x02;
541 if ( v.y() < -v.w() ) code |= 0x04;
542 if ( v.y() > v.w() ) code |= 0x08;
543 if ( v.z() < -v.w() ) code |= 0x10;
544 if ( v.z() > v.w() ) code |= 0x20;
545 return code;
546}
547
548
559bool Qgs3DUtils::isCullable( const QgsAABB &bbox, const QMatrix4x4 &viewProjectionMatrix )
560{
561 uint out = 0xff;
562
563 for ( int i = 0; i < 8; ++i )
564 {
565 const QVector4D p( ( ( i >> 0 ) & 1 ) ? bbox.xMin : bbox.xMax,
566 ( ( i >> 1 ) & 1 ) ? bbox.yMin : bbox.yMax,
567 ( ( i >> 2 ) & 1 ) ? bbox.zMin : bbox.zMax, 1 );
568 const QVector4D pc = viewProjectionMatrix * p;
569
570 // if the logical AND of all the outcodes is non-zero then the BB is
571 // definitely outside the view frustum.
572 out = out & outcode( pc );
573 }
574 return out;
575}
576
578{
579 return QgsVector3D( mapCoords.x() - origin.x(),
580 mapCoords.y() - origin.y(),
581 mapCoords.z() - origin.z() );
582
583}
584
586{
587 return QgsVector3D( worldCoords.x() + origin.x(),
588 worldCoords.y() + origin.y(),
589 worldCoords.z() + origin.z() );
590}
591
593{
594 QgsRectangle extentMapCrs( extent );
595 if ( crs1 != crs2 )
596 {
597 // reproject if necessary
598 QgsCoordinateTransform ct( crs1, crs2, context );
600 try
601 {
602 extentMapCrs = ct.transformBoundingBox( extentMapCrs );
603 }
604 catch ( const QgsCsException & )
605 {
606 // bad luck, can't reproject for some reason
607 QgsDebugError( QStringLiteral( "3D utils: transformation of extent failed: " ) + extentMapCrs.toString( -1 ) );
608 }
609 }
610 return extentMapCrs;
611}
612
613QgsAABB Qgs3DUtils::layerToWorldExtent( const QgsRectangle &extent, double zMin, double zMax, const QgsCoordinateReferenceSystem &layerCrs, const QgsVector3D &mapOrigin, const QgsCoordinateReferenceSystem &mapCrs, const QgsCoordinateTransformContext &context )
614{
615 const QgsRectangle extentMapCrs( Qgs3DUtils::tryReprojectExtent2D( extent, layerCrs, mapCrs, context ) );
616 return mapToWorldExtent( extentMapCrs, zMin, zMax, mapOrigin );
617}
618
620{
621 const QgsRectangle extentMap = worldToMapExtent( bbox, mapOrigin );
622 return Qgs3DUtils::tryReprojectExtent2D( extentMap, mapCrs, layerCrs, context );
623}
624
625QgsAABB Qgs3DUtils::mapToWorldExtent( const QgsRectangle &extent, double zMin, double zMax, const QgsVector3D &mapOrigin )
626{
627 const QgsVector3D extentMin3D( extent.xMinimum(), extent.yMinimum(), zMin );
628 const QgsVector3D extentMax3D( extent.xMaximum(), extent.yMaximum(), zMax );
629 const QgsVector3D worldExtentMin3D = mapToWorldCoordinates( extentMin3D, mapOrigin );
630 const QgsVector3D worldExtentMax3D = mapToWorldCoordinates( extentMax3D, mapOrigin );
631 QgsAABB rootBbox( worldExtentMin3D.x(), worldExtentMin3D.y(), worldExtentMin3D.z(),
632 worldExtentMax3D.x(), worldExtentMax3D.y(), worldExtentMax3D.z() );
633 return rootBbox;
634}
635
637{
638 const QgsVector3D extentMin3D( box3D.xMinimum(), box3D.yMinimum(), box3D.zMinimum() );
639 const QgsVector3D extentMax3D( box3D.xMaximum(), box3D.yMaximum(), box3D.zMaximum() );
640 const QgsVector3D worldExtentMin3D = mapToWorldCoordinates( extentMin3D, mapOrigin );
641 const QgsVector3D worldExtentMax3D = mapToWorldCoordinates( extentMax3D, mapOrigin );
642 // casting to float should be ok, assuming that the map origin is not too far from the box
643 return QgsAABB( static_cast<float>( worldExtentMin3D.x() ),
644 static_cast<float>( worldExtentMin3D.y() ),
645 static_cast<float>( worldExtentMin3D.z() ),
646 static_cast<float>( worldExtentMax3D.x() ),
647 static_cast<float>( worldExtentMax3D.y() ),
648 static_cast<float>( worldExtentMax3D.z() ) );
649}
650
652{
653 const QgsVector3D worldExtentMin3D = Qgs3DUtils::worldToMapCoordinates( QgsVector3D( bbox.xMin, bbox.yMin, bbox.zMin ), mapOrigin );
654 const QgsVector3D worldExtentMax3D = Qgs3DUtils::worldToMapCoordinates( QgsVector3D( bbox.xMax, bbox.yMax, bbox.zMax ), mapOrigin );
655 const QgsRectangle extentMap( worldExtentMin3D.x(), worldExtentMin3D.y(), worldExtentMax3D.x(), worldExtentMax3D.y() );
656 // we discard zMin/zMax here because we don't need it
657 return extentMap;
658}
659
660
662{
663 const QgsVector3D mapPoint1 = worldToMapCoordinates( worldPoint1, origin1 );
664 QgsVector3D mapPoint2 = mapPoint1;
665 if ( crs1 != crs2 )
666 {
667 // reproject if necessary
668 const QgsCoordinateTransform ct( crs1, crs2, context );
669 try
670 {
671 const QgsPointXY pt = ct.transform( QgsPointXY( mapPoint1.x(), mapPoint1.y() ) );
672 mapPoint2.set( pt.x(), pt.y(), mapPoint1.z() );
673 }
674 catch ( const QgsCsException & )
675 {
676 // bad luck, can't reproject for some reason
677 }
678 }
679 return mapToWorldCoordinates( mapPoint2, origin2 );
680}
681
682void Qgs3DUtils::estimateVectorLayerZRange( QgsVectorLayer *layer, double &zMin, double &zMax )
683{
684 if ( !QgsWkbTypes::hasZ( layer->wkbType() ) )
685 {
686 zMin = 0;
687 zMax = 0;
688 return;
689 }
690
691 zMin = std::numeric_limits<double>::max();
692 zMax = std::numeric_limits<double>::lowest();
693
694 QgsFeature f;
695 QgsFeatureIterator it = layer->getFeatures( QgsFeatureRequest().setNoAttributes().setLimit( 100 ) );
696 while ( it.nextFeature( f ) )
697 {
698 const QgsGeometry g = f.geometry();
699 for ( auto vit = g.vertices_begin(); vit != g.vertices_end(); ++vit )
700 {
701 const double z = ( *vit ).z();
702 if ( z < zMin ) zMin = z;
703 if ( z > zMax ) zMax = z;
704 }
705 }
706
707 if ( zMin == std::numeric_limits<double>::max() && zMax == std::numeric_limits<double>::lowest() )
708 {
709 zMin = 0;
710 zMax = 0;
711 }
712}
713
722
724{
726 settings.setAmbient( material->ambient() );
727 settings.setDiffuse( material->diffuse() );
728 settings.setSpecular( material->specular() );
729 settings.setShininess( material->shininess() );
730 return settings;
731}
732
733QgsRay3D Qgs3DUtils::rayFromScreenPoint( const QPoint &point, const QSize &windowSize, Qt3DRender::QCamera *camera )
734{
735 const QVector3D deviceCoords( point.x(), point.y(), 0.0 );
736 // normalized device coordinates
737 const QVector3D normDeviceCoords( 2.0 * deviceCoords.x() / windowSize.width() - 1.0f, 1.0f - 2.0 * deviceCoords.y() / windowSize.height(), camera->nearPlane() );
738 // clip coordinates
739 const QVector4D rayClip( normDeviceCoords.x(), normDeviceCoords.y(), -1.0, 0.0 );
740
741 const QMatrix4x4 invertedProjMatrix = camera->projectionMatrix().inverted();
742 const QMatrix4x4 invertedViewMatrix = camera->viewMatrix().inverted();
743
744 // ray direction in view coordinates
745 QVector4D rayDirView = invertedProjMatrix * rayClip;
746 // ray origin in world coordinates
747 const QVector4D rayOriginWorld = invertedViewMatrix * QVector4D( 0.0f, 0.0f, 0.0f, 1.0f );
748
749 // ray direction in world coordinates
750 rayDirView.setZ( -1.0f );
751 rayDirView.setW( 0.0f );
752 const QVector4D rayDirWorld4D = invertedViewMatrix * rayDirView;
753 QVector3D rayDirWorld( rayDirWorld4D.x(), rayDirWorld4D.y(), rayDirWorld4D.z() );
754 rayDirWorld = rayDirWorld.normalized();
755
756 return QgsRay3D( QVector3D( rayOriginWorld ), rayDirWorld );
757}
758
759QVector3D Qgs3DUtils::screenPointToWorldPos( const QPoint &screenPoint, double depth, const QSize &screenSize, Qt3DRender::QCamera *camera )
760{
761 double dNear = camera->nearPlane();
762 double dFar = camera->farPlane();
763 double distance = ( 2.0 * dNear * dFar ) / ( dFar + dNear - ( depth * 2 - 1 ) * ( dFar - dNear ) );
764
765 QgsRay3D ray = Qgs3DUtils::rayFromScreenPoint( screenPoint, screenSize, camera );
766 double dot = QVector3D::dotProduct( ray.direction(), camera->viewVector().normalized() );
767 distance /= dot;
768
769 return ray.origin() + distance * ray.direction();
770}
771
772void Qgs3DUtils::pitchAndYawFromViewVector( QVector3D vect, double &pitch, double &yaw )
773{
774 vect.normalize();
775
776 pitch = qRadiansToDegrees( qAcos( vect.y() ) );
777 yaw = qRadiansToDegrees( qAtan2( -vect.z(), vect.x() ) ) + 90;
778}
779
780QVector2D Qgs3DUtils::screenToTextureCoordinates( QVector2D screenXY, QSize winSize )
781{
782 return QVector2D( screenXY.x() / winSize.width(), 1 - screenXY.y() / winSize.width() );
783}
784
785QVector2D Qgs3DUtils::textureToScreenCoordinates( QVector2D textureXY, QSize winSize )
786{
787 return QVector2D( textureXY.x() * winSize.width(), ( 1 - textureXY.y() ) * winSize.height() );
788}
789
790std::unique_ptr<QgsPointCloudLayer3DRenderer> Qgs3DUtils::convert2DPointCloudRendererTo3D( QgsPointCloudRenderer *renderer )
791{
792 if ( !renderer )
793 return nullptr;
794
795 std::unique_ptr< QgsPointCloud3DSymbol > symbol3D;
796 if ( renderer->type() == QLatin1String( "ramp" ) )
797 {
798 const QgsPointCloudAttributeByRampRenderer *renderer2D = dynamic_cast< const QgsPointCloudAttributeByRampRenderer * >( renderer );
799 symbol3D = std::make_unique< QgsColorRampPointCloud3DSymbol >();
800 QgsColorRampPointCloud3DSymbol *symbol = static_cast< QgsColorRampPointCloud3DSymbol * >( symbol3D.get() );
801 symbol->setAttribute( renderer2D->attribute() );
802 symbol->setColorRampShaderMinMax( renderer2D->minimum(), renderer2D->maximum() );
803 symbol->setColorRampShader( renderer2D->colorRampShader() );
804 }
805 else if ( renderer->type() == QLatin1String( "rgb" ) )
806 {
807 const QgsPointCloudRgbRenderer *renderer2D = dynamic_cast< const QgsPointCloudRgbRenderer * >( renderer );
808 symbol3D = std::make_unique< QgsRgbPointCloud3DSymbol >();
809 QgsRgbPointCloud3DSymbol *symbol = static_cast< QgsRgbPointCloud3DSymbol * >( symbol3D.get() );
810 symbol->setRedAttribute( renderer2D->redAttribute() );
811 symbol->setGreenAttribute( renderer2D->greenAttribute() );
812 symbol->setBlueAttribute( renderer2D->blueAttribute() );
813
814 symbol->setRedContrastEnhancement( renderer2D->redContrastEnhancement() ? new QgsContrastEnhancement( *renderer2D->redContrastEnhancement() ) : nullptr );
815 symbol->setGreenContrastEnhancement( renderer2D->greenContrastEnhancement() ? new QgsContrastEnhancement( *renderer2D->greenContrastEnhancement() ) : nullptr );
816 symbol->setBlueContrastEnhancement( renderer2D->blueContrastEnhancement() ? new QgsContrastEnhancement( *renderer2D->blueContrastEnhancement() ) : nullptr );
817 }
818 else if ( renderer->type() == QLatin1String( "classified" ) )
819 {
820
821 const QgsPointCloudClassifiedRenderer *renderer2D = dynamic_cast< const QgsPointCloudClassifiedRenderer * >( renderer );
822 symbol3D = std::make_unique< QgsClassificationPointCloud3DSymbol >();
823 QgsClassificationPointCloud3DSymbol *symbol = static_cast< QgsClassificationPointCloud3DSymbol * >( symbol3D.get() );
824 symbol->setAttribute( renderer2D->attribute() );
825 symbol->setCategoriesList( renderer2D->categories() );
826 }
827
828 if ( symbol3D )
829 {
830 std::unique_ptr< QgsPointCloudLayer3DRenderer > renderer3D = std::make_unique< QgsPointCloudLayer3DRenderer >();
831 renderer3D->setSymbol( symbol3D.release() );
832 return renderer3D;
833 }
834 return nullptr;
835}
836
837QHash<QgsMapLayer *, QVector<QgsRayCastingUtils::RayHit>> Qgs3DUtils::castRay( Qgs3DMapScene *scene, const QgsRay3D &ray, const QgsRayCastingUtils::RayCastContext &context )
838{
839 QgsRayCastingUtils::Ray3D r( ray.origin(), ray.direction(), context.maxDistance );
840 QHash<QgsMapLayer *, QVector<QgsRayCastingUtils:: RayHit>> results;
841 const QList<QgsMapLayer *> keys = scene->layers();
842 for ( QgsMapLayer *layer : keys )
843 {
844 Qt3DCore::QEntity *entity = scene->layerEntity( layer );
845
846 if ( QgsChunkedEntity *chunkedEntity = qobject_cast<QgsChunkedEntity *>( entity ) )
847 {
848 const QVector<QgsRayCastingUtils::RayHit> result = chunkedEntity->rayIntersection( r, context );
849 if ( !result.isEmpty() )
850 results[ layer ] = result;
851 }
852 }
853 if ( QgsTerrainEntity *terrain = scene->terrainEntity() )
854 {
855 const QVector<QgsRayCastingUtils::RayHit> result = terrain->rayIntersection( r, context );
856 if ( !result.isEmpty() )
857 results[ nullptr ] = result; // Terrain hits are not tied to a layer so we use nullptr as their key here
858 }
859 return results;
860}
861
862float Qgs3DUtils::screenSpaceError( float epsilon, float distance, int screenSize, float fov )
863{
864 /* This routine approximately calculates how an error (epsilon) of an object in world coordinates
865 * at given distance (between camera and the object) will look like in screen coordinates.
866 *
867 * the math below simply uses triangle similarity:
868 *
869 * epsilon phi
870 * ----------------------------- = ----------------
871 * [ frustum width at distance ] [ screen width ]
872 *
873 * Then we solve for phi, substituting [frustum width at distance] = 2 * distance * tan(fov / 2)
874 *
875 * ________xxx__ xxx = real world error (epsilon)
876 * \ | / x = screen space error (phi)
877 * \ | /
878 * \___|_x_/ near plane (screen space)
879 * \ | /
880 * \ | /
881 * \|/ angle = field of view
882 * camera
883 */
884 float phi = epsilon * static_cast<float>( screenSize ) / static_cast<float>( 2 * distance * tan( fov * M_PI / ( 2 * 180 ) ) );
885 return phi;
886}
887
888void Qgs3DUtils::computeBoundingBoxNearFarPlanes( const QgsAABB &bbox, const QMatrix4x4 &viewMatrix, float &fnear, float &ffar )
889{
890 fnear = 1e9;
891 ffar = 0;
892
893 for ( int i = 0; i < 8; ++i )
894 {
895 const QVector4D p( ( ( i >> 0 ) & 1 ) ? bbox.xMin : bbox.xMax,
896 ( ( i >> 1 ) & 1 ) ? bbox.yMin : bbox.yMax,
897 ( ( i >> 2 ) & 1 ) ? bbox.zMin : bbox.zMax, 1 );
898
899 const QVector4D pc = viewMatrix * p;
900
901 const float dst = -pc.z(); // in camera coordinates, x grows right, y grows down, z grows to the back
902 fnear = std::min( fnear, dst );
903 ffar = std::max( ffar, dst );
904 }
905}
906
907Qt3DRender::QCullFace::CullingMode Qgs3DUtils::qt3DcullingMode( Qgs3DTypes::CullingMode mode )
908{
909 switch ( mode )
910 {
911 case Qgs3DTypes::NoCulling: return Qt3DRender::QCullFace::NoCulling;
912 case Qgs3DTypes::Front: return Qt3DRender::QCullFace::Front;
913 case Qgs3DTypes::Back: return Qt3DRender::QCullFace::Back;
914 case Qgs3DTypes::FrontAndBack: return Qt3DRender::QCullFace::FrontAndBack;
915 }
916 return Qt3DRender::QCullFace::NoCulling;
917}
918
919
920QByteArray Qgs3DUtils::addDefinesToShaderCode( const QByteArray &shaderCode, const QStringList &defines )
921{
922 // There is one caveat to take care of - GLSL source code needs to start with #version as
923 // a first directive, otherwise we get the old GLSL 100 version. So we can't just prepend the
924 // shader source code, but insert our defines at the right place.
925
926 QStringList defineLines;
927 for ( const QString &define : defines )
928 defineLines += "#define " + define + "\n";
929
930 QString definesText = defineLines.join( QString() );
931
932 QByteArray newShaderCode = shaderCode;
933 int versionIndex = shaderCode.indexOf( "#version " );
934 int insertionIndex = versionIndex == -1 ? 0 : shaderCode.indexOf( '\n', versionIndex + 1 ) + 1;
935 newShaderCode.insert( insertionIndex, definesText.toLatin1() );
936 return newShaderCode;
937}
938
939QByteArray Qgs3DUtils::removeDefinesFromShaderCode( const QByteArray &shaderCode, const QStringList &defines )
940{
941 QByteArray newShaderCode = shaderCode;
942
943 for ( const QString &define : defines )
944 {
945 const QString defineLine = "#define " + define + "\n";
946 const int defineLineIndex = newShaderCode.indexOf( defineLine.toUtf8() );
947 if ( defineLineIndex != -1 )
948 {
949 newShaderCode.remove( defineLineIndex, defineLine.size() );
950 }
951 }
952
953 return newShaderCode;
954}
955
956void Qgs3DUtils::decomposeTransformMatrix( const QMatrix4x4 &matrix, QVector3D &translation, QQuaternion &rotation, QVector3D &scale )
957{
958 // decompose the transform matrix
959 // assuming the last row has values [0 0 0 1]
960 // see https://math.stackexchange.com/questions/237369/given-this-transformation-matrix-how-do-i-decompose-it-into-translation-rotati
961 const float *md = matrix.data(); // returns data in column-major order
962 const float sx = QVector3D( md[0], md[1], md[2] ).length();
963 const float sy = QVector3D( md[4], md[5], md[6] ).length();
964 const float sz = QVector3D( md[8], md[9], md[10] ).length();
965 float rd[9] =
966 {
967 md[0] / sx, md[4] / sy, md[8] / sz,
968 md[1] / sx, md[5] / sy, md[9] / sz,
969 md[2] / sx, md[6] / sy, md[10] / sz,
970 };
971 const QMatrix3x3 rot3x3( rd ); // takes data in row-major order
972
973 scale = QVector3D( sx, sy, sz );
974 rotation = QQuaternion::fromRotationMatrix( rot3x3 );
975 translation = QVector3D( md[12], md[13], md[14] );
976}
AltitudeClamping
Altitude clamping.
Definition qgis.h:3691
@ 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:3704
@ 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.
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 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 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.
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.
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:39
#define BUILTIN_UNREACHABLE
Definition qgis.h:6571
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.