Qt Quick 3D Effects QML Types
自 QtQuick3D.Effects 6.5 起，该模块已被废弃。我们强烈建议不要在新代码中使用它。
请改用ExtendedSceneEnvironment 、MultiEffect ，或通过Effect 类型使用用户自定义效果。
警告： 从 Qt 6.5 开始，QtQuick3D.Effects中所有 现成的独立效果均 被视为已弃用。 若要获得由 3D 渲染器实现的高质量、高性能后期处理效果（例如景深、光晕与光晕效果、镜头耀斑、暗角、色彩调整与分级、雾效或环境光遮蔽），请改用ExtendedSceneEnvironment 。 它提供了更佳的性能、更高的视觉质量，以及在组合特效时的更好互操作性（例如对色调映射的正确支持），并且更适合与Qt Design Studio 等视觉设计工具配合使用。 对于无需在 3D 场景中执行的 2D 特效（例如对View3D 项的内容进行模糊处理），请在View3D （或其父节点）上使用MultiEffect 。如果以上方法均不适用，应用程序可以通过Effect 类型提供自己的后期处理特效。
警告： QtQuick3D.Effects中所有 现成的独立效果均与Qt Quick 3D XR 的多视图渲染模式不兼容，而该模式常用于 VR/AR 应用程序。新应用程序应始终使用ExtendedSceneEnvironment 或通过Effect 类型由应用程序提供的自定义效果，这些效果也与多视图渲染完全兼容。
© 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.
