Class: QgsMetalRoughTexturedMaterialSettings

A PBR metal rough shading material used for rendering with support for image texture maps.

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.

Added in version 4.2.

List of all members, including inherited members

Class Hierarchy

Inheritance diagram of qgis.core.QgsMetalRoughTexturedMaterialSettings

Base classes

QgsAbstractMaterialSettings

Abstract base class for material settings.

Methods

ambientOcclusionTexturePath

Returns the path to the ambient occlusion texture map.

baseColorTexturePath

Returns the path to the base color texture map.

metalnessTexturePath

Returns the path to the metalness texture map.

roughnessTexturePath

Returns the path to the roughness texture map.

setAmbientOcclusionTexturePath

Sets the path to the ambient occlusion texture map.

setBaseColorTexturePath

Sets the path to the base color texture map.

setMetalnessTexturePath

Sets the path to the metalness texture map.

setRoughnessTexturePath

Sets the path to the roughness texture map.

setTextureRotation

Sets the texture rotation, in degrees.

setTextureScale

Sets the texture scale.

textureRotation

Returns the texture rotation, in degrees.

textureScale

Returns the texture scale.

Static Methods

create

Returns a new instance of QgsMetalRoughTexturedMaterialSettings.

supportsTechnique

Returns True if the specified technique is supported by the metal rough material.

class qgis.core.QgsMetalRoughTexturedMaterialSettings[source]

Bases: QgsAbstractMaterialSettings

ambientOcclusionTexturePath(self) str[source]

Returns the path to the ambient occlusion texture map.

Return type:

str

baseColorTexturePath(self) str[source]

Returns the path to the base color texture map.

Return type:

str

static create() QgsAbstractMaterialSettings | None[source]

Returns a new instance of QgsMetalRoughTexturedMaterialSettings.

Return type:

Optional[QgsAbstractMaterialSettings]

metalnessTexturePath(self) str[source]

Returns the path to the metalness texture map.

Return type:

str

roughnessTexturePath(self) str[source]

Returns the path to the roughness texture map.

Return type:

str

setAmbientOcclusionTexturePath(self, path: str | None)[source]

Sets the path to the ambient occlusion texture map.

Parameters:

path (Optional[str])

setBaseColorTexturePath(self, path: str | None)[source]

Sets the path to the base color texture map.

Parameters:

path (Optional[str])

setMetalnessTexturePath(self, path: str | None)[source]

Sets the path to the metalness texture map.

Parameters:

path (Optional[str])

setRoughnessTexturePath(self, path: str | None)[source]

Sets the path to the roughness texture map.

Parameters:

path (Optional[str])

setTextureRotation(self, rotation: float)[source]

Sets the texture rotation, in degrees.

Parameters:

rotation (float)

setTextureScale(self, scale: float)[source]

Sets the texture scale.

The texture scale changes the size of the displayed texture in the 3D scene. If the texture scale is less than 1, the texture will be stretched.

See also

textureScale()

Parameters:

scale (float)

static supportsTechnique(technique: Qgis.MaterialRenderingTechnique) bool[source]

Returns True if the specified technique is supported by the metal rough material.

Parameters:

technique (Qgis.MaterialRenderingTechnique)

Return type:

bool

textureRotation(self) float[source]

Returns the texture rotation, in degrees.

Return type:

float

textureScale(self) float[source]

Returns the texture scale.

The texture scale changes the size of the displayed texture in the 3D scene. If the texture scale is less than 1, the texture will be stretched.

Return type:

float