BakedLightmap QML Type
Gibt die gebackenen Lightmap-Einstellungen für ein Modell an. Mehr...
Import Statement: | import QtQuick3D |
Since: | Qt 6.4 |
Inherits: |
Eigenschaften
- enabled : bool
- key : string
- loadPrefix : string
Detaillierte Beschreibung
Ein BakedLightmap-Objekt kann verwendet werden, um:
- die persistente Speicherung der gebackenen Lightmap-Daten - während des Backens, oder
- das Laden der zuvor generierten und gespeicherten Lightmaps - zur Laufzeit.
Ein Modell mit der Einstellung usedInBakedLighting auf true wird beim Baking von Lightmaps als Teil der Raytraced-Szene betrachtet, was bedeutet, dass die Geometrie und das Material des Modells zur direkten und indirekten Beleuchtung beitragen. Dies allein ermöglicht jedoch nicht die Erzeugung, einschließlich der vollständigen Berechnung der indirekten Beleuchtung und schließlich das Speichern einer Lightmap für das Modell. Dazu muss das Modell auch mit einem enabled BakedLightmap-Objekt mit einem eindeutigen Schlüsselsatz verknüpft werden.
Im normalen Modus zeigt das gleiche BakedLightmap-Objekt an, dass das Modell über Lightmap-Daten verfügt und dass die Engine versuchen sollte, diese Daten (basierend auf dem eindeutigen Schlüssel) zu laden und beim Rendern zu verwenden.
Weitere Informationen zum Bake von Lightmaps finden Sie in der Lightmapper Dokumentation.
Hinweis: Ab Qt 6.4 befindet sich das Baking von Lightmaps in einer frühen technischen Vorschau. Änderungen an den Funktionen, der Qualität und der API werden wahrscheinlich in zukünftigen Versionen erfolgen.
Siehe auch Lightmapper und Model::usedInBakedLighting.
Dokumentation der Eigenschaft
enabled : bool |
Wenn false, wird die für das Modell erzeugte Lightmap während des Lightmap-Backens nicht gespeichert, auch wenn key auf einen nicht leeren Wert gesetzt ist.
Der Standardwert ist true.
key : string |
Wenn der Wert nicht leer und enabled wahr ist, wird die für das Modell erzeugte Lightmap während des Lightmap-Backvorgangs dauerhaft gespeichert. Der Wert sollte ein eindeutiger String sein, der in den Namen einer Datei im Dateisystem aufgenommen werden kann. Kein anderes Modell in der Szene darf denselben Schlüssel verwenden.
Der Standardwert ist leer.
Siehe auch loadPrefix.
loadPrefix : string |
Wenn er nicht leer ist, wird der Wert als Pfad dem Wert von key vorangestellt, wenn die Lightmap für das Model geladen wird. Dies ermöglicht die Auslieferung der generierten Lightmaps an einem anderen Ort als dem, an den sie geschrieben wurden, zum Beispiel als eingebettete Ressourcen über das Qt-Ressourcensystem.
Das folgende Beispiel ermöglicht die Erzeugung von Lightmaps für ein statisches Modell unter Verwendung eines eindeutigen Schlüssels zur Identifizierung der Lightmap-Daten zwischen dem Backen und den realen Läufen der Anwendung. Nach dem Backen kann die generierte Datei im CMake-Projekt der Anwendung als Ressource unter /lightmaps
PREFIX aufgelistet werden, so dass der Build-Prozess die Datei aufnehmen und in die ausführbare Datei einfügen kann.
Model { source: "model.mesh" y: 10 bakedLightmap: BakedLightmap { key: "model34156" loadPrefix: "qrc:/lightmaps" // will attempt to load from :/lightmaps/qlm_model34156.exr at run time } }
Der Standardwert ist leer.
Siehe auch key.
© 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.