이 페이지에서

InstanceRepeater QML Type

인스턴스 테이블을 기반으로 컴포넌트를 인스턴스화합니다. 더 보기...

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

Repeater3D

속성

상세 설명

InstanceRepeater 유형은 인스턴싱 테이블( Instancing )을 기반으로 여러 개체의 인스턴스를 생성하는 데 사용됩니다. 이는 인스턴싱 테이블을 데이터 모델 대신 받아들이며, position, scale, rotation 을 자동으로 적용하는 Repeater3D 의 하위 유형입니다.

한 가지 사용 사례는 렌더링된 인스턴스와 일치하는 보이지 않는 더미 오브젝트를 생성하여 picking 을 구현하는 것입니다. 성능을 향상시키기 위해, 더미 오브젝트는 인스턴스화된 모델보다 더 단순한 지오메트리로 생성될 수 있습니다.

예를 들어:

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

InstanceModel도 참조하십시오 .

속성 문서

instancingTable : Instancing

이 속성은 리피터가 사용하는 인스턴스 테이블을 지정합니다.

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