SCurveTonemap QML Type
Ein Tonemapping-Effekt. Mehr...
| Import Statement: | import QtQuick3D.Effects 6.12 |
| Status: | Deprecated since 6.5 |
Dieser Typ ist seit QtQuick3D.Effects 6.5 veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- contrastBoost : real
- exposureValue : real
- gammaValue : real
- saturationLevel : real
- shoulderEmphasis : real
- shoulderSlope : real
- toeEmphasis : real
- toeSlope : real
- useExposure : bool
- whitePoint : real
Ausführliche Beschreibung
Verwenden Sie stattdessen „ ExtendedSceneEnvironment “.
Warnung: Alle vorgefertigten eigenständigen Effekte in „ QtQuick3D.Effects“ gelten ab Qt 6.5 als veraltet. Verwenden Sie stattdessen „ ExtendedSceneEnvironment “, um das Tonemapping zu steuern.

Der Effekt „SCurveTonemap“ ordnet die Luminanz jedes Pixels in der Szene einer S-förmigen Kurve zu:

Die Kurve besteht aus drei Teilen. Der Fußbereich bestimmt die Schatten und wird durch „ toeSlope “ und „ toeEmphasis “ gesteuert. Der mittlere Teil bestimmt den Gesamtkontrast und wird durch „ contrastBoost “ verändert. Der Schulterbereich bestimmt die Lichter und wird durch „ shoulderSlope “ und „ shoulderEmphasis “ gesteuert.
Dokumentation der Eigenschaften
contrastBoost : real
Erhöht oder verringert den Gesamtkontrast der Tonwertzuordnung. Dadurch wird die Steigung im mittleren Bereich der S-Kurve verändert.
Der Wertebereich liegt zwischen [-1...2]. Der Standardwert ist 0.
exposureValue : real
Legt die Belichtung für den Tonemap-Effekt fest. Dieser Wert wird nur verwendet, wenn „ useExposure “ auf „ true “ gesetzt ist. Der Wertebereich liegt zwischen „ [0.01...16] “. Der Standardwert ist „ 1 “.
gammaValue : real
Legt den Gammawert für den Tonemap-Effekt fest. Sinnvolle Werte liegen im Bereich von [0.1...8]. Der Standardwert ist 2.2.
saturationLevel : real
Legt den Gesamtsättigungsgrad des Tonemapping-Effekts fest. Der Wertebereich reicht von „ [0...2] “ bis „ 2 “, wobei „ 0 “ für reine Graustufen und „ “ für eine sehr hohe Sättigung steht. Der Standardwert ist „ 1 “.
shoulderEmphasis : real
Ändert die Form des Schulterbereichs der S-Kurve. Der Wertebereich liegt zwischen [-1...1]. Der Standardwert ist 0.
Siehe auch shoulderSlope.
shoulderSlope : real
Legt die Steigung des Schulterbereichs der S-Kurve fest. Die Schulter definiert, an welcher Stelle die Lichter an Kontrast verlieren.
Der Wertebereich liegt zwischen [0...3]. Der Standardwert ist 1.
Siehe auch „ shoulderEmphasis “.
toeEmphasis : real
Ändert die Form des vorderen Abschnitts der S-Kurve. Der Wertebereich liegt zwischen [-1...1]. Der Standardwert ist 0.
Siehe auch toeSlope.
toeSlope : real
Legt die Steigung des „Toe “-Bereichs der S-Kurve fest. Der „Toe“-Bereich definiert, an welcher Stelle Schatten an Kontrast verlieren.
Der Wertebereich liegt zwischen [0...3]. Der Standardwert ist 1.
Siehe auch „ toeEmphasis “.
useExposure : bool
Stellt sicher, dass der Effekt für Luminanzberechnungen „ whitePoint “ anstelle von „ exposureValue “ verwendet. Der Standardwert ist „ false “.
whitePoint : real
Legt den Weißpunkt der Tonwertzuordnung fest. Dieser Wert wird nur verwendet, wenn „ useExposure “ auf „ false “ gesetzt ist. Der Wertebereich liegt zwischen [0.01...128]. Der Standardwert ist 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.