本页内容

SCurveTonemap QML Type

色调映射效果。更多...

Import Statement: import QtQuick3D.Effects 6.12
Status: Deprecated since 6.5

自 QtQuick3D.Effects 6.5 起,此类型已被废弃。我们强烈建议不要在新代码中使用它。

属性

详细说明

请改用ExtendedSceneEnvironment 。

警告: 从 Qt 6.5 开始,QtQuick3D.Effects 中的所有 预制独立效果均 被视为已弃用。若要控制色调映射,请改用ExtendedSceneEnvironment 。

展示S型曲线色调映射效果的场景对比

SCurveTonemap 效果会根据 S 形曲线对场景中每个像素的亮度进行映射:

显示S型曲线色调映射函数的图表

该曲线由三部分组成。曲线底端区域决定阴影,由toeSlope 和toeEmphasis 控制;中间部分决定整体对比度,可通过contrastBoost 进行调整;曲线肩部区域决定高光,由shoulderSlope 和shoulderEmphasis 控制。

属性文档

contrastBoost : real

增强或降低色调映射的整体对比度。这会改变S曲线中段的斜率。

取值范围为[-1...2] 。默认值为0 。

exposureValue : real

指定色调映射效果的曝光值。只有当useExposure 的值为true 时,此值才会被使用。取值范围为[0.01...16] 。默认值为1 。

gammaValue : real

设置色调映射效果的伽马值。合理的取值范围为[0.1...8] 。默认值为2.2 。

saturationLevel : real

设置色调映射效果的整体饱和度级别。取值范围为[0...2] ,其中0 表示完全灰度,2 表示极度过饱和。默认值为1 。

shoulderEmphasis : real

修改S曲线肩部的形状。取值范围为[-1...1] 。默认值为0 。

另请参阅 shoulderSlope 。

shoulderSlope : real

设置S曲线肩部的斜率。肩部定义了高光区域开始失去对比度的位置。

取值范围为[0...3] 。默认值为1 。

另请参阅 shoulderEmphasis 。

toeEmphasis : real

修改S曲线的起始段形状。取值范围为[-1...1] 。默认值为0 。

另请参阅 toeSlope 。

toeSlope : real

设置S型曲线的起始段的斜率。起始段定义了阴影失去对比度的位置。

取值范围为[0...3] 。默认值为1 。

另请参阅 toeEmphasis 。

useExposure : bool

使该效果在计算亮度时使用whitePoint ,而非exposureValue 。默认值为false 。

whitePoint : real

设置色调映射的白点。只有当useExposure 的值为false 时,才会使用此值。取值范围为[0.01...128] 。默认值为1 。

© 2026 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.