DepthOfFieldHQBlur QML Type
Un efecto de desenfoque basado en la profundidad. Más...
| Import Statement: | import QtQuick3D.Effects 6.12 |
| Status: | Deprecated since 6.5 |
Este tipo está obsoleto desde QtQuick3D.Effects 6.5. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- blurAmount : real
- focusDistance : real
- focusRange : real
Descripción detallada
Utiliza en su lugar ExtendedSceneEnvironment.
Advertencia: Todos los efectos independientes predefinidos en QtQuick3D.Effects se consideran obsoletos a partir de Qt 6.5. Para aplicar un efecto de profundidad de campo a la escena, utiliza en su lugar ExtendedSceneEnvironment.

El efecto DepthOfFieldHQBlur aplica un desenfoque degradado a regiones de la imagen en función de su desviación respecto a una distancia especificada desde la cámara.
Para que este efecto funcione correctamente, debes ajustar las propiedades clipFar y clipNear de la cámara de la escena para encuadrar el contenido. Lo ideal es utilizar el valor más alto posible para clipNear y el valor más bajo posible para clipFar. A continuación, ajusta las propiedades del efecto para obtener el resultado deseado.
Por ejemplo, un valor de « focusDistance » de « 100 » y un valor de « focusRange » de « 20 » significa que todo lo que se encuentre entre 90 y 110 unidades de distancia de la cámara estará completamente enfocado, los elementos situados a una distancia de entre 70 y 90 y de entre 110 y 130 unidades presentarán un desenfoque variable, y todo lo que esté más cerca de 70 o más lejos de 130 estará completamente desenfocado.
Véase también TiltShift.
Documentación de la propiedad
blurAmount : real
La intensidad del desenfoque cuando la imagen está desenfocada. Los valores recomendados se encuentran en el rango [1...10]. El valor por defecto es 4.
focusDistance : real
La distancia desde la cámara en la que el contenido se ve perfectamente enfocado. El valor por defecto es 600.
focusRange : real
La distancia alrededor de la « focusDistance » en la que los elementos están totalmente enfocados. A partir de ahí, el enfoque se desvanece hasta quedar totalmente desenfocado en la misma distancia, tanto en el lado cercano como en el lejano. El valor por defecto es 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.