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
- void scheduleUpdate()
Ausführliche Beschreibung
Eine Reflexionssonde wird verwendet, um Reflexionen der aktuellen Szene auf die Objekte zu erzeugen. Die Sonde stellt der Laufzeitumgebung Eigenschaften zur Verfügung, die anschließend 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 – Beispiel für Reflexionssonden.
Dokumentation zu den Eigenschaften
boxOffset : vector3d
Der „Box-Offset“ dient dazu, die Box relativ zur Position der Reflexionssonde zu verschieben. Da die Sonde die Umgebung von ihrer Position aus erfasst, kann diese Eigenschaft genutzt 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 die Objekte zu bestimmen, die innerhalb der Box liegen. Wenn „ ReflectionProbe::parallaxCorrection “ aktiviert ist, kann diese Eigenschaft genutzt werden, um die Box so zu positionieren, dass genauere Reflexionen erzielt werden.
Siehe auch „ parallaxCorrection “.
boxSize : vector3d
Anhand der Boxgröße wird bestimmt, welche Objekte ihre Reflexionen von dieser ReflectionProbe erhalten. Objekte, die sich innerhalb der Box befinden, unterliegen dem Einfluss dieser ReflectionProbe. Befindet sich ein Objekt gleichzeitig innerhalb mehrerer Reflexionssonden, wird davon ausgegangen, dass es sich in der nächstgelegenen Reflexionssonde befindet. Bei aktivierter Option „ ReflectionProbe::parallaxCorrection “ wird die Größe zudem zur Berechnung der Entfernung der Reflexionen in der Cube-Map herangezogen.
Siehe auch parallaxCorrection.
clearColor : Color
Die „Clear“-Farbe ist die Farbe, mit der die Cube-Map vor dem Rendern der Szene gelöscht wird.
debugView : bool [since 6.4]
Wenn diese Eigenschaft auf „true“ gesetzt ist, wird ein Drahtgittermodell gerendert, um die Reflexions-Probe-Box darzustellen.
Diese Eigenschaft wurde in Qt 6.4 eingeführt.
parallaxCorrection : bool
Standardmäßig wird davon ausgegangen, dass die von der Reflection Probe bereitgestellten Reflexionen – ähnlich wie bei der Skybox – aus unendlicher Entfernung stammen. Dies funktioniert bei Umgebungsreflexionen einwandfrei, führt jedoch in engen Räumen zu perspektivischen Fehlern in den Reflexionen. Um dies zu beheben, kann die Parallaxenkorrektur aktiviert werden. Die Entfernung der Reflexion wird dann durch die Eigenschaft „ ReflectionProbe::boxSize “ bestimmt.
Siehe auch „ boxSize “.
quality : enumeration
Die Qualität bestimmt die Auflösung der Cube-Map.
Mögliche Werte sind:
| Konstant | Beschreibung |
|---|---|
ReflectionProbe.VeryLow | Rendert eine Reflektionskarte unter Verwendung einer 128x128-Textur. |
ReflectionProbe.Low | Rendert eine Reflektionskarte unter Verwendung einer 256x256-Textur. |
ReflectionProbe.Medium | Rendert eine Reflexionskarte unter Verwendung einer 512x512-Textur. |
ReflectionProbe.High | Rendert eine Reflexionskarte unter Verwendung einer 1024x1024-Textur. |
ReflectionProbe.VeryHigh | Rendert eine Reflexionskarte unter Verwendung einer 2048x2048-Textur. |
Der Standardwert ist ReflectionProbe.Low
refreshMode : enumeration
Der Aktualisierungsmodus legt fest, wie oft die Cube-Map aktualisiert werden soll.
Mögliche Werte sind:
| Konstant | Beschreibung |
|---|---|
ReflectionProbe.FirstFrame | Rendert die Szene im ersten Frame. |
ReflectionProbe.EveryFrame | Rendert die Szene in jedem Frame. |
Der Standardwert lautet ReflectionProbe.EveryFrame
Hinweis: Verwenden Sie „ ReflectionProbe.FirstFrame “, um die Leistung zu verbessern.
texture : CubeMapTexture [since 6.5]
Anstatt die Szene zu rendern, wird diese Cube-Map-Textur verwendet, um Reflexionen in Objekten darzustellen, die von dieser Reflexionssonde beeinflusst werden.
Diese Eigenschaft wurde in Qt 6.5 eingeführt.
Siehe auch CubeMapTexture.
timeSlicing : enumeration
Die Zeitaufteilung legt fest, wie die Darstellung der Cube-Map zeitlich gesteuert wird.
Mögliche Werte sind:
| Konstant | Beschreibung |
|---|---|
ReflectionProbe.None | Alle Flächen der Cube-Map werden innerhalb eines Frames gerendert und vorgefiltert. |
ReflectionProbe.AllFacesAtOnce | Alle Flächen werden innerhalb eines Frames gerendert, die Vorfilterung wird jedoch auf nachfolgende Frames aufgeteilt, wobei jede Mip-Stufe in einem eigenen Frame bearbeitet wird. Reflexionen auf rauen Oberflächen werden somit alle sechs Frames aktualisiert, während Reflexionen auf glatten Oberflächen in jedem Frame aktualisiert werden. |
ReflectionProbe.IndividualFaces | Jede Fläche wird in einem separaten Frame gerendert und vorgefiltert. Somit werden alle Reflexionen alle sechs Frames aktualisiert. |
Der Standardwert lautet ReflectionProbe.None
Hinweis: Verwenden Sie „ ReflectionProbe.AllFacesAtOnce “ oder „ ReflectionProbe.IndividualFaces “, um die Leistung zu steigern.
Methodendokumentation
void scheduleUpdate()
Aktualisiert die Darstellung der Reflection-Probe, wenn die Funktion aufgerufen wird, während „ ReflectionProbe::refreshMode “ auf „ ReflectionProbe.FirstFrame “ gesetzt ist.
© 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.
