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() 実装からこの関数を呼び出すことが期待されます。通常、この関数は無条件で呼び出され、state.rhi() とstate.resourceUpdateBatch() をQSGMaterialShader::RenderState から渡します。

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

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

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

同じネイティブテクスチャオブジェクトを参照する2つのQSGTexture インスタンスも等しいと見なされる必要があるため、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 はオプションのリソース更新バッチで、テクスチャ操作がある場合は、その操作がエンキューされます。マテリアルは、 からインスタンスを取得できます。 NULL の場合、removedFromAtlas() 実装は独自のバッチを作成し、すぐにそれをサブミットします。ただし、有効なインスタンスが指定されている場合、この関数は更新バッチを送信しません。QSGMaterialShader::RenderState

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

有効なテクスチャがまだ内部で作成されていないか、コンセプトが使用中の scenegraph バックエンドに適用されないため）この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() も参照して ください。