ExtendedSceneEnvironment QML Type

Un site SceneEnvironment fournissant les effets de rendu les plus courants. Plus d'informations...

Import Statement: import QtQuick3D.Helpers
Since: Qt 6.5
Inherits:

SceneEnvironment

Propriétés

Description détaillée

Le type ExtendedSceneEnvironment est une extension du type SceneEnvironment de QtQuick3D qui intègre une collection d'effets couramment utilisés. Les effets sont exposés par le biais d'un ensemble de propriétés préfixées par le nom de l'effet qu'elles contrôlent.

L'activation d'un ou de plusieurs de ces effets revient à ajouter manuellement des effets de post-traitement à la liste de SceneEnvironment's effects. ExtendedSceneEnvironment fournit cependant des effets qui ne sont pas disponibles sous forme autonome et, plus important encore, il combine efficacement les effets activés, réduisant ainsi le nombre de passes de rendu supplémentaires nécessaires, ce qui peut conduire à des performances nettement supérieures à celles de l'application d'effets de post-traitement individuels à la scène. ExtendedSceneEnvironment joue également bien avec la cartographie des tons, même pour les effets les plus complexes à passages multiples, et également lorsque plusieurs effets sont activés et combinés ensemble. Ce n'était pas toujours le cas avec les effets autonomes.

Remarque : si des effets de post-traitement supplémentaires sont ajoutés à la liste effects de SceneEnvironment, ils seront appliqués avant les effets fournis par le type ExtendedSceneEnvironment.

Certaines caractéristiques de SceneEnvironment, telles que la cartographie des tons, sont héritées et étendues avec des propriétés supplémentaires dans ExtendedSceneEnvironment. Par exemple, SceneEnvironment offre la propriété tonemapMode, tandis que ExtendedSceneEnvironment ajoute le contrôle de l'exposition, du point blanc, de l'accentuation et des paramètres de tramage du tonemapper. La propriété tonemapMode n'est cependant pas dupliquée puisque ExtendedSceneEnvironment hérite de tout ce qui se trouve sur SceneEnvironment, de sorte que le paramètre de base du mode de conversion de ton est utilisable quel que soit le type d'environnement associé à View3D, mais les propriétés supplémentaires ne sont disponibles que lorsque vous utilisez ExtendedSceneEnvironment. D'autres effets, tels que l'occlusion ambiante de l'espace écran (SSAO) ou le brouillard, font partie intégrante de SceneEnvironment et sont utilisables avec les deux types d'environnement.

Premiers pas avec ExtendedSceneEnvironment

Pour utiliser les fonctionnalités supplémentaires offertes par ExtendedSceneEnvironment, associez le site View3D à une instance de celui-ci. N'oubliez pas d'importer le module QtQuick3D.Helpers.

import QtQuick3D
import QtQuick3D.Helpers

View3D {
    environment: ExtendedSceneEnvironment {
        tonemapMode: SceneEnvironment.Filmic
        vignetteEnabled: true
        // ...
    }
}

Remarque : il est souvent plus productif d'expérimenter avec les paramètres de l'effet et d'ajuster les valeurs pour obtenir les résultats visuels souhaités lorsque cela est fait visuellement, avec des contrôles tels que des curseurs qui donnent un retour d'information instantané dans la scène rendue lorsqu'une valeur est modifiée. L'utilisation d'un outil de conception tel que Qt Design Studio ou d'un banc d'essai similaire à Qt Quick 3D - Scene Effects Example est donc souvent recommandée pour configurer une scène de haute qualité qui soit visuellement attrayante.

Remarque : le passage de SceneEnvironment à ExtendedSceneEnvironment implique automatiquement au moins une passe de rendu supplémentaire, comme si un effet avec une seule passe était ajouté à SceneEnvironment's effect list. Cela est vrai quel que soit le nombre d'étapes de post-traitement individuelles activées. (Les effets les plus complexes peuvent impliquer plus d'une passe de rendu supplémentaire.)

Effets disponibles

Voici un aperçu des effets et des fonctionnalités connexes fournis par ExtendedSceneEnvironment, y compris les fonctionnalités héritées de SceneEnvironment.

Voir également SceneEnvironment et Qt Quick 3D - Exemple d'effets de scène.

Propriété Documentation

adjustmentBrightness : real [default: 1]

Règle la luminosité de la scène.

Luminosité de 1Luminosité de 4


adjustmentContrast : real [default: 1]

Règle le contraste de la scène.

Contraste de 1Contraste de 4


adjustmentSaturation : real [default: 1]

Règle la saturation de la scène.

Saturation de 1Saturation de 4


colorAdjustmentsEnabled : bool [default: false]

Active les ajustements de couleur.

Voir également colorAdjustmentsEnabled.


depthOfFieldBlurAmount : real [default: 4.0]

Définit le degré de flou appliqué aux objets situés en dehors de la plage de mise au point. Les valeurs acceptables sont comprises entre 0 et 10. Une valeur de 0 n'applique aucun flou supplémentaire.

Valeur de flou de 0Valeur de flou de 15


depthOfFieldEnabled : bool [default: false]

Active l'effet de flou de profondeur de champ.


depthOfFieldFocusDistance : real [default: 600]

Définit la distance de l'appareil photo à laquelle les objets sont mis au point.

Ici, la scène Sponza a une échelle de 100 appliquée afin d'avoir une plage suffisamment grande pour appliquer le flou à l'arrière et à l'avant de la vue. La photo ci-dessous a été prise avec une distance de mise au point de 753 et une plage de mise au point de 482.


depthOfFieldFocusRange : real [default: 100]

La distance autour du site depthOfFieldFocusDistance où les éléments sont entièrement mis au point. La mise au point s'estompe ensuite pour devenir complètement floue à la même distance des côtés proche et éloigné.


ditheringEnabled : bool [default: false]

Permet le tramage pour réduire les artefacts de bandes.


exposure : real [default: 1.0]

Niveau d'exposition utilisé par le tonemapper.

Cartographie tonale filmique avec exposition 8Cartographie tonale filmique avec une exposition de 0,5


fxaaEnabled : bool [default: false]

Active l'anticrénelage approximatif rapide (FXAA).

FXAA désactivéFXAA activé


glowBlendMode : int [default: ExtendedSceneEnvironment.GlowBlendMode.SoftLight]

Mode de mélange pour l'effet de brillance.

Les modes disponibles sont les suivants

Additive est souvent recommandé pour les scènes extérieures, où un ciel ou un soleil est visible, alors que le mode par défaut SoftLight peut être plus efficace pour les environnements intérieurs.

Replace n'effectue pas de mélange, mais affiche uniquement la contribution de l'effet de lueur/bougie au contenu réel. Dans la pratique, cela peut s'avérer utile pour expérimenter et résoudre des problèmes lors de la configuration des paramètres d'un effet de lueur/bougie.

Mode de mélangeExemple
Effet de brillance désactivé

Additif

Écran

Lumière douce

Remplacer


glowBloom : real [default: 0]

Définit la quantité d'efflorescence appliquée à l'effet de brillance. Des valeurs comprises entre 0 et 1 sont attendues.

Les valeurs glowHDRMinimumValue, glowHDRMaximumValue, glowHDRScale, et glowBloom contrôlent ensemble la quantité de luminance feedback générée par l'effet de lueur/bougie.

Dans la pratique, les valeurs de glowStrength, glowIntensity et glowBloom seront souvent ajustées ensemble pour obtenir les résultats souhaités.

Par exemple, avec quatre niveaux d'éclat activés, une force de 1,5 et une intensité de 1 :

glowBloom réglé sur 0glowBloom réglé sur 0,5


glowEnabled : bool [default: false]

Active l'effet de brillance. Il peut également produire un effet d'efflorescence lorsque la valeur de glowBloom est supérieure à 0.


glowHDRMaximumValue : real [default: 12.0]

Définit la luminosité maximale de l'éclat, dans une plage dynamique élevée. La plage de valeurs est comprise entre 0 et 256.

Les valeurs glowHDRMinimumValue, glowHDRMaximumValue, glowHDRScale et glowBloom contrôlent ensemble la quantité de luminance feedback générée par l'effet de lueur/bougie.


glowHDRMinimumValue: real [default: 1.0]

Définit la luminosité minimale de la lueur, dans une plage dynamique élevée. Les valeurs attendues sont comprises entre 0 et 4.

Les valeurs glowHDRMinimumValue, glowHDRMaximumValue, glowHDRScale, et glowBloom contrôlent ensemble la quantité de luminance feedback générée par l'effet glow/bloom.


glowHDRScale : real [default: 2.0]

L'échelle d'atténuation de la lueur HDR. Les valeurs attendues sont comprises entre 0 et 8.

Les valeurs glowHDRMinimumValue, glowHDRMaximumValue, glowHDRScale et glowBloom contrôlent ensemble la quantité de luminance feedback générée par l'effet de lueur/bougie.


glowIntensity : real [default: 1]

Intensité de la lueur. Les valeurs attendues sont comprises entre 0 et 8.

L'intensité est en fait un facteur d'échelle (multiplicateur) pour la couleur d'éclat accumulée (y compris tous les niveaux).

Dans la pratique, les valeurs de glowStrength, glowIntensity et glowBloom seront souvent ajustées ensemble pour obtenir les résultats souhaités.

Par exemple, avec un glowStrength de 1,0 et un glowBloom de 0,25 :

glowIntensity de 0,25glowIntensity de 1,25


glowLevel : int [default: 1]

Définit le niveau de flou appliqué à l'effet de brillance. Au total, 7 niveaux sont disponibles.

Si aucun niveau n'est défini, la lueur n'aura aucun effet visuel.

Par exemple, pour activer les niveaux d'éclat un et six, il suffit de combiner les deux énumérations :

glowLevel = (ExtendedSceneEnvironment.GlowLevel.One | ExtendedSceneEnvironment.GlowLevel.Six)
glowLevel valeurExemple
Un

Un | Deux

Un | Deux | Trois

Un | Deux | Trois | Quatre


glowQualityHigh : bool [default: false]

Augmente le nombre d'échantillons utilisés pour la lueur lors du sous-échantillonnage afin d'améliorer la qualité de l'effet de lueur.

Remarque : l'activation de cette option est un compromis entre la qualité du rendu et les performances. Réfléchissez à la possibilité d'utiliser dithering à la place.


glowStrength : real [default: 1]

Intensité de l'éclat. Les valeurs acceptables sont comprises entre 0 et 2.

L'intensité est en fait un facteur d'échelle (multiplicateur) qui s'applique à chaque niveau. Cela signifie que plus le nombre de niveaux activés dans glowLevel est élevé, plus l'effet d'une valeur élevée de glowStrength est prononcé.

Dans la pratique, les valeurs de glowStrength, glowIntensity et glowBloom seront souvent ajustées ensemble pour obtenir les résultats souhaités.

Par exemple, avec un glowIntensity de 1,0, un glowBloom de 0,25 et les quatre premiers niveaux activés :

glowStrength de 0.5glowStrength de 1,5


glowUseBicubicUpscale : bool [default: false]

Réduit les artefacts d'aliasing et l'effet de boîte dans l'effet de lueur.

Remarque : l'utilisation de la mise à l'échelle bi-cubique se fera au détriment des performances. Examinez la possibilité d'utiliser dithering à la place.


lensFlareApplyDirtTexture : bool [default: false]

Permet d'appliquer ou non une texture de saleté au lens flare.

Texture de saleté désactivéeTexture sale activée par défaut

Voir aussi lensFlareLensDirtTexture.


lensFlareApplyStarburstTexture : bool [default: false]

Indiquer si une texture de type "starburst" doit être appliquée au lens flare.

Texture de starburst désactivéeTexture d'étincelles activée par défaut

Voir également lensFlareLensStarburstTexture.


lensFlareBloomBias : real [default: 0.95]

Définit le niveau à partir duquel le lens flare commence à s'épanouir.

La valeur du biais est soustraite de la valeur de la couleur de la plage dynamique élevée, le résultat étant fixé à 0. Cela signifie que, selon la scène, il peut parfois être nécessaire de fixer une valeur assez basse, par exemple inférieure à 1, pour que l'éblouissement de la lentille soit évident. D'où la valeur par défaut de 0,95. En revanche, lorsque la gamme de couleurs est plus étendue, une valeur plus élevée peut s'avérer plus judicieuse.

Biais de 0,81Biais de 0.31


lensFlareBloomScale : real [default: 10]

Définit l'échelle de l'effet d'éclatement de la lentille. La valeur attendue de l'échelle est comprise entre 0 et 20.

En pratique, il s'agit d'un multiplicateur pour la valeur de la couleur fixée à zéro avec la soustraction de lensFlareBloomBias.

Échelle 2, biais 0,81Échelle 20, biais 0,81


lensFlareBlurAmount : real [default: 3]

Définit la quantité de flou à appliquer à l'éblouissement de l'objectif. Plage de 0 à 50.

Quantité de flou réglée sur 0Quantité de flou réglée sur 30


lensFlareCameraDirection : vector3d [default: Qt.vector3d(0, 0, -1)]

Définit la direction de la caméra dans la scène.


lensFlareDistortion : real [default: 5]

Définit la quantité d'aberration chromatique dans le lens flare. Les valeurs attendues sont comprises entre 0 et 20.

Distorsion réglée sur 0Distorsion réglée sur 15


lensFlareEnabled : bool [default: false]

Active l'effet d'éblouissement de la lentille.

Une fois l'effet activé, la première propriété à régler est généralement lensFlareBloomBias.


lensFlareGhostCount : int [default: 4]

Définit la quantité de fantômes de l'effet d'éblouissement. Les valeurs attendues sont comprises entre 0 et 20.

Nombre de fantômes de 2Nombre de fantômes de 16


lensFlareGhostDispersal : real [default: 0.5]

Définit la distance entre les fantômes de lens flare. Les valeurs attendues sont comprises entre 0 et 5. La valeur doit être supérieure à 0.

Dispersion des fantômes de 0,25Dispersion des fantômes de 0,90


lensFlareHaloWidth : real [default: 0.25]

Définit la taille du halo des éclats de lentilles. La valeur est comprise entre 0 et 1.


lensFlareLensColorTexture : Texture

Une image de gradient utilisée pour la couleur de la lentille du lens flare.

Par défaut, une texture intégrée de 256x256 est utilisée :


lensFlareLensDirtTexture : Texture

Image utilisée pour simuler les imperfections de l'objectif.

N'a d'effet que lorsque lensFlareApplyDirtTexture est activé.

Par défaut, une texture sale intégrée est utilisée :


lensFlareLensStarburstTexture : Texture

Une image de bruit pour augmenter l'effet de starburst de l'éblouissement de l'objectif. N'a d'effet que lorsque l'option lensFlareApplyStarburstTexture est activée.

Par défaut, une texture de bruit intégrée est utilisée :


lensFlareStretchToAspect : real [default: 0.5 [0, 1]]

Définir le facteur de correction pour l'arrondi du halo de l'éblouissement.


lutEnabled : bool [default: false]

Active l'étalonnage des couleurs à l'aide de tables de conversion (LUT). La table de recherche est donnée sous forme de texture.


lutFilterAlpha : real [default: 1]

Définit la quantité d'étalonnage à mélanger à la scène. La valeur doit être comprise entre 0 et 1.


lutSize : real [default: 16]

Définit la taille de la texture de la table de conversion. La texture doit avoir les dimensions

width = lutSize * lutSize et height = lutSize


lutTexture : Texture

Source de la texture de recherche. Si aucune texture n'est définie, une table d'identité intégrée est utilisée.

L'image ci-dessous est un exemple de texture d'une taille de 256x16, correspondant à la valeur par défaut lutSize de 16.

Le résultat de cet effet :


sharpnessAmount : real [default: 0.0]

Définir le niveau d'accentuation. Les valeurs valides sont comprises entre 0.0 (désactivé) et 1.0 (complet).

Cartographie tonale filmique avec une netteté réglée sur 0Cartographie tonale filmique avec une netteté réglée sur 1


tonemapMode : enumeration [default: SceneEnvironment.TonemapModeLinear]

Cette propriété définit la manière dont les couleurs sont tonifiées avant le rendu. Tous les rendus dans Qt Quick 3D sont effectués dans l'espace colorimétrique linéaire et peuvent, dans de nombreux cas, générer des valeurs de couleur qui ne sont pas affichables. La propriété tonemapMode détermine la technique utilisée pour remapper les couleurs dans une gamme affichable.

La valeur par défaut est SceneEnvironment.TonemapModeLinear

ConstanteDescription
SceneEnvironment.TonemapModeNoneToute la cartographie tonale est ignorée. Ce mode est utile lors de l'exécution d'effets de post-traitement.
SceneEnvironment.TonemapModeLinearLa cartographie tonale linéaire est appliquée. Les couleurs sont corrigées en fonction du gamma et renvoyées dans l'espace colorimétrique sRGB.
SceneEnvironment.TonemapModeAcesLa cartographie tonale de l'Academy Color Encoding System est appliquée.
SceneEnvironment.TonemapModeHejlDawsonLa cartographie tonale Hejl-Dawson est appliquée.
SceneEnvironment.TonemapModeFilmicLa cartographie tonale filmique est appliquée.

Remarque : lors de l'utilisation d'effets de post-traitement, de nombreux effets attendent des données de couleurs linéaires non cartographiées. Il est important de contourner la cartographie tonale intégrée dans ce cas en utilisant la valeur SceneEnvironment.TonemapModeNone. Cela ne s'applique pas aux effets intégrés de ExtendedSceneEnvironment, car ils se chargent automatiquement de la cartographie tonale.

Mode TonemapExemple
Aucun

Linéaire

As

HejlDawson

Filmique


vignetteColor : color [default: "gray"]

Définit la couleur de l'effet de vignette.

Par exemple, en changeant la couleur en rouge, illustré ici avec un rayon de 4 et une force de 15 :


vignetteEnabled : bool [default: false]

Active l'effet de vignette.


vignetteRadius : real [default: 0.35]

Définit le rayon de l'effet de vignette. Les valeurs sont comprises entre 0 et 5.

Rayon de 0,35Rayon de 5,0


vignetteStrength : real [default: 15]

Définit l'intensité de l'effet de vignette. La plage va de 0 à 15.

Intensité de 15Intensité de 10


whitePoint : real [default: 1]

Valeur de référence pour le blanc lorsque la cartographie des tons est activée. La valeur doit être supérieure à 0.

Remarque : Cette valeur est ignorée lors de l'utilisation de SceneEnvironment.TonemapModeLinear.

Cartographie tonale filmique avec un point blanc réglé sur 0,1Cartographie tonale filmique avec point blanc réglé sur 1


© 2025 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.