En esta página

InstanceList QML Type

Permite especificar manualmente la instanciación en QML. Más...

Import Statement: import QtQuick3D
Inherits:

Instancing

Propiedades

Descripción detallada

El tipo InstanceList permite definir manualmente una tabla de instancias en QML.

El siguiente ejemplo crea una tabla de instancias con dos elementos:

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

También es posible rellenar la propiedad `instances` simplemente añadiendo elementos secundarios a la `InstanceList`. El siguiente ejemplo es equivalente al anterior:

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

Cada « InstanceListEntry » es un objeto que puede tener enlaces de propiedades y animaciones. Esto ofrece una gran flexibilidad, pero también supone una sobrecarga de memoria. Por lo tanto, no se recomienda utilizar InstanceList para tablas generadas de forma procedimental que contengan miles (o millones) de instancias. Además, cualquier cambio en las propiedades de una entrada provocará que se recalcule toda la tabla de instancias y se cargue en la GPU.

Véase también RandomInstancing y QQuick3DInstancing.

Documentación sobre propiedades

instanceCount : int [since 6.3]

Esta propiedad de solo lectura contiene el número de instancias de la lista.

Esta propiedad se introdujo en Qt 6.3.

instances : List<QtQuick3D::InstanceListEntry> [default]

Esta propiedad contiene la lista de definiciones de instancias. Si se modifica esta lista, o cualquiera de sus elementos, se actualizará la tabla de instancias.

© 2026 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.