PrincipledMaterial QML Type

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

默认值为 0.5。

另请参阅 alphaMode 。

该属性指定如何使用baseColor 的 alpha 颜色值和base color map 的 alpha 通道。

另请参阅 alphaCutoff 和blendMode 。

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

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

该属性设置了材质的基色。根据指定的材料类型（金属或电介质），漫反射和镜面反射通道将被适当设置。例如，电介质材料的漫反射颜色等于基色，而镜面反射颜色（取决于镜面反射量）则为明亮的镜面反射颜色。对于金属材料，漫反射和镜面反射通道将从基色开始混合，形成深色漫反射通道和接近基色的镜面反射通道。

另请参阅 baseColorMap 和alphaMode 。

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

此属性在 Qt 6.8 中引入。

该属性定义了用于设置材质基色的纹理。

另请参阅 baseColor 和alphaMode 。

启用该属性后，材质将使用baseColorMap 中baseColorChannel 的单值作为 RGB 值，并使用 1.0 作为 alpha 值。默认值为 false。

该属性在 Qt 6.8 中引入。

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

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

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

默认值为0.0

该属性定义用于从clearcoatMap 读取透明涂层数量值的纹理通道。默认值为Material.R 。

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

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

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

将该值设置为 true 后，材质将考虑 Clearcoat 菲涅尔刻度和 Clearcoat 菲涅尔偏置。默认值为false 。

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

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

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

该属性定义了透明涂层的粗糙度。默认值为0.0

该属性定义用于从clearcoatRoughnessMap 读取透明涂层粗糙度的纹理通道。默认值为Material.G 。

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

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

此属性在 Qt 6.8 中引入。

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

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

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

此属性在 Qt 6.8 中引入。

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

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

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

将该值设置为 true 后，材质将考虑菲涅尔刻度和菲涅尔偏置。默认值为false 。

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

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

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

该属性定义了材质的折射率。默认值1.5 是塑料或玻璃等材料的理想值，但水、沥青、蓝宝石或钻石等其他材料则需要调整折射率，使其看起来更逼真。对于逼真的材料，折射率通常应在1.0 和 之间。3.0

以下是一些常见材料折射率的例子：

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

该属性在 Qt 6.8 中引入。

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

默认值为PrincipledMaterial.FragmentLighting

使用PrincipledMaterial.FragmentLighting 时，会为每个渲染像素计算漫反射和镜面反射光照。某些效果（如菲涅尔或法线贴图）需要PrincipledMaterial.FragmentLighting 才能实现。

使用PrincipledMaterial.NoLighting 时，不计算光照。这种模式（可以预见）速度非常快，在使用不需要照明阴影的图像贴图时非常有效。除了baseColor 值、alpha 值和顶点颜色外，所有其他阴影属性都将被忽略。

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

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

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

金属度属性定义了材质的金属度。该值是标准化的，0.0 表示材料是介电（非金属）材料，1.0 表示材料是金属。

范围为 [0.0, 1.0]。默认值为 0。

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

此属性设置一个纹理，用于设置材质不同部分的金属度量。

该属性定义了使用heightMap 执行 Parallex Occlusion Mapping 时使用的最小样本数。minHeightMapSamples（minHeightMap 样本）值是直接观察表面时（当相机视图垂直于片段时）使用的heightMap 样本数。默认值为 8。

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

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

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

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

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

该属性定义了一种纹理，用于确定材质的不同区域应接收多少光线。数值应为 0.0 至 1.0 的线性范围，其中 0.0 表示无光照，1.0 表示光照效果保持不变。

另请参阅 occlusionAmount 。

此属性仅降低此材质的不透明度，与模型分开。

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

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

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

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

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

此属性定义了一个纹理，用于控制材质的镜面粗糙度。

该属性可控制镜面反射（高光和反射）的强度。

范围为 [0.0, 1.0]。默认值为1.0 。

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

该属性在 Qt 6.8 中引入。

该属性定义了一个 RGB 纹理，用于调节整个材质表面的镜面反射数量和颜色。这些值乘以specularAmount 。

镜面反射纹理（Texture） 该属性用于设置材质上的镜面反射高光纹理。

这通常用于执行环境贴图：当模型旋转时，贴图将显示为从环境中反射出来。为使其达到预期效果，需要将贴图的mappingMode 设置为 Texture.Environment。镜面反射贴图是一种以相对较低的成本添加高质量外观的简便方法。

另请参阅 Texture::mappingMode 。

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

此属性在 Qt 6.8 中引入。

该属性定义了基色对镜面反射的贡献程度。

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

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

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

该属性定义了用于从transmissionMap 读取透射比的纹理通道。默认值为Material.R 。

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

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

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

此属性在 Qt 6.8 中引入。

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

此属性在 Qt 6.8 中引入。

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

此属性在 Qt 6.8 中引入。

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

此属性在 Qt 6.8 中引入。

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

此属性在 Qt 6.5 中引入。

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

此属性在 Qt 6.8 中引入。