- Qt 6.9
- Qt Quick 3D
- QML Types
- QtQuick3D.Effects
- SCurveTonemap
- Qt Quick 3D | Commercial or GPLv3

# SCurveTonemap QML Type

A tonemapping effect. More...

Import Statement: | `import QtQuick3D.Effects 6.9`
Status: | Deprecated since 6.5

This type is deprecated since QtQuick3D.Effects 6.5. We strongly advise against using it in new code.

- List of all members, including inherited members

## Properties

- contrastBoost : real
- exposureValue : real
- gammaValue : real
- saturationLevel : real
- shoulderEmphasis : real
- shoulderSlope : real
- toeEmphasis : real
- toeSlope : real
- useExposure : bool
- whitePoint : real

## Detailed Description

Use ExtendedSceneEnvironment instead.

Warning: All pre-made standalone effects in QtQuick3D.Effects are considered deprecated starting with Qt 6.5. To control tonemapping, use ExtendedSceneEnvironment instead.

The SCurveTonemap effect maps the luminance of each pixel in the Scene according to an s-shaped curve:

The curve has three parts. The toe area determines the shadows, and is governed by toeSlope and toeEmphasis. The middle part determines overall contrast, and is changed by contrastBoost. The shoulder area determines the highlights, and is governed by shoulderSlope and shoulderEmphasis.

## Property Documentation

contrastBoost : real

Enhances or reduces the overall contrast of the tonemap. This changes the slope of the middle part of the s-curve.

The range is `[-1...2]`. The default value is `0`.

exposureValue : real

Specifies the exposure for the tonemap effect. This value is only used if useExposure is `true`. The range is `[0.01...16]`. The default value is `1`.

gammaValue : real

Sets the gamma value for the tonemap effect. Sensible values are in the range `[0.1...8]`. The default value is `2.2`.

saturationLevel : real

Sets the overall saturation level of the tonemap effect. The range is `[0...2]`, with `0` being fully grayscale and `2` being very oversaturated. The default value is `1`.

shoulderEmphasis : real

Modifies the shape of the shoulder part of the s-curve. The range is `[-1...1]`. The default value is `0`.

See also shoulderSlope.

shoulderSlope : real

Sets the slope of the shoulder part of the s-curve. The shoulder defines where highlights lose contrast.

The range is `[0...3]`. The default value is `1`.

See also shoulderEmphasis.

toeEmphasis : real

Modifies the shape of the toe part of the s-curve. The range is `[-1...1]`. The default value is `0`.

See also toeSlope.

toeSlope : real

Sets the slope of the toe part of the s-curve. The toe defines where shadows lose contrast.

The range is `[0...3]`. The default value is `1`.

See also toeEmphasis.

useExposure : bool

Makes the effect use whitePoint instead of exposureValue for luminance calculations. The default value is `false`.

whitePoint : real

Sets the white point of the tonemap. This value is only used if useExposure is `false`. The range is `[0.01...128]`. The default value is `1`.