PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial¶

class QDiffuseSpecularMaterial¶

QDiffuseSpecularMaterial 类提供了冯氏光照效果的默认实现。更多…

概要¶

属性¶

• alphaBlendingᅟ

• ambientᅟ

• diffuseᅟ

• normalᅟ

• shininessᅟ

• specularᅟ

• textureScaleᅟ

方法¶

• def __init__()

• def ambient()

• def diffuse()

• def isAlphaBlendingEnabled()

• def normal()

• def shininess()

• def specular()

• def textureScale()

插槽¶

• def setAlphaBlendingEnabled()

• def setAmbient()

• def setDiffuse()

• def setNormal()

• def setShininess()

• def setSpecular()

• def setTextureScale()

信号¶

• def alphaBlendingEnabledChanged()

• def ambientChanged()

• def diffuseChanged()

• def normalChanged()

• def shininessChanged()

• def specularChanged()

• def textureScaleChanged()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

Phong光照效果基于三种光照组件的组合：环境光、漫反射和镜面反射。这些组件的相对强度通过它们的反射系数来控制，这些系数被建模为RGB三元组：

• 环境光是指物体在没有其他光源的情况下发出的颜色。

• 漫反射是光线与粗糙表面反射时发出的颜色。

• 镜面反射是灯光照射下闪亮表面反射发出的颜色。

• 表面的光泽度由一个浮点属性控制。

该材料使用单次渲染通道方法的效果，并执行每个片段的照明。提供了适用于OpenGL 2、OpenGL 3及以上版本以及OpenGL ES 2的技术。

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property alphaBlendingᅟ: bool¶

指示在渲染过程中是否考虑来自漫反射属性的alpha信息。默认为false。

Access functions:

• isAlphaBlendingEnabled()

• setAlphaBlendingEnabled()

• 信号 alphaBlendingEnabledChanged()

property ambientᅟ: QColor¶

保存由对象发出的环境颜色，没有任何其他光源。

Access functions:

• ambient()

• setAmbient()

• 信号 ambientChanged()

property diffuseᅟ: object¶

保存材质在粗糙表面反射光线时发出的漫反射颜色。这可以是纯色值或纹理。

Access functions:

• diffuse()

• setDiffuse()

• 信号 diffuseChanged()

property normalᅟ: object¶

保存材质的当前法线贴图纹理。这只能是一个纹理，否则将被忽略。默认情况下，此贴图未设置。

Access functions:

• normal()

• setNormal()

• 信号 normalChanged()

property shininessᅟ: float¶

保持光泽指数。较高的光泽值会导致更小和更亮的高光。

默认为150.0。

Access functions:

• shininess()

• setShininess()

• 信号 shininessChanged()

property specularᅟ: object¶

保存材质的高光颜色，该颜色用于灯光下的闪亮表面反射。这可以是纯色值或纹理。

Access functions:

• specular()

• setSpecular()

• 信号 specularChanged()

property textureScaleᅟ: float¶

保存当前的纹理比例。它在渲染时作为纹理坐标的乘数应用。默认为1.0。

当与QTextureWrapMode::Repeat一起使用时，textureScale提供了一种简单的方法来在表面上平铺纹理。例如，纹理比例为4.0将导致16（4x4）个平铺。

Access functions:

• textureScale()

• setTextureScale()

• 信号 textureScaleChanged()

__init__([parent=None])¶

Parameters:

parent – QNode

构造一个新的 QDiffuseSpecularMaterial 实例，其父对象为 parent。

alphaBlendingEnabledChanged(enabled)¶

Parameters:

enabled – 布尔值

属性 alphaBlendingᅟ 的通知信号。

ambient()¶

Return type:

QColor

另请参阅

setAmbient()

属性 ambientᅟ 的获取器。

ambientChanged(ambient)¶

Parameters:

环境 – QColor

属性 ambientᅟ 的通知信号。

diffuse()¶

Return type:

对象

另请参阅

setDiffuse()

属性 diffuseᅟ 的获取器。

diffuseChanged(diffuse)¶

Parameters:

diffuse – 对象

属性 diffuseᅟ 的通知信号。

isAlphaBlendingEnabled()¶

Return type:

布尔

属性 alphaBlendingᅟ 的获取器。

normal()¶

Return type:

对象

另请参阅

setNormal()

属性 normalᅟ 的获取器。

normalChanged(normal)¶

Parameters:

normal – 对象

属性 normalᅟ 的通知信号。

setAlphaBlendingEnabled(enabled)¶

Parameters:

enabled – 布尔值

另请参阅

isAlphaBlendingEnabled()

属性 alphaBlendingᅟ 的设置器。

setAmbient(ambient)¶

Parameters:

环境 – QColor

另请参阅

ambient()

属性 ambientᅟ 的设置器。

setDiffuse(diffuse)¶

Parameters:

diffuse – 对象

另请参阅

diffuse()

属性 diffuseᅟ 的设置器。

setNormal(normal)¶

Parameters:

normal – 对象

另请参阅

normal()

属性 normalᅟ 的设置器。

setShininess(shininess)¶

Parameters:

光泽度 – 浮点数

另请参阅

shininess()

属性 shininessᅟ 的设置器。

setSpecular(specular)¶

Parameters:

specular – 对象

另请参阅

specular()

属性 specularᅟ 的设置器。

setTextureScale(textureScale)¶

Parameters:

textureScale – 浮点数

另请参阅

textureScale()

属性 textureScaleᅟ 的设置器。

shininess()¶

Return type:

浮点数

另请参阅

setShininess()

属性 shininessᅟ 的获取器。

shininessChanged(shininess)¶

Parameters:

光泽度 – 浮点数

属性 shininessᅟ 的通知信号。

specular()¶

Return type:

对象

另请参阅

setSpecular()

属性 specularᅟ 的获取器。

specularChanged(specular)¶

Parameters:

specular – 对象

属性 specularᅟ 的通知信号。

textureScale()¶

Return type:

浮点数

另请参阅

setTextureScale()

属性 textureScaleᅟ 的获取器。

textureScaleChanged(textureScale)¶

Parameters:

textureScale – 浮点数

属性 textureScaleᅟ 的通知信号。