内容

• 特性
• 公共函数
• 公共槽
• 信号
• 保护函数
• 详细描述

QMaterial Class

( Qt3DRender::QMaterial )

Provides an abstract class that should be the base of all material component classes in a scene. 更多...

头：	#include <QMaterial>
qmake:	QT += 3drender
Since:	Qt 5.5
实例化：	Material
继承：	Qt3DCore::QComponent
继承者：	Qt3DExtras::QDiffuseMapMaterial , Qt3DExtras::QDiffuseSpecularMapMaterial , Qt3DExtras::QGoochMaterial , Qt3DExtras::QMetalRoughMaterial , Qt3DExtras::QMorphPhongMaterial , Qt3DExtras::QNormalDiffuseMapMaterial , Qt3DExtras::QNormalDiffuseSpecularMapMaterial , Qt3DExtras::QPerVertexColorMaterial , Qt3DExtras::QPhongAlphaMaterial , Qt3DExtras::QPhongMaterial , Qt3DExtras::QTexturedMetalRoughMaterial ，和 Qt3DExtras::QTextureMaterial

• 所有成员列表，包括继承成员

特性

• effect : Qt3DRender::QEffect *

• 1 特性继承自 Qt3DCore::QComponent
• 3 特性继承自 Qt3DCore::QNode
• 1 特性继承自 QObject

公共函数

	QMaterial (Qt3DCore::QNode * parent = nullptr)
	~QMaterial ()
void	addParameter (QParameter * 参数 )
QEffect *	effect () const
QVector<QParameter *>	参数 () const
void	removeParameter (QParameter * 参数 )

• 2 公共函数继承自 Qt3DCore::QComponent
• 11 public functions inherited from Qt3DCore::QNode
• 32 公共函数继承自 QObject

公共槽

void	setEffect (QEffect * effect )

• 1 公共槽继承自 Qt3DCore::QComponent
• 3 公共槽继承自 Qt3DCore::QNode
• 1 公共槽继承自 QObject

信号

void	effectChanged (QEffect * effect )

• 3 信号继承自 Qt3DCore::QComponent
• 4 信号继承自 Qt3DCore::QNode
• 2 信号继承自 QObject

保护函数

QMaterial (QMaterialPrivate & dd , Qt3DCore::QNode * parent = nullptr)

• 2 protected functions inherited from Qt3DCore::QNode
• 9 保护函数继承自 QObject

额外继承成员

• 11 静态公共成员继承自 QObject

详细描述

Provides an abstract class that should be the base of all material component classes in a scene.

QMaterial provides a way to specify the rendering of an entity . Any aspect can define its own subclass of QMaterial so that a Material can be used to describe a visual element; for example, the way sound should reflect off an element, the temperature of a surface, and so on.

In itself, a QMaterial doesn't do anything. It's only when it references a QEffect node that a QMaterial becomes useful.

In practice, it often happens that a single QEffect is being referenced by several QMaterial components. This allows to only create the effect, techniques, passes and shaders once while allowing to specify the material by adding QParameter 实例。

A QParameter defined on a QMaterial is overridden by a QParameter (of the same name) defined in a QTechniqueFilter 或 QRenderPassFilter .

QMaterial *material1 = new QMaterial();
QMaterial *material2 = new QMaterial();
// Create effect, technique, render pass and shader
QEffect *effect = new QEffect();
QTechnique *gl3Technique = new QTechnique();
QRenderPass *gl3Pass = new QRenderPass();
QShaderProgram *glShader = new QShaderProgram();
// Set the shader on the render pass
gl3Pass->setShaderProgram(glShader);
// Add the pass to the technique
gl3Technique->addRenderPass(gl3Pass);
// Set the targeted GL version for the technique
gl3Technique->graphicsApiFilter()->setApi(QGraphicsApiFilter::OpenGL);
gl3Technique->graphicsApiFilter()->setMajorVersion(3);
gl3Technique->graphicsApiFilter()->setMinorVersion(1);
gl3Technique->graphicsApiFilter()->setProfile(QGraphicsApiFilter::CoreProfile);
// Add the technique to the effect
effect->addTechnique(gl3Technique);
// Set the effect on the materials
material1->setEffect(effect);
material2->setEffect(effect);
// Set different parameters on the materials
const QString parameterName = QStringLiteral("color");
material1->addParameter(new QParameter(parameterName, QColor::fromRgbF(0.0f, 1.0f, 0.0f, 1.0f);
material2->addParameter(new QParameter(parameterName, QColor::fromRgbF(1.0f, 1.0f, 1.0f, 1.0f);
					

另请参阅 QEffect , QTechnique ，和 QParameter .

特性文档编制

effect : Qt3DRender::QEffect *

Specifies the effect to be used with the material.

访问函数：

QEffect *	effect () const
void	setEffect (QEffect * effect )

通知程序信号：

void	effectChanged (QEffect * effect )

成员函数文档编制

QMaterial:: QMaterial ( Qt3DCore::QNode * parent = nullptr)

Default constructs an instance of QMaterial.

[protected] QMaterial:: QMaterial ( QMaterialPrivate & dd , Qt3DCore::QNode * parent = nullptr)

Copy constructor.

QMaterial:: ~QMaterial ()

Destroys the instance of QMaterial.

void QMaterial:: addParameter ( QParameter * 参数 )

添加 参数 to the material's parameters.

QVector < QParameter *> QMaterial:: 参数 () const

Returns a vector of the material's current parameters

void QMaterial:: removeParameter ( QParameter * 参数 )

Remove a 参数 from the material's parameters.