内容

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

QDiffuseSpecularMaterial Class

class Qt3DExtras ::QDiffuseSpecularMaterial

The QDiffuseSpecularMaterial class provides a default implementation of the phong lighting effect. 更多...

头：	#include <QDiffuseSpecularMaterial>
CMake:	find_package(Qt6 COMPONENTS 3dextras REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake:	QT += 3dextras
Since:	Qt 5.10
实例化：	DiffuseSpecularMaterial
继承：	Qt3DRender::QMaterial

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

特性

alphaBlending : bool ambient : QColor diffuse : QVariant normal : QVariant

shininess : float specular : QVariant textureScale : float

公共函数

	QDiffuseSpecularMaterial (Qt3DCore::QNode * parent = nullptr)
virtual	~QDiffuseSpecularMaterial ()
QColor	ambient () const
QVariant	diffuse () const
bool	isAlphaBlendingEnabled () const
QVariant	normal () const
float	shininess () const
QVariant	specular () const
float	textureScale () const

公共槽

void	setAlphaBlendingEnabled (bool enabled )
void	setAmbient (const QColor & ambient )
void	setDiffuse (const QVariant & diffuse )
void	setNormal (const QVariant & normal )
void	setShininess (float shininess )
void	setSpecular (const QVariant & specular )
void	setTextureScale (float textureScale )

信号

void	alphaBlendingEnabledChanged (bool enabled )
void	ambientChanged (const QColor & ambient )
void	diffuseChanged (const QVariant & diffuse )
void	normalChanged (const QVariant & normal )
void	shininessChanged (float shininess )
void	specularChanged (const QVariant & specular )
void	textureScaleChanged (float textureScale )

详细描述

The phong lighting effect is based on the combination of 3 lighting components ambient, diffuse and specular. The relative strengths of these components are controlled by means of their reflectivity coefficients which are modelled as RGB triplets:

• Ambient is the color that is emitted by an object without any other light source.
• Diffuse is the color that is emitted for rought surface reflections with the lights.
• Specular is the color emitted for shiny surface reflections with the lights.
• The shininess of a surface is controlled by a float property.

This material uses an effect with a single render pass approach and performs per fragment lighting. Techniques are provided for OpenGL 2, OpenGL 3 or above as well as OpenGL ES 2.

特性文档编制

alphaBlending : bool

Indicates if the alpha information coming from the diffuse property will be taken into account during rendering. Defaults to false.

访问函数：

bool	isAlphaBlendingEnabled () const
void	setAlphaBlendingEnabled (bool enabled )

通知程序信号：

void	alphaBlendingEnabledChanged (bool enabled )

ambient : QColor

Holds the ambient color that is emitted by an object without any other light source.

访问函数：

QColor	ambient () const
void	setAmbient (const QColor & ambient )

通知程序信号：

void	ambientChanged (const QColor & ambient )

diffuse : QVariant

Holds the diffuse color of the material that is emitted for rough surface reflections with the lights. This can be either a plain color value or a texture.

访问函数：

QVariant	diffuse () const
void	setDiffuse (const QVariant & diffuse )

通知程序信号：

void	diffuseChanged (const QVariant & diffuse )

normal : QVariant

Holds the current normal map texture of the material. This can only be a texture, otherwise it is ignored. By default this map is not set.

访问函数：

QVariant	normal () const
void	setNormal (const QVariant & normal )

通知程序信号：

void	normalChanged (const QVariant & normal )

shininess : float

Holds the shininess exponent. Higher values of shininess result in a smaller and brighter highlight.

Defaults to 150.0.

访问函数：

float	shininess () const
void	setShininess (float shininess )

通知程序信号：

void	shininessChanged (float shininess )

specular : QVariant

Holds the specular color of the material that is emitted for shiny surface reflections with the lights. This can be either a plain color value or a texture.

访问函数：

QVariant	specular () const
void	setSpecular (const QVariant & specular )

通知程序信号：

void	specularChanged (const QVariant & specular )

textureScale : float

Holds the current texture scale. It is applied as a multiplier to texture coordinates at render time. Defaults to 1.0.

When used in conjunction with QTextureWrapMode::Repeat, textureScale provides a simple way to tile a texture across a surface. For example, a texture scale of 4.0 would result in 16 (4x4) tiles.

访问函数：

float	textureScale () const
void	setTextureScale (float textureScale )

通知程序信号：

void	textureScaleChanged (float textureScale )

成员函数文档编制

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

Constructs a new QDiffuseSpecularMaterial instance with parent object parent .

[虚拟] QDiffuseSpecularMaterial:: ~QDiffuseSpecularMaterial ()

销毁 QDiffuseSpecularMaterial .