En esta página

SCurveTonemap QML Type

Un efecto de mapeo de tonos. 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 de QtQuick3D.Effects se consideran obsoletos a partir de Qt 6.5. Para controlar el mapeo de tonos, utiliza en su lugar ExtendedSceneEnvironment.

Comparación de escenas que muestra el efecto del mapeo de tonos con curva en S

El efecto SCurveTonemap mapea la luminancia de cada píxel de la escena según una curva en forma de S:

Gráfico que muestra la función de mapeo de tonos de curva en S

La curva tiene tres partes. La zona de la base determina las sombras y viene definida por toeSlope y toeEmphasis. La parte central determina el contraste general y se modifica mediante contrastBoost. La zona de los hombros determina las luces y viene definida por shoulderSlope y shoulderEmphasis.

Documentación de propiedades

contrastBoost : real

Aumenta o reduce el contraste general del mapa de tonos. Esto modifica la pendiente de la parte central de la curva en S.

El rango es [-1...2]. El valor por defecto es 0.

exposureValue : real

Especifica la exposición para el efecto de mapeo de tonos. Este valor solo se utiliza si « useExposure » tiene el valor « true ». El rango es « [0.01...16] ». El valor por defecto es « 1 ».

gammaValue : real

Establece el valor de gamma para el efecto de mapeo de tonos. Los valores adecuados se encuentran en el intervalo [0.1...8]. El valor por defecto es 2.2.

saturationLevel : real

Establece el nivel general de saturación del efecto de mapeo de tonos. El rango va de [0...2], donde 0 corresponde a una escala de grises total y 2 a una saturación muy elevada. El valor por defecto es 1.

shoulderEmphasis : real

Modifica la forma de la parte del hombro de la curva en S. El rango es [-1...1]. El valor por defecto es 0.

Véase también shoulderSlope.

shoulderSlope : real

Establece la pendiente de la parte del «hombro» de la curva en S. El «hombro» define el punto en el que las luces pierden contraste.

El rango es [0...3]. El valor por defecto es 1.

Véase también shoulderEmphasis.

toeEmphasis : real

Modifica la forma de la parte inicial de la curva en S. El rango es [-1...1]. El valor por defecto es 0.

Véase también toeSlope.

toeSlope : real

Establece la pendiente de la parte inicial de la curva en S. La parte inicial define el punto en el que las sombras pierden contraste.

El rango es [0...3]. El valor por defecto es 1.

Véase también toeEmphasis.

useExposure : bool

Hace que el efecto utilice whitePoint en lugar de exposureValue para los cálculos de luminancia. El valor por defecto es false.

whitePoint : real

Establece el punto blanco del mapa de tonos. Este valor solo se utiliza si « useExposure » es « false ». El rango es « [0.01...128] ». El valor por defecto es « 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.