ReflectionProbe QML Type
Définit une sonde de réflexion dans la scène. En savoir plus…
| Import Statement: | import QtQuick3D |
| Inherits: |
Propriétés
- boxOffset : vector3d
- boxSize : vector3d
- clearColor : Color
- debugView : bool
(since 6.4) - parallaxCorrection : bool
- quality : enumeration
- refreshMode : enumeration
- texture : CubeMapTexture
(since 6.5) - timeSlicing : enumeration
Méthodes
- void scheduleUpdate()
Description détaillée
Une sonde de réflexion sert à fournir aux objets les reflets de la scène actuelle. La sonde transmet des propriétés au moteur d'exécution, qui sont ensuite utilisées pour rendre la scène sous forme de cube map. La cube map est ensuite utilisée comme information de réflexion pour les objets réfléchissants.
Voir également l’exemple «Qt Quick 3D - Reflection Probes ».
Documentation des propriétés
boxOffset : vector3d
Le décalage de la boîte permet de déplacer celle-ci par rapport à la position de la sonde de réflexion. Comme la sonde capture l’environnement depuis sa position, cette propriété permet de déplacer la boîte sans modifier l’emplacement à partir duquel la sonde capture l’environnement. Associée à la propriété « ReflectionProbe::boxSize », elle sert à déterminer les objets qui se trouvent à l’intérieur de la boîte. Lorsque l'option « ReflectionProbe::parallaxCorrection » est activée, cette propriété permet de positionner la boîte de manière à obtenir des reflets plus précis.
Voir également « parallaxCorrection ».
boxSize : vector3d
La taille du rectangle sert à déterminer quels objets reçoivent leurs reflets à partir de cette adresse : ReflectionProbe. Les objets situés à l'intérieur du rectangle sont influencés par cette adresse : ReflectionProbe. Si un objet se trouve simultanément à l'intérieur de plusieurs sondes de réflexion, il est considéré comme se trouvant à l'intérieur de la sonde de réflexion la plus proche. Lorsque l'option « ReflectionProbe::parallaxCorrection » est activée, la taille est également utilisée pour calculer la distance des reflets dans la carte cubique.
Voir également parallaxCorrection.
clearColor : Color
La couleur « Clear » est la couleur utilisée pour effacer la carte cubique avant le rendu de la scène.
debugView : bool [since 6.4]
Si cette propriété est définie sur « true », un filaire est affiché pour visualiser la boîte de sonde de réflexion.
Cette propriété a été introduite dans Qt 6.4.
parallaxCorrection : bool
Par défaut, les reflets fournis par la sonde de réflexion sont supposés provenir d’une distance infinie, à l’instar du skybox. Cela fonctionne bien pour les reflets environnementaux, mais dans les espaces restreints, cela entraîne des erreurs de perspective dans les reflets. Pour y remédier, il est possible d’activer la correction de parallaxe. La distance du reflet est alors déterminée par la propriété « ReflectionProbe::boxSize ».
Voir également boxSize.
quality : enumeration
La qualité détermine la résolution de la carte cubique.
Les valeurs possibles sont :
| Constante | Description |
|---|---|
ReflectionProbe.VeryLow | Affiche une carte de réflexion à l'aide d'une texture de 128x128. |
ReflectionProbe.Low | Affiche une carte de réflexion à l'aide d'une texture de 256x256. |
ReflectionProbe.Medium | Affiche une carte de réflexion à l'aide d'une texture de 512x512. |
ReflectionProbe.High | Affiche une carte de réflexion à l'aide d'une texture de 1024x1024. |
ReflectionProbe.VeryHigh | Affiche une carte de réflexion à l'aide d'une texture de 2048x2048. |
La valeur par défaut est ReflectionProbe.Low
refreshMode : enumeration
Le mode de rafraîchissement indique au moteur d'exécution à quelle fréquence la carte cubique doit être mise à jour.
Les valeurs possibles sont :
| Constante | Description |
|---|---|
ReflectionProbe.FirstFrame | Affiche la scène dès la première image. |
ReflectionProbe.EveryFrame | Rendu de la scène à chaque image. |
La valeur par défaut est ReflectionProbe.EveryFrame
Remarque : utilisez « ReflectionProbe.FirstFrame » pour améliorer les performances.
texture : CubeMapTexture [since 6.5]
Au lieu de rendre la scène, cette texture de cube map sert à afficher les reflets sur les objets concernés par cette sonde de réflexion.
Cette propriété a été introduite dans Qt 6.5.
Voir également CubeMapTexture.
timeSlicing : enumeration
Le « time slicing » détermine la synchronisation du rendu de la carte cubique.
Les valeurs possibles sont les suivantes :
| Constante | Description |
|---|---|
ReflectionProbe.None | Toutes les faces de la carte cubique sont rendues et préfiltrées au cours d’une seule image. |
ReflectionProbe.AllFacesAtOnce | Toutes les faces sont rendues au cours d’une même image, mais le préfiltrage est réparti sur les images suivantes, chaque niveau de mip étant traité sur sa propre image. Les reflets des surfaces rugueuses sont ainsi actualisés toutes les six images, tandis que ceux des surfaces lisses le sont à chaque image. |
ReflectionProbe.IndividualFaces | Chaque face est rendue et préfiltrée dans une image distincte. Ainsi, tous les reflets sont actualisés toutes les six images. |
La valeur par défaut est ReflectionProbe.None
Remarque : utilisez ReflectionProbe.AllFacesAtOnce ou ReflectionProbe.IndividualFaces pour améliorer les performances.
Documentation de la méthode
void scheduleUpdate()
Mise à jour du rendu de la sonde de réflexion lorsqu’elle est appelée alors que la propriété « ReflectionProbe::refreshMode » est définie sur « ReflectionProbe.FirstFrame ».
© 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.
