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

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.
emissionFactor	Returns the emission factor, which dictates the strength of the emission effect.
emissionTexturePath	Returns the path to the emission/luminosity texture map.
metalnessTexturePath	Returns the path to the metalness texture map.
normalTexturePath	Returns the path to the normal 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.
setEmissionFactor	Sets the emission factor, which dictates the strength of the emission effect.
setEmissionTexturePath	Sets the path to the emission/luminosity texture map.
setMetalnessTexturePath	Sets the path to the metalness texture map.
setNormalTexturePath	Sets the path to the normal 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

Bases: QgsAbstractMaterialSettings

ambientOcclusionTexturePath(self) → str

Returns the path to the ambient occlusion texture map.

See also

setAmbientOcclusionTexturePath()

Return type:

str

baseColorTexturePath(self) → str

Returns the path to the base color texture map.

See also

setBaseColorTexturePath()

Return type:

str

static create() → QgsAbstractMaterialSettings | None

Returns a new instance of QgsMetalRoughTexturedMaterialSettings.

Return type:

Optional[QgsAbstractMaterialSettings]

emissionFactor(self) → float

Returns the emission factor, which dictates the strength of the emission effect.

A value of 1.0 indicates that the emission texture values should be used directly. Larger values result in more light emission.

See also

setEmissionFactor()

See also

emissionTexturePath()

Return type:

float

emissionTexturePath(self) → str

Returns the path to the emission/luminosity texture map.

See also

emissionFactor()

See also

setEmissionTexturePath()

Return type:

str

metalnessTexturePath(self) → str

Returns the path to the metalness texture map.

See also

setMetalnessTexturePath()

Return type:

str

normalTexturePath(self) → str

Returns the path to the normal texture map.

See also

setNormalTexturePath()

Return type:

str

roughnessTexturePath(self) → str

Returns the path to the roughness texture map.

See also

setRoughnessTexturePath()

Return type:

str

setAmbientOcclusionTexturePath(self, path: str | None)

Sets the path to the ambient occlusion texture map.

See also

ambientOcclusionTexturePath()

Parameters:

path (Optional[str])

setBaseColorTexturePath(self, path: str | None)

Sets the path to the base color texture map.

See also

baseColorTexturePath()

Parameters:

path (Optional[str])

setEmissionFactor(self, factor: float)

Sets the emission factor, which dictates the strength of the emission effect.

A value of 1.0 indicates that the emission texture values should be used directly. Larger values result in more light emission.

See also

emissionFactor()

See also

setEmissionTexturePath()

Parameters:

factor (float)

setEmissionTexturePath(self, path: str | None)

Sets the path to the emission/luminosity texture map.

See also

setEmissionFactor()

See also

emissionTexturePath()

Parameters:

path (Optional[str])

setMetalnessTexturePath(self, path: str | None)

Sets the path to the metalness texture map.

See also

metalnessTexturePath()

Parameters:

path (Optional[str])

setNormalTexturePath(self, path: str | None)

Sets the path to the normal texture map.

See also

normalTexturePath()

Parameters:

path (Optional[str])

setRoughnessTexturePath(self, path: str | None)

Sets the path to the roughness texture map.

See also

roughnessTexturePath()

Parameters:

path (Optional[str])

setTextureRotation(self, rotation: float)

Sets the texture rotation, in degrees.

See also

textureRotation()

Parameters:

rotation (float)

setTextureScale(self, scale: float)

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

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

Parameters:

technique (Qgis.MaterialRenderingTechnique)

Return type:

bool

textureRotation(self) → float

Returns the texture rotation, in degrees.

See also

setTextureRotation()

Return type:

float

textureScale(self) → float

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.

See also

setTextureScale()

Return type:

float