QPhongAlphaMaterial Class

class Qt3DExtras ::QPhongAlphaMaterial

The QPhongAlphaMaterial class provides a default implementation of the phong lighting effect with alpha. 更多...

头: #include <QPhongAlphaMaterial>
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.

特性

公共函数

QPhongAlphaMaterial (Qt3DCore::QNode * parent = nullptr)
virtual ~QPhongAlphaMaterial ()
float alpha () const
QColor ambient () const
Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg () const
Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg () const
Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg () const
QColor diffuse () const
float shininess () const
Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg () const
Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg () const
QColor specular () const

公共槽

void setAlpha (float alpha )
void setAmbient (const QColor & ambient )
void setBlendFunctionArg (Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg )
void setDestinationAlphaArg (Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg )
void setDestinationRgbArg (Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg )
void setDiffuse (const QColor & diffuse )
void setShininess (float shininess )
void setSourceAlphaArg (Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg )
void setSourceRgbArg (Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg )
void setSpecular (const QColor & specular )

信号

void alphaChanged (float alpha )
void ambientChanged (const QColor & ambient )
void blendFunctionArgChanged (Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg )
void destinationAlphaArgChanged (Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg )
void destinationRgbArgChanged (Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg )
void diffuseChanged (const QColor & diffuse )
void shininessChanged (float shininess )
void sourceAlphaArgChanged (Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg )
void sourceRgbArgChanged (Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg )
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.
  • Alpha is the transparency of the surface between 0 (fully transparent) and 1 (opaque).

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.

特性文档编制

alpha : float

Holds the alpha component of the object which varies between 0 and 1.

The default value is 0.5f.

访问函数:

float alpha () const
void setAlpha (float alpha )

通知程序信号:

void alphaChanged (float alpha )

ambient : QColor

Holds the ambient color.

访问函数:

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

通知程序信号:

void ambientChanged (const QColor & ambient )

blendFunctionArg : Qt3DRender::QBlendEquation::BlendFunction

Holds the blend equation function argument.

访问函数:

Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg () const
void setBlendFunctionArg (Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg )

通知程序信号:

void blendFunctionArgChanged (Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg )

另请参阅 Qt3DRender::QBlendEquation::BlendFunction .

destinationAlphaArg : Qt3DRender::QBlendEquationArguments::Blending

Holds the blend equation destination alpha blending argument.

访问函数:

Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg () const
void setDestinationAlphaArg (Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg )

通知程序信号:

void destinationAlphaArgChanged (Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg )

另请参阅 Qt3DRender::QBlendEquationArguments::Blending .

destinationRgbArg : Qt3DRender::QBlendEquationArguments::Blending

Holds the blend equation destination RGB blending argument.

访问函数:

Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg () const
void setDestinationRgbArg (Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg )

通知程序信号:

void destinationRgbArgChanged (Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg )

另请参阅 Qt3DRender::QBlendEquationArguments::Blending .

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 )

sourceAlphaArg : Qt3DRender::QBlendEquationArguments::Blending

Holds the blend equation source alpha blending argument.

访问函数:

Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg () const
void setSourceAlphaArg (Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg )

通知程序信号:

void sourceAlphaArgChanged (Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg )

另请参阅 Qt3DRender::QBlendEquationArguments::Blending .

sourceRgbArg : Qt3DRender::QBlendEquationArguments::Blending

Holds the blend equation source RGB blending argument.

访问函数:

Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg () const
void setSourceRgbArg (Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg )

通知程序信号:

void sourceRgbArgChanged (Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg )

另请参阅 Qt3DRender::QBlendEquationArguments::Blending .

specular : QColor

Holds the specular color.

访问函数:

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

通知程序信号:

void specularChanged (const QColor & specular )

成员函数文档编制

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

Constructs a new QPhongAlphaMaterial instance with parent object parent .

[virtual noexcept] QPhongAlphaMaterial:: ~QPhongAlphaMaterial ()

销毁 QPhongAlphaMaterial .