SCurveTonemap QML Type
音调映射效果更多
| Import Statement: | import QtQuick3D.Effects 6.11 |
| Status: | Deprecated since 6.5 |
自 QtQuick3D.Effects 6.5 起,该类型已被弃用。我们强烈建议不要在新代码中使用它。
属性
- contrastBoost : real
- exposureValue : real
- gammaValue : real
- saturationLevel : real
- shoulderEmphasis : real
- shoulderSlope : real
- toeEmphasis : real
- toeSlope : real
- useExposure : bool
- whitePoint : real
详细说明
请使用ExtendedSceneEnvironment 代替。
警告: 从 Qt 6.5 开始,QtQuick3D.Effects 中的所有预制独立特效均被视为过时。要控制色调映射,请使用ExtendedSceneEnvironment 。

SCurveTonemap 特效根据一条 s 形曲线映射场景中每个像素的亮度:

曲线有三个部分。趾部决定阴影,由toeSlope 和toeEmphasis 控制。中间部分决定整体对比度,由contrastBoost 更改。肩部区域决定高光部分,由shoulderSlope 和shoulderEmphasis 控制。
属性文档
contrastBoost : real
增强或减弱色调地图的整体对比度。这会改变 s 曲线中间部分的斜率。
范围是[-1...2] 。默认值为0 。
exposureValue : real
指定 tonemap 效果的曝光量。该值仅在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
设置 tonemap 的白点。该值仅在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.