ReflectionProbe QML Type
Definiert eine Reflexionssonde in der Szene. Mehr...
| Import Statement: | import QtQuick3D |
| Inherits: |
Eigenschaften
- boxOffset : vector3d
- boxSize : vector3d
- clearColor : Color
- debugView : bool
(since 6.4) - parallaxCorrection : bool
- quality : enumeration
- refreshMode : enumeration
- texture : CubeMapTexture
(since 6.5) - timeSlicing : enumeration
Methoden
Ausführliche Beschreibung
Eine Reflexionssonde wird verwendet, um den Objekten Reflexionen der aktuellen Szene zu liefern. Die Probe stellt der Laufzeitumgebung Eigenschaften zur Verfügung, die dann zum Rendern der Szene in eine Cube-Map verwendet werden. Die Cube Map wird dann als Reflexionsinformation für die reflektierenden Objekte verwendet.
Siehe auch Qt Quick 3D - Reflection Probes Beispiel.
Dokumentation der Eigenschaften
boxOffset : vector3d |
Der Box-Offset wird verwendet, um die Box relativ zur Position der Reflexionssonde zu verschieben. Da die Sonde die Umgebung von ihrer Position aus erfasst, kann diese Eigenschaft verwendet werden, um die Box zu verschieben, ohne die Position zu beeinflussen, an der die Sonde die Umgebung erfasst. Diese Eigenschaft wird zusammen mit ReflectionProbe::boxSize verwendet, um das Objekt zu bestimmen, das sich innerhalb des Kastens befindet. Wenn ReflectionProbe::parallaxCorrection aktiviert ist, kann diese Eigenschaft verwendet werden, um den Kasten zu positionieren, um genauere Reflexionen zu erhalten.
Siehe auch parallaxCorrection.
boxSize : vector3d |
Die Größe des Kastens wird verwendet, um zu bestimmen, welche Objekte ihre Reflexionen von diesem ReflectionProbe erhalten. Objekte, die sich innerhalb des Kastens befinden, werden von diesem ReflectionProbe beeinflusst. Befindet sich ein Objekt gleichzeitig in mehr als einer Reflexionssonde, wird davon ausgegangen, dass sich das Objekt in der nächstgelegenen Reflexionssonde befindet. Wenn ReflectionProbe::parallaxCorrection eingeschaltet ist, wird die Größe auch zur Berechnung des Abstands der Reflexionen in der Würfelkarte verwendet.
Siehe auch parallaxCorrection.
clearColor : Color |
Clear color ist die Farbe, die verwendet wird, um die Cube-Map vor dem Rendern der Szene zu löschen.
debugView : bool |
Wenn diese Eigenschaft auf true gesetzt ist, wird ein Drahtgitter gerendert, um die Reflexions-Sondenbox zu visualisieren.
Diese Eigenschaft wurde in Qt 6.4 eingeführt.
parallaxCorrection : bool |
Standardmäßig wird angenommen, dass die von der Reflexionssonde gelieferten Reflexionen aus einer unendlichen Entfernung stammen, ähnlich wie bei der Skybox. Dies funktioniert gut für Umgebungsreflexionen, aber bei engen Räumen führt dies zu perspektivischen Fehlern in den Reflexionen. Um dies zu beheben, kann die Parallaxenkorrektur eingeschaltet werden. Die Entfernung der Reflexion wird dann durch die Eigenschaft ReflectionProbe::boxSize bestimmt.
Siehe auch boxSize.
quality : enumeration |
Qualität bestimmt die Auflösung der Würfelkarte.
Mögliche Werte sind:
| Konstant | Beschreibung |
|---|---|
ReflectionProbe.VeryLow | Rendert eine Reflection Map unter Verwendung einer 128x128 Textur. |
ReflectionProbe.Low | Rendert eine Reflection Map unter Verwendung einer 256x256 Textur. |
ReflectionProbe.Medium | Rendert eine Reflection Map unter Verwendung einer 512x512-Textur. |
ReflectionProbe.High | Rendert eine Reflection Map unter Verwendung einer 1024x1024-Textur. |
ReflectionProbe.VeryHigh | Rendert eine Reflection Map unter Verwendung einer 2048x2048-Textur. |
Der Standardwert ist ReflectionProbe.Low
refreshMode : enumeration |
Refresh mode gibt der Laufzeit an, wie oft die Cube-Map aktualisiert werden soll.
Mögliche Werte sind:
| Konstant | Beschreibung |
|---|---|
ReflectionProbe.FirstFrame | Rendert die Szene beim ersten Frame. |
ReflectionProbe.EveryFrame | Rendert die Szene bei jedem Frame. |
Der Standardwert ist ReflectionProbe.EveryFrame
Hinweis: Verwenden Sie ReflectionProbe.FirstFrame, um die Leistung zu verbessern.
texture : CubeMapTexture |
Anstatt die Szene zu rendern, wird diese Cube-Map-Textur verwendet, um Reflexionen in Objekten anzuzeigen, die von dieser Reflexionssonde betroffen sind.
Diese Eigenschaft wurde in Qt 6.5 eingeführt.
Siehe auch CubeMapTexture.
timeSlicing : enumeration |
Time slicing bestimmt, wie das Rendering der Cube-Map zeitlich gesteuert wird.
Mögliche Werte sind:
| Konstant | Beschreibung |
|---|---|
ReflectionProbe.None | Alle Flächen der Cube-Map werden in einem Frame gerendert und vorgefiltert. |
ReflectionProbe.AllFacesAtOnce | Alle Flächen werden in einem Frame gerendert, aber die Vorfilterung wird auf Teilframes aufgeteilt, wobei jede Mip-Ebene in einem eigenen Frame behandelt wird. Die Reflexionen auf rauen Oberflächen werden also jedes sechste Bild aufgefrischt, während die Reflexionen auf glatten Oberflächen jedes Bild aufgefrischt werden. |
ReflectionProbe.IndividualFaces | Jede Fläche wird in einem separaten Frame gerendert und vorgefiltert. Somit werden alle Reflexionen jedes sechste Bild aufgefrischt. |
Der Standardwert ist ReflectionProbe.None
Hinweis: Verwenden Sie ReflectionProbe.AllFacesAtOnce oder ReflectionProbe.IndividualFaces, um die Leistung zu erhöhen.
Dokumentation der Methode
scheduleUpdate() |
Aktualisiert das Rendering der Reflexionssonde, wenn ReflectionProbe::refreshMode aufgerufen wird, während ReflectionProbe.FirstFrame eingestellt ist.
© 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.
