Class: QgsTessellator

Tessellates polygons into triangles.

It is expected that client code will create the tessellator object, then repeatedly call addPolygon() method that will generate triangles, and finally call data() to get final vertex data.

Optionally provides extrusion by adding triangles that serve as walls when extrusion height is non-zero.

List of all members, including inherited members

Methods

addPolygon	Tessellates a triangle and adds its vertex entries to the output data array
data	Returns array of triangle vertex data
dataVerticesCount	Returns the number of vertices stored in the output data array
error	Returns a descriptive error string if the tessellation failed.
extrusionFaces	Returns which faces are generated during extrusion.
hasBackFacesEnabled	Returns whether back faces are being added to the output data (True) or not (False).
hasInvertedNormals	Returns whether normals are inverted (True) or not (False).
hasNormals	Returns whether normals are being added to the output data (True) or not (False).
hasTextureUVs	Returns whether texture UV coordinates are being added to the output data (True) or not (False).
indexBuffer	Returns index buffer for the generated points.
indexStride	Returns size of one index entry in bytes
isOutputZUp	Returns whether the "up" direction should be the Z axis on output (True), otherwise the "up" direction will be the Y axis (False).
isZValueIgnored	Returns whether Z values from the input geometries are ignored (True) or not (False).
origin	Returns the origin point of the map.
setAddNormals	Sets whether normals should be added to the output data (True) or not (False).
setAddTextureUVs	Sets whether texture UV coordinates should be added to the output data (True) or not (False).
setBackFacesEnabled	Sets whether back faces should be added to the output data (True) or not (False).
setBounds	Sets scaling and the bounds of the input geometry coordinates.
setExtrusionFaces	Sets which faces should be generated during extrusion.
setInputZValueIgnored	Sets whether Z values from the input geometries are ignored (True) or not (False).
setInvertNormals	Sets whether normals should be inverted (True) or not (False).
setOrigin	Sets the origin point of the map.
setOutputZUp	Sets whether the "up" direction should be the Z axis on output (True), otherwise the "up" direction will be the Y axis (False).
setTextureRotation	Sets the rotation of texture UV coordinates (in degrees).
setTriangulationAlgorithm	Sets the triangulation algorithm.
stride	Returns size of one vertex entry in bytes
textureRotation	Returns the rotation of texture UV coordinates (in degrees).
triangulationAlgorithm	Returns the algorithm used for triangulation.
uniqueVertexCount	Returns unique vertex count.
vertexBuffer	Returns vertex buffer for the generated points.
zMaximum	Returns maximal Z value of the data (in world coordinates)
zMinimum	Returns minimal Z value of the data (in world coordinates)

class qgis.core.QgsTessellator

Bases: object

__init__()

__init__(originX: float, originY: float, addNormals: bool, invertNormals: bool = False, addBackFaces: bool = False, noZ: bool = False, addTextureCoords: bool = False, facade: int = 3, textureRotation: float = 0)

Creates tessellator with a specified origin point of the world (in map coordinates)

Deprecated since version 4.0: Use the default QgsTessellator() constructor and individual setters instead.

Parameters:

• originX (float)

• originY (float)

• addNormals (bool)

• invertNormals (bool = False)

• addBackFaces (bool = False)

• noZ (bool = False)

• addTextureCoords (bool = False)

• facade (int = 3)

• textureRotation (float = 0)

__init__(bounds: QgsRectangle, addNormals: bool, invertNormals: bool = False, addBackFaces: bool = False, noZ: bool = False, addTextureCoords: bool = False, facade: int = 3, textureRotation: float = 0)

Creates tessellator with a specified bounds of input geometry coordinates. This constructor allows the tessellator to map input coordinates to a desirable range for numerical stability during calculations.

If noZ is True, then a 2-dimensional tessellation only will be performed and all z coordinates will be ignored.

Added in version 3.10.

Deprecated since version 4.0: Use the default QgsTessellator() constructor and individual setters instead.

Parameters:

• bounds (QgsRectangle)

• addNormals (bool)

• invertNormals (bool = False)

• addBackFaces (bool = False)

• noZ (bool = False)

• addTextureCoords (bool = False)

• facade (int = 3)

• textureRotation (float = 0)

__init__(a0: QgsTessellator)

Parameters:

a0 (QgsTessellator)

addPolygon(self, polygon: QgsPolygon, extrusionHeight: float)

Tessellates a triangle and adds its vertex entries to the output data array

Parameters:

• polygon (QgsPolygon)

• extrusionHeight (float)

data(self) → list[float]

Returns array of triangle vertex data

Vertice coordinates are stored as (x, z, -y)

Deprecated since version 4.0: Use vertexBuffer() in combination with indexBuffer().

Return type:

list[float]

dataVerticesCount(self) → int

Returns the number of vertices stored in the output data array

Return type:

int

error(self) → str

Returns a descriptive error string if the tessellation failed.

Added in version 3.34.

Return type:

str

extrusionFaces(self) → Qgis.ExtrusionFace

Returns which faces are generated during extrusion.

Added in version 4.0.

Return type:

Qgis.ExtrusionFace

hasBackFacesEnabled(self) → bool

Returns whether back faces are being added to the output data (True) or not (False).

Added in version 4.0.

Return type:

bool

hasInvertedNormals(self) → bool

Returns whether normals are inverted (True) or not (False).

Added in version 4.0.

Return type:

bool

hasNormals(self) → bool

Returns whether normals are being added to the output data (True) or not (False).

Added in version 4.0.

Return type:

bool

hasTextureUVs(self) → bool

Returns whether texture UV coordinates are being added to the output data (True) or not (False).

Added in version 4.0.

Return type:

bool

indexBuffer(self) → QByteArray

Returns index buffer for the generated points.

Added in version 4.0.

Return type:

QByteArray

indexStride(self) → int

Returns size of one index entry in bytes

Added in version 4.0.

Return type:

int

isOutputZUp(self) → bool

Returns whether the “up” direction should be the Z axis on output (True), otherwise the “up” direction will be the Y axis (False). The default value is False (to keep compatibility for existing tessellator use cases).

Added in version 3.42.

Return type:

bool

isZValueIgnored(self) → bool

Returns whether Z values from the input geometries are ignored (True) or not (False).

Added in version 4.0.

Return type:

bool

origin(self) → QgsVector3D

Returns the origin point of the map.

Added in version 4.0.

Return type:

QgsVector3D

setAddNormals(self, addNormals: bool)

Sets whether normals should be added to the output data (True) or not (False).

Added in version 4.0.

Parameters:

addNormals (bool)

setAddTextureUVs(self, addTextureUVs: bool)

Sets whether texture UV coordinates should be added to the output data (True) or not (False).

Added in version 4.0.

Parameters:

addTextureUVs (bool)

setBackFacesEnabled(self, addBackFaces: bool)

Sets whether back faces should be added to the output data (True) or not (False).

Added in version 4.0.

Parameters:

addBackFaces (bool)

setBounds(self, bounds: QgsRectangle)

Sets scaling and the bounds of the input geometry coordinates.

Added in version 4.0.

Parameters:

bounds (QgsRectangle)

setExtrusionFaces(self, faces: Qgis.ExtrusionFace)

Sets which faces should be generated during extrusion.

Added in version 4.0.

Parameters:

faces (Qgis.ExtrusionFace)

setInputZValueIgnored(self, ignore: bool)

Sets whether Z values from the input geometries are ignored (True) or not (False). By default, this is False.

Added in version 4.0.

Parameters:

ignore (bool)

setInvertNormals(self, invertNormals: bool)

Sets whether normals should be inverted (True) or not (False).

Added in version 4.0.

Parameters:

invertNormals (bool)

setOrigin(self, origin: QgsVector3D)

Sets the origin point of the map.

Added in version 4.0.

Parameters:

origin (QgsVector3D)

setOutputZUp(self, zUp: bool)

Sets whether the “up” direction should be the Z axis on output (True), otherwise the “up” direction will be the Y axis (False). The default value is False (to keep compatibility for existing tessellator use cases).

Added in version 3.42.

Parameters:

zUp (bool)

setTextureRotation(self, rotation: float)

Sets the rotation of texture UV coordinates (in degrees).

Added in version 4.0.

Parameters:

rotation (float)

setTriangulationAlgorithm(self, algorithm: Qgis.TriangulationAlgorithm)

Sets the triangulation algorithm.

Added in version 4.0.

Parameters:

algorithm (Qgis.TriangulationAlgorithm)

stride(self) → int

Returns size of one vertex entry in bytes

Return type:

int

textureRotation(self) → float

Returns the rotation of texture UV coordinates (in degrees).

Added in version 4.0.

Return type:

float

triangulationAlgorithm(self) → Qgis.TriangulationAlgorithm

Returns the algorithm used for triangulation.

Added in version 4.0.

Return type:

Qgis.TriangulationAlgorithm

uniqueVertexCount(self) → int

Returns unique vertex count.

Added in version 4.0.

Return type:

int

vertexBuffer(self) → QByteArray

Returns vertex buffer for the generated points.

Added in version 4.0.

Return type:

QByteArray

zMaximum(self) → float

Returns maximal Z value of the data (in world coordinates)

Added in version 3.12.

Return type:

float

zMinimum(self) → float

Returns minimal Z value of the data (in world coordinates)

Added in version 3.12.

Return type:

float