Sur cette page

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

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.

Comparaison de scènes illustrant l'effet du « tonemapping » en courbe en S

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

Graphique illustrant la fonction de mappage des tons en 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.