En esta página

DepthOfFieldHQBlur QML Type

Efecto de desenfoque basado en la profundidad. Más...

Import Statement: import QtQuick3D.Effects 6.11
Status: Deprecated since 6.5

Este tipo está obsoleto desde QtQuick3D.Effects 6.5. Desaconsejamos su uso en código nuevo.

Propiedades

Descripción detallada

Utilice ExtendedSceneEnvironment en su lugar.

Advertencia: Todos los efectos independientes prefabricados en QtQuick3D.Effects se consideran obsoletos a partir de Qt 6.5. Para aplicar un efecto de profundidad de campo a la escena, utilice ExtendedSceneEnvironment en su lugar.

Comparación de escenas con efecto de desenfoque de la profundidad de campo

El efecto DepthOfFieldHQBlur realiza un desenfoque de gradiente en regiones de la imagen basándose en su desviación de una distancia especificada desde la cámara.

Para que este efecto funcione bien, es necesario ajustar las propiedades clipFar y clipNear de la cámara para que la escena encuadre el contenido. Lo ideal es obtener el mayor valor posible para clipNear y el menor valor posible para clipFar. A continuación, ajusta las propiedades del efecto para obtener el resultado deseado.

Por ejemplo, un focusDistance de 100 y un focusRange de 20 significa que todo lo que esté entre 90 y 110 unidades de distancia de la cámara estará totalmente enfocado, los elementos a una distancia de 70-90 y 110-130 unidades experimentarán un desenfoque variable, y todo lo que esté más cerca de 70 o más lejos de 130 estará totalmente desenfocado.

Véase también TiltShift.

Documentación de propiedades

blurAmount : real

La intensidad del desenfoque cuando está desenfocado. Los valores sensibles están en el rango [1...10]. El valor por defecto es 4.

focusDistance : real

La distancia desde la cámara a la que el contenido está perfectamente enfocado. El valor predeterminado es 600.

focusRange : real

La distancia alrededor de focusDistance en la que los elementos están totalmente enfocados. A continuación, el enfoque se desvanece hasta quedar totalmente borroso a la misma distancia tanto en el lado cercano como en el lejano. El valor predeterminado 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.