Auf dieser Seite

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

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.

Szenenvergleich, der den Tonemapping-Effekt der S-Kurve veranschaulicht

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

Grafik zur Darstellung der S-Kurven-Tonwertumwandlungsfunktion

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.