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

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

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

アトラスからテクスチャを削除することは、主に、アトラス内のテクスチャサブrectの代わりにテクスチャ座標0-1を操作するシェーダにそれを渡すときに便利です。

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

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

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

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

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