QPhongAlphaMaterial Class
class Qt3DExtras::QPhongAlphaMaterialThe QPhongAlphaMaterial class provides a default implementation of the phong lighting effect with alpha. More...
Header: | #include <QPhongAlphaMaterial> |
CMake: | find_package(Qt6 COMPONENTS 3dextras REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
qmake: | QT += 3dextras |
Since: | Qt 5.7 |
Inherits: | Qt3DRender::QMaterial |
This class is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.
Properties
|
|
Public Functions
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 |
Public Slots
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) |
Signals
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) |
Detailed Description
This class is deprecated; use QDiffuseSpecularMaterial instead.
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.
Property Documentation
alpha : float
Holds the alpha component of the object which varies between 0 and 1.
The default value is 0.5f.
Access functions:
float | alpha() const |
void | setAlpha(float alpha) |
Notifier signal:
void | alphaChanged(float alpha) |
ambient : QColor
Holds the ambient color.
Access functions:
QColor | ambient() const |
void | setAmbient(const QColor &ambient) |
Notifier signal:
void | ambientChanged(const QColor &ambient) |
blendFunctionArg : Qt3DRender::QBlendEquation::BlendFunction
Holds the blend equation function argument.
Access functions:
Qt3DRender::QBlendEquation::BlendFunction | blendFunctionArg() const |
void | setBlendFunctionArg(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg) |
Notifier signal:
void | blendFunctionArgChanged(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg) |
See also Qt3DRender::QBlendEquation::BlendFunction.
destinationAlphaArg : Qt3DRender::QBlendEquationArguments::Blending
Holds the blend equation destination alpha blending argument.
Access functions:
Qt3DRender::QBlendEquationArguments::Blending | destinationAlphaArg() const |
void | setDestinationAlphaArg(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg) |
Notifier signal:
void | destinationAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg) |
See also Qt3DRender::QBlendEquationArguments::Blending.
destinationRgbArg : Qt3DRender::QBlendEquationArguments::Blending
Holds the blend equation destination RGB blending argument.
Access functions:
Qt3DRender::QBlendEquationArguments::Blending | destinationRgbArg() const |
void | setDestinationRgbArg(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg) |
Notifier signal:
void | destinationRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg) |
See also Qt3DRender::QBlendEquationArguments::Blending.
diffuse : QColor
Holds the diffuse color.
Access functions:
QColor | diffuse() const |
void | setDiffuse(const QColor &diffuse) |
Notifier signal:
void | diffuseChanged(const QColor &diffuse) |
shininess : float
Holds the shininess exponent.
Access functions:
float | shininess() const |
void | setShininess(float shininess) |
Notifier signal:
void | shininessChanged(float shininess) |
sourceAlphaArg : Qt3DRender::QBlendEquationArguments::Blending
Holds the blend equation source alpha blending argument.
Access functions:
Qt3DRender::QBlendEquationArguments::Blending | sourceAlphaArg() const |
void | setSourceAlphaArg(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg) |
Notifier signal:
void | sourceAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg) |
See also Qt3DRender::QBlendEquationArguments::Blending.
sourceRgbArg : Qt3DRender::QBlendEquationArguments::Blending
Holds the blend equation source RGB blending argument.
Access functions:
Qt3DRender::QBlendEquationArguments::Blending | sourceRgbArg() const |
void | setSourceRgbArg(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg) |
Notifier signal:
void | sourceRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg) |
See also Qt3DRender::QBlendEquationArguments::Blending.
specular : QColor
Holds the specular color.
Access functions:
QColor | specular() const |
void | setSpecular(const QColor &specular) |
Notifier signal:
void | specularChanged(const QColor &specular) |
Member Function Documentation
QPhongAlphaMaterial::QPhongAlphaMaterial(Qt3DCore::QNode *parent = nullptr)
Constructs a new QPhongAlphaMaterial instance with parent object parent.
[virtual]
QPhongAlphaMaterial::~QPhongAlphaMaterial()
Destroys the QPhongAlphaMaterial.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qt3dextras-qphongalphamaterial.html