SceneEnvironment QML Type

Permet de configurer le rendu d'une scène. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• antialiasingMode : enumeration
• antialiasingQuality : enumeration
• aoBias : real
• aoDistance : real
• aoDither : bool
• aoEnabled : bool (since 6.5)
• aoSampleRate : int
• aoSoftness : real
• aoStrength : real
• backgroundMode : enumeration
• clearColor : color
• debugSettings : QtQuick3D::DebugSettings (since 6.5)
• depthPrePassEnabled : bool
• depthTestEnabled : bool
• effects : List<QtQuick3D::Effect>
• fog : QtQuick3D::Fog (since 6.5)
• lightProbe : QtQuick3D::Texture
• lightmapper : Lightmapper
• oitMethod : enumeration (since 6.11)
• probeExposure : real
• probeHorizon : real
• probeOrientation : vector3d
• scissorRect : rect (since 6.5)
• skyBoxCubeMap : QtQuick3D::CubeMapTexture (since 6.4)
• skyboxBlurAmount : real (since 6.4)
• specularAAEnabled : bool (since 6.4)
• temporalAAEnabled : bool
• temporalAAMode : enumeration (since 6.11)
• temporalAAStrength : real
• tonemapMode : enumeration (since 6.0)

Description détaillée

SceneEnvironment définit un ensemble de propriétés globales pour le rendu d'une scène.

Pour utiliser SceneEnvironment ou ExtendedSceneEnvironment, associez le environment property d'un View3D à une instance de ces types. L'objet peut être déclaré en ligne, par exemple comme ceci :

View3D {
    environment: SceneEnvironment {
        antialiasingMode: SceneEnvironment.MSAA
        tonemapMode: SceneEnvironment.TonemapModeFilmic
        backgroundMode: SceneEnvironment.SkyBox
        lightProbe: Texture {
            source: "panoramic_hdri_background.hdr"
        }
    }
}

L'objet environnement peut également être défini séparément. Il peut ensuite être référencé par un ou plusieurs objets View3D. Un exemple d'extrait de code, utilisant cette fois ExtendedSceneEnvironment:

ExtendedSceneEnvironment {
    id: myEnv
    vignetteEnabled: true
}

View3D {
    width: parent.width / 2
    environment: myEnv
}

View3D {
    width: parent.width / 2
    x: parent.width / 2
    environment: myEnv
}

Aperçu des fonctionnalités

• Paramètres d'anticrénelage. Voir les meilleures pratiques en matière d'anticrénelage pour une vue d'ensemble de ce sujet. Les propriétés concernées sont antialiasingMode, antialiasingQuality, specularAAEnabled, temporalAAEnabled, temporalAAStrength. En outre, si ExtendedSceneEnvironment est utilisé, une autre méthode est disponible via fxaaEnabled.
• Occlusion ambiante dans l'espace de l'écran. Les propriétés concernées sont aoEnabled, aoStrength, aoBias, aoDistance, aoDither, aoSampleRate, aoSoftness. Notez que SSGI fournit également l'occlusion ambiante et qu'il donnera souvent des résultats de meilleure qualité, bien qu'à un coût plus élevé en termes de performances. Évitez d'activer l'occlusion ambiante de SceneEnvironment et le SSGI de ExtendedSceneEnvironment en même temps.
• Couleur claire, boîte à ciel, éclairage basé sur l'image. Pour plus d'informations sur l'IBL, voir Utilisation de l'éclairage basé sur l'image. Les propriétés concernées sont backgroundMode, clearColor, lightProbe, probeExposure, probeHorizon, probeOrientation, skyboxBlurAmount, skyBoxCubeMap.
• Tonemapping. tonemapMode configure la méthode de tonemapping utilisée pour convertir les valeurs de couleur de la plage dynamique élevée en plage 0-1 à la fin du pipeline graphique. ExtendedSceneEnvironment offre quelques propriétés supplémentaires, telles que whitePoint et sharpnessAmount, qui peuvent être utilisées pour ajuster les calculs de tonemapping.
• Paramètres du tampon de profondeur. Les propriétés correspondantes sont depthPrePassEnabled, depthTestEnabled.
• Effets de post-traitement. Outre les effets de post-traitement intégrés fournis par ExtendedSceneEnvironment, les applications peuvent fournir leurs propres effets personnalisés via le type Effect. La propriété effects est une liste d'instances Effect.
• Paramètres de visualisation de débogage, tels que le mode fil de fer ou le fait de ne rendre que certaines contributions de couleur pour les matériaux. Ces paramètres sont contrôlés par l'objet DebugSettings référencé par la propriété debugSettings. La plupart de ces paramètres peuvent également être contrôlés de manière interactive lorsqu'un élément DebugView est ajouté à la scène.
• Paramètres de brouillard. Pour activer le brouillard, définissez un objet Fog configuré de manière appropriée dans la propriété fog.
• Paramètres de cuisson de la carte lumineuse. Lorsque des lightmaps précuites sont utilisées pour certains modèles de la scène, l'objet Lightmapper défini dans la propriété lightmapper définit les paramètres utilisés au cours du processus de cuisson.
• Paramètres des ciseaux. Pour appliquer un ciseau différent de celui de la fenêtre, définissez la propriété scissorRect.

Voir également ExtendedSceneEnvironment.

Documentation sur les propriétés

antialiasingMode : enumeration

Cette propriété contrôle le mode d'anticrénelage appliqué lors du rendu de la scène.

Les valeurs possibles sont les suivantes

La valeur par défaut est SceneEnvironment.NoAA.

Suréchantillonnage

La scène est rendue dans une résolution plus élevée, puis réduite à la résolution réelle.

Avantages: Haute qualité. Anticipe tout le contenu de la scène et pas seulement les silhouettes géométriques.

Inconvénients: généralement plus coûteux que le MSAA. Augmente l'utilisation de la mémoire vidéo. Pris en charge avec les éléments View3D avec tous les modes de rendu sauf Inline, mais comme la technique implique d'effectuer d'abord le rendu vers une texture, l'activation de SSAA avec un mode de rendu Underlay ou Overlay entraînera l'utilisation d'une texture intermédiaire et d'une passe de rendu qui ne serait normalement pas nécessaire, ce qui signifie que les coûts en termes de performances peuvent être plus perceptibles. Il est recommandé d'utiliser SSAA uniquement lorsque le mode de rendu est Offscreen par défaut.

Multi-échantillonnage

Les bords de la géométrie sont super-échantillonnés, ce qui permet d'obtenir des silhouettes plus lisses. Cette technique n'a cependant aucun effet sur les matériaux à l'intérieur de la géométrie.

Avantages: Fonctionne avec n'importe quel élément View3D, quel que soit le mode de rendu. Bons résultats sur les silhouettes géométriques, où l'aliasing est souvent le plus visible ; fonctionne sans problème avec les animations rapides. Les performances dépendent uniquement des capacités du système (GPU).

Inconvénients: n'aide pas à résoudre les problèmes de texture ou de réflexion. Augmente l'utilisation de la mémoire vidéo. Peut être coûteux à utiliser sur du matériel graphique moins puissant. Peut être contrôlé par fenêtre ou pour des éléments individuels sur View3D en fonction du renderMode. Lors de l'utilisation de l'option Underlay/Overlay avec un effet appliqué ou Offscreen, le MSAA peut être contrôlé pour chaque élément de View3D. En revanche, si l'on utilise le mode de rendu Underlay/Overlay sans effet ou Inline, le MSAA sera contrôlé par fenêtre.

Anti-crénelage progressif

Cette propriété permet d'activer et de définir le niveau d'anticrénelage progressif appliqué à la scène.

Lorsque tout le contenu de la scène a cessé de bouger, la caméra est légèrement secouée entre les images et le résultat de chaque nouvelle image est fusionné avec les images précédentes. Plus vous accumulez d'images, plus le résultat est beau.

Avantages: Donne d'excellents résultats lorsque tous les éléments de la scène sont immobiles.

Inconvénients: ne prend pas effet en cas de changement visuel. Coûteux en raison de la nécessité d'accumuler et de mélanger les images. Augmente l'utilisation de la mémoire vidéo.

Voir les meilleures pratiques en matière d' anticrénelage pour plus de détails sur les méthodes d'anticrénelage.

antialiasingQuality : enumeration

Cette propriété définit le niveau d'anticrénelage appliqué à la scène. Le comportement dépend de l'utilisation de antialiasingMode. Si la propriété antialiasingMode est définie sur NoAA, cette propriété n'a pas d'effet.

Les valeurs possibles sont les suivantes

La valeur par défaut est SceneEnvironment.High

aoBias : real

Cette propriété définit une distance limite empêchant les objets de présenter une occlusion ambiante à des distances proches. Des valeurs plus élevées augmentent la distance requise entre les objets avant que l'occlusion ambiante ne soit observée.

La valeur par défaut est 0,0.

aoDistance : real

Cette propriété définit approximativement la distance à laquelle les ombres de l'occlusion ambiante s'éloignent des objets. Plus la distance est grande, plus l'impact sur les performances est important.

La valeur par défaut est 5.0.

Illustration ici avec la valeur par défaut aoSoftness et la valeur maximale aoStrength:

Voir également aoStrength et aoSoftness.

aoDither : bool

Lorsque cette propriété est activée, elle disperse les bords des bandes d'ombre de l'occlusion ambiante afin d'améliorer la fluidité (au risque de produire parfois des artefacts de motifs évidents).

La valeur par défaut est false.

Voir également PerspectiveCamera.clipFar et OrthographicCamera.clipFar.

aoEnabled : bool [since 6.5]

Active ou désactive l'occlusion ambiante.

La valeur par défaut est false, ce qui signifie que l'occlusion ambiante est désactivée.

Cette propriété a été introduite dans Qt 6.5.

Voir également aoStrength et aoDistance.

aoSampleRate : int

Cette propriété définit la qualité de l'occlusion ambiante (plus de nuances de gris) au détriment des performances.

La valeur doit être 2, 3 ou 4. La valeur par défaut est 2.

aoSoftness : real

Cette propriété définit à quel point les bords de l'ombrage de l'occlusion ambiante sont lisses.

La valeur doit être comprise entre 0,0 et 50,0. La valeur par défaut est 50.0.

Illustré ici avec la valeur par défaut aoDistance et la valeur maximale aoStrength:

Voir également aoStrength et aoDistance.

aoStrength : real

Cette propriété définit la quantité d'occultation ambiante appliquée. L'occultation ambiante est une forme d'éclairage global approximatif qui provoque des ombres non directionnelles lorsque les objets sont proches les uns des autres. Une valeur de 100 entraîne une obscurité totale des ombres ; des valeurs inférieures font apparaître les ombres plus claires. Une valeur de 0 désactive entièrement l'occlusion ambiante, ce qui améliore les performances au détriment du réalisme visuel des objets 3D rendus dans la scène.

Toutes les valeurs autres que 0 ont le même impact sur les performances.

La valeur par défaut est 0,0. La valeur maximale est de 100,0.

Une valeur de 0 équivaut à définir aoEnabled sur false.

La photo montre les valeurs par défaut aoSoftness et aoDistance:

Voir également aoEnabled, aoDistance, et aoSoftness.

backgroundMode : enumeration

Cette propriété détermine si et comment l'arrière-plan de la scène doit être effacé.

La valeur par défaut est SceneEnvironment.Transparent

Prenons l'exemple suivant. Le modèle Suzanne est censé être prétraité avec l'outil balsam et provient du dépôt glTF Sample Models.

import QtQuick
import QtQuick3D
import QtQuick3D.Helpers

Item {
    width: 1280
    height: 720

    View3D {
        id: v3d
        anchors.fill: parent

        environment: ExtendedSceneEnvironment {
            backgroundMode: SceneEnvironment.SkyBox
            lightProbe: Texture { source: "00455_OpenfootageNET_field_low.hdr" }

            glowEnabled: true
            glowStrength: 1.25
            glowBloom: 0.25
            glowBlendMode: ExtendedSceneEnvironment.GlowBlendMode.Additive
        }

        DirectionalLight {
        }

        Suzanne {
            scale: Qt.vector3d(50, 50, 50)
            z: -500
        }

        PerspectiveCamera {
            id: camera
        }

        WasdController {
            controlledObject: camera
        }
    }
}

L'utilisation d'un éclairage basé sur l'image en plus de l'outil DirectionalLight et l'utilisation de la texture de la sonde lumineuse comme boîte à ciel donnent les résultats suivants :

Que se passe-t-il s'il n'y a pas de sonde lumineuse ?

backgroundMode: SceneEnvironment.Transparent

Ici, l'arrière-plan n'est pas fourni par le site View3D mais par le site QQuickWindow ou QQuickView qui héberge la scène 2D et 3D. L'éclairage est basé sur le site DirectionalLight uniquement.

Utilisation d'une couleur claire fixe :

backgroundMode: SceneEnvironment.Color
clearColor: "green"

Voir également lightProbe, QQuickWindow::setColor(), Window::color, et View3D.

clearColor : color

Cette propriété définit la couleur qui sera utilisée pour effacer la fenêtre d'affichage lors de l'utilisation de SceneEnvironment.Color pour la propriété backgroundMode.

La valeur par défaut est Qt::black

Voir aussi backgroundMode.

debugSettings : QtQuick3D::DebugSettings [since 6.5]

Cette propriété spécifie un objet DebugSettings utilisé pour configurer les outils de débogage du moteur de rendu. Lors de la construction, SceneEnvironment crée automatiquement un objet DebugSettings qui lui est associé, et il n'est donc généralement pas nécessaire de définir un objet DebugSettings personnalisé.

Exemple de rendu de la scène avec le mode fil de fer activé :

Visualisation des vecteurs normaux des mailles :

Visualisation de la contribution de l'éclairage spéculaire :

Cette propriété a été introduite dans Qt 6.5.

Voir aussi DebugSettings.

depthPrePassEnabled : bool

Lorsque cette option est activée, le moteur de rendu effectue un Z-prepass pour les objets opaques, ce qui signifie qu'il effectue le rendu avec un shader simple et l'écriture des couleurs désactivée afin de pré-remplir le tampon de profondeur avant d'émettre des appels de dessin pour les passes de rendu principales.

Cela peut améliorer les performances en fonction du contenu de la scène. Ce sont typiquement les scènes avec beaucoup d'objets qui se chevauchent et un ombrage de fragments coûteux qui en bénéficient. Dans le même temps, il convient de noter que le moteur de rendu effectue un tri avant-arrière pour les objets opaques, ce qui permet de réduire l'ombrage des fragments inutiles.

Sur les GPU qui utilisent une architecture de rendu en mosaïque, ce qui est courant dans les systèmes mobiles et embarqués, il est recommandé de régler ce paramètre sur false.

La valeur par défaut est false.

depthTestEnabled : bool

La valeur par défaut est true. Par défaut, le moteur de rendu classe les objets de la scène soit comme opaque soit comme semi-transparent. Les objets (sous-mailles avec le matériau associé) de la liste opaque sont rendus en premier, avec le test de profondeur et l'écriture de profondeur activés, ce qui permet un Z-culling optimal pour les objets 3D typiques qui n'ont pas de régions semi-transparentes. Les objets de la liste semi-transparent sont rendus avec l'écriture de profondeur désactivée, bien que le test de profondeur soit toujours activé (pour tester les objets opaques), dans l'ordre inverse (triés en fonction de la distance de leur point central par rapport à la caméra). Cela permet un mélange correct ("voir à travers") pour les objets 3D qui comportent des régions semi-transparentes sur leur surface, soit en raison de node opacity, soit en raison d'une carte de couleur ou de texture dans le matériau.

Lorsque cette propriété vaut false, le tampon Z n'est pas écrit et testé, le test de profondeur est ignoré et tous les objets, y compris ceux qui sont totalement opaques, sont rendus en une seule fois, triés de l'arrière vers l'avant.

La définition de cette propriété à false devrait être rarement nécessaire. Elle peut être utile dans les scènes où l'on sait que l'approche à deux tours présente peu d'avantages, soit parce qu'il y a très peu d'objets opaques, soit parce qu'ils sont transformés d'une manière telle qu'une seule passe triée de l'arrière vers l'avant donne de meilleurs résultats.

effects : List<QtQuick3D::Effect>

Cette propriété contient une liste d'effets de post-traitement qui seront appliqués à l'ensemble de la fenêtre. Le résultat de chaque effet est transmis au suivant, de sorte que l'ordre est important.

fog : QtQuick3D::Fog [since 6.5]

Lorsque cette propriété est définie sur un objet Fog valide, elle est utilisée pour configurer la prise en charge du brouillard intégré au moteur de rendu.

La valeur par défaut est null, ce qui signifie qu'il n'y a pas de brouillard. Cela équivaut à définir un objet Fog avec enabled à false.

Cette propriété a été introduite dans Qt 6.5.

Voir aussi Fog.

lightProbe : QtQuick3D::Texture

Cette propriété définit une image utilisée pour éclairer la scène, soit à la place, soit en plus des lumières standard.

L'image est de préférence une image à gamme dynamique élevée ou une cubemap pré-générée. La pré-génération permet d'améliorer considérablement les performances au moment de l'exécution, car aucun temps n'est consacré au filtrage et à la génération de mipmaps. Si la source est une image .hdr ou autre, le prétraitement basé sur le GPU s'effectue au moment de l'exécution après le chargement du fichier image, ce qui peut prendre beaucoup de temps, en particulier sur le matériel embarqué et mobile. Il est donc fortement recommandé aux applications de prétraiter les images .hdr au plus tard au moment de la compilation, comme décrit ici.

Pour plus d'informations sur l'éclairage basé sur l'image, voir Utilisation de l'éclairage basé sur l'image.

Les exemples ci-dessous ont été générés en faisant varier backgroundMode dans l'environnement de la scène suivante. La scène n'a pas de DirectionLight, PointLight ou SpotLight. Tout l'éclairage est basé sur l'image HDRI panoramique.

import QtQuick
import QtQuick3D
import QtQuick3D.Helpers

Item {
    width: 1280
    height: 720

    View3D {
        id: v3d
        anchors.fill: parent

        environment: ExtendedSceneEnvironment {
            backgroundMode: SceneEnvironment.SkyBox
            lightProbe: Texture { source: "00455_OpenfootageNET_field_low.hdr" }

            tonemapMode: SceneEnvironment.TonemapModeFilmic
            sharpnessAmount: 0.4

            glowEnabled: true
            glowStrength: 1.25
            glowBloom: 0.25
            glowBlendMode: ExtendedSceneEnvironment.GlowBlendMode.Additive
        }

        Node {
            scale: Qt.vector3d(100, 100, 100)

            Sponza {
            }

            Suzanne {
                y: 1
                scale: Qt.vector3d(0.5, 0.5, 0.5)
                eulerRotation.y: -90
            }
        }

        PerspectiveCamera {
            id: camera
            y: 100
        }

        WasdController {
            controlledObject: camera
        }
    }
}

Résultats avec l'environnement ci-dessus :

En remplaçant backgroundMode par SceneEnvironment.Transparent, on obtient :

Ici, l'éclairage de la scène 3D est le même que précédemment, ce qui signifie que les matériaux utilisent la sonde de lumière dans les calculs d'éclairage de la même manière que précédemment, mais il n'y a pas de boîte à ciel rendue. Le fond est blanc puisque c'est la couleur claire par défaut du site QQuickWindow qui héberge les scènes 2D et 3D.

Il est possible de remettre la valeur de la propriété lightProbe à la valeur par défaut null. Cela permet de désassigner la texture précédemment associée. Par exemple, utilisons la touche Suppr pour basculer dynamiquement entre un éclairage basé sur l'image avec une boîte à ciel et un éclairage non basé sur l'image avec une couleur claire fixe pour l'arrière-plan :

environment: ExtendedSceneEnvironment {
    id: env

    backgroundMode: SceneEnvironment.SkyBox
    lightProbe: iblTex

    tonemapMode: SceneEnvironment.TonemapModeFilmic
    sharpnessAmount: 0.4

    glowEnabled: true
    glowStrength: 1.25
    glowBloom: 0.25
    glowBlendMode: ExtendedSceneEnvironment.GlowBlendMode.Additive
}

Texture {
    id: iblTex
    source: "00455_OpenfootageNET_field_low.hdr"
}

focus: true
Keys.onDeletePressed: {
    if (env.backgroundMode == SceneEnvironment.SkyBox) {
        env.backgroundMode = SceneEnvironment.Color;
        env.clearColor = "green";
        env.lightProbe = null;
    } else {
        env.backgroundMode = SceneEnvironment.SkyBox;
        env.lightProbe = iblTex;
    }
}

L'appui sur la touche Suppr donne le résultat suivant. Rappelez-vous que la scène utilisée ici n'a pas d'éclairage, de sorte que tous les modèles 3D apparaissent complètement noirs.

Bien que lightProbe soit généralement utilisé en combinaison avec des instances de textures dont les données proviennent d'un fichier image (typiquement .hdr ou .ktx), il peut également être judicieux de l'associer à une texture qui utilise des données en mémoire ( procedurally generated image data). Un exemple parfait est celui d'une texture dont les données d'image sont générées par ProceduralSkyTextureData à partir du module QtQuick3D.Helpers :

backgroundMode: SceneEnvironment.SkyBox
lightProbe: Texture {
    textureData: ProceduralSkyTextureData {
    }
}

Cela nous donne une texture de boîte à ciel HDR générée de manière procédurale qui est maintenant utilisée à la fois comme boîte à ciel et pour l'éclairage basé sur l'image :

Voir également backgroundMode, Using Image-Based Lighting, Pre-generating IBL cubemap, probeExposure, probeHorizon, probeOrientation, et ProceduralSkyTextureData.

lightmapper : Lightmapper

Lorsque cette propriété est associée à un objet Lightmapper valide, les paramètres spécifiés par l'objet sont pris en compte lors de la création de lightmaps.

La valeur par défaut est null, ce qui signifie que les valeurs par défaut sont utilisées pour tous les paramètres liés à la cuisson.

Pour plus d'informations sur la cuisson des lightmaps, voir la documentation Lightmapper.

Lorsque les lightmaps ne sont pas pertinentes pour une application et que l'éclairage cuit n'est jamais généré, la propriété et l'objet associé ne servent à rien dans la pratique.

Voir également Model::usedInBakedLighting, Model::bakedLightmap, Light::bakeMode, et Lightmapper.

oitMethod : enumeration [since 6.11]

Cette propriété contient la méthode de transparence indépendante de l'ordre. En définissant cette propriété sur une méthode OIT valide, le moteur de rendu rend les pixels transparents dans l'ordre de profondeur correct.

Les valeurs possibles sont les suivantes

La valeur par défaut est None et la transparence indépendante de l'ordre est désactivée.

Pondéré Mélangé

Il s'agit d'une approximation de la transparence indépendante de l'ordre. Les fragments transparents sont rendus dans un tampon hors écran tandis qu'une pondération est appliquée à chaque fragment en fonction de sa distance par rapport à la caméra. Cette mémoire tampon est ensuite mélangée au tampon arrière après dépondération de chaque pixel. Cette méthode ne suit pas la règle de composition source-sur pour tous les fragments et le résultat est différent du résultat correct. Cependant, cette méthode fonctionne également sur du matériel plus ancien et est plus rapide que les autres méthodes plus rigoureuses.

Listechaînée

Il s'agit d'une transparence indépendante de l'ordre exact. Les fragments transparents sont rendus dans une liste chaînée lors de la passe de rendu, puis triés en fonction de leur profondeur et mélangés lors de la passe de composition.

Cette propriété a été introduite dans Qt 6.11.

probeExposure : real

Cette propriété modifie la quantité de lumière émise par la sonde lumineuse. Une partie de la cartographie des tons est la cartographie de l'exposition, et cette propriété ajuste la façon dont les valeurs de lumière dans les sondes lumineuses sont cartographiées.

Par défaut, l'exposition est fixée à 1,0.

Voir également lightProbe, probeHorizon, et probeOrientation.

probeHorizon : real

Cette propriété, lorsqu'elle est définie avec des valeurs croissantes, ajoute de l'obscurité (noir) à la moitié inférieure de l'environnement, forçant l'éclairage à provenir principalement du haut de l'image (et supprimant les réflexions spécifiques de la moitié inférieure). Cette propriété est utile pour tenir compte d'un plan de sol qui aurait pour effet d'obscurcir la réflexion de la sonde lumineuse sur le sol. Cette propriété est nécessaire car les contributions de la sonde lumineuse proviennent directement de l'image sans tenir compte du contenu de la scène.

La plage de valeurs attendues pour la propriété probeHorizon est comprise entre 0,0 et 1,0. Toute valeur en dehors de cette plage sera limitée à la plage attendue.

Par défaut, probeHorizon est fixé à 0,0, ce qui signifie que la totalité de la sonde lumineuse est utilisée sans ajustement.

Voir également lightProbe, probeExposure, et probeOrientation.

probeOrientation : vector3d

Cette propriété définit l'orientation de la sonde lumineuse. L'orientation est définie en termes d'angles d'Euler en degrés sur les axes x, y et z.

Voir également lightProbe, probeHorizon, et probeExposure.

scissorRect : rect [since 6.5]

Cette propriété définit un rectangle de ciseaux en coordonnées de vue, avec le coin supérieur gauche à [0, 0]

Cette propriété a été introduite dans Qt 6.5.

skyBoxCubeMap : QtQuick3D::CubeMapTexture [since 6.4]

Cette propriété définit un cubemap à utiliser comme skybox lorsque le mode d'arrière-plan est SkyBoxCubeMap.

Cette propriété a été introduite dans Qt 6.4.

skyboxBlurAmount : real [since 6.4]

Cette propriété détermine le degré de flou de la boîte à ciel lors de l'utilisation de SceneEnvironment.SkyBox pour la propriété backgroundMode. La valeur par défaut est 0.0, ce qui signifie qu'il n'y a pas de flou.

Les valeurs acceptables sont comprises entre 0.0 et 1.0, toutes les autres valeurs seront limitées à cette plage.

Cette propriété a été introduite dans Qt 6.4.

specularAAEnabled : bool [since 6.4]

Lorsque cette propriété est activée, le crénelage spéculaire est atténué. Le crénelage spéculaire est souvent visible sous la forme de points brillants, éventuellement vacillants lorsque l'on déplace la caméra.

La valeur par défaut est false.

Cette propriété a été introduite dans Qt 6.4.

temporalAAEnabled : bool [default: false]

Lorsque cette propriété est activée, l'anticrénelage temporel est utilisé.

La caméra est légèrement secouée entre les images et le résultat de chaque nouvelle image est fusionné avec l'image précédente.

Avantages: En raison du mouvement de la caméra, il est possible de trouver des détails réels qui auraient été perdus autrement ; l'impact sur les performances est faible.

Inconvénients: les objets se déplaçant rapidement provoquent des images fantômes.

temporalAAMode : enumeration [since 6.11]

Contrôle le mode d'anticrénelage temporel. L'anticrénelage temporel réduit le scintillement et le crénelage en mélangeant les informations sur plusieurs images.

La valeur par défaut est SceneEnvironment.TAADefault.

Cette propriété a été introduite dans Qt 6.11.

temporalAAStrength : real [default: 0.3]

Cette propriété modifie l'importance du mouvement temporel (anticrénelage). Elle n'a d'effet que lorsque la propriété temporalAAEnabled est vraie et que la propriété temporalAAMode est SceneEnvironment.TAADefault.

Voir aussi temporalAAEnabled.

tonemapMode : enumeration [since 6.0]

Cette propriété définit la manière dont les couleurs sont mises en correspondance avant le rendu. Tous les rendus dans Qt Quick 3D sont effectués dans un 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 plage affichable.

La valeur par défaut est SceneEnvironment.TonemapModeLinear

Voir ExtendedSceneEnvironment pour un exemple de ces différents modes.

Cette propriété a été introduite dans Qt 6.0.