Fog QML Type
Especifica los ajustes de niebla para una escena. Más...
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.5 |
| Inherits: |
Propiedades
- color : color
- density : real
- depthCurve : real
- depthEnabled : bool
- depthFar : real
- depthNear : real
- enabled : bool
- heightCurve : real
- heightEnabled : bool
- leastIntenseY : real
- mostIntenseY : real
- transmitCurve : real
- transmitEnabled : bool
Descripción detallada
Cuando la propiedad « fog » de un « SceneEnvironment » se establece en un objeto «Fog» válido, estas propiedades se utilizan para configurar el renderizado de la niebla.

La niebla simple que proporciona este tipo se implementa mediante los materiales. No se trata de un efecto de posprocesamiento, lo que significa que no implica pasadas de renderizado adicionales que procesen la textura con el resultado de View3D, sino que se implementa en el sombreador de fragmentos para cada objeto renderizable (submalla de Model) con un sombreador de fragmentos ( PrincipledMaterial ) o un sombreador de fragmentos con sombreado ( CustomMaterial).
La niebla se configura mediante una serie de propiedades:
- Ajustes generales: color y density
- Ajustes de la niebla de profundidad: depthEnabled, depthNear, depthFar, depthCurve
- Ajustes de altura de la niebla: heightEnabled, leastIntenseY, mostIntenseY, heightCurve
- Configuración de la transmisión del color: transmitEnabled, transmitCurve
Por ejemplo, el siguiente fragmento de código habilita la niebla de profundidad (pero no la de altura) utilizando los parámetros predeterminados de niebla:
environment: SceneEnvironment {
backgroundMode: SceneEnvironment.Color
clearColor: theFog.color
fog: Fog {
id: theFog
enabled: true
depthEnabled: true
}
}En lugar de definir el objeto Fog de forma inline, también es posible hacer referencia a un objeto Fog mediante id. Y dado que ExtendedSceneEnvironment hereda todo de su tipo padre SceneEnvironment, la niebla también se puede utilizar con ExtendedSceneEnvironment:
Fog {
id: theFog
enabled: true
depthEnabled: true
}
environment: ExtendedSceneEnvironment {
fog: theFog
}Véase también «Qt Quick 3D - Ejemplo sencillo de niebla » y «Qt Quick 3D - Ejemplo de efectos de escena».
Documentación de propiedades
color : color
El color de la niebla. El valor por defecto es «#8099b3»

La misma escena con el color modificado para que tenga un tono más azulado:

Véase también density.
density : real
Controla la intensidad de la niebla; en la práctica, se trata de un multiplicador con un rango de valores entre 0 y 1. El valor por defecto es 1,0. Al reducir el valor, disminuye la intensidad del efecto de niebla. Solo se aplica cuando la opción « depthEnabled » está establecida en «true».
El efecto visual en pantalla puede verse afectado por otros ajustes de « ExtendedSceneEnvironment », como el mapeo de tonos o el resplandor y el bloom. Un mismo valor de densidad puede dar resultados diferentes dependiendo de qué otros efectos estén activados y de cómo estén configurados.
Una escena de ejemplo con la densidad ajustada a « 0.95 »:

La misma escena con la densidad reducida a 0.15:

Véase también color.
depthCurve : real
El valor por defecto es 1,0.
Solo es aplicable cuando « depthEnabled » está establecido en «true».
Véase también « depthEnabled ».
depthEnabled : bool
Determina si aparece la niebla en la distancia. El valor por defecto es «false».
Véase también heightEnabled, enabled, depthNear, depthFar y depthCurve.
depthFar : real
Distancia final respecto a la cámara. El valor por defecto es 1000,0. Solo se aplica cuando « depthEnabled » está establecido en «true».
Nota: Se espera quela escena, incluyendo la cámara y los modelos, esté configurada adecuadamente, de modo que se puedan definir rangos razonables mediante propiedades como « depthNear » y «depthFar». No se debe dar por sentado que la niebla siempre se pueda activar en una escena que contenga recursos importados tal cual, sin ajustar primero las transformaciones. Por ejemplo, las capturas de pantalla de ejemplo de esta página con el modelo Sponza se han generado tras aplicar manualmente una escala adicional de (100, 100, 100) al componente Sponza instanciado, generado por la herramienta balsam a partir del recurso fuente glTF. Esto proporcionó un rango Z suficiente para obtener resultados satisfactorios ajustando los valores de depthNear y depthFar.
Véase también depthNear y depthEnabled.
depthNear : real
Distancia inicial respecto a la cámara. El valor por defecto es 10,0. Solo se aplica cuando la opción « depthEnabled » está establecida en «true».
Tomemos como ejemplo esta escena, primero con un valor más alto para depthNear.

Al reducir el valor de depthNear, la niebla «se acerca» efectivamente a la cámara, ya que ahora comienza a partir de una distancia menor respecto a esta:

Nota: Se espera quela escena, incluyendo la cámara y los modelos, esté configurada adecuadamente, de modo que se puedan definir rangos razonables mediante propiedades como depthNear y depthFar. No esperes que la niebla siempre se pueda habilitar en una escena que contenga recursos importados tal cual, sin ajustar primero las transformaciones. Por ejemplo, las capturas de pantalla de ejemplo de esta página con el modelo Sponza se han generado tras aplicar manualmente una escala adicional de (100, 100, 100) al componente Sponza instanciado, que fue generado por la herramienta balsam a partir del recurso fuente glTF. Esto proporcionó un rango Z suficiente para obtener buenos resultados ajustando los valores de depthNear y depthFar.
Véase también depthFar y depthEnabled.
enabled : bool
Determina si se aplica niebla a la escena. El valor por defecto es «false».
Habilitar la niebla de profundidad o de altura no tiene ningún efecto si no se establece este valor en «true».
Véase también depthEnabled y heightEnabled.
heightCurve : real
Especifica la intensidad de la niebla de altura. El valor por defecto es 1,0. Solo se aplica cuando la opción « heightEnabled » está establecida en «true».
Véase también « heightEnabled ».
heightEnabled : bool
Determina si está activada la niebla de altura. El valor por defecto es «false».
Véase también depthEnabled, enabled, leastIntenseY, mostIntenseY y heightCurve.
leastIntenseY : real
Especifica la posición (coordenada Y) en la que la niebla es menos intensa. El valor por defecto es 10,0. Solo es aplicable cuando « heightEnabled » está establecido en «true».
Nota: Por defecto, el valor es mayor que ` mostIntenseY`. Mientras esto sea así, la niebla se renderizará de arriba abajo. Cuando este valor sea menor que ` mostIntenseY`, la niebla se renderizará de abajo arriba.
Nota: El eje Y apunta hacia arriba en las escenas 3D de Qt Quick.
En la imagen se muestra una escena con la niebla de altura activada (sin niebla de profundidad) y el valor de `leastIntenseY` establecido de tal forma que la niebla solo se extiende por la parte inferior de la escena de Sponza.

Al aumentar el valor de «leastIntenseY», la niebla se extiende más hacia arriba, ya que ahora comienza efectivamente en una posición Y más alta dentro de la escena. (Recuerda que el eje Y apunta hacia arriba)

Nota: Al igual que con la niebla de profundidad, se espera que la escena esté configurada adecuadamente, de modo que se puedan definir rangos de coordenadas Y razonables mediante `leastIntenseY` y ` mostIntenseY`. No esperes que la niebla siempre se pueda activar en una escena que contenga activos importados tal cual, sin ajustar primero las transformaciones. Por ejemplo, las capturas de pantalla de ejemplo de esta página con el modelo Sponza se han generado tras aplicar manualmente una escala adicional de (100, 100, 100) al componente Sponza instanciado, que fue generado por la herramienta balsam a partir del recurso fuente glTF.
Véase también mostIntenseY y heightEnabled.
mostIntenseY : real
Especifica la posición (coordenada Y) en la que la niebla es más intensa. El valor por defecto es 0. Solo es aplicable cuando « heightEnabled » está establecido en «true».
Nota: Por defecto, el valor es menor que ` leastIntenseY`. Mientras esto sea así, la niebla se renderiza de arriba abajo. Cuando este valor es mayor que ` leastIntenseY`, la niebla se renderiza de abajo arriba.
Nota: El eje Y apunta hacia arriba en las escenas 3D de Qt Quick.
Nota: Al igual que con la niebla de profundidad, se espera que la escena esté configurada adecuadamente, de modo que se puedan definir rangos de coordenadas Y razonables mediante leastIntenseY y mostIntenseY. No esperes que la niebla siempre se pueda activar en una escena que contenga activos importados tal cual, sin ajustar primero las transformaciones. Por ejemplo, las capturas de pantalla de ejemplo de esta página con el modelo Sponza se han generado tras aplicar manualmente una escala adicional de (100, 100, 100) al componente Sponza instanciado, que fue generado por la herramienta balsam a partir del recurso fuente glTF.
Véase también leastIntenseY y heightEnabled.
transmitCurve : real
Intensidad del efecto de transmisión de la luz. El valor por defecto es 1,0. Solo se aplica cuando « transmitEnabled » está establecido en «true».
transmitEnabled : bool
Determina si la niebla tiene un efecto de transmisión de la luz. El valor por defecto es «false».
© 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.