QPhongMaterial Class

class Qt3DExtras ::QPhongMaterial

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

头: #include <QPhongMaterial>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
继承: Qt3DRender::QMaterial
状态: Deprecated

This class is deprecated. We strongly advise against using it in new code.

特性

公共函数

QPhongMaterial (Qt3DCore::QNode * parent = nullptr)
virtual ~QPhongMaterial ()
QColor ambient () const
QColor diffuse () const
float shininess () const
QColor specular () const

公共槽

void setAmbient (const QColor & ambient )
void setDiffuse (const QColor & diffuse )
void setShininess (float shininess )
void setSpecular (const QColor & specular )

信号

void ambientChanged (const QColor & ambient )
void diffuseChanged (const QColor & diffuse )
void shininessChanged (float shininess )
void specularChanged (const QColor & specular )

详细描述

This class is deprecated; use QDiffuseSpecularMaterial 代替。

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.

特性文档编制

ambient : QColor

Holds the ambient color.

访问函数:

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

通知程序信号:

void ambientChanged (const QColor & ambient )

diffuse : QColor

Holds the diffuse color.

访问函数:

QColor diffuse () const
void setDiffuse (const QColor & diffuse )

通知程序信号:

void diffuseChanged (const QColor & diffuse )

shininess : float

Holds the shininess exponent.

访问函数:

float shininess () const
void setShininess (float shininess )

通知程序信号:

void shininessChanged (float shininess )

specular : QColor

Holds the specular color.

访问函数:

QColor specular () const
void setSpecular (const QColor & specular )

通知程序信号:

void specularChanged (const QColor & specular )

成员函数文档编制

[explicit] QPhongMaterial:: QPhongMaterial ( Qt3DCore::QNode * parent = nullptr)

Constructs a new QPhongMaterial instance with parent object parent .

[virtual noexcept] QPhongMaterial:: ~QPhongMaterial ()

销毁 QPhongMaterial .