InstanceRepeater QML Type

Instantiates components based on an instance table. More...

Import Statement: import QtQuick3D.Helpers
Since: Qt 6.4
Inherits:

Repeater3D

Properties

Detailed Description

The InstanceRepeater type is used to create a number of objects based on an Instancing table. The primary use case is to implement picking.

Instances do not exist as individual objects in the scene graph, so they cannot be discovered by picking, and they are not individual objects, so there is nothing that can be returned from a picking API. The solution is to create invisible dummy objects that match the rendered instances.

InstanceRepeater is a Repeater3D subtype that takes an Instancing table instead of a data model, and automatically applies position, scale, and rotation.

For example:

 InstanceRepeater {
     instancingTable: myInstanceTable
     Model {
         source: "#Cube"
         pickable: true
         property int instanceIndex: index // expose the index, so we can identify the instance
         opacity: 0
     }
 }

See also InstanceModel.

Property Documentation

instancingTable : Instancing

This property specifies the instance table used by the repeater.