En esta página

ExtendedSceneEnvironment QML Type

Un ` SceneEnvironment ` que proporciona efectos de renderizado de uso habitual. Más...

Import Statement: import QtQuick3D.Helpers
Since: Qt 6.5
Inherits:

SceneEnvironment

Propiedades

Descripción detallada

ExtendedSceneEnvironment es una extensión del tipo SceneEnvironment de QtQuick3D que incluye una colección de efectos de uso habitual integrados. Los efectos se acceden a través de un conjunto de propiedades cuyo nombre va precedido del nombre del efecto que controlan.

Al habilitar uno o varios de estos efectos, el resultado es similar al de añadir manualmente efectos de posprocesamiento a la lista effects de SceneEnvironment. Sin embargo, ExtendedSceneEnvironment proporciona efectos que no están disponibles de forma independiente y, lo que es más importante, combina de manera eficiente los efectos habilitados, reduciendo el número de pasadas de renderizado adicionales necesarias, lo que puede traducirse en un rendimiento significativamente mejor que el de aplicar efectos de posprocesamiento individuales a la escena. ExtendedSceneEnvironment también funciona bien con el mapeo de tonos, incluso en el caso de los efectos de múltiples pasadas más complicados, así como cuando se activan y combinan varios efectos a la vez. Esto no siempre era así con los efectos independientes.

Nota: Si se añaden efectos de posprocesamiento adicionales a la lista de « effects » de « SceneEnvironment », dichos efectos se aplicarán antes que los proporcionados por el tipo « ExtendedSceneEnvironment ».

Ciertas características de SceneEnvironment, como el mapeo de tonos, se heredan y amplían con propiedades adicionales en ExtendedSceneEnvironment. Por ejemplo, SceneEnvironment ofrece la propiedad tonemapMode, mientras que ExtendedSceneEnvironment añade también control sobre los ajustes de exposición, punto blanco, nitidez y difuminado del mapeador de tonos. Sin embargo, la propiedad ` tonemapMode ` no se duplica, ya que `ExtendedSceneEnvironment` hereda todo de ` SceneEnvironment`, por lo que la configuración básica del modo de mapeo de tonos se puede utilizar independientemente del tipo de entorno asociado a un ` View3D`, pero las propiedades adicionales solo están disponibles cuando se utiliza `ExtendedSceneEnvironment`. Otros efectos, como la oclusión ambiental en el espacio de pantalla (SSAO) o la niebla, forman parte integrante de SceneEnvironment y se pueden utilizar con ambos tipos de entornos.

Primeros pasos con ExtendedSceneEnvironment

Para utilizar las funciones adicionales que ofrece ExtendedSceneEnvironment, asocia el ` View3D ` a una instancia del mismo. No olvides importar el módulo ` QtQuick3D.Helpers `.

import QtQuick3D
import QtQuick3D.Helpers

View3D {
    environment: ExtendedSceneEnvironment {
        tonemapMode: SceneEnvironment.Filmic
        vignetteEnabled: true
        // ...
    }
}

Nota: Experimentar con los parámetros de los efectos y ajustar los valores para lograr los resultados visuales deseados suele ser más productivo cuando se hace de forma visual, con controles como los deslizadores que ofrecen una respuesta instantánea en la escena renderizada al cambiar un valor. Por lo tanto, suele ser recomendable utilizar una herramienta de diseño como Qt Design Studio o un entorno de pruebas similar al ejemplo «Qt Quick 3D - Scene Effects» cuando se pretenda configurar una escena de alta calidad que resulte visualmente atractiva.

Nota: Cambiar SceneEnvironment a ExtendedSceneEnvironment implica automáticamente al menos una pasada de renderizado adicional, del mismo modo que si se añadiera un efecto de una sola pasada a SceneEnvironment's effect list. Esto es así independientemente del número de pasos de posprocesamiento individuales que estén habilitados. (Los efectos más complejos pueden implicar más de una pasada de renderizado adicional).

Efectos disponibles

A continuación se ofrece una descripción general de los efectos y las funciones relacionadas que ofrece ExtendedSceneEnvironment, incluidas las funciones heredadas de « SceneEnvironment ».

Véase también SceneEnvironment y Qt Quick Ejemplo de efectos de escena en 3D.

Documentación de propiedades

adjustmentBrightness : real [default: 1]

Ajusta el brillo de la escena.

Brillo de 1Brillo de 4

Pasillo de piedra con nivel de luminosidad predeterminado

Pasillo de piedra con el nivel de luminosidad aumentado a 4

adjustmentContrast : real [default: 1]

Ajusta el contraste de la escena.

Contraste de 1Contraste de 4

Pasillo de piedra con el nivel de luminosidad predeterminado

Pasillo de piedra con el contraste aumentado a 4

adjustmentSaturation : real [default: 1]

Ajusta la saturación de la escena.

Saturación de 1Saturación de 4

Pasillo de piedra con el nivel de luminosidad predeterminado

Pasillo de piedra con la saturación aumentada a 4

colorAdjustmentsEnabled : bool [default: false]

Habilita los ajustes de color.

Véase también colorAdjustmentsEnabled .

depthOfFieldBlurAmount : real [default: 4.0]

Establece el grado de desenfoque que se aplica a los objetos que se encuentran fuera del rango de enfoque. Los valores adecuados se sitúan entre 0 y 10. Un valor de 0 no aplica ningún desenfoque adicional.

Nivel de desenfoque de 0Nivel de desenfoque de 15

Escena sin desenfoque por profundidad de campo

Escena con desenfoque por profundidad de campo a 15

depthOfFieldEnabled : bool [default: false]

Activa el efecto de desenfoque de la profundidad de campo.

depthOfFieldFocusDistance : real [default: 600]

Establece la distancia desde la cámara a la que los objetos aparecen enfocados.

En este caso, a la escena de Sponza se le ha aplicado una escala de 100 para disponer de un rango lo suficientemente amplio como para aplicar el desenfoque tanto al fondo como al primer plano de la imagen. La imagen que se muestra a continuación se ha tomado con una distancia de enfoque de 753 y un rango de enfoque de 482.

Escena que muestra el efecto de profundidad de campo

depthOfFieldFocusRange : real [default: 100]

La distancia alrededor de la « depthOfFieldFocusDistance » en la que los objetos se ven totalmente nítidos. A partir de ahí, la nitidez va disminuyendo hasta que todo queda completamente desenfocado en la misma distancia, tanto en el lado cercano como en el lejano.

ditheringEnabled : bool [default: false]

Activa el dithering para reducir los artefactos de bandas.

exposure : real [default: 1.0]

Nivel de exposición utilizado por el mapeador de tonos.

Mapeado de tonos cinematográfico con exposición 8Mapeo tonal cinematográfico con la exposición ajustada a 0,5

Escena con un valor de exposición de 8

Escena con un valor de exposición de 0,5

fxaaEnabled : bool [default: false]

Activa el suavizado aproximado rápido (FXAA).

FXAA desactivadoFXAA activado

Pasillo de piedra sin suavizado

Pasillo de piedra con suavizado rápido aproximado

glowBlendMode : int [default: ExtendedSceneEnvironment.GlowBlendMode.SoftLight]

Modo de fusión para el efecto de resplandor.

Los modos disponibles son:

Additive suele recomendarse para escenas al aire libre, en las que se ve el cielo o el sol, mientras que el valor predeterminado « SoftLight » puede funcionar mejor en entornos interiores.

Replace no realiza ninguna fusión, sino que se limita a mostrar únicamente la contribución que el efecto de resplandor o bloom fusionaría con el contenido real. En la práctica, esto puede resultar útil para experimentar y solucionar problemas al configurar los parámetros de un efecto de resplandor o bloom.

Modo de fusiónEjemplo
Resplandor desactivado

Pasillo de piedra sin efecto de brillo

Aditivo

Escena con el modo de fusión «Aditivo brillante»

Pantalla

Escena con el modo de fusión «Pantalla brillante»

Luz suave

Pasillo de piedra con un efecto luminoso conseguido mediante el modo de fusión «Luz suave»

Reemplazar

Escena con el modo de fusión «Reemplazar brillo»

glowBloom : real [default: 0]

Establece la intensidad del efecto «bloom» aplicado al efecto de resplandor. Se admiten valores entre 0 y 1.

Los valores de « glowHDRMinimumValue », « glowHDRMaximumValue », « glowHDRScale » y «glowBloom» controlan conjuntamente la intensidad del « luminance feedback » generado por el efecto de resplandor/bloom.

En la práctica, los valores de « glowStrength », « glowIntensity » y «glowBloom» suelen ajustarse conjuntamente para lograr los resultados deseados.

Por ejemplo, con cuatro niveles de resplandor activados, una potencia de 1,5 y una intensidad de 1:

glowBloom establecido en 0glowBloom establecido en 0,5

Pasillo de piedra con el efecto «glow bloom» ajustado a 0

Pasillo de piedra con el efecto «glow bloom» ajustado a 0,5

glowEnabled : bool [default: false]

Activa el efecto de resplandor. También puede generar un efecto de «bloom» cuando el valor de « glowBloom » es mayor que 0.

glowHDRMaximumValue : real [default: 12.0]

Establece el brillo máximo del resplandor, en rango dinámico alto. El rango de valores va de 0 a 256.

Los valores « glowHDRMinimumValue », «glowHDRMaximumValue», « glowHDRScale » y « glowBloom » controlan conjuntamente la cantidad de « luminance feedback » generada por el efecto de resplandor/bloom.

glowHDRMinimumValue : real [default: 1.0]

Establece el brillo mínimo del resplandor, en rango dinámico alto. Los valores esperados se encuentran en el intervalo de 0 a 4.

Los valores glowHDRMinimumValue, glowHDRMaximumValue, glowHDRScale y glowBloom controlan conjuntamente la cantidad de « luminance feedback » generada por el efecto de resplandor o «bloom».

glowHDRScale : real [default: 2.0]

La escala de difuminado del resplandor HDR. Los valores esperados se sitúan en el intervalo de 0 a 8.

Los valores de « glowHDRMinimumValue », « glowHDRMaximumValue », «glowHDRScale» y « glowBloom » controlan conjuntamente la cantidad de « luminance feedback » generada por el efecto de resplandor/bloom.

glowIntensity : real [default: 1]

Intensidad del resplandor. Los valores esperados se sitúan en el intervalo de 0 a 8.

La intensidad es, en la práctica, un factor de escala (multiplicador) para el color del resplandor acumulado (incluidos todos los niveles).

En la práctica, los valores de « glowStrength », «glowIntensity» y « glowBloom » suelen ajustarse conjuntamente para conseguir los resultados deseados.

Por ejemplo, con un valor de « glowStrength » de 1,0 y un valor de « glowBloom » de 0,25:

glowIntensity de 0,25glowIntensity de 1,25

Patio de piedra con una intensidad de brillo de 0,25

Patio de piedra con intensidad de brillo 1,25

glowLevel : int [default: 1]

Establece qué pasadas de desenfoque se aplican al efecto de resplandor. Hay un total de 7 niveles disponibles.

Si no se establece ningún nivel, el resplandor no tendrá ningún efecto visual.

Por ejemplo, para activar los niveles de resplandor uno y seis, basta con realizar una operación OR entre las dos enumeraciones:

glowLevel = (ExtendedSceneEnvironment.GlowLevel.One | ExtendedSceneEnvironment.GlowLevel.Six)
valor de glowLevelEjemplo
Uno

Patio de piedra con resplandor en el nivel 1

Uno | Dos

Patio de piedra con iluminación en los niveles 1 y 2

Uno | Dos | Tres

Patio de piedra con resplandor en los niveles 1, 2 y 3

Uno | Dos | Tres | Cuatro

Escena en la que se aprecia el resplandor en los niveles 1, 2, 3 y 4

glowQualityHigh : bool [default: false]

Aumenta el número de muestras utilizadas para el resplandor al reducir la resolución, con el fin de mejorar la calidad del efecto de resplandor.

Nota: Al activar esta opción, hay que sopesar la calidad del renderizado frente al rendimiento. Valora si es posible utilizar en su lugar « dithering ».

glowStrength : real [default: 1]

Intensidad del brillo. Los valores aceptables van de 0 a 2.

La intensidad es, en la práctica, un factor de escala (multiplicador) que se aplica por nivel. Esto significa que cuantos más niveles estén activados en « glowLevel », más pronunciado será el efecto de un valor mayor de «glowStrength».

En la práctica, los valores de «glowStrength», « glowIntensity » y « glowBloom » suelen ajustarse conjuntamente para conseguir los resultados deseados.

Por ejemplo, con un valor de « glowIntensity » de 1,0, un valor de « glowBloom » de 0,25 y los cuatro primeros niveles activados:

glowStrength de 0,5glowStrength de 1,5

Escena con intensidad de brillo de 0,5

Escena con intensidad de brillo 1,5

glowUseBicubicUpscale : bool [default: false]

Reduce los artefactos de aliasing y el efecto de «encajonamiento» en el efecto de resplandor.

Nota: El uso del escalado bicúbico conllevará una merma en el rendimiento. Valora si es posible utilizar en su lugar « dithering ».

lensFlareApplyDirtTexture : bool [default: false]

Establece si se aplica una textura de suciedad al destello de la lente.

Textura de suciedad desactivadaTextura de suciedad activada por defecto

Patio de piedra con un destello de lente nítido

Patio de piedra con efecto de destello que muestra la textura de la tierra

Véase también lensFlareLensDirtTexture.

lensFlareApplyStarburstTexture : bool [default: false]

Establece si se aplica una textura de rayos de estrella al destello de la lente.

Textura de rayo estelar desactivadaTextura de estrella activada por defecto

Patio de piedra con destello de lente, sin efecto de estrella

Patio de piedra con un efecto de destello que forma un patrón en forma de estrella

Véase también lensFlareLensStarburstTexture.

lensFlareBloomBias : real [default: 0.95]

Establece el nivel a partir del cual comienza el efecto de destello de la lente.

El valor de sesgo se resta del valor de color de alto rango dinámico, y el resultado se limita a 0. Esto significa que, dependiendo de la escena, a veces puede ser necesario establecerlo en un valor bastante bajo, por ejemplo, por debajo de 1, para que el destello de la lente resulte evidente. De ahí el valor predeterminado de 0,95. Sin embargo, cuando se dispone de una gama de colores más amplia, puede tener más sentido utilizar un valor mayor.

Desviación de 0,81Sesgo de 0,31

Patio de piedra con un sutil destello de lente, sesgo 0,81

Patio de piedra con un marcado efecto de destello de lente, sesgo de 0,31

lensFlareBloomScale : real [default: 10]

Establece la escala del efecto de difuminado del destello de lente. El valor de escala esperado oscila entre 0 y 20.

En la práctica, esto actúa como un multiplicador del valor de color, limitado a cero y del que se ha restado el valor « lensFlareBloomBias ».

Escala 2, sesgo 0,81Escala 20, sesgo 0,81

Pasillo de piedra con efecto de destello de lente, escala 2

Pasillo de piedra con efecto de destello de lente, escala 20

lensFlareBlurAmount : real [default: 3]

Establece el grado de desenfoque que se aplicará al destello de la lente. El rango va de 0 a 50.

Nivel de desenfoque establecido en 0Nivel de desenfoque establecido en 30

Patio de piedra con un fuerte destello de lente

Patio de piedra con un destello difuso de la lente

lensFlareCameraDirection : vector3d [default: Qt.vector3d(0, 0, -1)]

Establece la orientación de la cámara en la escena.

lensFlareDistortion : real [default: 5]

Establece el nivel de aberración cromática en el destello de la lente. Los valores esperados oscilan entre 0 y 20.

Distorsión ajustada a 0Distorsión ajustada a 15

Patio de piedra con efecto de destello, sin aberración cromática

Patio de piedra con un destello en forma de lente que muestra una aberración cromática

lensFlareEnabled : bool [default: false]

Activa el efecto de destello de lente.

Una vez activado, la primera propiedad que suele ajustarse es « lensFlareBloomBias ».

lensFlareGhostCount : int [default: 4]

Establece la cantidad de reflejos fantasma del objetivo. Los valores esperados van de 0 a 20.

Número de reflejos: 2Número de reflejos fantasma: 16

Patio de piedra con dos reflejos en forma de fantasma

Patio de piedra con 16 reflejos de lente en forma de fantasma

lensFlareGhostDispersal : real [default: 0.5]

Establece la distancia entre los reflejos fantasmas del destello de la lente. Los valores esperados están comprendidos entre 0 y 5. El valor debe ser mayor que 0.

Dispersión de los reflejos de 0,25Dispersión de los reflejos de 0,90

Patio de piedra con reflejos de lente muy próximos entre sí

Patio de piedra con reflejos de lente muy espaciados

lensFlareHaloWidth : real [default: 0.25]

Establece el tamaño del halo del destello de la lente. El valor puede oscilar entre 0 y 1.

lensFlareLensColorTexture : Texture

Una imagen con degradado que se utiliza para el color del destello de la lente.

Por defecto se utiliza una textura integrada de 256x256:

Degradado horizontal que va del amarillo al rosa y al magenta

lensFlareLensDirtTexture : Texture

Una imagen que se utiliza para simular imperfecciones en la lente.

Solo surte efecto cuando está activada la opción « lensFlareApplyDirtTexture ».

Por defecto, se utiliza una textura de suciedad integrada:

Textura en escala de grises con puntos brillantes dispersos sobre un fondo oscuro

lensFlareLensStarburstTexture : Texture

Una imagen de ruido para realzar el efecto de destello estelar del resplandor de la lente. Solo surte efecto cuando está activada la opción « lensFlareApplyStarburstTexture ».

Por defecto, se utiliza una textura de ruido integrada:

Textura de ruido en escala de grises con patrones irregulares de claros y oscuros

lensFlareStretchToAspect : real [default: 0.5 [0, 1]]

Establece el factor de corrección de la redondez del halo del destello de la lente.

lutEnabled : bool [default: false]

Permite la corrección de color mediante tablas de consulta (LUT). La tabla de consulta se proporciona en forma de textura.

lutFilterAlpha : real [default: 1]

Establece la intensidad del ajuste de color que se aplicará a la escena. El valor debe estar comprendido entre 0 y 1.

lutSize : real [default: 16]

Establece el tamaño de la textura LUT. La textura debe tener las siguientes dimensiones:

width = lutSize * lutSize y height = lutSize

lutTexture : Texture

Fuente de la textura de consulta. Si no se establece ninguna textura, se utiliza una tabla de identidad integrada.

A continuación se muestra una textura de ejemplo con un tamaño de 256x16, que coincide con el valor predeterminado de « lutSize » (tamaño de texto) de 16.

Franja de degradado horizontal que muestra la conversión de colores mediante LUT para la inversión

El resultado de este efecto:

Pasillo de piedra con colores invertidos mediante LUT

sharpnessAmount : real [default: 0.0]

Establece el nivel de nitidez. Los valores válidos van desde « 0.0 » (desactivado) hasta « 1.0 » (máximo).

Mapeo de tonos cinematográfico con la nitidez ajustada a 0Mapeo de tonos cinematográfico con la nitidez ajustada a 1

Pasillo de piedra con la nitidez ajustada a 0

Pasillo de piedra con la nitidez ajustada a 1

ssgiBufferSizeFactor : real [default: 0.5, since 6.11]

Controla el tamaño de los búferes de color sobre los que actúa el efecto SSGI. Realizar todo el proceso con objetivos de renderizado que coincidan con las dimensiones de entrada y salida (es decir, el tamaño de píxel de View3D) puede resultar demasiado costoso, algo que muchas GPU y dispositivos no pueden permitirse en la práctica. Por lo tanto, el efecto SSGI opera con un tamaño reducido para las texturas intermedias. Por defecto, este valor es 0,5, lo que significa la mitad del tamaño de las texturas de entrada y salida. Aumentar el valor hacia 1 mejora la calidad de los resultados, a costa de un aumento considerable de la carga de la GPU.

Esta propiedad se introdujo en Qt 6.11.

ssgiEnabled : bool [default: false, since 6.11]

Activa la iluminación global en el espacio de la pantalla. Este efecto aumenta el realismo al añadir oclusión ambiental y luz indirecta a la escena.

SSGI desactivadaSSGI activado

Sala medieval sin iluminación global en el espacio-pantalla

Sala medieval con iluminación global «screen-space» activada

Esta propiedad se introdujo en Qt 6.11.

Véase también «Qt Quick 3D - Ejemplo de mapa de luz SSGI».

ssgiHitThickness : real [default: 0.5, since 6.11]

Configura el algoritmo de iluminación global.

El rango recomendado es de 0,001 a 4,0.

Esta propiedad se introdujo en Qt 6.11.

ssgiIndirectLightBoost : real [default: 4.0, since 6.11]

Multiplicador para los resultados de la luz indirecta. Al aumentar el valor, la contribución de la luz indirecta se hace más notable. El rango recomendado es de 1 a 100. El valor adecuado depende siempre de la escena y de cómo esté iluminada.

Esta propiedad se introdujo en Qt 6.11.

ssgiIndirectLightEnabled : bool [default: true, since 6.11]

Determina si se incluye la luz indirecta en el resultado, o solo la oclusión ambiental. Por defecto, ambas opciones están activadas.

Establecer el valor en «false» ofrece una alternativa directa a la opción « ambient occlusion » de SceneEnvironment. Se espera que los resultados de AO proporcionados por SSGI sean de mayor calidad y requieran poco o ningún ajuste. Esto conlleva una carga potencialmente mayor para la GPU.

SSGI desactivadoSSGI solo con AO

Escultura de un león sin oclusión ambiental

Escultura de un león con oclusión ambiental de SSGI

Esta propiedad se introdujo en Qt 6.11.

ssgiSampleCount : int [default: 4, since 6.11]

Configura el algoritmo de iluminación global. Un mayor número de muestras proporcionará mejores resultados, aunque a costa de una mayor carga de la GPU.

El rango recomendado es de 1 a 16.

Esta propiedad se introdujo en Qt 6.11.

ssgiSampleRadius : real [default: 0.1, since 6.11]

Configura el algoritmo de iluminación global.

El rango recomendado es de 0,001 a 4,0.

Esta propiedad se introdujo en Qt 6.11.

ssgiSimulatedBounceEnabled : bool [default: false, since 6.11]

Determina si se simula el rebote adicional de la luz mediante el muestreo de la textura del fotograma anterior.

Esta propiedad se introdujo en Qt 6.11.

ssgiSimulatedBounceFactor : real [default: 0.5, since 6.11]

Multiplicador del resultado del cálculo de rebote simulado. Solo surte efecto cuando « ssgiSimulatedBounceEnabled » está establecido en « true ». Es posible que sea necesario ajustar este valor junto con « ssgiIndirectLightBoost ». Dependiendo de la escena y de cómo esté iluminada, unos valores más altos para estas propiedades pueden dar lugar a una contribución de la luz indirecta excesivamente exagerada, e incluso a un bucle de retroalimentación en el que la luz indirecta aumente de forma desmesurada entre fotogramas.

Esta propiedad se introdujo en Qt 6.11.

ssgiSliceCount : int [default: 4, since 6.11]

Configura el algoritmo de iluminación global.

El rango recomendado es de 1 a 8.

Esta propiedad se introdujo en Qt 6.11.

ssrEnabled : bool [default: false, since 6.11]

Activa los reflejos en el espacio de la pantalla, una técnica de posprocesamiento que crea reflejos utilizando los datos renderizados en la pantalla.

SSR desactivadoSSR activado

Logotipo verde de Qt y cubo rojo sobre un suelo sin reflejos

Logotipo verde de Qt y cubo rojo reflejados en un suelo reflectante

Esta propiedad se introdujo en Qt 6.11.

ssrMaxSteps : int [default: 256, since 6.12]

Limita el número de pasos que puede recorrer el rayo de reflexión por la pantalla. Los valores más altos mejoran el alcance y la calidad del reflejo, pero reducen el rendimiento.

Esta propiedad se introdujo en Qt 6.12.

ssrThickness : real [default: 20, since 6.12]

Espesor supuesto de la geometría de la escena utilizada por los reflejos en el espacio de pantalla. Los valores más altos reducen la fragmentación de los reflejos (similar al «acné de las sombras»), pero pueden hacer que los reflejos parezcan físicamente incorrectos.

Esta propiedad se introdujo en Qt 6.12.

tonemapMode : enumeration [default: SceneEnvironment.TonemapModeLinear]

Esta propiedad define cómo se aplica el mapeo de tonos a los colores antes del renderizado. Todo el renderizado en Qt Quick 3D se realiza en un espacio de color lineal, lo que en muchos casos puede dar lugar a la generación de valores de color que no se pueden visualizar. El parámetro «tonemapMode» determina la técnica que se utiliza para reasignar los colores a un rango visualizable.

El valor por defecto es SceneEnvironment.TonemapModeLinear

ConstantDescripción
SceneEnvironment.TonemapModeNoneSe omite todo el mapeo de tonos. Este modo resulta útil al aplicar efectos de posprocesamiento.
SceneEnvironment.TonemapModeLinearSe aplica un mapeo de tonos lineal. Los colores se someten a una corrección gamma y se devuelven en el espacio de color sRGB.
SceneEnvironment.TonemapModeAcesSe aplica el mapeo de tonos del Sistema de Codificación de Color de la Academia (ACES).
SceneEnvironment.TonemapModeHejlDawsonSe aplica el mapeo de tonos Hejl-Dawson.
SceneEnvironment.TonemapModeFilmicSe aplica el mapeo tonal «Filmic».

Nota: Al utilizar efectos de posprocesamiento, muchos de ellos requieren datos de color lineales sin mapeo de tonos. En este caso, es importante omitir el mapeo de tonos integrado utilizando el valor « SceneEnvironment.TonemapModeNone ». Esto no se aplica a los efectos integrados de « ExtendedSceneEnvironment », ya que estos se encargan automáticamente del mapeo de tonos adecuado.

Modo de mapeo de tonosEjemplo
Ninguno

Escena sin mapeo de tonos

Lineal

Escena con mapeo de tonos lineal

Aces

Escena con mapeo de tonos ACES

HejlDawson

Escena con mapeo de tonos de Hejl-Dawson

Cinemático

Escena con mapeo de tonos cinematográfico

vignetteColor : color [default: "gray"]

Establece el color del efecto de viñeta.

Por ejemplo, si se cambia el color a rojo, como se muestra aquí con un radio de 4 y una intensidad de 15:

Pasillo de piedra con efecto de viñeta roja

vignetteEnabled : bool [default: false]

Activa el efecto de viñeta.

vignetteRadius : real [default: 0.35]

Establece el radio del efecto de viñeta. El valor puede oscilar entre 0 y 5.

Radio de 0,35Radio de 5,0

Pasillo de piedra con el radio de viñeta fijado en 0,35

Pasillo de piedra con el radio de la viñeta fijado en 5,0

vignetteStrength : real [default: 15]

Establece la intensidad del efecto de viñeta. El rango va de 0 a 15.

Intensidad de 15Intensidad de 10

Pasillo de piedra con la intensidad de la viñeta ajustada a 15

Pasillo de piedra con la intensidad de la viñeta ajustada a 10

whitePoint : real [default: 1]

Valor de referencia para el blanco cuando está activado el mapeo de tonos. El valor debe ser mayor que 0.

Nota: Este valor se ignora cuando se utiliza « SceneEnvironment.TonemapModeLinear ».

Mapeo de tonos cinematográfico con el punto blanco establecido en 0,1Mapeo tonal cinematográfico con el punto blanco fijado en 1

Pasillo de piedra con mapeo de tonos más luminoso, punto blanco 0,1

Pasillo de piedra con mapeo de tonos más oscuro, punto blanco 1

© 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.