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 は、QQuick3DRenderExtension クラスの特殊化で、どのようなタイプのテクスチャが提供されるかについての追加メタデータを提供し、また、QtQuick3D シーングラフに拡張機能を自動的に登録することができる、カスタムテクスチャプロバイダ拡張機能を作成するために使用されます。つまり、View3D で使用する拡張機能のリストに手動で拡張機能を追加する必要はなく、Texture コンポーネントの textureProvider プロパティを使用するだけで、必要なときに拡張機能を実行するコードをトリガーできます。
QQuick3DTextureProviderExtension クラスは抽象クラスであり、サブクラス化して QML に公開する必要があります。サブクラスはQQuick3DRenderExtension::updateSpatialNode() 関数を実装し、実行されるべきコードを含むQSSGRenderExtension インスタンスを返す必要があります。
QSSGRenderExtensionも参照してください 。
プロパティドキュメント
[since 6.11] samplerHint : SamplerHint
このプロパティには、拡張機能によって提供されるテクスチャのタイプに関するヒントが含まれます。テクスチャデータは必要になるまで提供されないので、これは必要ですが、Textureコンポーネントを使用するマテリアルは、提供するサンプラのタイプを知る必要があります。
デフォルト値はQQuick3DTextureProviderExtension::Sampler2D です。
注意: このプロパティは、CustomMaterials を使用する場合にのみ使用されます。
このプロパティは Qt 6.11 で導入されました。
アクセス関数
| QQuick3DTextureProviderExtension::SamplerHint | samplerHint() const |
| void | setSamplerHint(QQuick3DTextureProviderExtension::SamplerHint newSamplerHint) |
Notifierシグナル：
| void | samplerHintChanged() |
SamplerHintも参照してください 。
メンバ関数のドキュメント
[override virtual protected] QSSGRenderGraphObject *QQuick3DTextureProviderExtension::updateSpatialNode(QSSGRenderGraphObject *node)
再実装：QQuick3DRenderExtension::updateSpatialNode(QSSGRenderGraphObject *node)。
この関数は、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.
