3D handler for the PBR metal rough material. More...

#include <qgsmetalroughmaterial3dhandler.h>

Inheritance diagram for QgsMetalRoughMaterial3DHandler:

Public Member Functions
	QgsMetalRoughMaterial3DHandler ()=default
void	applyDataDefinedToGeometry (const QgsAbstractMaterialSettings settings, Qt3DCore::QGeometry geometry, int vertexCount, const QByteArray &data) const override
	Applies the data defined bytes, dataDefinedBytes, on the geometry by filling a specific vertex buffer that will be used by the shader.
QByteArray	dataDefinedVertexColorsAsByte (const QgsAbstractMaterialSettings *settings, const QgsExpressionContext &expressionContext) const override
	Returns byte array corresponding to the data defined colors depending of the expressionContext, used to fill the specific vertex buffer used for rendering the geometry.
QMap< QString, QString >	toExportParameters (const QgsAbstractMaterialSettings *settings) const override
	Returns the parameters to be exported to .mtl file.
QgsMaterial *	toInstancedMaterial (const QgsAbstractMaterialSettings *settings, const QgsMaterialContext &context, Qgis::InstancedMaterialFlags flags) const override
	Creates a QgsMaterial for instanced point rendering.
QgsMaterial *	toMaterial (const QgsAbstractMaterialSettings *settings, Qgis::MaterialRenderingTechnique technique, const QgsMaterialContext &context) const override
	Creates a new QgsMaterial object representing the material settings.
bool	updatePreviewScene (Qt3DCore::QEntity sceneRoot, const QgsAbstractMaterialSettings settings, const QgsMaterialContext &context) const override
	Updates an existing material preview scene with new material settings.
Public Member Functions inherited from QgsAbstractMaterial3DHandler
virtual	~QgsAbstractMaterial3DHandler ()=default
virtual Qt3DCore::QEntity *	createPreviewMesh (const QString &type, Qt3DCore::QEntity *parent) const
	Creates a new entity representing a suitable preview mesh for this material type.
virtual Qt3DCore::QEntity *	createPreviewScene (const QgsAbstractMaterialSettings settings, const QString &type, const QgsMaterialContext &context, QWindow window, Qt3DCore::QEntity *parent) const
	Builds a complete self-contained scene for previewing the material, using the specified mesh type.
virtual QList< PreviewMeshType >	previewMeshTypes () const
	Returns a list of available preview mesh types for the material.

Additional Inherited Members
Static Protected Member Functions inherited from QgsAbstractMaterial3DHandler
static Qt3DRender::QParameter *	findParameter (Qt3DRender::QEffect *effect, const QString &name)
	Finds an existing parameter in an effect by name.

Detailed Description

3D handler for the PBR metal rough material.

Warning: Not available in Python bindings

Since: QGIS 4.2

Definition at line 36 of file qgsmetalroughmaterial3dhandler.h.

Constructor & Destructor Documentation

◆ QgsMetalRoughMaterial3DHandler()

QgsMetalRoughMaterial3DHandler::QgsMetalRoughMaterial3DHandler ( )

default

Member Function Documentation

◆ applyDataDefinedToGeometry()

void QgsMetalRoughMaterial3DHandler::applyDataDefinedToGeometry	(	const QgsAbstractMaterialSettings *	settings,
		Qt3DCore::QGeometry *	geometry,
		int	vertexCount,
		const QByteArray &	dataDefinedBytes ) const

overridevirtual

Applies the data defined bytes, dataDefinedBytes, on the geometry by filling a specific vertex buffer that will be used by the shader.

Reimplemented from QgsAbstractMaterial3DHandler.

Definition at line 131 of file qgsmetalroughmaterial3dhandler.cpp.

◆ dataDefinedVertexColorsAsByte()

QByteArray QgsMetalRoughMaterial3DHandler::dataDefinedVertexColorsAsByte	(	const QgsAbstractMaterialSettings *	settings,
		const QgsExpressionContext &	expressionContext ) const

overridevirtual

Returns byte array corresponding to the data defined colors depending of the expressionContext, used to fill the specific vertex buffer used for rendering the geometry.

See also: applyDataDefinedToGeometry()

Since: QGIS 3.18

Reimplemented from QgsAbstractMaterial3DHandler.

Definition at line 99 of file qgsmetalroughmaterial3dhandler.cpp.

◆ toExportParameters()

QMap< QString, QString > QgsMetalRoughMaterial3DHandler::toExportParameters ( const QgsAbstractMaterialSettings * settings ) const

overridevirtual

Returns the parameters to be exported to .mtl file.

Implements QgsAbstractMaterial3DHandler.

Definition at line 81 of file qgsmetalroughmaterial3dhandler.cpp.

◆ toInstancedMaterial()

QgsMaterial * QgsMetalRoughMaterial3DHandler::toInstancedMaterial	(	const QgsAbstractMaterialSettings *	settings,
		const QgsMaterialContext &	context,
		Qgis::InstancedMaterialFlags	flags ) const

overridevirtual

Creates a QgsMaterial for instanced point rendering.

The flags argument controls which per-instance attributes are active.

The default implementation returns nullptr.

Subclasses that support instancing must override this method to construct the material with the correct shader from the start.

Reimplemented from QgsAbstractMaterial3DHandler.

Definition at line 68 of file qgsmetalroughmaterial3dhandler.cpp.

◆ toMaterial()

QgsMaterial * QgsMetalRoughMaterial3DHandler::toMaterial	(	const QgsAbstractMaterialSettings *	settings,
		Qgis::MaterialRenderingTechnique	technique,
		const QgsMaterialContext &	context ) const

overridevirtual

Creates a new QgsMaterial object representing the material settings.

The technique argument specifies the rendering technique which will be used with the returned material.

Implements QgsAbstractMaterial3DHandler.

Definition at line 32 of file qgsmetalroughmaterial3dhandler.cpp.

◆ updatePreviewScene()

bool QgsMetalRoughMaterial3DHandler::updatePreviewScene	(	Qt3DCore::QEntity *	sceneRoot,
		const QgsAbstractMaterialSettings *	settings,
		const QgsMaterialContext &	context ) const

overridevirtual

Updates an existing material preview scene with new material settings.

This method is called on every material setting parameter change while configuring materials, so the implementation must be cheap (e.g. involve no entity creation, just direct manipulation of existing attributes).

Returns false if the scene could not be updated in place and needs to be regenered via createPreviewScene().

Implements QgsAbstractMaterial3DHandler.

Definition at line 87 of file qgsmetalroughmaterial3dhandler.cpp.

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

/build/qgis-4.1.0+git20260529+31622b25bb0+99sid/src/3d/materials/qgsmetalroughmaterial3dhandler.h
/build/qgis-4.1.0+git20260529+31622b25bb0+99sid/src/3d/materials/qgsmetalroughmaterial3dhandler.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QgsMetalRoughMaterial3DHandler()

Member Function Documentation

◆ applyDataDefinedToGeometry()

◆ dataDefinedVertexColorsAsByte()

◆ toExportParameters()

◆ toInstancedMaterial()

◆ toMaterial()

◆ updatePreviewScene()