本页内容

HDRBloomTonemap 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 。

展示HDR光晕色调映射效果的场景对比

HDRBloomTonemap 特效提供两项功能:

  • 调整高动态范围渲染内容的伽马值和曝光度,以获得所需的图像质量。
  • 对亮部区域(例如阳光在汽车上闪烁的光斑)应用可调节的晕光效果。

属性文档

bloomThreshold : real

设置光晕效果的阈值。场景中亮度高于此值的任何部分都会产生光晕。1.0 对应白色。降低此值会导致渲染场景中更多区域产生光晕。当值为0.0 时,场景中的所有内容都会产生光晕。取值范围为[0...1] 。默认值为1 。

blurFalloff : real

调整光晕效果的强度。数值越小,光晕效果越明显;数值越大,效果越微妙。取值范围为[0...10] 。默认值为0 。

channelThreshold : real

指定图像的白点。通常无需调整此参数。其取值范围为[0...1] 。默认值为1 。

exposure : real

为照明设置一个线性倍数,从而整体提亮或调暗图像。当值为0.0 时,图像不会发生任何调整。取值范围为[-9...9] 。默认值为0 。

gamma : real

影响灯光的非线性曲线。数值越高,中间调的曝光度越大,图像越亮,对比度越低。数值设为1.0 时,图像不会发生任何调整。合理的数值范围为[0.1...4] 。默认值为1 。

tonemappingLerp : real

指定整体光晕效果的强度。通常无需调整此参数。取值范围为[0...1] ,其中0 表示无模糊,1 表示全光晕。默认值为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.