QRhiTexture Class

QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(512, 512));
if (!texture->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
QImage image(512, 512, QImage::Format_RGBA8888);
image.fill(Qt::green);
batch->uploadTexture(texture, image);
// ...
commandBuffer->resourceUpdate(batch); // or, alternatively, pass 'batch' to a beginPass() call

// determine newSize, e.g. based on the swapchain's output size or other factors
if (texture->pixelSize() != newSize) {
    texture->setPixelSize(newSize);
    if (!texture->create()) { error(); }
}
// continue using texture, fill it with new data

メンバ関数ドキュメント

int QRhiTexture::arrayRangeLength() const

setArrayRange() がコールされたときに公開されていた配列範囲のサイズを返す。

setArrayRange()も参照 。

int QRhiTexture::arrayRangeStart() const

setArrayRange() がコールされたときの最初の配列レイヤーを返す。

setArrayRange()も参照 。

int QRhiTexture::arraySize() const

テクスチャ配列のサイズを返します。

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

[pure virtual] bool QRhiTexture::create()

対応するネイティブ・グラフィックス・リソースを作成する。以前の create() で対応するdestroy() がなかったためにすでにリソースが存在する場合は、destroy() が暗黙的に最初に呼び出されます。

グラフィックス操作に成功した場合はtrue を、失敗した場合はfalse を返します。返り値に関係なく、destroy() を呼び出すことは常に安全です。

[virtual] bool QRhiTexture::createFrom(QRhiTexture::NativeTexture src)

create() と似ているが、新しいネイティブテクスチャは作成されない。代わりに、src によって指定されたネイティブテクスチャリソースが使用される。

これにより、外部のグラフィックスエンジンから既存のネイティブテクスチャオブジェクト（グラフィックス API によっては、同じデバイスまたは共有コンテキストに属している必要があります）をインポートすることができます。

指定された既存のネイティブテクスチャオブジェクトが正常に非所有QRhiTexture としてラップされた場合、true を返します。

この操作の逆で、QRhiTexture で作成されたネイティブのテクスチャオブジェクトを外国のエンジンに公開することは、nativeTexture() で可能です。

int QRhiTexture::depth() const

3D テクスチャの深度を返します。

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

QRhiTexture::Flags QRhiTexture::flags() const

テクスチャフラグを返します。

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

QRhiTexture::Format QRhiTexture::format() const

テクスチャフォーマットを返します。

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

[virtual] QRhiTexture::NativeTexture QRhiTexture::nativeTexture()

このテクスチャの基礎となるネイティブリソースを返します。基盤となるネイティブリソースの公開がバックエンドでサポートされていない場合、返される値は空になります。

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

QSize QRhiTexture::pixelSize() const

ピクセル単位のサイズを返します。

setPixelSize()も参照 。

[since 6.8] QRhiTexture::ViewFormat QRhiTexture::readViewFormat() const

テクスチャをサンプリングするときに使用されるビューフォーマットを返します。呼び出されない場合、ビューフォーマットはformat() と同じと見なされます。

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

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

[override virtual] QRhiResource::Type QRhiTexture::resourceType() const

再実装：QRhiResource::resourceType() const.

リソース型を返します。

int QRhiTexture::sampleCount() const

サンプル数を返します。1 は、マルチサンプル アンチエイリアシングを行わないことを意味します。

setSampleCount()も参照 。

void QRhiTexture::setArrayRange(int startIndex, int count)

通常、すべての配列レイヤは公開され、sampler2DArray をサンプリングするときにtexture() GLSL 関数に渡される 3 番目の座標を介してレイヤを選択するのはシェーダ次第です。QRhi::TextureArrayRange がサポートされていると報告された場合、create() またはcreateFrom() の前に setArrayRange() を呼び出すと、指定された範囲、startIndex から始まるcount 要素のみを選択するように要求されます。 シェーダロジックは、このことを念頭に置いて記述できます。

QRhi::TextureArrayRangeも参照してください 。

void QRhiTexture::setArraySize(int arraySize)

テクスチャarraySize を設定します。

arraySize()も参照 。

void QRhiTexture::setDepth(int depth)

3D テクスチャのdepth を設定します。

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

void QRhiTexture::setFlags(QRhiTexture::Flags f)

テクスチャフラグをf に設定します。

flags()も参照 。

void QRhiTexture::setFormat(QRhiTexture::Format fmt)

要求されたテクスチャフォーマットをfmt に設定します。

format()も参照 。

[virtual] void QRhiTexture::setNativeLayout(int layout)

VulkanのようないくつかのグラフィックスAPIでは、グラフィックスAPIを直接使用するカスタムレンダリングコードの統合は、画像レイアウトに関しては特別な注意が必要です。この関数を使用すると、ネイティブのレンダリングコマンドの後に、QRhiTexture のイメージのバッキングが予想されるlayout を伝えることができます。

たとえば、QRhiCommandBuffer::beginExternal() とQRhiCommandBuffer::endExternal() で囲まれたコードブロックで、QRhiTexture's VkImage に直接 Vulkan でレンダリングし、その後、QRhi-based render pass でテクスチャサンプリングのために画像を使用することを考えます。潜在的に不正確なイメージレイアウトの遷移を避けるために、この関数を使用して、前記コードブロックに記録されたコマンドが完了すると、イメージレイアウトがどうなるかを示すことができます。

この関数を呼び出すのは、QRhiCommandBuffer::endExternal （）の後と、それに続くQRhiCommandBuffer::beginPass （）の前だけです。

この関数は、基礎となる Graphical API が画像レイアウトの概念を公開しないQRhi バックエンドでは効果がありません。

void QRhiTexture::setPixelSize(const QSize &sz)

ピクセル単位で指定されたテクスチャサイズをsz に設定します。

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

[since 6.8] void QRhiTexture::setReadViewFormat(const QRhiTexture::ViewFormat &fmt)

シェーダーリソースビューフォーマット（またはテクスチャをサンプリングするために使用されるビューのフォーマット）をfmt に設定します。 デフォルトでは、テクスチャそのものと同じフォーマット（およびsRGB-ness）が使用され、ほとんどの場合、この関数を呼び出す必要はありません。

この設定は、TextureViewFormat機能がサポートされていると報告された場合にのみ考慮されます。

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

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

void QRhiTexture::setSampleCount(int s)

サンプル数をs に設定する。

sampleCount()も参照のこと 。

[since 6.8] void QRhiTexture::setWriteViewFormat(const QRhiTexture::ViewFormat &fmt)

レンダーターゲットのビューフォーマットをfmt に設定します。デフォルトでは、テクスチャ自体と同じフォーマット（およびsRGB-ness）が使用され、ほとんどの場合、この関数を呼び出す必要はありません。

書き込みビューフォーマットを提供するための1つの一般的なユースケースは、私たちの制御の範囲外で、VulkanやDirect 3Dのような3D APIでsRGBフォーマットを使用する外部提供のテクスチャを扱うことですが、レンダリングエンジンは、そのシェーディングパイプラインの最後に線形化とsRGBへの変換を処理するようにすでに準備されています。この場合、このようなテクスチャにレンダリングするときに必要なのは、同じ、しかし非sRGBフォーマットを持つレンダーターゲットビュー（VkImageViewなど）です。(例えば、OpenXRの実装からVK_FORMAT_R8G8B8A8_SRGBテクスチャを取得した場合、レンダリングエンジンのパイプラインが要求するものであれば、VK_FORMAT_R8G8B8A8_UNORMビューを使用してレンダリングする必要があります。この例では、フォーマットがQRhiTexture::RGBA8 、srgb がfalse に設定されたViewFormat を使用してこの関数を呼び出します。）

この設定は、TextureViewFormat 機能がサポートされていると報告された場合にのみ考慮されます。

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

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

[since 6.8] QRhiTexture::ViewFormat QRhiTexture::writeViewFormat() const

テクスチャに書き込むとき、および image load/store で使用するときに使用されるビューフォーマットを返します。呼び出されない場合、ビューフォーマットはformat() と同じと見なされます。

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

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