En esta página

SCurveTonemap QML Type

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

Comparación de escenas con efecto de mapa tonal de curva en S

El efecto SCurveTonemap mapea la luminancia de cada pixel en la Escena de acuerdo a una curva en forma de s. La curva tiene tres partes:

Gráfico de la función S-curve tonemap

La curva tiene tres partes. La parte de la punta determina las sombras, y se rige por toeSlope y toeEmphasis. La parte central determina el contraste general, y se modifica mediante contrastBoost. La zona del hombro determina las luces, y se rige por shoulderSlope y shoulderEmphasis.

Documentación de propiedades

contrastBoost : real

Aumenta o reduce el contraste general del mapa tonal. Cambia la pendiente de la parte central de la curva s.

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

exposureValue : real

Especifica la exposición para el efecto tonemap. Este valor sólo se utiliza si useExposure es true. El rango es [0.01...16]. El valor por defecto es 1.

gammaValue : real

Establece el valor gamma para el efecto tonemap. Los valores sensibles están en el rango [0.1...8]. El valor por defecto es 2.2.

saturationLevel : real

Establece el nivel de saturación general del efecto tonemap. El rango es [0...2], siendo 0 totalmente en escala de grises y 2 muy sobresaturado. El valor por defecto es 1.

shoulderEmphasis : real

Modifica la forma de la parte del hombro de la curva 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 dónde pierden contraste las luces.

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

Véase también shoulderEmphasis.

toeEmphasis : real

Modifica la forma de la parte de la punta de la curva 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 del dedo gordo de la curva en S. El dedo gordo define dónde las sombras pierden contraste. La punta define dónde 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 sólo 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.