InstanceList QML Type

Ermöglicht die manuelle Angabe der Instanzierung in QML. Mehr...

• Liste aller Mitglieder, einschließlich vererbter Mitglieder

Eigenschaften

• instanceCount : int (since 6.3)
• instances : List<QtQuick3D::InstanceListEntry>

Detaillierte Beschreibung

Der Typ InstanceList ermöglicht es, eine Instanztabelle manuell in QML zu definieren.

Das folgende Beispiel erstellt eine Instanztabelle mit zwei Elementen:

InstanceList {
    id: manualInstancing
    instances: [
        InstanceListEntry {
            position: Qt.vector3d(0, 0, -60)
            eulerRotation: Qt.vector3d(-10, 0, 30)
            color: "red"
        },
        InstanceListEntry {
            position: Qt.vector3d(50, 10, 100)
            eulerRotation: Qt.vector3d(0, 180, 0)
            color: "green"
        }
    ]
}

Es ist auch möglich, die Instanzen-Eigenschaft zu füllen, indem man einfach Kinder zur InstanceList hinzufügt. Das folgende Beispiel ist äquivalent zum vorherigen:

InstanceList {
    id: manualInstancing
    InstanceListEntry {
        position: Qt.vector3d(0, 0, -60)
        eulerRotation: Qt.vector3d(-10, 0, 30)
        color: "red"
    }
    InstanceListEntry {
        position: Qt.vector3d(50, 10, 100)
        eulerRotation: Qt.vector3d(0, 180, 0)
        color: "green"
    }
}

Jedes InstanceListEntry ist ein Objekt, das Eigenschaftsbindungen und Animationen haben kann. Dies bietet eine große Flexibilität, verursacht aber auch einen Speicher-Overhead. Daher ist es nicht empfehlenswert, InstanceList für prozedural generierte Tabellen mit Tausenden (oder Millionen) von Instanzen zu verwenden. Außerdem führt jede Eigenschaftsänderung an einem Eintrag dazu, dass die gesamte Instanztabelle neu berechnet und auf die GPU hochgeladen wird.

Siehe auch RandomInstancing und QQuick3DInstancing.

Eigenschaft Dokumentation