DepthOfFieldHQBlur QML Type
Un effet de flou basé sur la profondeur. En savoir plus…
| Import Statement: | import QtQuick3D.Effects 6.12 |
| Status: | Deprecated since 6.5 |
Ce type est obsolète depuis la version 6.5 de QtQuick3D.Effects. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
- blurAmount : real
- focusDistance : real
- focusRange : real
Description détaillée
Utilisez plutôt ExtendedSceneEnvironment.
Avertissement : tous les effets autonomes prédéfinis dans QtQuick3D.Effects sont considérés comme obsolètes à partir de Qt 6.5. Pour appliquer un effet de profondeur de champ à la scène, utilisez plutôt ExtendedSceneEnvironment.

L'effet DepthOfFieldHQBlur applique un flou dégradé sur certaines zones de l'image en fonction de leur écart par rapport à une distance spécifiée par rapport à la caméra.
Pour que cet effet fonctionne correctement, vous devez ajuster les propriétés clipFar et clipNear de la caméra de la scène afin de cadrer le contenu. Idéalement, vous devriez utiliser la valeur la plus élevée possible pour clipNear et la valeur la plus faible possible pour clipFar. Ajustez ensuite les propriétés de l’effet pour obtenir le résultat souhaité.
Par exemple, une valeur de « focusDistance » ( 100 ) et une valeur de « focusRange » ( 20 ) signifient que tout ce qui se trouve entre 90 et 110 unités de la caméra sera entièrement net, les éléments situés à une distance comprise entre 70 et 90 et entre 110 et 130 unités présenteront un flou variable, et tout ce qui se trouve à moins de 70 ou à plus de 130 unités sera entièrement flou.
Voir également TiltShift.
Documentation sur les propriétés
blurAmount : real
Intensité du flou lorsque l'image n'est pas nette. Les valeurs recommandées se situent dans la plage [1...10]. La valeur par défaut est 4.
focusDistance : real
Distance par rapport à l'appareil photo à laquelle le sujet est parfaitement net. La valeur par défaut est 600.
focusRange : real
Distance autour de l'focusDistance, à partir de laquelle les éléments sont parfaitement nets. La netteté s'estompe ensuite progressivement jusqu'à devenir totalement floue sur une distance identique, tant du côté proche que du côté lointain. La valeur par défaut est 100.
© 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.