En esta página

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

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.

Comparación de escenas que muestra el efecto de desenfoque por profundidad de campo

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.