QSGTexture Class

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

QSGTexture::QSGTexture()

基底クラス「QSGTexture」を生成します。

[override virtual noexcept] QSGTexture::~QSGTexture()

QSGTexture を削除します。

QSGTexture::AnisotropyLevel QSGTexture::anisotropyLevel() const

このテクスチャのフィルタリングに使用されている異方性のレベルを返します。

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

[virtual, since 6.0] void QSGTexture::commitTextureOperations(QRhi *rhi, QRhiResourceUpdateBatch *resourceUpdates)

この関数を呼び出すと、resourceUpdates への画像アップロード操作がキューに追加されます（保留中の操作がある場合）。新しいデータがない場合（例えば、この関数の前回の呼び出し以降に setImage() が呼び出されていない場合など）、この関数は何もしません。

rhi のテクスチャを使用するマテリアルでは、updateSampledImage()の実装内で、通常は条件を付けずに、QSGMaterialShader::RenderState からstate.rhi() およびstate.resourceUpdateBatch() を引数としてこの関数を呼び出すことが想定されています。

この関数は Qt 6.0 で導入されました。

[pure virtual] qint64 QSGTexture::comparisonKey() const

テクスチャの比較に適したキーを返します。通常、QSGMaterial::compare() の実装で使用されます。

QSGTexture ポインタを単に比較するだけでは必ずしも十分ではありません。なぜなら、内部で同じネイティブテクスチャオブジェクトを参照している2つのQSGTexture インスタンスも、等しいとみなされるべきだからです。したがって、この関数が必要となります。

この関数の実装は、まだグラフィックスリソース（ネイティブテクスチャオブジェクト）が存在しない場合、それらを作成することは想定されておらず、また作成してはならない。

内部にネイティブテクスチャオブジェクトを持たない `QSGTexture ` は、通常、他のどの `QSGTexture` とも等しくないため、戻り値はそれに応じて適切に設定する必要があります。これには例外があり、特にアトラス化が使用されている場合（内部では複数のテクスチャが同じアトラステクスチャを共有している場合）は、サブクラスの実装において適切に対処する必要があります。

QRectF QSGTexture::convertToNormalizedSourceRect(const QRectF &rect) const

rect を正規化座標に変換した値を返します。

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

QSGTexture::Filtering QSGTexture::filtering() const

このテクスチャで使用するサンプリングモードを返します。

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

[pure virtual] bool QSGTexture::hasAlphaChannel() const

テクスチャデータにアルファチャンネルが含まれている場合、trueを返します。

[pure virtual] bool QSGTexture::hasMipmaps() const

テクスチャデータにミップマップレベルが含まれている場合、true を返します。

QSGTexture::WrapMode QSGTexture::horizontalWrapMode() const

このテクスチャに適用する水平方向の折り返しモードを返します。

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

[virtual] bool QSGTexture::isAtlasTexture() const

このテクスチャがアトラスの一部であるかどうかを返します。

デフォルトの実装では、false を返します。

QSGTexture::Filtering QSGTexture::mipmapFiltering() const

このテクスチャからサンプリングを行う際に、ミップマッピングを使用すべきかどうかを返します。

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

template <typename QNativeInterface> QNativeInterface *QSGTexture::nativeInterface() const

指定された型のテクスチャに対するネイティブインターフェースを返します。

この関数は、QNativeInterface 名前空間で宣言されているQSGTexture のプラットフォーム固有の機能へのアクセスを提供します。

これにより、OpenGL の `GLuint ` テクスチャ ID や Vulkan の `VkImage ` ハンドルなど、基盤となるネイティブのテクスチャオブジェクトへのアクセスが可能になります。

要求されたインターフェースが利用できない場合は、nullptr が返されます。

[virtual] QRectF QSGTexture::normalizedTextureSubRect() const

このテクスチャが表す、textureSize() 内の矩形を正規化座標で返します。

デフォルトの実装では、位置 (0, 0) にある、幅と高さが 1 の矩形を返します。

[virtual] QSGTexture *QSGTexture::removedFromAtlas(QRhiResourceUpdateBatch *resourceUpdates = nullptr) const

この関数は、現在のテクスチャのコピーを返し、そのテクスチャをアトラスから削除します。

現在のテクスチャは変更されないため、テクスチャ座標を更新する必要はありません。

アトラスからテクスチャを削除することは、アトラス内のテクスチャのサブ矩形ではなく、テクスチャ座標 0～1 を操作するシェーダーにテクスチャを渡す場合に特に役立ちます。

テクスチャがテクスチャアトラスの一部でない場合、この関数は 0 を返します。

メモリ使用量を抑えるため、この関数の実装では、複数の呼び出しに対して同じインスタンスを返すことを推奨します。

resourceUpdates はオプションのリソース更新バッチであり、テクスチャ操作がある場合は、その操作がこのバッチにキューに入れられます。マテリアルは、QSGMaterialShader::RenderState からインスタンスを取得できます。null の場合、removedFromAtlas() の実装は独自のバッチを作成し、直ちにそれを送信します。ただし、有効なインスタンスが指定された場合、この関数は更新バッチを送信しません。

[virtual, since 6.0] QRhiTexture *QSGTexture::rhiTexture() const

このQSGTexture に対応するQRhiTexture を返します。該当する が存在しない場合はnullを返します（内部でまだ有効なテクスチャが作成されていないか、使用中のシーングラフバックエンドにこの概念が適用されないためです）。

この関数は、QRhiTexture が存在しない場合に新しいものを生成することは想定されていません。その場合はnullを返すべきです。レンダラーに対しては、nullのテクスチャが指定された場合、代わりに透明なダミーテクスチャが使用されることが期待されます。

この関数はQt 6.0で導入されました。

void QSGTexture::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)

異方性フィルタリングのレベルをlevel に設定します。デフォルト値はQSGTexture::AnisotropyNone であり、これは異方性フィルタリングが有効になっていないことを意味します。

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

void QSGTexture::setFiltering(QSGTexture::Filtering filter)

サンプリングモードをfilter に設定します。

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

void QSGTexture::setHorizontalWrapMode(QSGTexture::WrapMode hwrap)

水平方向の折り返しモードを次のように設定します。hwrap

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

void QSGTexture::setMipmapFiltering(QSGTexture::Filtering filter)

ミップマップのサンプリングモードをfilter に設定します。

テクスチャにミップマップがない場合、ミップマップフィルタリングの設定は効果を持ちません。

mipmapFiltering() およびhasMipmaps()も参照してください 。

void QSGTexture::setVerticalWrapMode(QSGTexture::WrapMode vwrap)

垂直方向の折り返しモードをvwrap

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

[pure virtual] QSize QSGTexture::textureSize() const

テクスチャのサイズをピクセル単位で返します。

QSGTexture::WrapMode QSGTexture::verticalWrapMode() const

このテクスチャに使用する垂直方向の折り返しモードを返します。

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