QQuick3DInstancing Class

Dokumentation der Eigenschaften

depthSortingEnabled : bool

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

Zugriffsfunktionen:

Notifier-Signal:

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 hat nur dann Auswirkungen, wenn das Modell undurchsichtig ist: Wenn das Modell einen transparenten „ material “ oder einen „ opacity “ von weniger als eins aufweist, wird in jedem Fall der Alpha-Wert aus der Tabelle verwendet.

Zugriffsfunktionen:

Notifier-Signal:

instanceCountOverride : int

Setzen Sie diese Eigenschaft, um die Anzahl der Instanzen zu begrenzen, ohne die Instanztabelle neu zu generieren oder erneut hochzuladen. Dies ermöglicht eine sehr ressourcenschonende Animation der Anzahl der gerenderten Instanzen.

Zugriffsfunktionen:

Benachrichtigungssignal:

[since 6.9] shadowBoundsMaximum : QVector3D

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

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

Diese Aufzählung wurde in Qt 6.9 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch ` shadowBoundsMinimum`.

[since 6.9] shadowBoundsMinimum : QVector3D

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

Standardwert: (1, 1, 1)

Diese Aufzählung wurde in Qt 6.9 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ shadowBoundsMaximum “.

QByteArray MyInstanceTable::getInstanceBuffer(int *instanceCount)
{
    QByteArray instanceData;

    ...

    auto entry = calculateTableEntry({xPos, yPos, zPos}, {xScale, yScale, zScale}, {xRot, yRot, zRot}, color, {});
    instanceData.append(reinterpret_cast<const char *>(&entry), sizeof(entry));