Class: QgsPoint3DSymbol

class qgis._3d.QgsPoint3DSymbol

Bases: QgsAbstract3DSymbol

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

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.

QgsPoint3DSymbol() Constructor for QgsPoint3DSymbol with default QgsMarkerSymbol as the billboardSymbol

QgsPoint3DSymbol(other: QgsPoint3DSymbol) Copy Constructor for QgsPoint3DSymbol

Methods

altitudeClamping

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

billboardSymbol

Returns a symbol for billboard

billboardTransform

Returns transform for billboards

clone

rtype:

QgsAbstract3DSymbol

compatibleGeometryTypes

rtype:

List[Qgis.GeometryType]

copyBaseSettings

Copies base class settings from this object to a destination object.

create

Creates a new QgsPoint3DSymbol.

materialSettings

Returns material settings used for shading of the symbol

readXml

param elem:

setAltitudeClamping

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

setBillboardSymbol

Set symbol for billboard and the ownership is transferred

setDefaultPropertiesFromLayer

param layer:

setMaterialSettings

Sets the material settings used for shading of the symbol.

setShape

Sets 3D shape for points

setShapeProperties

Sets a key-value dictionary of point shape properties

setTransform

Sets transform for individual objects represented by the symbol

shape

Returns 3D shape for points

shapeFromString

Returns shape enum value from a string

shapeProperties

Returns a key-value dictionary of point shape properties.

shapeProperty

Returns the value for a specific shape property.

shapeToString

Returns string from a shape enum value

transform

Returns transform for individual objects represented by the symbol

type

rtype:

str

writeXml

param elem:

altitudeClamping(self) Qgis.AltitudeClamping

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

Return type:

Qgis.AltitudeClamping

billboardSymbol(self) QgsMarkerSymbol

Returns a symbol for billboard

Return type:

QgsMarkerSymbol

billboardTransform(self) QMatrix4x4

Returns transform for billboards

Return type:

QMatrix4x4

clone(self) QgsAbstract3DSymbol
Return type:

QgsAbstract3DSymbol

compatibleGeometryTypes(self) List[Qgis.GeometryType]
Return type:

List[Qgis.GeometryType]

copyBaseSettings(self, destination: QgsAbstract3DSymbol)

Copies base class settings from this object to a destination object.

create() QgsAbstract3DSymbol

Creates a new QgsPoint3DSymbol.

Caller takes ownership of the returned symbol.

Return type:

QgsAbstract3DSymbol

materialSettings(self) QgsAbstractMaterialSettings

Returns material settings used for shading of the symbol

Return type:

QgsAbstractMaterialSettings

readXml(self, elem: QDomElement, context: QgsReadWriteContext)
Parameters:
setAltitudeClamping(self, altClamping: Qgis.AltitudeClamping)

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

Parameters:

altClamping (Qgis.AltitudeClamping) –

setBillboardSymbol(self, symbol: QgsMarkerSymbol)

Set symbol for billboard and the ownership is transferred

Parameters:

symbol (QgsMarkerSymbol) –

setDefaultPropertiesFromLayer(self, layer: QgsVectorLayer)
Parameters:

layer (QgsVectorLayer) –

setMaterialSettings(self, materialSettings: QgsAbstractMaterialSettings)

Sets the material settings used for shading of the symbol.

Ownership of material is transferred to the symbol.

Parameters:

materialSettings (QgsAbstractMaterialSettings) –

setShape(self, shape: Qgis.Point3DShape)

Sets 3D shape for points

Parameters:

shape (Qgis.Point3DShape) –

setShapeProperties(self, properties: Dict[str, Any])

Sets a key-value dictionary of point shape properties

Parameters:

properties (Dict[str) –

setTransform(self, transform: QMatrix4x4)

Sets transform for individual objects represented by the symbol

Parameters:

transform (QMatrix4x4) –

shape(self) Qgis.Point3DShape

Returns 3D shape for points

Return type:

Qgis.Point3DShape

shapeFromString(shape: str) Qgis.Point3DShape

Returns shape enum value from a string

Parameters:

shape (str) –

Return type:

Qgis.Point3DShape

shapeProperties(self) Dict[str, Any]

Returns a key-value dictionary of point shape properties.

In most cases callers should use shapeProperty() instead, to correctly handle default values when a property has not been explicitly set.

See also

shapeProperty()

Return type:

Dict[str, Any]

shapeProperty(self, property: str) Any

Returns the value for a specific shape property.

This method accounts for default property values for the symbol’s shape(), used when the property has not been explicitly set.

New in version 3.36.

Parameters:

property (str) –

Return type:

Any

shapeToString(shape: Qgis.Point3DShape) str

Returns string from a shape enum value

Parameters:

shape (Qgis.Point3DShape) –

Return type:

str

transform(self) QMatrix4x4

Returns transform for individual objects represented by the symbol

Return type:

QMatrix4x4

type(self) str
Return type:

str

writeXml(self, elem: QDomElement, context: QgsReadWriteContext)
Parameters: