Тип QML InstanceList

Позволяет вручную задавать экземпляры в QML. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• instances : List<QtQuick3D::InstanceListEntry>

Подробное описание

Тип InstanceList позволяет определять таблицу экземпляров вручную в QML.

Следующий пример создает таблицу экземпляров с двумя элементами:

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"
        }
    ]
}

Каждый InstanceListEntry — это объект, который может иметь привязки свойств и анимации. Это обеспечивает большую гибкость, но также приводит к увеличению потребления памяти. Поэтому не рекомендуется использовать InstanceList для таблиц, сгенерированных процедурно, содержащих тысячи (или миллионы) экземпляров. Кроме того, любое изменение свойства элемента приведет к перерасчёту и загрузке всей таблицы экземпляров в графический процессор.

См. также RandomInstancing и QQuick3DInstancing.

Документация свойств

instances : Список<QtQuick3D::InstanceListEntry>

Это свойство содержит список определений экземпляров. Изменение этого списка или любого из его элементов приведет к обновлению таблицы экземпляров.