ReflectionProbe QML Type
Définit une sonde de réflexion dans la scène. Plus d'informations...
| 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 est utilisée pour fournir des réflexions de la scène actuelle aux objets. La sonde fournit des propriétés au moteur d'exécution qui sont ensuite utilisées pour rendre la scène dans une carte cubique. La carte cubique est ensuite utilisée comme information de réflexion pour les objets réfléchissants.
Voir aussi Qt Quick 3D - Exemple de sonde de réflexion.
Documentation sur les propriétés
boxOffset : vector3d
Le décalage de la boîte est utilisé pour déplacer la boîte par rapport à la position de la sonde de réflexion. Étant donné que la sonde capture l'environnement à partir de sa position, cette propriété peut être utilisée pour déplacer la boîte sans affecter la position où la sonde capture l'environnement. Cette propriété, ainsi que ReflectionProbe::boxSize, sera utilisée pour déterminer l'objet qui tombe à l'intérieur de la boîte. Lorsque ReflectionProbe::parallaxCorrection est activé, cette propriété peut être utilisée pour positionner la boîte afin d'obtenir des réflexions plus précises.
Voir aussi parallaxCorrection.
boxSize : vector3d
La taille de la boîte est utilisée pour déterminer quels objets obtiennent leurs réflexions de cette ReflectionProbe. Les objets qui se trouvent à l'intérieur de la boîte sont sous l'influence de cette ReflectionProbe. Si un objet se trouve à l'intérieur de plus d'une sonde de réflexion en même temps, il est considéré comme étant à l'intérieur de la sonde de réflexion la plus proche. Si l'option ReflectionProbe::parallaxCorrection est activée, la taille est également utilisée pour calculer la distance des réflexions dans la carte du cube.
Voir également parallaxCorrection.
clearColor : Color
Clear color est la couleur utilisée pour effacer la carte du cube avant le rendu de la scène.
debugView : bool [since 6.4]
Si cette propriété est définie sur true, une image filaire est rendue 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 réflexions fournies par la sonde de réflexion sont supposées provenir d'une distance infinie, comme dans la boîte à images. Cela fonctionne bien pour les réflexions environnementales, mais pour les espaces restreints, cela provoque des erreurs de perspective dans les réflexions. Pour y remédier, la correction de parallaxe peut être activée. La distance de la réflexion 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 du cube.
Les valeurs possibles sont les suivantes
| Constante | Description |
|---|---|
ReflectionProbe.VeryLow | Rend une carte de réflexion en utilisant une texture de 128x128. |
ReflectionProbe.Low | Rend une carte de réflexion en utilisant une texture de 256x256. |
ReflectionProbe.Medium | Rend une carte de réflexion en utilisant une texture 512x512. |
ReflectionProbe.High | Rend une carte de réflexion en utilisant une texture 1024x1024. |
ReflectionProbe.VeryHigh | Rend une carte de réflexion en utilisant une texture de 2048x2048. |
La valeur par défaut est ReflectionProbe.Low
refreshMode : enumeration
Le mode de rafraîchissement indique au système d'exécution à quelle fréquence la carte du cube doit être mise à jour.
Les valeurs possibles sont les suivantes :
| Constante | Description |
|---|---|
ReflectionProbe.FirstFrame | Rend la scène à la première image. |
ReflectionProbe.EveryFrame | Rend 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 carte cubique est utilisée pour montrer les réflexions dans les objets affectés par cette sonde de réflexion.
Cette propriété a été introduite dans Qt 6.5.
Voir aussi CubeMapTexture.
timeSlicing : enumeration
Le découpage temporel détermine la manière dont le rendu de la carte cubique est temporisé.
Les valeurs possibles sont les suivantes :
| Constante | Description |
|---|---|
ReflectionProbe.None | Toutes les faces de la carte du cube sont rendues et préfiltrées en une seule image. |
ReflectionProbe.AllFacesAtOnce | Toutes les faces sont rendues au cours d'une seule image, mais le préfiltrage est réparti sur des images subséquentes, chaque niveau de mip étant traité sur sa propre image. Les réflexions des surfaces rugueuses sont donc rafraîchies toutes les six images, tandis que les réflexions des surfaces lisses sont rafraîchies toutes les images. |
ReflectionProbe.IndividualFaces | Chaque face est rendue et préfiltrée dans une image séparée. Ainsi, toutes les réflexions sont rafraîchies 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()
Met à jour le rendu de la sonde de réflexion lorsqu'il est appelé alors que ReflectionProbe::refreshMode est défini comme 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.
