SCurveTonemap QML Type
Un effet de « tonemapping ». En savoir plus…
| Import Statement: | import QtQuick3D.Effects 6.12 |
| Status: | Deprecated since 6.5 |
Ce type est obsolète depuis QtQuick3D.Effects 6.5. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
- contrastBoost : real
- exposureValue : real
- gammaValue : real
- saturationLevel : real
- shoulderEmphasis : real
- shoulderSlope : real
- toeEmphasis : real
- toeSlope : real
- useExposure : bool
- whitePoint : real
Description détaillée
Utilisez plutôt ExtendedSceneEnvironment.
Avertissement : tous les effets autonomes prédéfinis de la classe QtQuick3D.Effects sont considérés comme obsolètes à partir de Qt 6.5. Pour contrôler le tonemapping, utilisez plutôt ExtendedSceneEnvironment.

L'effet SCurveTonemap mappe la luminance de chaque pixel de la scène selon une courbe en S :

La courbe comporte trois parties. La zone de base détermine les ombres et est régie par toeSlope et toeEmphasis. La partie centrale détermine le contraste global et est modifiée par contrastBoost. La zone d’épaule détermine les hautes lumières et est régie par shoulderSlope et shoulderEmphasis.
Documentation des propriétés
contrastBoost : real
Augmente ou réduit le contraste global de la carte de tons. Cela modifie la pente de la partie centrale de la courbe en S.
La plage est comprise entre [-1...2]. La valeur par défaut est 0.
exposureValue : real
Définit l'exposition de l'effet « tonemap ». Cette valeur n'est utilisée que si l'option « useExposure » est définie sur « true ». La plage de valeurs est comprise entre « [0.01...16] ». La valeur par défaut est « 1 ».
gammaValue : real
Définit la valeur gamma pour l'effet de tonemapping. Les valeurs recommandées se situent dans l'intervalle [0.1...8]. La valeur par défaut est 2.2.
saturationLevel : real
Permet de définir le niveau global de saturation de l'effet de mappage des tons. La plage va de [0...2], où 0 correspond à une image entièrement en niveaux de gris et 2 à une image très sursaturée. La valeur par défaut est 1.
shoulderEmphasis : real
Modifie la forme de la partie « épaule » de la courbe en S. La plage de valeurs est comprise entre [-1...1]. La valeur par défaut est 0.
Voir également shoulderSlope.
shoulderSlope : real
Définit la pente de la partie « épaule » de la courbe en S. L'épaule détermine l'endroit où les zones claires perdent en contraste.
La plage de valeurs est comprise entre [0...3]. La valeur par défaut est 1.
Voir aussi shoulderEmphasis.
toeEmphasis : real
Modifie la forme de la partie initiale de la courbe en S. La plage de valeurs est comprise entre [-1...1]. La valeur par défaut est 0.
Voir également toeSlope.
toeSlope : real
Définit la pente de la partie inférieure de la courbe en S. Cette partie inférieure détermine à quel endroit les ombres perdent en contraste.
La plage de valeurs est comprise entre [0...3]. La valeur par défaut est 1.
Voir également toeEmphasis.
useExposure : bool
Permet à l'effet d'utiliser whitePoint au lieu de exposureValue pour les calculs de luminance. La valeur par défaut est false.
whitePoint : real
Définit le point blanc de la carte de tons. Cette valeur n'est utilisée que si l'option « useExposure » est définie sur « false ». La plage de valeurs est comprise entre [0.01...128]. La valeur par défaut est 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.