Instancing QML Type

Basistyp für Instanztabellen. Mehr...

Import Statement:	`import QtQuick3D`
Since:	Qt 6.2
In C++:	QQuick3DInstancing
Inherits:	Object3D
Inherited By:	FileInstancing, InstanceList, and RandomInstancing

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

depthSortingEnabled : bool
hasTransparency : bool
instanceCountOverride : int
shadowBoundsMaximum : vector3d
shadowBoundsMinimum : vector3d

Methoden

color instanceColor(int index) (since 6.3)
vector3d instanceCustomData(int index) (since 6.3)
vector3d instancePosition(int index) (since 6.3)
quaternion instanceRotation(int index) (since 6.3)
vector3d instanceScale(int index) (since 6.3)

Detaillierte Beschreibung

Instanziertes Rendering ermöglicht das Duplizieren eines Modells mit Variationen.

Der Typ Instanzierung definiert eine Tabelle, die angibt, wie jede Instanz im Vergleich zum Basismodell geändert wird. Die Tabelle hat einen Eintrag für jeden Index, der eine Transformationsmatrix, eine Farbe und generische Daten für die Verwendung durch benutzerdefinierte Materialien enthält. Um Instancing zu verwenden, setzen Sie die Eigenschaft instancing eines Modells, um auf ein Instancing-Objekt zu verweisen.

Eine Anwendung kann ein Instancing-Objekt in C++ definieren, indem sie QQuick3DInstancing subclassing, oder sie kann einen der vordefinierten QML-Typen verwenden: InstanceList FileInstancing RandomInstancing Darüber hinaus ist es möglich, eine particle system zu verwenden, um eine Instanzierungstabelle zu definieren, indem die Eigenschaft ModelParticle3D.instanceTable verwendet wird.

Dokumentation der Eigenschaft

depthSortingEnabled : bool

Enthält den Wert für die aktivierte Tiefensortierung für die Instanztabelle. Wenn aktiviert, werden die Instanzen sortiert und von der am weitesten von der Kamera entfernten Instanz zur nächstgelegenen gerendert, d. h. von hinten nach vorne. Wenn der Wert deaktiviert ist, was die Standardeinstellung ist, werden die Instanzen in der Reihenfolge gerendert, in der sie in der Instanztabelle angegeben sind.

Hinweis: Die Instanzen werden nur gegeneinander sortiert. Die Instanzen werden nicht gegen andere Objekte in der Szene sortiert.

Hinweis: Die Sortierung erhöht die Frame-Vorbereitungszeit, insbesondere bei einer großen Anzahl von Instanzen.

hasTransparency : bool

Setzen Sie diese Eigenschaft auf true, wenn die Instanzierungstabelle Alpha-Werte enthält, die beim Rendern des Modells verwendet werden sollen. Diese Eigenschaft macht nur einen Unterschied, wenn das Modell undurchsichtig ist: Wenn das Modell eine transparente material oder eine opacity kleiner als eins hat, wird der Alphawert aus der Tabelle trotzdem verwendet.

Hinweis: Das Aktivieren von Alpha-Blending kann zu Rendering-Problemen führen, wenn sich Instanzen überlappen. Siehe die Dokumentation zu Alpha-Blending und Instanzierung für weitere Details.

instanceCountOverride : int

Setzen Sie diese Eigenschaft, um die Anzahl der Instanzen zu begrenzen, ohne die Instanztabelle neu zu generieren oder neu zu laden. Dies ermöglicht eine sehr kostengünstige Animation der Anzahl der gerenderten Instanzen.

shadowBoundsMaximum : vector3d

Legt die maximalen Grenzen fest, die bei der Berechnung der Schattenkartengrenzen der Modelle in der Instanztabelle verwendet werden.

Standardwert: (-1, -1, -1)

Hinweis: Diese Eigenschaft ist nur aktiviert, wenn die jeweiligen Komponenten von Instancing::shadowBoundsMinimum kleiner sind als die in Instancing::shadowBoundsMaximum. Andernfalls werden die Begrenzungen automatisch berechnet.

Siehe auch shadowBoundsMinimum.

shadowBoundsMinimum : vector3d

Legt die Mindestgrenzen fest, die bei der Berechnung der Schattenkartengrenzen der Modelle in der Instanztabelle verwendet werden.

Standardwert: (1, 1, 1)

Hinweis: Diese Eigenschaft ist nur aktiviert, wenn die jeweiligen Komponenten von Instancing::shadowBoundsMinimum kleiner sind als die von Instancing::shadowBoundsMaximum. Andernfalls werden die Begrenzungen automatisch berechnet.

Siehe auch shadowBoundsMaximum.