3D symbol that draws point geometries as 3D objects using one of the predefined shapes. More...

#include <qgspoint3dsymbol.h>

Inheritance diagram for QgsPoint3DSymbol:

Public Types
enum	Shape { Cylinder, Sphere, Cone, Cube, Torus, Plane, ExtrudedText, Model, Billboard }
	3D shape types supported by the symbol More...

Public Member Functions
	QgsPoint3DSymbol ()
	Constructor for QgsPoint3DSymbol with default QgsMarkerSymbol as the billboardSymbol. More...

	QgsPoint3DSymbol (const QgsPoint3DSymbol &other)
	Copy Constructor for QgsPoint3DSymbol. More...

	~QgsPoint3DSymbol () override

Qgis::AltitudeClamping	altitudeClamping () const
	Returns method that determines altitude (whether to clamp to feature to terrain) More...

QgsMarkerSymbol *	billboardSymbol () const
	Returns a symbol for billboard. More...

QMatrix4x4	billboardTransform () const
	Returns transform for billboards. More...

QgsAbstract3DSymbol *	clone () const override SIP_FACTORY

QList< QgsWkbTypes::GeometryType >	compatibleGeometryTypes () const override

bool	exportGeometries (Qgs3DSceneExporter exporter, Qt3DCore::QEntity entity, const QString &objectNamePrefix) const override SIP_SKIP
	Exports the geometries contained within the hierarchy of entity. More...

QgsAbstractMaterialSettings *	material () const
	Returns material used for shading of the symbol. More...

void	readXml (const QDomElement &elem, const QgsReadWriteContext &context) override

void	setAltitudeClamping (Qgis::AltitudeClamping altClamping)
	Sets method that determines altitude (whether to clamp to feature to terrain) More...

void	setBillboardSymbol (QgsMarkerSymbol *symbol)
	Set symbol for billboard and the ownership is transferred. More...

void	setDefaultPropertiesFromLayer (const QgsVectorLayer *layer) override

void	setMaterial (QgsAbstractMaterialSettings *material SIP_TRANSFER)
	Sets the material settings used for shading of the symbol. More...

void	setShape (Shape shape)
	Sets 3D shape for points. More...

void	setShapeProperties (const QVariantMap &properties)
	Sets a key-value dictionary of point shape properties. More...

void	setTransform (const QMatrix4x4 &transform)
	Sets transform for individual objects represented by the symbol. More...

Shape	shape () const
	Returns 3D shape for points. More...

QVariantMap	shapeProperties () const
	Returns a key-value dictionary of point shape properties. More...

QMatrix4x4	transform () const
	Returns transform for individual objects represented by the symbol. More...

QString	type () const override

void	writeXml (QDomElement &elem, const QgsReadWriteContext &context) const override

Static Public Member Functions
static QgsAbstract3DSymbol *	create () SIP_FACTORY
	Creates a new QgsPoint3DSymbol. More...

static Shape	shapeFromString (const QString &shape)
	Returns shape enum value from a string. More...

static QString	shapeToString (Shape shape)
	Returns string from a shape enum value. More...

Detailed Description

3D symbol that draws point geometries as 3D objects using one of the predefined shapes.

3

Warning: This is not considered stable API, and may change in future QGIS releases. It is exposed to the Python bindings as a tech preview only.

Since: QGIS 3.0

Definition at line 38 of file qgspoint3dsymbol.h.

Member Enumeration Documentation

◆ Shape

enum QgsPoint3DSymbol::Shape

3D shape types supported by the symbol

Enumerator
Cylinder
Sphere
Cone
Cube
Torus
Plane
ExtrudedText	Supported in Qt 5.9+.
Model
Billboard

Definition at line 80 of file qgspoint3dsymbol.h.

Constructor & Destructor Documentation

◆ QgsPoint3DSymbol() [1/2]

QgsPoint3DSymbol::QgsPoint3DSymbol ( )

Constructor for QgsPoint3DSymbol with default QgsMarkerSymbol as the billboardSymbol.

Definition at line 40 of file qgspoint3dsymbol.cpp.

◆ QgsPoint3DSymbol() [2/2]

QgsPoint3DSymbol::QgsPoint3DSymbol ( const QgsPoint3DSymbol & other )

Copy Constructor for QgsPoint3DSymbol.

Definition at line 46 of file qgspoint3dsymbol.cpp.

◆ ~QgsPoint3DSymbol()

QgsPoint3DSymbol::~QgsPoint3DSymbol ( )

overridedefault

Member Function Documentation

◆ altitudeClamping()

Qgis::AltitudeClamping QgsPoint3DSymbol::altitudeClamping ( ) const

inline

Returns method that determines altitude (whether to clamp to feature to terrain)

Definition at line 65 of file qgspoint3dsymbol.h.

◆ billboardSymbol()

QgsMarkerSymbol * QgsPoint3DSymbol::billboardSymbol ( ) const

Returns a symbol for billboard.

Definition at line 244 of file qgspoint3dsymbol.cpp.

◆ billboardTransform()

QMatrix4x4 QgsPoint3DSymbol::billboardTransform ( ) const

Returns transform for billboards.

Definition at line 172 of file qgspoint3dsymbol.cpp.

◆ clone()

QgsAbstract3DSymbol * QgsPoint3DSymbol::clone ( ) const

override

Definition at line 30 of file qgspoint3dsymbol.cpp.

◆ compatibleGeometryTypes()

QList< QgsWkbTypes::GeometryType > QgsPoint3DSymbol::compatibleGeometryTypes ( ) const

override

Definition at line 119 of file qgspoint3dsymbol.cpp.

◆ create()

QgsAbstract3DSymbol * QgsPoint3DSymbol::create ( )

static

Creates a new QgsPoint3DSymbol.

Caller takes ownership of the returned symbol.

Definition at line 35 of file qgspoint3dsymbol.cpp.

◆ exportGeometries()

bool QgsPoint3DSymbol::exportGeometries	(	Qgs3DSceneExporter *	exporter,
		Qt3DCore::QEntity *	entity,
		const QString &	objectNamePrefix
	)		const

override

Exports the geometries contained within the hierarchy of entity.

Returns whether any objects were exported

Definition at line 193 of file qgspoint3dsymbol.cpp.

◆ material()

QgsAbstractMaterialSettings * QgsPoint3DSymbol::material ( ) const

Returns material used for shading of the symbol.

Definition at line 180 of file qgspoint3dsymbol.cpp.

◆ readXml()

void QgsPoint3DSymbol::readXml	(	const QDomElement &	elem,
		const QgsReadWriteContext &	context
	)

override

Definition at line 93 of file qgspoint3dsymbol.cpp.

◆ setAltitudeClamping()

void QgsPoint3DSymbol::setAltitudeClamping ( Qgis::AltitudeClamping altClamping )

inline

Sets method that determines altitude (whether to clamp to feature to terrain)

Definition at line 67 of file qgspoint3dsymbol.h.

◆ setBillboardSymbol()

void QgsPoint3DSymbol::setBillboardSymbol ( QgsMarkerSymbol * symbol )

Set symbol for billboard and the ownership is transferred.

Definition at line 249 of file qgspoint3dsymbol.cpp.

◆ setDefaultPropertiesFromLayer()

void QgsPoint3DSymbol::setDefaultPropertiesFromLayer ( const QgsVectorLayer * layer )

override

Definition at line 124 of file qgspoint3dsymbol.cpp.

◆ setMaterial()

void QgsPoint3DSymbol::setMaterial ( QgsAbstractMaterialSettings *material SIP_TRANSFER )

Sets the material settings used for shading of the symbol.

Ownership of material is transferred to the symbol.

Definition at line 185 of file qgspoint3dsymbol.cpp.

◆ setShape()

void QgsPoint3DSymbol::setShape ( Shape shape )

inline

Sets 3D shape for points.

Definition at line 101 of file qgspoint3dsymbol.h.

◆ setShapeProperties()

void QgsPoint3DSymbol::setShapeProperties ( const QVariantMap & properties )

inline

Sets a key-value dictionary of point shape properties.

Definition at line 106 of file qgspoint3dsymbol.h.

◆ setTransform()

void QgsPoint3DSymbol::setTransform ( const QMatrix4x4 & transform )

inline

Sets transform for individual objects represented by the symbol.

Definition at line 116 of file qgspoint3dsymbol.h.

◆ shape()

Shape QgsPoint3DSymbol::shape ( ) const

inline

Returns 3D shape for points.

Definition at line 99 of file qgspoint3dsymbol.h.

◆ shapeFromString()

QgsPoint3DSymbol::Shape QgsPoint3DSymbol::shapeFromString ( const QString & shape )

static

Returns shape enum value from a string.

Definition at line 133 of file qgspoint3dsymbol.cpp.

◆ shapeProperties()

QVariantMap QgsPoint3DSymbol::shapeProperties ( ) const

inline

Returns a key-value dictionary of point shape properties.

Definition at line 104 of file qgspoint3dsymbol.h.

◆ shapeToString()

QString QgsPoint3DSymbol::shapeToString ( QgsPoint3DSymbol::Shape shape )

static

Returns string from a shape enum value.

Definition at line 155 of file qgspoint3dsymbol.cpp.

◆ transform()

QMatrix4x4 QgsPoint3DSymbol::transform ( ) const

inline

Returns transform for individual objects represented by the symbol.

Definition at line 114 of file qgspoint3dsymbol.h.

◆ type()

QString QgsPoint3DSymbol::type ( ) const

inlineoverride

Definition at line 56 of file qgspoint3dsymbol.h.

◆ writeXml()

void QgsPoint3DSymbol::writeXml	(	QDomElement &	elem,
		const QgsReadWriteContext &	context
	)		const

override

Definition at line 59 of file qgspoint3dsymbol.cpp.

The documentation for this class was generated from the following files:

/build/qgis-3.26.3+32focal/src/3d/symbols/qgspoint3dsymbol.h
/build/qgis-3.26.3+32focal/src/3d/symbols/qgspoint3dsymbol.cpp

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ Shape

Constructor & Destructor Documentation

◆ QgsPoint3DSymbol() [1/2]

◆ QgsPoint3DSymbol() [2/2]

◆ ~QgsPoint3DSymbol()

Member Function Documentation

◆ altitudeClamping()

◆ billboardSymbol()

◆ billboardTransform()

◆ clone()

◆ compatibleGeometryTypes()

◆ create()

◆ exportGeometries()

◆ material()

◆ readXml()

◆ setAltitudeClamping()

◆ setBillboardSymbol()

◆ setDefaultPropertiesFromLayer()

◆ setMaterial()

◆ setShape()

◆ setShapeProperties()

◆ setTransform()

◆ shape()

◆ shapeFromString()

◆ shapeProperties()

◆ shapeToString()

◆ transform()

◆ type()

◆ writeXml()