QTextureImage Class
class Qt3DRender::QTextureImage画像ソースからOpenGLテクスチャ画像を作成するために必要な情報をカプセル化します。詳細...
| ヘッダー | #include <QTextureImage> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake | QT += 3drender |
| QML で | TextureImage |
| を継承しています： | Qt3DRender::QAbstractTextureImage |
| ステータス | 非推奨 |
パブリックな型
| enum | Status { None, Loading, Ready, Error } |
プロパティ
パブリック機能
| QTextureImage(Qt3DCore::QNode *parent = nullptr) | |
| bool | isMirrored() const |
| QUrl | source() const |
| Qt3DRender::QTextureImage::Status | status() const |
パブリックスロット
| void | setMirrored(bool mirrored) |
| void | setSource(const QUrl &source) |
シグナル
| void | mirroredChanged(bool mirrored) |
| void | sourceChanged(const QUrl &source) |
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
保護された関数
| void | setStatus(Qt3DRender::QTextureImage::Status status) |
メンバ型ドキュメント
enum QTextureImage::Status
この列挙は、テクスチャ画像の読み込みのステータス値を指定します。
| 定数 | 値 | 説明 |
|---|---|---|
Qt3DRender::QTextureImage::None | 0 | テクスチャ画像の読み込みはまだ開始されていません。 |
Qt3DRender::QTextureImage::Loading | 1 | テクスチャ画像の読み込みは開始されましたが、完了していません。 |
Qt3DRender::QTextureImage::Ready | 2 | テクスチャ画像の読み込みが終了しました。 |
Qt3DRender::QTextureImage::Error | 3 | テクスチャ画像の読み込みがエラーになりました。 |
プロパティの説明
mirrored : bool
このプロパティは、ロード時に画像をミラーリングするかどうかを指定します。これは、レンダリングAPIが使用するテクスチャ座標の原点と一致させるために画像を操作する手間を省くための便利な機能です。デフォルトでは、このプロパティはtrueに設定されています。GPU 圧縮テクスチャフォーマットを使用する場合、この効果はありません。
警告 このプロパティは、PNG のような非圧縮または CPU 圧縮のイメージフォーマットをロードするとき、実行時に支払うパフォーマンスの代償となります。このパフォーマンスの代償を避けるには、このプロパティを False に設定し、事前 にミラーリングされたテクスチャ アセットをロードすることをお勧めします。
注： OpenGLはテクスチャ座標の原点を左下隅から指定しますが、DirectXは左上隅を使用します。
注意： キューブマップテクスチャを使用する場合、キューブマップサンプラーは通常のテクスチャ座標ではなく方向を取るため、ミラーリングは無効にした方が良いでしょう。
アクセス関数
| bool | isMirrored() const |
| void | setMirrored(bool mirrored) |
通知シグナル
| void | mirroredChanged(bool mirrored) |
source : QUrl
このプロパティは、テクスチャイメージのデータがロードされるソースURLを保持します。
アクセス関数
通知シグナル
| void | sourceChanged(const QUrl &source) |
[read-only] status : const Status
このプロパティは、テクスチャ画像のロード状態を保持します。
- TextureImage.なし
- TextureImage.読み込み中
- TextureImage.準備完了
- TextureImage.エラー
アクセス関数です：
| Qt3DRender::QTextureImage::Status | status() const |
通知シグナル
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
メンバー関数ドキュメント
[explicit] QTextureImage::QTextureImage(Qt3DCore::QNode *parent = nullptr)
parent を親として新しいQt3DRender::QTextureImage インスタンスを構築する。
bool QTextureImage::isMirrored() const
ミラーリングが有効かどうかを返す。
注： プロパティmirrored のゲッター関数。
[slot] void QTextureImage::setMirrored(bool mirrored)
ミラーリングをmirrored に設定する。
注： これは内部的にデータジェネレーターを更新するコールをトリガーする。
注: プロパティmirrored のセッター関数。
isMirrored()も参照 。
[slot] void QTextureImage::setSource(const QUrl &source)
テクスチャ画像のソースURLをsource に設定します。
注： これは内部的にデータジェネレーターを更新する呼び出しをトリガーします。
注: プロパティsource のセッター関数です。
source()も参照してください 。
[protected] void QTextureImage::setStatus(Qt3DRender::QTextureImage::Status status)
ステータスをstatusに設定する。
status()も参照のこと 。
QUrl QTextureImage::source() const
テクスチャ画像のデータがロードされるソースURLを返します。
注： プロパティソース用のゲッター関数です。
setSource()も参照してください 。
Qt3DRender::QTextureImage::Status QTextureImage::status() const
現在の状態を返す。
注： プロパティ状態のゲッター関数。
setStatus()も参照してください 。
© 2025 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.
