SpecularGlossyMaterial QML Type

让您使用镜面/光泽度工作流程为 3D 项目定义材质。更多

• 所有成员（包括继承成员）的列表

属性

• albedoChannel : enumeration (since 6.8)
• albedoColor : color
• albedoMap : Texture
• albedoSingleChannelEnabled : bool (since 6.8)
• alphaCutoff : real
• alphaMode : enumeration
• attenuationColor : color
• attenuationDistance : real
• blendMode : enumeration
• clearcoatAmount : real
• clearcoatChannel : enumeration
• clearcoatFresnelBias : real
• clearcoatFresnelPower : real
• clearcoatFresnelScale : real
• clearcoatFresnelScaleBiasEnabled : real
• clearcoatMap : Texture
• clearcoatNormalMap : Texture
• clearcoatRoughnessAmount : real
• clearcoatRoughnessChannel : enumeration
• clearcoatRoughnessMap : Texture
• emissiveChannel : enumeration (since 6.8)
• emissiveFactor : vector3d
• emissiveMap : Texture
• emissiveSingleChannelEnabled : bool (since 6.8)
• fresnelBias : real
• fresnelPower : real
• fresnelScale : real
• fresnelScaleBiasEnabled : real
• glossiness : real
• glossinessChannel : enumeration
• glossinessMap : Texture
• heightAmount : real
• heightChannel : enumeration
• heightMap : Texture
• invertOpacityMapValue : real (since 6.8)
• lighting : enumeration
• lineWidth : real
• maxHeightMapSamples : int
• minHeightMapSamples : int
• normalMap : Texture
• normalStrength : real
• occlusionAmount : real
• occlusionChannel : enumeration
• occlusionMap : Texture
• opacity : real
• opacityChannel : enumeration
• opacityMap : Texture
• pointSize : real
• specularChannel : enumeration (since 6.8)
• specularColor : color
• specularMap : Texture
• specularSingleChannelEnabled : bool (since 6.8)
• thicknessChannel : enumeration
• thicknessFactor : real
• thicknessMap : Texture
• transmissionChannel : enumeration
• transmissionFactor : real
• transmissionMap : Texture
• vertexColorAlphaMask : enumeration (since 6.8)
• vertexColorBlueMask : enumeration (since 6.8)
• vertexColorGreenMask : enumeration (since 6.8)
• vertexColorRedMask : enumeration (since 6.8)
• vertexColorsEnabled : bool (since 6.5)
• vertexColorsMaskEnabled : bool (since 6.8)

详细描述

在场景中渲染模型之前，必须至少有一种材质附加到模型上，用于描述网格的着色方式。SpecularGlossyMaterial（镜面光泽材质）是一种 PBR 镜面/光泽度材质，旨在成为一种使用简单、参数极少的材质。除了参数少之外，所有输入值都在 0 和 1 之间严格归一化，并有合理的默认值，这意味着即使不更改任何值，也可以使用该材质为模型着色。有关镜面/光泽材质的不同属性如何影响模型着色的介绍，请参阅 "原理材质 "示例，该示例提供了使用镜面/光泽工作流程的模式。

另外，要使用金属/亮度工作流程，请使用PrincipledMaterial 。

镜面/亮度工作流程

SpecularGlossyMaterial 提供了一种使用镜面/光泽度类型工作流程创建材质的方法。材料的主要属性由specular 、glossiness 和albedo 属性控制。

镜面反射

specularColor 属性描述了物体表面的镜面反射量和颜色。对于反光材质来说，该属性是主要的颜色来源。

光泽度

材料的glossiness 描述了物体表面的状况。glossiness 值越高，说明物体表面越光滑，因此反光性越好，而glossiness 值越低，反光性越差。

反照率

albedoColor 属性描述了材料的漫反射颜色，与PrincipledMaterial 的基色不同，反照率不包含任何有关材料反射率的信息。这意味着，对于反射表面，反照率的颜色值应设置为黑色色调，因为这样可以让镜面反射颜色发挥作用。

属性文档

albedoChannel : enumeration [since 6.8]

该属性定义了用于从albedoMap 读取反照率颜色值的纹理通道。要使用单一纹理通道作为颜色，必须启用albedoSingleChannelEnabled 。默认值为Material.R 。

此属性在 Qt 6.8 中引入。

albedoColor : color

该属性用于设置材质的反照率颜色。将漫反射颜色设置为黑色将创建纯镜面材料（如金属或镜面）。

另请参阅 albedoMap 和alphaMode 。

albedoMap : Texture

该属性定义了用于设置材质反照率颜色的纹理。

另请参阅 albedo 和alphaMode 。

albedoSingleChannelEnabled : bool [since 6.8]

启用此属性后，材质将使用albedoMap 中albedoChannel 的单一值作为 RGB 值，并使用 1.0 作为 alpha 值。默认值为 false。

此属性在 Qt 6.8 中引入。

alphaCutoff : real

在使用Mask alphaMode 时，alphaCutoff 属性可用于指定截止值。当 alpha 值低于阈值时，片段将呈现全透明效果（所有颜色通道均为0.0 ）。当 alpha 值等于或大于截止值时，颜色不会受到任何影响。

默认值为 0.5。

另请参见 alphaMode 。

alphaMode : enumeration

该属性指定如何使用albedoColor 的 alpha 颜色值和albedo map 的 alpha 通道。

另请参阅 alphaCutoff 和blendMode 。

attenuationColor : color

该属性定义白光在达到衰减距离时由于吸收而变成的颜色。默认值为Qt.White

attenuationDistance : real

该属性定义了介质的密度，即光线在与粒子发生作用前在介质中移动的平均距离。该值以世界空间为单位。默认值为+infinity 。

blendMode : enumeration

该属性决定了渲染的模型颜色如何与后面的颜色混合。

另请参阅 alphaMode 和Qt Quick 3D Architecture。

clearcoatAmount : real

该属性定义了透明涂层的强度。

默认值为0.0

clearcoatChannel : enumeration

该属性定义了用于从clearcoatMap 读取清漆量值的纹理通道。默认值为Material.R 。

clearcoatFresnelBias : real

该属性可将正面反射（直视表面）向前推进，同时保留掠过角度的反射。要对材质的变化产生影响，必须启用clearcoatFresnelScaleBiasEnabled 。默认值为0.0 。

clearcoatFresnelPower : real

该属性可减少迎面反射（直视表面），同时保持掠过角度的反射。默认值为5.0 。

clearcoatFresnelScale : real

该属性可缩放正面反射（直视表面），同时保留掠过角度的反射。要对材质的变化产生影响，必须启用clearcoatFresnelScaleBiasEnabled 。默认值为1.0 。

clearcoatFresnelScaleBiasEnabled : real

将该值设置为 true 后，材料将考虑菲涅尔清晰度和菲涅尔清晰度偏差。默认值为false 。

clearcoatMap : Texture

该属性定义了一个纹理，用于确定透明涂层的强度。clearcoatAmount 的值将乘以从该纹理读取的值。

clearcoatNormalMap : Texture

该属性定义了一种纹理，用于确定应用于透明涂层的法线贴图。

clearcoatRoughnessAmount : real

该属性定义清漆层的粗糙度。默认值为0.0

clearcoatRoughnessChannel : enumeration

该属性定义了用于从clearcoatRoughnessMap 读取清漆粗糙度值的纹理通道。默认值为Material.G 。

clearcoatRoughnessMap : Texture

该属性定义了一种纹理，用于确定清漆层的粗糙度。clearcoatRoughnessAmount 的值将乘以从该纹理读取的值。

emissiveChannel : enumeration [since 6.8]

该属性定义了用于从emissiveMap 读取发射颜色值的纹理通道。要使用单一纹理通道作为颜色，必须启用emissiveSingleChannelEnabled 。默认值为Material.R 。

此属性在 Qt 6.8 中引入。

emissiveFactor : vector3d

此属性决定了此材质的自发光颜色。如果设置了发射贴图，则 x、y 和 z 分量将分别用作纹理 R、G 和 B 通道的因子（乘数）。默认值为 (0、0、0)，表示完全没有发射贡献。

emissiveMap : Texture

该属性设置一个 RGB 纹理，用于指定发射色的强度。

emissiveSingleChannelEnabled : bool [since 6.8]

启用此属性后，材质将使用emissiveMap 中emissiveChannel 的单一值作为 RGB 值。默认值为 false。

此属性在 Qt 6.8 中引入。

fresnelBias : real

该属性可将正面反射（直视表面）向前推进，同时保留掠过角度的反射。要对材质的变化产生影响，必须启用fresnelScaleBiasEnabled 。默认值为0.0 。

fresnelPower : real

该属性可减少迎面反射（直视表面），同时保持掠过角度的反射。默认值为5.0 。

fresnelScale : real

该属性可缩放正面反射（直视表面），同时保留掠过角度的反射。要对材质的变化产生影响，必须启用fresnelScaleBiasEnabled 。默认值为1.0 。

fresnelScaleBiasEnabled : real

将该值设为 true 时，材质将考虑菲涅尔标尺和菲涅尔偏置。默认值为false 。

glossiness : real

该属性控制灯光产生的镜面反射高光的大小，以及一般反射的清晰度。数值越小，粗糙度越大，镜面反射亮点越柔和，反射越模糊。取值范围为 [0.0, 1.0]。默认值为1.0 。

glossinessChannel : enumeration

该属性定义了用于从glossinessMap 读取光泽度值的纹理通道。默认值为Material.A 。

glossinessMap : Texture

此属性定义了一种纹理，用于控制材质的光泽度。

heightAmount : real

该属性包含用于修改heightMap 纹理值的因子。该值应介于 0.0 至 1.0 之间。默认值为 0.0，这意味着即使设置了高度贴图，也将禁用高度位移。

heightChannel : enumeration

该属性定义了用于从heightMap 读取高度值的纹理通道。默认值为Material.R 。

heightMap : Texture

此属性定义了一种纹理，用于确定纹理在使用视差贴图渲染时的位移高度。数值应为 0.0 至 1.0 的线性范围，其中 0.0 表示无位移，1.0 表示最大位移。

invertOpacityMapValue : real [since 6.8]

该属性反转opacityMap 的不透明度值。默认值为false 。

此属性在 Qt 6.8 中引入。

lighting : enumeration

此属性定义了生成此材质时使用的照明方法。

默认值为SpecularGlossyMaterial.FragmentLighting

lineWidth : real

当几何体使用线条或线条条的原始类型时，该属性决定渲染线条的宽度。默认值为 1.0。该属性与渲染其他类型的几何体（如三角形网格）无关。

maxHeightMapSamples : int

该属性定义了使用heightMap 执行 Parallex Occlusion Mapping（平行闭塞映射）时所使用的最大样本数。maxHeightMapSamples（maxHeightMapSamples）值是与曲面平行时heightMap 所使用的样本数。默认值为 32。

每个片段实际使用的样本数将介于minHeightMapSamples 和 maxHeightMapSamples 之间，具体取决于摄像机相对于渲染表面的角度。

minHeightMapSamples : int

该属性定义了使用heightMap 执行 Parallex Occlusion Mapping 时使用的最小采样数目。minHeightMapSamples 值是heightMap 直视表面时（摄像机视图垂直于片段）使用的采样数目。默认值为 8。

每个片段实际使用的样本数将介于 minHeightMapSamples 和maxHeightMapSamples 之间，具体取决于摄像机相对于渲染表面的角度。

normalMap : Texture

该属性定义了一个 RGB 图像，用于模拟材料表面的细微几何位移。RGB 通道表示 XYZ 法线偏差。

normalStrength : real

该属性控制normalMap 的模拟位移量。

occlusionAmount : real

该属性包含用于修改occlusionMap 纹理值的因子。该值应介于 0.0 至 1.0 之间。默认值为 1.0

occlusionChannel : enumeration

该属性定义了用于从occlusionMap 读取闭塞值的纹理通道。默认值为Material.R 。

occlusionMap : Texture

该属性定义了一种纹理，用于确定材质的不同区域应接受多少间接光照。数值应在 0.0 至 1.0 之间呈线性关系，其中 0.0 表示没有间接光照，1.0 表示间接光照的效果保持不变。

另请参见 occlusionAmount 。

opacity : real

该属性仅降低该材质的不透明度，与模型无关。

opacityChannel : enumeration

该属性定义了用于从opacityMap 读取不透明度值的纹理通道。默认值为Material.A 。

opacityMap : Texture

该属性定义了一种纹理，用于对材质的不同部分进行不同的不透明度控制。

pointSize : real

当几何体使用原始点类型时，该属性决定渲染点的大小。默认值为 1.0。该属性与渲染其他类型的几何体（如三角形网格）无关。

specularChannel : enumeration [since 6.8]

该属性定义了用于从specularMap 读取镜面反射颜色值的纹理通道。要使用单一纹理通道作为颜色，必须启用specularSingleChannelEnabled 。默认值为Material.R 。

此属性在 Qt 6.8 中引入。

specularColor : color

该属性定义镜面 RGB 颜色。如果提供了 alpha 值，该值将被忽略。

默认值为Qt.White

specularMap : Texture

此属性设置一个纹理，用于为材质的不同部分设置镜面反射颜色。只使用 RGB 通道。

specularSingleChannelEnabled : bool [since 6.8]

启用此属性后，材质将使用specularMap 中specularChannel 的单一值作为 RGB 值。默认值为 false。

此属性在 Qt 6.8 中引入。

thicknessChannel : enumeration

该属性定义了用于从transmissionMap 读取厚度值的纹理通道。默认值为Material.G 。

thicknessFactor : real

该属性定义了曲面下体积的厚度。与SpecularGlossyMaterial 的许多其他属性不同， thicknessFactor 中定义的值是模型坐标空间中从 0.0 到 +infinity 的厚度值。0.0 表示材料是薄壁的。默认值为0.0

thicknessMap : Texture

该属性定义了一个纹理，用于定义材料体积的厚度。thicknessFactor 的值将乘以从该纹理读取的值。

transmissionChannel : enumeration

该属性定义用于从transmissionMap 读取传输百分比的纹理通道。默认值为Material.R 。

transmissionFactor : real

该属性定义了透过材料表面的光线百分比。默认值为0.0

transmissionMap : Texture

该属性定义了一种纹理，用于确定透过表面的光线百分比。transmissionFactor 的值将乘以从该纹理读取的值。

vertexColorAlphaMask : enumeration [since 6.8]

该属性定义了用作指定遮罩的顶点颜色 alpha 通道。该值是一个以位为单位的标志组合。默认值为SpecularGlossyMaterial.NoMask 。

此属性在 Qt 6.8 中引入。

vertexColorBlueMask : enumeration [since 6.8]

该属性定义顶点颜色的蓝色通道，用作指定遮罩。该值是一个以位为单位的标志组合。默认值为SpecularGlossyMaterial.NoMask 。

此属性在 Qt 6.8 中引入。

vertexColorGreenMask : enumeration [since 6.8]

该属性定义顶点颜色绿色通道，用作指定遮罩。该值是一个以位为单位的标志组合。默认值为SpecularGlossyMaterial.NoMask 。

此属性在 Qt 6.8 中引入。

vertexColorRedMask : enumeration [since 6.8]

该属性定义了用作指定遮罩的顶点颜色红色通道。该值是一个以位为单位的标志组合。默认值为SpecularGlossyMaterial.NoMask 。

此属性在 Qt 6.8 中引入。

vertexColorsEnabled : bool [since 6.5]

启用此属性后，材质将使用网格的顶点颜色。这些颜色将乘以为材质指定的其他颜色。默认值为 true。

此属性在 Qt 6.5 中引入。

vertexColorsMaskEnabled : bool [since 6.8]

启用此属性后，材质将使用网格中的顶点颜色作为各种属性（如光泽度、闭塞量......）的遮罩。默认值为 false。

此属性在 Qt 6.8 中引入。