QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgs3d.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgs3d.cpp
3 ----------
4 begin : July 2020
5 copyright : (C) 2020 by Nyall Dawson
6 email : nyall dot dawson at gmail dot com
7 ***************************************************************************/
8
9/***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17
18#include "qgs3d.h"
19
20#include "qgsapplication.h"
21#include "qgs3drendererregistry.h"
22
23#include "qgsabstract3drenderer.h"
24#include "qgs3drendererregistry.h"
25#include "qgsrulebased3drenderer.h"
26#include "qgsvectorlayer3drenderer.h"
27#include "qgsmeshlayer3drenderer.h"
28#include "qgspointcloudlayer3drenderer.h"
29#include "qgstiledscenelayer3drenderer.h"
30#include "qgs3dsymbolregistry.h"
31#include "qgspoint3dsymbol.h"
32#include "qgsline3dsymbol.h"
33#include "qgspolygon3dsymbol.h"
34#include "qgsmaterialregistry.h"
35
36#include "qgspolygon3dsymbol_p.h"
37#include "qgspoint3dsymbol_p.h"
38#include "qgsline3dsymbol_p.h"
39#include "qgsgoochmaterialsettings.h"
40#include "qgsmetalroughmaterialsettings.h"
41#include "qgssimplelinematerialsettings.h"
42#include "qgsphongtexturedmaterialsettings.h"
43#include "qgsnullmaterialsettings.h"
44
45#include "qgsstyle.h"
46
47Qgs3D *Qgs3D::instance()
48{
49 static Qgs3D *sInstance( new Qgs3D() );
50 return sInstance;
51}
52
53Qgs3D::~Qgs3D()
54{
55}
56
57void Qgs3D::initialize()
58{
59 if ( instance()->mInitialized )
60 return;
61
62 instance()->mInitialized = true;
63
64 QgsApplication::renderer3DRegistry()->addRenderer( new QgsVectorLayer3DRendererMetadata );
65 QgsApplication::renderer3DRegistry()->addRenderer( new QgsRuleBased3DRendererMetadata );
66 QgsApplication::renderer3DRegistry()->addRenderer( new QgsMeshLayer3DRendererMetadata );
67 QgsApplication::renderer3DRegistry()->addRenderer( new QgsPointCloudLayer3DRendererMetadata );
68 QgsApplication::renderer3DRegistry()->addRenderer( new QgsTiledSceneLayer3DRendererMetadata );
69
70 QgsApplication::symbol3DRegistry()->addSymbolType( new Qgs3DSymbolMetadata( QStringLiteral( "point" ), QObject::tr( "Point" ),
71 &QgsPoint3DSymbol::create, nullptr, Qgs3DSymbolImpl::handlerForPoint3DSymbol ) );
72 QgsApplication::symbol3DRegistry()->addSymbolType( new Qgs3DSymbolMetadata( QStringLiteral( "line" ), QObject::tr( "Line" ),
73 &QgsLine3DSymbol::create, nullptr, Qgs3DSymbolImpl::handlerForLine3DSymbol ) );
74 QgsApplication::symbol3DRegistry()->addSymbolType( new Qgs3DSymbolMetadata( QStringLiteral( "polygon" ), QObject::tr( "Polygon" ),
75 &QgsPolygon3DSymbol::create, nullptr, Qgs3DSymbolImpl::handlerForPolygon3DSymbol ) );
76
77 Qgs3D::materialRegistry()->addMaterialSettingsType( new QgsMaterialSettingsMetadata( QStringLiteral( "null" ), QObject::tr( "Embedded Textures" ),
78 QgsNullMaterialSettings::create, QgsNullMaterialSettings::supportsTechnique, nullptr, QgsApplication::getThemeIcon( QStringLiteral( "/mIconPhongTexturedMaterial.svg" ) ) ) );
79 Qgs3D::materialRegistry()->addMaterialSettingsType( new QgsMaterialSettingsMetadata( QStringLiteral( "phong" ), QObject::tr( "Realistic (Phong)" ),
80 QgsPhongMaterialSettings::create, QgsPhongMaterialSettings::supportsTechnique, nullptr, QgsApplication::getThemeIcon( QStringLiteral( "/mIconPhongMaterial.svg" ) ) ) );
81 Qgs3D::materialRegistry()->addMaterialSettingsType( new QgsMaterialSettingsMetadata( QStringLiteral( "phongtextured" ), QObject::tr( "Realistic Textured (Phong)" ),
82 QgsPhongTexturedMaterialSettings::create, QgsPhongTexturedMaterialSettings::supportsTechnique, nullptr, QgsApplication::getThemeIcon( QStringLiteral( "/mIconPhongTexturedMaterial.svg" ) ) ) );
83 Qgs3D::materialRegistry()->addMaterialSettingsType( new QgsMaterialSettingsMetadata( QStringLiteral( "simpleline" ), QObject::tr( "Single Color (Unlit)" ),
84 QgsSimpleLineMaterialSettings::create, QgsSimpleLineMaterialSettings::supportsTechnique, nullptr, QgsApplication::getThemeIcon( QStringLiteral( "/mIconSimpleLineMaterial.svg" ) ) ) );
85 Qgs3D::materialRegistry()->addMaterialSettingsType( new QgsMaterialSettingsMetadata( QStringLiteral( "gooch" ), QObject::tr( "CAD (Gooch)" ),
86 QgsGoochMaterialSettings::create, QgsGoochMaterialSettings::supportsTechnique, nullptr, QgsApplication::getThemeIcon( QStringLiteral( "/mIconGoochMaterial.svg" ) ) ) );
87 Qgs3D::materialRegistry()->addMaterialSettingsType( new QgsMaterialSettingsMetadata( QStringLiteral( "metalrough" ), QObject::tr( "Metal Roughness" ),
88 QgsMetalRoughMaterialSettings::create, QgsMetalRoughMaterialSettings::supportsTechnique, nullptr, QgsApplication::getThemeIcon( QStringLiteral( "/mIconGoochMaterial.svg" ) ) ) );
89
90 // because we are usually populating the 3d registry AFTER QgsApplication initialization, we need to defer creation
91 // of 3d symbols in the default style until now
92 QgsStyle::defaultStyle()->handleDeferred3DSymbolCreation();
93}
94
95QgsMaterialRegistry *Qgs3D::materialRegistry()
96{
97 return instance()->mMaterialRegistry;
98}
99
100Qgs3D::Qgs3D()
101{
102 mMaterialRegistry = new QgsMaterialRegistry();
103}
Qgs3DRendererRegistry::addRenderer
void addRenderer(Qgs3DRendererAbstractMetadata *metadata)
Registers a new 3D renderer type.
Definition: qgs3drendererregistry.cpp:38
Qgs3DSymbolMetadata
Convenience metadata class that uses static functions to create a 3D symbol and its widget.
Definition: qgs3dsymbolregistry.h:118
Qgs3DSymbolRegistry::addSymbolType
bool addSymbolType(Qgs3DSymbolAbstractMetadata *metadata)
Registers a new symbol type. Takes ownership of the metadata instance.
Definition: qgs3dsymbolregistry.cpp:28
Qgs3D
Qgs3D is a singleton class containing various registries and other global members related to 3D class...
Definition: qgs3d.h:33
Qgs3D::initialize
static void initialize()
Initializes the 3D framework.
Definition: qgs3d.cpp:57
Qgs3D::materialRegistry
static QgsMaterialRegistry * materialRegistry()
Returns the material registry, used for managing 3D materials.
Definition: qgs3d.cpp:95
Qgs3D::instance
static Qgs3D * instance()
Returns a pointer to the singleton instance.
Definition: qgs3d.cpp:47
Qgs3D::~Qgs3D
~Qgs3D()
Definition: qgs3d.cpp:53
QgsApplication::getThemeIcon
static QIcon getThemeIcon(const QString &name, const QColor &fillColor=QColor(), const QColor &strokeColor=QColor())
Helper to get a theme icon.
Definition: qgsapplication.cpp:772
QgsApplication::symbol3DRegistry
static Qgs3DSymbolRegistry * symbol3DRegistry()
Returns registry of available 3D symbols.
Definition: qgsapplication.cpp:2621
QgsApplication::renderer3DRegistry
static Qgs3DRendererRegistry * renderer3DRegistry()
Returns registry of available 3D renderers.
Definition: qgsapplication.cpp:2616
QgsGoochMaterialSettings::create
static QgsAbstractMaterialSettings * create()
Returns a new instance of QgsGoochMaterialSettings.
Definition: qgsgoochmaterialsettings.cpp:48
QgsGoochMaterialSettings::supportsTechnique
static bool supportsTechnique(QgsMaterialSettingsRenderingTechnique technique)
Returns true if the specified technique is supported by the Gooch material.
Definition: qgsgoochmaterialsettings.cpp:53
QgsLine3DSymbol::create
static QgsAbstract3DSymbol * create() SIP_FACTORY
Creates a new QgsLine3DSymbol.
Definition: qgsline3dsymbol.cpp:116
QgsMaterialRegistry
Registry of available 3d material settings classes.
Definition: qgsmaterialregistry.h:186
QgsMaterialRegistry::addMaterialSettingsType
bool addMaterialSettingsType(QgsMaterialSettingsAbstractMetadata *metadata)
Registers a new material settings type. Takes ownership of the metadata instance.
Definition: qgsmaterialregistry.cpp:28
QgsMaterialSettingsMetadata
Convenience metadata class that uses static functions to create a 3D material settings object and its...
Definition: qgsmaterialregistry.h:122
QgsMeshLayer3DRendererMetadata
Metadata for mesh layer 3D renderer to allow creation of its instances from XML.
Definition: qgsmeshlayer3drenderer.h:45
QgsMetalRoughMaterialSettings::create
static QgsAbstractMaterialSettings * create()
Returns a new instance of QgsMetalRoughMaterialSettings.
Definition: qgsmetalroughmaterialsettings.cpp:43
QgsMetalRoughMaterialSettings::supportsTechnique
static bool supportsTechnique(QgsMaterialSettingsRenderingTechnique technique)
Returns true if the specified technique is supported by the metal rough material.
Definition: qgsmetalroughmaterialsettings.cpp:25
QgsNullMaterialSettings::create
static QgsAbstractMaterialSettings * create()
Returns a new instance of QgsNullMaterialSettings.
Definition: qgsnullmaterialsettings.cpp:43
QgsNullMaterialSettings::supportsTechnique
static bool supportsTechnique(QgsMaterialSettingsRenderingTechnique technique)
Returns true if the specified technique is supported by the material.
Definition: qgsnullmaterialsettings.cpp:25
QgsPhongMaterialSettings::create
static QgsAbstractMaterialSettings * create()
Returns a new instance of QgsPhongMaterialSettings.
Definition: qgsphongmaterialsettings.cpp:66
QgsPhongMaterialSettings::supportsTechnique
static bool supportsTechnique(QgsMaterialSettingsRenderingTechnique technique)
Returns true if the specified technique is supported by the Phong material.
Definition: qgsphongmaterialsettings.cpp:48
QgsPhongTexturedMaterialSettings::supportsTechnique
static bool supportsTechnique(QgsMaterialSettingsRenderingTechnique technique)
Returns true if the specified technique is supported by the Phong material.
Definition: qgsphongtexturedmaterialsettings.cpp:37
QgsPhongTexturedMaterialSettings::create
static QgsAbstractMaterialSettings * create()
Returns a new instance of QgsPhongTexturedMaterialSettings.
Definition: qgsphongtexturedmaterialsettings.cpp:55
QgsPoint3DSymbol::create
static QgsAbstract3DSymbol * create()
Creates a new QgsPoint3DSymbol.
Definition: qgspoint3dsymbol.cpp:35
QgsPointCloudLayer3DRendererMetadata
Metadata for point cloud layer 3D renderer to allow creation of its instances from XML.
Definition: qgspointcloudlayer3drenderer.h:224
QgsPolygon3DSymbol::create
static QgsAbstract3DSymbol * create() SIP_FACTORY
Creates a new QgsPolygon3DSymbol.
Definition: qgspolygon3dsymbol.cpp:154
QgsSimpleLineMaterialSettings::supportsTechnique
static bool supportsTechnique(QgsMaterialSettingsRenderingTechnique technique)
Returns true if the specified technique is supported by the material.
Definition: qgssimplelinematerialsettings.cpp:48
QgsSimpleLineMaterialSettings::create
static QgsAbstractMaterialSettings * create()
Returns a new instance of QgsSimpleLineMaterialSettings.
Definition: qgssimplelinematerialsettings.cpp:66
QgsStyle::defaultStyle
static QgsStyle * defaultStyle(bool initialize=true)
Returns the default application-wide style.
Definition: qgsstyle.cpp:145
QgsVectorLayer3DRendererMetadata
Metadata for vector layer 3D renderer to allow creation of its instances from XML.
Definition: qgsvectorlayer3drenderer.h:43
qgsline3dsymbol_p.h
qgspoint3dsymbol_p.h
qgspolygon3dsymbol_p.h
Generated by doxygen 1.9.4