QQuick3DTextureProviderExtension Class
사용자 측 텍스처 공급자 확장을 구현하기 위한 추상 클래스입니다. 더 보기...
| Header: | #include <QQuick3DTextureProviderExtension> |
| Since: | Qt 6.11 |
| In QML: | TextureProviderExtension |
| Inherits: | QQuick3DRenderExtension |
속성
(since 6.11)samplerHint : SamplerHint
공공 기능
| QQuick3DTextureProviderExtension::SamplerHint | samplerHint() const |
| void | setSamplerHint(QQuick3DTextureProviderExtension::SamplerHint newSamplerHint) |
신호
| void | samplerHintChanged() |
재구현된 보호 기능
| virtual QSSGRenderGraphObject * | updateSpatialNode(QSSGRenderGraphObject *node) override |
상세 설명
텍스처 제공자 확장의 프론트엔드 측면입니다. 백엔드 쪽은 QSSGRenderExtension 에서 구현됩니다. QQuick3DTextureProviderExtension은 제공되는 텍스처 유형에 대한 추가 메타데이터를 제공하고 QtQuick3D 씬 그래프에 확장을 자동으로 등록할 수 있는 사용자 정의 텍스처 제공자 확장을 만드는 데 사용되는 QQuick3DRenderExtension 클래스의 특수화입니다. 즉, View3D 와 함께 사용할 확장자 목록에 확장자를 수동으로 추가할 필요가 없으며, 필요할 때 확장자 코드가 실행되도록 Texture 컴포넌트의 textureProvider 속성을 사용하는 것만으로 충분합니다.
QQuick3DTextureProviderExtension 클래스는 추상 클래스로 서브클래싱하여 QML에 노출해야 합니다. 서브클래스는 QQuick3DRenderExtension::updateSpatialNode() 함수를 구현하고 실행해야 하는 코드가 포함된 QSSGRenderExtension 인스턴스를 반환해야 합니다.
QSSGRenderExtension 를참조하세요 .
속성 문서
[since 6.11] samplerHint : SamplerHint
이 프로퍼티에는 확장 기능에서 제공할 텍스처 유형에 대한 힌트가 포함되어 있습니다. 텍스처 데이터는 필요할 때까지 제공되지 않지만 텍스처 컴포넌트를 사용하는 머티리얼은 어떤 유형의 샘플러를 제공할지 알아야 하므로 이 속성이 필요합니다.
기본값은 QQuick3DTextureProviderExtension::Sampler2D 입니다.
참고: 이 프로퍼티는 커스텀 머티리얼을 사용할 때만 사용됩니다.
이 프로퍼티는 Qt 6.11에 도입되었습니다.
함수 액세스:
| QQuick3DTextureProviderExtension::SamplerHint | samplerHint() const |
| void | setSamplerHint(QQuick3DTextureProviderExtension::SamplerHint newSamplerHint) |
알림 신호:
| void | samplerHintChanged() |
샘플러힌트도 참조하십시오 .
멤버 함수 문서
[override virtual protected] QSSGRenderGraphObject *QQuick3DTextureProviderExtension::updateSpatialNode(QSSGRenderGraphObject *node)
다시 구현합니다: QQuick3DRenderExtension::updateSpatialNode(QSSGRenderGraphObject *노드).
이 함수는 일반적으로 아이템이 생성되거나 아이템의 속성 변경으로 인해 업데이트가 요청될 때 QtQuick3D 씬 그래프를 동기화하는 동안 호출됩니다. 이 함수는 QtQuick3D 의 렌더링 파이프라인 실행 중에 실행해야 하는 코드가 포함된 QSSGRenderTextureProviderExtension 인스턴스를 반환해야 합니다.
node 매개 변수는 이 함수에서 반환된 이전 QSSGRenderTextureProviderExtension 인스턴스이거나 함수가 처음 호출되는 경우 null입니다. 함수는 동일한 인스턴스, 다른 인스턴스 또는 null을 반환할 수 있습니다. 함수가 null을 반환하면 해당 확장은 렌더링 파이프라인에서 제거됩니다.
참고: QSSGRenderTextureProviderExtension 인스턴스는 리소스 객체이며 QtQuick3D 씬 그래프가 소유하게 됩니다. 다른 인스턴스 또는 null이 반환되면 이전 인스턴스는 렌더러가 삭제하기 위해 대기열에 대기합니다.
QSSGRenderTextureProviderExtension 를참조하세요 .
© 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.
