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()

対応するネイティブ・グラフィックス・リソースを作成します。対応するdestroy() がない以前の create() によって既にリソースが存在する場合は、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 （）の前だけです。

この関数は、基礎となるグラフィックス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

テクスチャに書き込むときや、画像のロード/ストアで使用するときに使用されるビューフォーマットを返します。呼び出されない場合、ビューフォーマットはformat() と同じと見なされます。

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

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