このページでは

Qt3DRender::QTextureLoader Class

class Qt3DRender::QTextureLoader

テクスチャの読み込みおよびテクスチャのプロパティの設定を行います。詳細...

ヘッダー: #include <Qt3DRender/QTexture>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
QML内: TextureLoader
継承元: Qt3DRender::QAbstractTexture
ステータス: 非推奨

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

プロパティ

パブリック関数

QTextureLoader(Qt3DCore::QNode *parent = nullptr)
bool isMirrored() const
QUrl source() const

パブリックスロット

void setMirrored(bool mirrored)
void setSource(const QUrl &source)

シグナル

void mirroredChanged(bool mirrored)
void sourceChanged(const QUrl &source)

詳細な説明

プロパティのドキュメント

mirrored : bool

このプロパティは、テクスチャを読み込む際に反転させるかどうかを指定します。これは、レンダリング API で使用されるテクスチャ座標の原点に合わせて画像を加工する手間を省くための機能です。デフォルトでは、このプロパティは true に設定されています。GPU 圧縮されたテクスチャ形式を使用する場合、この設定は効果を持ちません。

警告:この プロパティを設定すると、PNGなどの非圧縮またはCPU圧縮された画像形式を読み込む際に、実行時のパフォーマンス低下を招きます。このパフォーマンス低下を避けるには、このプロパティを`false`に設定し、あらかじめミラーリング済みのテクスチャアセットを読み込むことをお勧めします。

注:OpenGLでは テクスチャ座標の原点が左下隅と規定されていますが、DirectXでは左上隅が使用されます。

注: キューブマップテクスチャを使用する場合、 キューブマップサンプラは通常のテクスチャ座標ではなく方向を指定するため、ミラーリングを無効にすることをお勧めします。

アクセス関数:

bool isMirrored() const
void setMirrored(bool mirrored)

通知シグナル:

void mirroredChanged(bool mirrored)

source : QUrl

このプロパティは、現在のテクスチャソースを保持します。

アクセス関数:

QUrl source() const
void setSource(const QUrl &source)

通知シグナル:

void sourceChanged(const QUrl &source)

メンバ関数のドキュメント

[explicit] QTextureLoader::QTextureLoader(Qt3DCore::QNode *parent = nullptr)

parent を親として、新しいQt3DRender::QTextureLoader インスタンスを生成します。

なお、デフォルトでは、ファイルのメタデータと矛盾しない限り、読み込まれたテクスチャには以下のプロパティが設定されます: - wrapMode が Repeat に設定される - minificationFilter が LinearMipMapLinear に設定される - magnificationFilter が Linear に設定される - generateMipMaps が true に設定される - maximumAnisotropy が 16.0f に設定される - target が TargetAutomatic に設定される

[slot] void QTextureLoader::setMirrored(bool mirrored)

ミラーリングをmirrored に設定します。

注:これにより 、内部的にデータジェネレータの更新が呼び出されます。

注: プロパティ `mirrored`のセッター 関数です。

isMirrored()も参照してください 。

[slot] void QTextureLoader::setSource(const QUrl &source)

テクスチャローダーのソースを `source` に設定します。source

注: プロパティ `source`のセッター 関数です。

source()も参照してください 。

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