DepthOfFieldHQBlur QML Type
A depth-based blur effect. More...
|Import Statement:||import QtQuick3D.Effects 6.5|
- blurAmount : real
- focusDistance : real
- focusRange : real
Use ExtendedSceneEnvironment instead.
Warning: All pre-made standalone effects in QtQuick3D.Effects are considered deprecated starting with Qt 6.5. To apply a depth-of-field effect to the scene, use ExtendedSceneEnvironment instead.
The DepthOfFieldHQBlur effect performs a gradient blur on regions of the image based on their deviation from a specified distance from the camera.
For this effect to work well, you need to adjust the clipFar and clipNear properties of the camera for the scene to frame the content. You ideally want the largest possible value for clipNear and the smallest possible value for clipFar. Next, adjust the properties of the effect for the desired result.
For example, a focusDistance of
100 and a focusRange of
20 means that everything that is between 90 and 110 units away from the camera will be entirely in focus, items at a distance of 70-90 and 110-130 units will experience variable blurring, and everything closer than 70 or farther than 130 will be entirely blurred.
See also TiltShift.
blurAmount : real
The strength of blur when out of focus. Sensible values are in the range
[1...10]. The default value is
focusDistance : real
The distance from the camera where the content is in perfect focus. The default value is
focusRange : real
The distance around the focusDistance where items are fully in focus. The focus then fades away to fully blurred by the same distance on both the near and far sides. The default value is
© 2023 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.