Qt3DExtras::QPhongAlphaMaterial Class
class Qt3DExtras::QPhongAlphaMaterialQPhongAlphaMaterial 类提供了带有 alpha 的 phong 灯光效果的默认实现。更多
| Header： | #include <QPhongAlphaMaterial> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3dextras)target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake： | QT += 3dextras |
| 继承： | Qt3DRender::QMaterial |
| 状态： | 已废弃 |
该类已被弃用。我们强烈建议不要在新代码中使用它。
属性
|
|
公共功能
| 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) |
详细说明
该类已被弃用，请使用QDiffuseSpecularMaterial 。
phong 灯光效果是基于环境、漫反射和镜面三种照明成分的组合。这些组件的相对强度由它们的反射系数控制，反射系数以 RGB 三元组建模：
- 环境光是物体在没有任何其他光源的情况下发出的颜色。
- 漫反射（Diffuse）是灯光在物体表面反射时发出的颜色。
- 镜面反射色是在灯光照射下闪亮表面反射时发出的颜色。
- 表面的光泽度由浮点属性控制。
- Alpha 是表面的透明度，介于 0（完全透明）和 1（不透明）之间。
该材质采用了单次渲染通过的效果方法，并对每个片段进行照明。该技术适用于 OpenGL 2、OpenGL 3 或更高版本以及 OpenGL ES 2。
属性文档
alpha : float
对象的 alpha 分量，在 0 和 1 之间变化。
默认值为 0.5f。
访问功能：
| float | alpha() const |
| void | setAlpha(float alpha) |
通知信号：
| void | alphaChanged(float alpha) |
ambient : QColor
保存环境颜色。
访问功能：
| QColor | ambient() const |
| void | setAmbient(const QColor &ambient) |
提示信号：
| void | ambientChanged(const QColor &ambient) |
blendFunctionArg : Qt3DRender::QBlendEquation::BlendFunction
保存混合方程函数参数。
访问功能：
| Qt3DRender::QBlendEquation::BlendFunction | blendFunctionArg() const |
| void | setBlendFunctionArg(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg) |
Notifier 信号：
| void | blendFunctionArgChanged(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg) |
另请参阅 Qt3DRender::QBlendEquation::BlendFunction 。
destinationAlphaArg : Qt3DRender::QBlendEquationArguments::Blending
保存混合方程目标 alpha 混合参数。
访问功能：
| Qt3DRender::QBlendEquationArguments::Blending | destinationAlphaArg() const |
| void | setDestinationAlphaArg(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg) |
通知信号：
| void | destinationAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg) |
另请参见 Qt3DRender::QBlendEquationArguments::Blending 。
destinationRgbArg : Qt3DRender::QBlendEquationArguments::Blending
保存混合方程目标 RGB 混合参数。
访问功能：
| Qt3DRender::QBlendEquationArguments::Blending | destinationRgbArg() const |
| void | setDestinationRgbArg(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg) |
通知信号：
| void | destinationRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg) |
另请参阅 Qt3DRender::QBlendEquationArguments::Blending 。
diffuse : QColor
保存漫反射颜色。
访问功能：
| QColor | diffuse() const |
| void | setDiffuse(const QColor &diffuse) |
通知信号：
| void | diffuseChanged(const QColor &diffuse) |
shininess : float
保存光泽度指数。
访问功能：
| float | shininess() const |
| void | setShininess(float shininess) |
通知信号：
| void | shininessChanged(float shininess) |
sourceAlphaArg : Qt3DRender::QBlendEquationArguments::Blending
保存混合方程源 alpha 混合参数。
访问功能：
| Qt3DRender::QBlendEquationArguments::Blending | sourceAlphaArg() const |
| void | setSourceAlphaArg(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg) |
通知信号：
| void | sourceAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg) |
另请参见 Qt3DRender::QBlendEquationArguments::Blending 。
sourceRgbArg : Qt3DRender::QBlendEquationArguments::Blending
保存混合方程源 RGB 混合参数。
访问功能：
| Qt3DRender::QBlendEquationArguments::Blending | sourceRgbArg() const |
| void | setSourceRgbArg(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg) |
通知信号：
| void | sourceRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg) |
另请参阅 Qt3DRender::QBlendEquationArguments::Blending 。
specular : QColor
保存镜面反射颜色。
访问功能
| QColor | specular() const |
| void | setSpecular(const QColor &specular) |
Notifier 信号：
| void | specularChanged(const QColor &specular) |
成员函数 文档
[explicit] QPhongAlphaMaterial::QPhongAlphaMaterial(Qt3DCore::QNode *parent = nullptr)
使用父对象parent 构建一个新的 QPhongAlphaMaterial 实例。
[virtual noexcept] QPhongAlphaMaterial::~QPhongAlphaMaterial()
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
