QQuick3DRenderExtension Class
사용자 측 렌더링 확장을 구현하기 위한 추상 클래스. 더 보기...
| Header: | #include <QQuick3DRenderExtension> |
| Since: | Qt 6.7 |
| In QML: | RenderExtension |
| Inherits: | QQuick3DObject |
| Inherited By: |
재구현된 공용 함수
| virtual QSSGRenderGraphObject * | updateSpatialNode(QSSGRenderGraphObject *node) override |
상세 설명
이 클래스는 렌더링 확장 기능의 프론트엔드 측을 담당합니다. 백엔드 부분은 ` QSSGRenderExtension`에서 구현됩니다. `QQuick3DRenderExtension` 클래스는 ` View3D`와 함께 사용할 확장 목록에 추가함으로써 ` QtQuick3D ` 씬 그래프에서 사용할 수 있는 사용자 정의 렌더링 확장을 생성하는 데 사용됩니다. 그러면 확장 코드는 ` QtQuick3D`의 렌더링 파이프라인 실행의 일부로 실행됩니다.
QQuick3DRenderExtension 클래스는 추상 클래스로, 이를 상속받아 QML에 노출시켜야 합니다. 하위 클래스는 QQuick3DRenderExtension::updateSpatialNode() 함수를 구현하고, 실행해야 할 코드가 포함된 QSSGRenderExtension 인스턴스를 반환해야 합니다.
QSSGRenderExtension도 참조하십시오 .
멤버 함수 설명서
[override virtual] QSSGRenderGraphObject *QQuick3DRenderExtension::updateSpatialNode(QSSGRenderGraphObject *node)
이 함수는 QtQuick3D 장면 그래프의 동기화 과정에서, 항목이 생성되거나(일반적으로 항목 속성의 변경으로 인해) 업데이트가 요청될 때 호출됩니다. 이 함수는 QtQuick3D 의 렌더링 파이프라인 실행 중에 실행되어야 할 코드가 포함된 QSSGRenderExtension 인스턴스를 반환해야 합니다.
node 매개변수는 이 함수에서 이전에 반환된 QSSGRenderExtension 인스턴스이거나, 함수가 처음 호출된 경우 null입니다. 이 함수는 동일한 인스턴스, 다른 인스턴스 또는 null을 반환할 수 있습니다. 함수가 null을 반환하면 해당 확장 기능은 렌더링 파이프라인에서 제거됩니다.
참고: ` QSSGRenderExtension `인스턴스는 리소스 객체이며, ` QtQuick3D ` 씬 그래프가 이를 소유하게 됩니다. 다른 인스턴스나 null이 반환되면, 이전 인스턴스는 렌더러에 의해 삭제 대기열에 추가됩니다.
QSSGRenderExtension도 참조하십시오 .
© 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.
