En esta página

Fog QML Type

Especifica los ajustes de niebla para una escena. Más...

Import Statement: import QtQuick3D
Since: Qt 6.5
Inherits:

QtObject

Propiedades

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.

Escena con efecto de 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:

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»

Escena con una niebla azul ligeramente desaturada

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

Escena con niebla azul

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 »:

Escena con una densidad de niebla del 95 por ciento

La misma escena con la densidad reducida a 0.15:

Escena con una densidad de niebla del 15 por ciento

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.

Escena con mayor profundidad. Valor cercano al de la niebla

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:

Escena con menor profundidad. Valor cercano al de la niebla.

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.

Escena con un valor de «leastIntenseY» más bajo

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)

Escena con un valor de «leastIntenseY fog» más alto

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.