QGIS API Documentation  3.22.4-Białowieża (ce8e65e95e)
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"
27 #include "qgsexpression.h"
28 #include "qgsexpressionutils.h"
29 #include "qgsoffscreen3dengine.h"
30 
31 #include "qgs3dmapscene.h"
32 #include "qgsabstract3dengine.h"
33 #include "qgsterraingenerator.h"
34 #include "qgscameracontroller.h"
35 
36 #include "qgsline3dsymbol.h"
37 #include "qgspoint3dsymbol.h"
38 #include "qgspolygon3dsymbol.h"
39 
40 #include <Qt3DExtras/QPhongMaterial>
41 #include <Qt3DRender/QRenderSettings>
42 
44 {
45  QImage resImage;
46  QEventLoop evLoop;
47 
48  // We need to change render policy to RenderPolicy::Always, since otherwise render capture node won't work
49  engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::Always );
50 
51  auto requestImageFcn = [&engine, scene]
52  {
53  if ( scene->sceneState() == Qgs3DMapScene::Ready )
54  {
55  engine.requestCaptureImage();
56  }
57  };
58 
59  auto saveImageFcn = [&evLoop, &resImage]( const QImage & img )
60  {
61  resImage = img;
62  evLoop.quit();
63  };
64 
65  const QMetaObject::Connection conn1 = QObject::connect( &engine, &QgsAbstract3DEngine::imageCaptured, saveImageFcn );
66  QMetaObject::Connection conn2;
67 
68  if ( scene->sceneState() == Qgs3DMapScene::Ready )
69  {
70  requestImageFcn();
71  }
72  else
73  {
74  // first wait until scene is loaded
75  conn2 = QObject::connect( scene, &Qgs3DMapScene::sceneStateChanged, requestImageFcn );
76  }
77 
78  evLoop.exec();
79 
80  QObject::disconnect( conn1 );
81  if ( conn2 )
82  QObject::disconnect( conn2 );
83 
84  engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::OnDemand );
85  return resImage;
86 }
87 
88 bool Qgs3DUtils::exportAnimation( const Qgs3DAnimationSettings &animationSettings,
89  const Qgs3DMapSettings &mapSettings,
90  int framesPerSecond,
91  const QString &outputDirectory,
92  const QString &fileNameTemplate,
93  const QSize &outputSize,
94  QString &error,
95  QgsFeedback *feedback
96  )
97 {
98  QgsOffscreen3DEngine engine;
99  engine.setSize( outputSize );
100  Qgs3DMapScene *scene = new Qgs3DMapScene( mapSettings, &engine );
101  engine.setRootEntity( scene );
102  // We need to change render policy to RenderPolicy::Always, since otherwise render capture node won't work
103  engine.renderSettings()->setRenderPolicy( Qt3DRender::QRenderSettings::RenderPolicy::Always );
104 
105  if ( animationSettings.keyFrames().size() < 2 )
106  {
107  error = QObject::tr( "Unable to export 3D animation. Add at least 2 keyframes" );
108  return false;
109  }
110 
111  const float duration = animationSettings.duration(); //in seconds
112  if ( duration <= 0 )
113  {
114  error = QObject::tr( "Unable to export 3D animation (invalid duration)." );
115  return false;
116  }
117 
118  float time = 0;
119  int frameNo = 0;
120  const int totalFrames = static_cast<int>( duration * framesPerSecond );
121 
122  if ( fileNameTemplate.isEmpty() )
123  {
124  error = QObject::tr( "Filename template is empty" );
125  return false;
126  }
127 
128  const int numberOfDigits = fileNameTemplate.count( QLatin1Char( '#' ) );
129  if ( numberOfDigits < 0 )
130  {
131  error = QObject::tr( "Wrong filename template format (must contain #)" );
132  return false;
133  }
134  const QString token( numberOfDigits, QLatin1Char( '#' ) );
135  if ( !fileNameTemplate.contains( token ) )
136  {
137  error = QObject::tr( "Filename template must contain all # placeholders in one continuous group." );
138  return false;
139  }
140 
141  while ( time <= duration )
142  {
143 
144  if ( feedback )
145  {
146  if ( feedback->isCanceled() )
147  {
148  error = QObject::tr( "Export canceled" );
149  return false;
150  }
151  feedback->setProgress( frameNo / static_cast<double>( totalFrames ) * 100 );
152  }
153  ++frameNo;
154 
155  const Qgs3DAnimationSettings::Keyframe kf = animationSettings.interpolate( time );
156  scene->cameraController()->setLookingAtPoint( kf.point, kf.dist, kf.pitch, kf.yaw );
157 
158  QString fileName( fileNameTemplate );
159  const QString frameNoPaddedLeft( QStringLiteral( "%1" ).arg( frameNo, numberOfDigits, 10, QChar( '0' ) ) ); // e.g. 0001
160  fileName.replace( token, frameNoPaddedLeft );
161  const QString path = QDir( outputDirectory ).filePath( fileName );
162 
163  const QImage img = Qgs3DUtils::captureSceneImage( engine, scene );
164 
165  img.save( path );
166 
167  time += 1.0f / static_cast<float>( framesPerSecond );
168  }
169 
170  return true;
171 }
172 
173 
174 int Qgs3DUtils::maxZoomLevel( double tile0width, double tileResolution, double maxError )
175 {
176  if ( maxError <= 0 || tileResolution <= 0 || tile0width <= 0 )
177  return 0; // invalid input
178 
179  // derived from:
180  // tile width [map units] = tile0width / 2^zoomlevel
181  // tile error [map units] = tile width / tile resolution
182  // + re-arranging to get zoom level if we know tile error we want to get
183  const double zoomLevel = -log( tileResolution * maxError / tile0width ) / log( 2 );
184  return round( zoomLevel ); // we could use ceil() here if we wanted to always get to the desired error
185 }
186 
188 {
189  switch ( altClamp )
190  {
191  case Qgs3DTypes::AltClampAbsolute: return QStringLiteral( "absolute" );
192  case Qgs3DTypes::AltClampRelative: return QStringLiteral( "relative" );
193  case Qgs3DTypes::AltClampTerrain: return QStringLiteral( "terrain" );
194  default: Q_ASSERT( false ); return QString();
195  }
196 }
197 
198 
200 {
201  if ( str == QLatin1String( "absolute" ) )
203  else if ( str == QLatin1String( "terrain" ) )
205  else // "relative" (default)
207 }
208 
209 
211 {
212  switch ( altBind )
213  {
214  case Qgs3DTypes::AltBindVertex: return QStringLiteral( "vertex" );
215  case Qgs3DTypes::AltBindCentroid: return QStringLiteral( "centroid" );
216  default: Q_ASSERT( false ); return QString();
217  }
218 }
219 
220 
222 {
223  if ( str == QLatin1String( "vertex" ) )
225  else // "centroid" (default)
227 }
228 
230 {
231  switch ( mode )
232  {
233  case Qgs3DTypes::NoCulling: return QStringLiteral( "no-culling" );
234  case Qgs3DTypes::Front: return QStringLiteral( "front" );
235  case Qgs3DTypes::Back: return QStringLiteral( "back" );
236  case Qgs3DTypes::FrontAndBack: return QStringLiteral( "front-and-back" );
237  }
238  return QString();
239 }
240 
242 {
243  if ( str == QLatin1String( "front" ) )
244  return Qgs3DTypes::Front;
245  else if ( str == QLatin1String( "back" ) )
246  return Qgs3DTypes::Back;
247  else if ( str == QLatin1String( "front-and-back" ) )
249  else
250  return Qgs3DTypes::NoCulling;
251 }
252 
254 {
255  float terrainZ = 0;
256  if ( altClamp == Qgs3DTypes::AltClampRelative || altClamp == Qgs3DTypes::AltClampTerrain )
257  {
258  const QgsPointXY pt = altBind == Qgs3DTypes::AltBindVertex ? p : centroid;
259  terrainZ = map.terrainGenerator() ? map.terrainGenerator()->heightAt( pt.x(), pt.y(), map ) : 0;
260  }
261 
262  float geomZ = 0;
263  if ( p.is3D() && ( altClamp == Qgs3DTypes::AltClampAbsolute || altClamp == Qgs3DTypes::AltClampRelative ) )
264  geomZ = p.z();
265 
266  const float z = ( terrainZ + geomZ ) * map.terrainVerticalScale() + height;
267  return z;
268 }
269 
271 {
272  for ( int i = 0; i < lineString->nCoordinates(); ++i )
273  {
274  float terrainZ = 0;
275  if ( altClamp == Qgs3DTypes::AltClampRelative || altClamp == Qgs3DTypes::AltClampTerrain )
276  {
277  QgsPointXY pt;
278  if ( altBind == Qgs3DTypes::AltBindVertex )
279  {
280  pt.setX( lineString->xAt( i ) );
281  pt.setY( lineString->yAt( i ) );
282  }
283  else
284  {
285  pt.set( centroid.x(), centroid.y() );
286  }
287 
288  terrainZ = map.terrainGenerator() ? map.terrainGenerator()->heightAt( pt.x(), pt.y(), map ) : 0;
289  }
290 
291  float geomZ = 0;
292  if ( altClamp == Qgs3DTypes::AltClampAbsolute || altClamp == Qgs3DTypes::AltClampRelative )
293  geomZ = lineString->zAt( i );
294 
295  const float z = ( terrainZ + geomZ ) * map.terrainVerticalScale() + height;
296  lineString->setZAt( i, z );
297  }
298 }
299 
300 
302 {
303  if ( !polygon->is3D() )
304  polygon->addZValue( 0 );
305 
307  if ( altBind == Qgs3DTypes::AltBindCentroid )
308  centroid = polygon->centroid();
309 
310  QgsCurve *curve = const_cast<QgsCurve *>( polygon->exteriorRing() );
311  QgsLineString *lineString = qgsgeometry_cast<QgsLineString *>( curve );
312  if ( !lineString )
313  return false;
314 
315  clampAltitudes( lineString, altClamp, altBind, centroid, height, map );
316 
317  for ( int i = 0; i < polygon->numInteriorRings(); ++i )
318  {
319  QgsCurve *curve = const_cast<QgsCurve *>( polygon->interiorRing( i ) );
320  QgsLineString *lineString = qgsgeometry_cast<QgsLineString *>( curve );
321  if ( !lineString )
322  return false;
323 
324  clampAltitudes( lineString, altClamp, altBind, centroid, height, map );
325  }
326  return true;
327 }
328 
329 
330 QString Qgs3DUtils::matrix4x4toString( const QMatrix4x4 &m )
331 {
332  const float *d = m.constData();
333  QStringList elems;
334  elems.reserve( 16 );
335  for ( int i = 0; i < 16; ++i )
336  elems << QString::number( d[i] );
337  return elems.join( ' ' );
338 }
339 
340 QMatrix4x4 Qgs3DUtils::stringToMatrix4x4( const QString &str )
341 {
342  QMatrix4x4 m;
343  float *d = m.data();
344  QStringList elems = str.split( ' ' );
345  for ( int i = 0; i < 16; ++i )
346  d[i] = elems[i].toFloat();
347  return m;
348 }
349 
350 void Qgs3DUtils::extractPointPositions( const QgsFeature &f, const Qgs3DMapSettings &map, Qgs3DTypes::AltitudeClamping altClamp, QVector<QVector3D> &positions )
351 {
352  const QgsAbstractGeometry *g = f.geometry().constGet();
353  for ( auto it = g->vertices_begin(); it != g->vertices_end(); ++it )
354  {
355  const QgsPoint pt = *it;
356  float geomZ = 0;
357  if ( pt.is3D() )
358  {
359  geomZ = pt.z();
360  }
361  const float terrainZ = map.terrainGenerator() ? map.terrainGenerator()->heightAt( pt.x(), pt.y(), map ) * map.terrainVerticalScale() : 0;
362  float h;
363  switch ( altClamp )
364  {
366  default:
367  h = geomZ;
368  break;
370  h = terrainZ;
371  break;
373  h = terrainZ + geomZ;
374  break;
375  }
376  positions.append( QVector3D( pt.x() - map.origin().x(), h, -( pt.y() - map.origin().y() ) ) );
377  QgsDebugMsgLevel( QStringLiteral( "%1 %2 %3" ).arg( positions.last().x() ).arg( positions.last().y() ).arg( positions.last().z() ), 2 );
378  }
379 }
380 
386 static inline uint outcode( QVector4D v )
387 {
388  // For a discussion of outcodes see pg 388 Dunn & Parberry.
389  // For why you can't just test if the point is in a bounding box
390  // consider the case where a view frustum with view-size 1.5 x 1.5
391  // is tested against a 2x2 box which encloses the near-plane, while
392  // all the points in the box are outside the frustum.
393  // TODO: optimise this with assembler - according to D&P this can
394  // be done in one line of assembler on some platforms
395  uint code = 0;
396  if ( v.x() < -v.w() ) code |= 0x01;
397  if ( v.x() > v.w() ) code |= 0x02;
398  if ( v.y() < -v.w() ) code |= 0x04;
399  if ( v.y() > v.w() ) code |= 0x08;
400  if ( v.z() < -v.w() ) code |= 0x10;
401  if ( v.z() > v.w() ) code |= 0x20;
402  return code;
403 }
404 
405 
416 bool Qgs3DUtils::isCullable( const QgsAABB &bbox, const QMatrix4x4 &viewProjectionMatrix )
417 {
418  uint out = 0xff;
419 
420  for ( int i = 0; i < 8; ++i )
421  {
422  const QVector4D p( ( ( i >> 0 ) & 1 ) ? bbox.xMin : bbox.xMax,
423  ( ( i >> 1 ) & 1 ) ? bbox.yMin : bbox.yMax,
424  ( ( i >> 2 ) & 1 ) ? bbox.zMin : bbox.zMax, 1 );
425  const QVector4D pc = viewProjectionMatrix * p;
426 
427  // if the logical AND of all the outcodes is non-zero then the BB is
428  // definitely outside the view frustum.
429  out = out & outcode( pc );
430  }
431  return out;
432 }
433 
435 {
436  return QgsVector3D( mapCoords.x() - origin.x(),
437  mapCoords.z() - origin.z(),
438  -( mapCoords.y() - origin.y() ) );
439 
440 }
441 
443 {
444  return QgsVector3D( worldCoords.x() + origin.x(),
445  -worldCoords.z() + origin.y(),
446  worldCoords.y() + origin.z() );
447 }
448 
449 static QgsRectangle _tryReprojectExtent2D( const QgsRectangle &extent, const QgsCoordinateReferenceSystem &crs1, const QgsCoordinateReferenceSystem &crs2, const QgsCoordinateTransformContext &context )
450 {
451  QgsRectangle extentMapCrs( extent );
452  if ( crs1 != crs2 )
453  {
454  // reproject if necessary
455  QgsCoordinateTransform ct( crs1, crs2, context );
456  ct.setBallparkTransformsAreAppropriate( true );
457  try
458  {
459  extentMapCrs = ct.transformBoundingBox( extentMapCrs );
460  }
461  catch ( const QgsCsException & )
462  {
463  // bad luck, can't reproject for some reason
464  QgsDebugMsg( QStringLiteral( "3D utils: transformation of extent failed: " ) + extentMapCrs.toString( -1 ) );
465  }
466  }
467  return extentMapCrs;
468 }
469 
470 QgsAABB Qgs3DUtils::layerToWorldExtent( const QgsRectangle &extent, double zMin, double zMax, const QgsCoordinateReferenceSystem &layerCrs, const QgsVector3D &mapOrigin, const QgsCoordinateReferenceSystem &mapCrs, const QgsCoordinateTransformContext &context )
471 {
472  const QgsRectangle extentMapCrs( _tryReprojectExtent2D( extent, layerCrs, mapCrs, context ) );
473  return mapToWorldExtent( extentMapCrs, zMin, zMax, mapOrigin );
474 }
475 
477 {
478  const QgsRectangle extentMap = worldToMapExtent( bbox, mapOrigin );
479  return _tryReprojectExtent2D( extentMap, mapCrs, layerCrs, context );
480 }
481 
482 QgsAABB Qgs3DUtils::mapToWorldExtent( const QgsRectangle &extent, double zMin, double zMax, const QgsVector3D &mapOrigin )
483 {
484  const QgsVector3D extentMin3D( extent.xMinimum(), extent.yMinimum(), zMin );
485  const QgsVector3D extentMax3D( extent.xMaximum(), extent.yMaximum(), zMax );
486  const QgsVector3D worldExtentMin3D = mapToWorldCoordinates( extentMin3D, mapOrigin );
487  const QgsVector3D worldExtentMax3D = mapToWorldCoordinates( extentMax3D, mapOrigin );
488  QgsAABB rootBbox( worldExtentMin3D.x(), worldExtentMin3D.y(), worldExtentMin3D.z(),
489  worldExtentMax3D.x(), worldExtentMax3D.y(), worldExtentMax3D.z() );
490  return rootBbox;
491 }
492 
494 {
495  const QgsVector3D worldExtentMin3D = Qgs3DUtils::worldToMapCoordinates( QgsVector3D( bbox.xMin, bbox.yMin, bbox.zMin ), mapOrigin );
496  const QgsVector3D worldExtentMax3D = Qgs3DUtils::worldToMapCoordinates( QgsVector3D( bbox.xMax, bbox.yMax, bbox.zMax ), mapOrigin );
497  const QgsRectangle extentMap( worldExtentMin3D.x(), worldExtentMin3D.y(), worldExtentMax3D.x(), worldExtentMax3D.y() );
498  // we discard zMin/zMax here because we don't need it
499  return extentMap;
500 }
501 
502 
504 {
505  const QgsVector3D mapPoint1 = worldToMapCoordinates( worldPoint1, origin1 );
506  QgsVector3D mapPoint2 = mapPoint1;
507  if ( crs1 != crs2 )
508  {
509  // reproject if necessary
510  const QgsCoordinateTransform ct( crs1, crs2, context );
511  try
512  {
513  const QgsPointXY pt = ct.transform( QgsPointXY( mapPoint1.x(), mapPoint1.y() ) );
514  mapPoint2.set( pt.x(), pt.y(), mapPoint1.z() );
515  }
516  catch ( const QgsCsException & )
517  {
518  // bad luck, can't reproject for some reason
519  }
520  }
521  return mapToWorldCoordinates( mapPoint2, origin2 );
522 }
523 
524 void Qgs3DUtils::estimateVectorLayerZRange( QgsVectorLayer *layer, double &zMin, double &zMax )
525 {
526  if ( !QgsWkbTypes::hasZ( layer->wkbType() ) )
527  {
528  zMin = 0;
529  zMax = 0;
530  return;
531  }
532 
533  zMin = std::numeric_limits<double>::max();
534  zMax = std::numeric_limits<double>::min();
535 
536  QgsFeature f;
537  QgsFeatureIterator it = layer->getFeatures( QgsFeatureRequest().setNoAttributes().setLimit( 100 ) );
538  while ( it.nextFeature( f ) )
539  {
540  const QgsGeometry g = f.geometry();
541  for ( auto vit = g.vertices_begin(); vit != g.vertices_end(); ++vit )
542  {
543  const double z = ( *vit ).z();
544  if ( z < zMin ) zMin = z;
545  if ( z > zMax ) zMax = z;
546  }
547  }
548 
549  if ( zMin == std::numeric_limits<double>::max() && zMax == std::numeric_limits<double>::min() )
550  {
551  zMin = 0;
552  zMax = 0;
553  }
554 }
555 
557 {
558  QgsExpressionContext exprContext;
562  return exprContext;
563 }
564 
566 {
567  QgsPhongMaterialSettings settings;
568  settings.setAmbient( material->ambient() );
569  settings.setDiffuse( material->diffuse() );
570  settings.setSpecular( material->specular() );
571  settings.setShininess( material->shininess() );
572  return settings;
573 }
574 
575 QgsRay3D Qgs3DUtils::rayFromScreenPoint( const QPoint &point, const QSize &windowSize, Qt3DRender::QCamera *camera )
576 {
577  const QVector3D deviceCoords( point.x(), point.y(), 0.0 );
578  // normalized device coordinates
579  const QVector3D normDeviceCoords( 2.0 * deviceCoords.x() / windowSize.width() - 1.0f, 1.0f - 2.0 * deviceCoords.y() / windowSize.height(), camera->nearPlane() );
580  // clip coordinates
581  const QVector4D rayClip( normDeviceCoords.x(), normDeviceCoords.y(), -1.0, 0.0 );
582 
583  const QMatrix4x4 invertedProjMatrix = camera->projectionMatrix().inverted();
584  const QMatrix4x4 invertedViewMatrix = camera->viewMatrix().inverted();
585 
586  // ray direction in view coordinates
587  QVector4D rayDirView = invertedProjMatrix * rayClip;
588  // ray origin in world coordinates
589  const QVector4D rayOriginWorld = invertedViewMatrix * QVector4D( 0.0f, 0.0f, 0.0f, 1.0f );
590 
591  // ray direction in world coordinates
592  rayDirView.setZ( -1.0f );
593  rayDirView.setW( 0.0f );
594  const QVector4D rayDirWorld4D = invertedViewMatrix * rayDirView;
595  QVector3D rayDirWorld( rayDirWorld4D.x(), rayDirWorld4D.y(), rayDirWorld4D.z() );
596  rayDirWorld = rayDirWorld.normalized();
597 
598  return QgsRay3D( QVector3D( rayOriginWorld ), rayDirWorld );
599 }
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.
@ Ready
The scene is fully loaded/updated.
Definition: qgs3dmapscene.h:96
QgsCameraController * cameraController()
Returns camera controller.
Definition: qgs3dmapscene.h:77
void sceneStateChanged()
Emitted when the scene's state has changed.
SceneState sceneState() const
Returns the current state of the scene.
QgsTerrainGenerator * terrainGenerator() const
Returns terrain generator. It takes care of producing terrain tiles from the input data.
double terrainVerticalScale() const
Returns vertical scale (exaggeration) of terrain.
QgsVector3D origin() const
Returns coordinates in map CRS at which 3D scene has origin (0,0,0)
AltitudeClamping
how to handle altitude of vector features
Definition: qgs3dtypes.h:35
@ AltClampAbsolute
Z_final = z_geometry.
Definition: qgs3dtypes.h:36
@ AltClampTerrain
Z_final = z_terrain.
Definition: qgs3dtypes.h:38
@ AltClampRelative
Z_final = z_terrain + z_geometry.
Definition: qgs3dtypes.h:37
AltitudeBinding
how to handle clamping of vertices of individual features
Definition: qgs3dtypes.h:43
@ AltBindCentroid
Clamp just centroid of feature.
Definition: qgs3dtypes.h:45
@ AltBindVertex
Clamp every vertex of feature.
Definition: qgs3dtypes.h:44
CullingMode
Triangle culling mode.
Definition: qgs3dtypes.h:50
@ FrontAndBack
Will not render anything.
Definition: qgs3dtypes.h:54
@ NoCulling
Will render both front and back faces of triangles.
Definition: qgs3dtypes.h:51
@ Front
Will render only back faces of triangles.
Definition: qgs3dtypes.h:52
@ Back
Will render only front faces of triangles (recommended when input data are consistent)
Definition: qgs3dtypes.h:53
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)
Definition: qgs3dutils.cpp:503
static QString altBindingToString(Qgs3DTypes::AltitudeBinding altBind)
Converts a value from AltitudeBinding enum to a string.
Definition: qgs3dutils.cpp:210
static Qgs3DTypes::CullingMode cullingModeFromString(const QString &str)
Converts a string to a value from CullingMode enum.
Definition: qgs3dutils.cpp:241
static QString altClampingToString(Qgs3DTypes::AltitudeClamping altClamp)
Converts a value from AltitudeClamping enum to a string.
Definition: qgs3dutils.cpp:187
static void clampAltitudes(QgsLineString *lineString, Qgs3DTypes::AltitudeClamping altClamp, Qgs3DTypes::AltitudeBinding altBind, const QgsPoint &centroid, float height, const Qgs3DMapSettings &map)
Clamps altitude of vertices of a linestring according to the settings.
Definition: qgs3dutils.cpp:270
static QString matrix4x4toString(const QMatrix4x4 &m)
Converts a 4x4 transform matrix to a string.
Definition: qgs3dutils.cpp:330
static QgsRectangle worldToMapExtent(const QgsAABB &bbox, const QgsVector3D &mapOrigin)
Converts axis aligned bounding box in 3D world coordinates to extent in map coordinates.
Definition: qgs3dutils.cpp:493
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.
Definition: qgs3dutils.cpp:476
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...
Definition: qgs3dutils.cpp:174
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.
Definition: qgs3dutils.cpp:482
static float clampAltitude(const QgsPoint &p, Qgs3DTypes::AltitudeClamping altClamp, Qgs3DTypes::AltitudeBinding altBind, float height, const QgsPoint &centroid, const Qgs3DMapSettings &map)
Clamps altitude of a vertex according to the settings, returns Z value.
Definition: qgs3dutils.cpp:253
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.
Definition: qgs3dutils.cpp:470
static QString cullingModeToString(Qgs3DTypes::CullingMode mode)
Converts a value from CullingMode enum to a string.
Definition: qgs3dutils.cpp:229
static bool isCullable(const QgsAABB &bbox, const QMatrix4x4 &viewProjectionMatrix)
Returns true if bbox is completely outside the current viewing volume.
Definition: qgs3dutils.cpp:416
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.
Definition: qgs3dutils.cpp:524
static QgsPhongMaterialSettings phongMaterialFromQt3DComponent(Qt3DExtras::QPhongMaterial *material)
Returns phong material settings object based on the Qt3D material.
Definition: qgs3dutils.cpp:565
static void extractPointPositions(const QgsFeature &f, const Qgs3DMapSettings &map, Qgs3DTypes::AltitudeClamping altClamp, QVector< QVector3D > &positions)
Calculates (x,y,z) positions of (multi)point from the given feature.
Definition: qgs3dutils.cpp:350
static Qgs3DTypes::AltitudeClamping altClampingFromString(const QString &str)
Converts a string to a value from AltitudeClamping enum.
Definition: qgs3dutils.cpp:199
static QMatrix4x4 stringToMatrix4x4(const QString &str)
Convert a string to a 4x4 transform matrix.
Definition: qgs3dutils.cpp:340
static QgsVector3D worldToMapCoordinates(const QgsVector3D &worldCoords, const QgsVector3D &origin)
Converts 3D world coordinates to map coordinates (applies offset and turns (x,y,z) into (x,...
Definition: qgs3dutils.cpp:442
static QgsVector3D mapToWorldCoordinates(const QgsVector3D &mapCoords, const QgsVector3D &origin)
Converts map coordinates to 3D world coordinates (applies offset and turns (x,y,z) into (x,...
Definition: qgs3dutils.cpp:434
static bool exportAnimation(const Qgs3DAnimationSettings &animationSettings, const 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.
Definition: qgs3dutils.cpp:88
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.
Definition: qgs3dutils.cpp:575
static QImage captureSceneImage(QgsAbstract3DEngine &engine, Qgs3DMapScene *scene)
Captures image of the current 3D scene of a 3D engine.
Definition: qgs3dutils.cpp:43
static Qgs3DTypes::AltitudeBinding altBindingFromString(const QString &str)
Converts a string to a value from AltitudeBinding enum.
Definition: qgs3dutils.cpp:221
static QgsExpressionContext globalProjectLayerExpressionContext(QgsVectorLayer *layer)
Returns expression context for use in preparation of 3D data of a layer.
Definition: qgs3dutils.cpp:556
3
Definition: qgsaabb.h:34
float yMax
Definition: qgsaabb.h:85
float xMax
Definition: qgsaabb.h:84
float xMin
Definition: qgsaabb.h:81
float zMax
Definition: qgsaabb.h:86
float yMin
Definition: qgsaabb.h:82
float zMin
Definition: qgsaabb.h:83
void requestCaptureImage()
Starts a request for an image rendered by the engine.
void imageCaptured(const QImage &image)
Emitted after a call to requestCaptureImage() to return the captured image.
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 SIP_HOLDGIL
Returns true if the geometry is 3D and contains a z-value.
vertex_iterator vertices_begin() const
Returns STL-style iterator pointing to the first vertex of the geometry.
virtual QgsPoint centroid() const
Returns the centroid of the geometry.
void setLookingAtPoint(const QgsVector3D &point, float distance, float pitch, float yaw)
Sets the complete camera configuration: the point towards it is looking (in 3D world coordinates),...
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.
QgsPointXY transform(const QgsPointXY &point, Qgis::TransformDirection direction=Qgis::TransformDirection::Forward) const SIP_THROW(QgsCsException)
Transform the point from the source CRS to the destination CRS.
Custom exception class for Coordinate Reference System related exceptions.
Definition: qgsexception.h:66
bool addZValue(double zValue=0) override
Adds a z-dimension to the geometry, initialized to a preset value.
const QgsCurve * interiorRing(int i) const SIP_HOLDGIL
Retrieves an interior ring from the curve polygon.
const QgsCurve * exteriorRing() const SIP_HOLDGIL
Returns the curve polygon's exterior ring.
int numInteriorRings() const SIP_HOLDGIL
Returns the number of interior rings contained with the curve polygon.
Abstract base class for curved geometry type.
Definition: qgscurve.h:36
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)
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:56
QgsGeometry geometry
Definition: qgsfeature.h:67
Base class for feedback objects to be used for cancellation of something running in a worker thread.
Definition: qgsfeedback.h:45
bool isCanceled() const SIP_HOLDGIL
Tells whether the operation has been canceled already.
Definition: qgsfeedback.h:54
void setProgress(double progress)
Sets the current progress for the feedback object.
Definition: qgsfeedback.h:63
A geometry is the spatial representation of a feature.
Definition: qgsgeometry.h:125
const QgsAbstractGeometry * constGet() const SIP_HOLDGIL
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.
Definition: qgslinestring.h:44
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.
int nCoordinates() const override SIP_HOLDGIL
Returns the number of nodes contained in the geometry.
double zAt(int index) const
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.
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 setAmbient(const QColor &ambient)
Sets ambient color component.
void setShininess(float shininess)
Sets shininess of the surface.
void setSpecular(const QColor &specular)
Sets specular color component.
A class to represent a 2D point.
Definition: qgspointxy.h:59
void set(double x, double y) SIP_HOLDGIL
Sets the x and y value of the point.
Definition: qgspointxy.h:139
void setX(double x) SIP_HOLDGIL
Sets the x value of the point.
Definition: qgspointxy.h:122
double y
Definition: qgspointxy.h:63
Q_GADGET double x
Definition: qgspointxy.h:62
void setY(double y) SIP_HOLDGIL
Sets the y value of the point.
Definition: qgspointxy.h:132
Point geometry type, with support for z-dimension and m-values.
Definition: qgspoint.h:49
Q_GADGET double x
Definition: qgspoint.h:52
double z
Definition: qgspoint.h:54
double y
Definition: qgspoint.h:53
Polygon geometry type.
Definition: qgspolygon.h:34
static QgsProject * instance()
Returns the QgsProject singleton instance.
Definition: qgsproject.cpp:467
A representation of a ray in 3D.
Definition: qgsray3d.h:31
A rectangle specified with double values.
Definition: qgsrectangle.h:42
double yMaximum() const SIP_HOLDGIL
Returns the y maximum value (top side of rectangle).
Definition: qgsrectangle.h:193
double xMaximum() const SIP_HOLDGIL
Returns the x maximum value (right side of rectangle).
Definition: qgsrectangle.h:183
double xMinimum() const SIP_HOLDGIL
Returns the x minimum value (left side of rectangle).
Definition: qgsrectangle.h:188
double yMinimum() const SIP_HOLDGIL
Returns the y minimum value (bottom side of rectangle).
Definition: qgsrectangle.h:198
virtual float heightAt(double x, double y, const Qgs3DMapSettings &map) const
Returns height at (x,y) in terrain's CRS.
double y() const
Returns Y coordinate.
Definition: qgsvector3d.h:51
double z() const
Returns Z coordinate.
Definition: qgsvector3d.h:53
double x() const
Returns X coordinate.
Definition: qgsvector3d.h:49
void set(double x, double y, double z)
Sets vector coordinates.
Definition: qgsvector3d.h:56
Represents a vector layer which manages a vector based data sets.
Q_INVOKABLE QgsWkbTypes::Type wkbType() const FINAL
Returns the WKBType or WKBUnknown in case of error.
QgsFeatureIterator getFeatures(const QgsFeatureRequest &request=QgsFeatureRequest()) const FINAL
Queries the layer for features specified in request.
static bool hasZ(Type type) SIP_HOLDGIL
Tests whether a WKB type contains the z-dimension.
Definition: qgswkbtypes.h:1080
CORE_EXPORT QgsMeshVertex centroid(const QgsMeshFace &face, const QVector< QgsMeshVertex > &vertices)
Returns the centroid of the face.
#define str(x)
Definition: qgis.cpp:37
#define QgsDebugMsgLevel(str, level)
Definition: qgslogger.h:39
#define QgsDebugMsg(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.