Lightmapper QML Type
Legt die Einstellungen für das Backen von Lichtkarten für eine Szene fest. Mehr...
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.4 |
| Inherits: |
Eigenschaften
- adaptiveBiasEnabled : bool
- bias : real
- bounces : int
- indirectLightEnabled : bool
- indirectLightFactor : real
- indirectLightWorkgroupSize : int
- opacityThreshold : real
- samples : int
Detaillierte Beschreibung
Wird beim Backen von direkter und indirekter Beleuchtung verwendet. Diese Einstellungen sind zu anderen Zeiten nicht relevant, z.B. wenn bereits generierte Lightmaps zum Rendern einer Szene verwendet werden.
Hinweis: Ab Qt 6.4 befindet sich das Backen von Lightmaps in einem frühen Stadium der technischen Vorschau. Änderungen an den Funktionen, der Qualität und der API werden wahrscheinlich in zukünftigen Versionen erfolgen.
Das Lightmapper Objekt arbeitet in Kombination mit:
- Model::bakedLightmap und den zugehörigen BakedLightmap,
- Model::usedInBakedLighting und Model::lightmapBaseResolution,
- Light::bakeMode,
- dem eingebauten Lightmap-Baker der Engine.
Siehe auch Lightmaps und Global Illumination und Qt Quick 3D - Baked Lightmap Example.
Eigenschaft Dokumentation
adaptiveBiasEnabled : bool |
Ermöglicht die Anwendung einer zusätzlichen, dynamischen Verzerrung basierend auf der Oberflächennormale.
Der Standardwert ist true.
bias : real |
Raycasting-Bias, der beim Baking verwendet wird. Passen Sie den Wert an, falls Artefakte auftreten, z. B. um unerwünschte Schattenmuster zu reduzieren. In vielen Fällen ist der Standardwert ausreichend.
Der Standardwert ist 0,005.
bounces : int |
Die maximale Anzahl der indirekten Lichtreflexe pro Probe. Der Wert sollte mindestens 1 sein, da die Berechnung des indirekten Lichts sonst sinnlos ist.
Der Standardwert ist 3.
Der Wert beeinflusst sowohl die Leistung als auch die Qualität der resultierenden Lightmaps während des Lightmap-Backens erheblich.
indirectLightEnabled : bool |
Normalerweise besteht keine Notwendigkeit, diesen Wert zu ändern. Der Standardwert ist true. Wenn Sie diese Eigenschaft auf false setzen, wird die Berechnung des indirekten Lichts während des Lightmap-Backens deaktiviert. Somit enthalten die resultierenden Texturkarten nur direkte Lichtinformationen. Zur Laufzeit verwendet die Engine die Maps normal weiter, in der Annahme, dass sie sowohl direkte als auch indirekte Beleuchtung enthalten.
indirectLightFactor : real |
Multiplikator für die Menge des indirekten Lichts. Während der Wert von 1 (d.h. er hat keinen Einfluss auf die Berechnung der indirekten Lichtmenge) die absolut korrekten Rendering-Ergebnisse liefert, kann ein etwas höherer Wert oft zu besser aussehenden Ergebnissen bei der Verwendung der Lightmap führen, selbst bei einer geringeren Anzahl von Bounces.
Der Standardwert ist 1.
indirectLightWorkgroupSize : int |
Die Größe der Beispiel-Arbeitsgruppen. Es wird versucht, diese Arbeitsgruppen parallel auszuführen. (das genaue Verhalten hängt von der Anzahl der CPU-Kerne und der Konfiguration von QThreadPool ab)
Der Standardwert ist 32. Bei der Standardprobenanzahl von 256 bedeutet dies, dass versucht wird, 8 Gruppen pro Modell parallel auszuführen.
opacityThreshold : real |
Der Schwellenwert für die Deckkraft (Alpha), unterhalb dessen ein Objekt bei der Berechnung der Beleuchtung mittels Raytracing in Strahlen-Netz-Schnittpunkten ignoriert wird. Wenn die Deckkraft unter den Schwellenwert fällt, wird das Modell (Submesh) keine Lichter verdecken und somit auch keine Schatten erzeugen.
Der Standardwert ist 0.5.
Hinweis: Der Lightmapper berücksichtigt die material's opacity und die baseColor alpha kombiniert mit der base color map's alpha. Andere Quellen der Semitransparenz, wie z.B. die Deckkraftkarte oder die Alpha-Cut-Off-Einstellungen, werden während des Lightmap-Backvorgangs ignoriert.
samples : int |
Die Anzahl der Samples pro Lightmap-Texel.
Der Standardwert ist 256.
Der Wert beeinflusst sowohl die Leistung als auch die Qualität der resultierenden Lightmaps während des Lightmap-Backvorgangs erheblich.
© 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.
