QRhiColorAttachment Class

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

[constexpr noexcept default] QRhiColorAttachment::QRhiColorAttachment()

空のカラーアタッチメントの説明を作成します。

QRhiColorAttachment::QRhiColorAttachment(QRhiRenderBuffer *renderBuffer)

renderBuffer を関連付けられたカラーバッファとして指定する、カラーアタッチメントの記述を生成します。

QRhiColorAttachment::QRhiColorAttachment(QRhiTexture *texture)

texture を関連付けられたカラーバッファとして指定する、カラーアタッチメントの記述を作成します。

int QRhiColorAttachment::layer() const

レイヤーインデックス（キューブマップの面または配列レイヤー）を返します。デフォルトは 0 です。

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

int QRhiColorAttachment::level() const

ミップレベルを返します。デフォルトは 0 です。

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

[since 6.7] int QRhiColorAttachment::multiViewCount() const

現在設定されているビューの数を返します。デフォルトは 0 で、これはこのカラーアタッチメントを持つレンダリングターゲットがマルチビューレンダリングで使用されないことを示します。

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

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

QRhiRenderBuffer *QRhiColorAttachment::renderBuffer() const

このアタッチメント記述が参照するレンダリングバッファを返します。参照するバッファがない場合は、nullptr を返します。

実際には、マルチサンプルcolor レンダリングバッファを介してマルチサンプルレンダリングを設定し、レンダリングパスの最後にそれを非マルチサンプルテクスチャに変換する場合に、QRhiRenderBuffer をQRhiColorAttachment と関連付けることが最も理にかなっています。

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

int QRhiColorAttachment::resolveLayer() const

現在設定されているリゾルブ・テクスチャ・レイヤーを返します。デフォルトは 0 です。

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

int QRhiColorAttachment::resolveLevel() const

現在設定されている解像度テクスチャのミップレベルを返します。デフォルトは 0 です。

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

QRhiTexture *QRhiColorAttachment::resolveTexture() const

このアタッチメント記述が参照するリゾルブテクスチャを返します。参照するテクスチャが存在しない場合は、nullptr を返します。

アタッチメントがマルチサンプルテクスチャまたはレンダーバッファを参照している場合、null 以外の resolveTexture を設定できます。この場合、resolveTexture() 内の `QRhiTexture ` は、同じサイズ（ただしサンプル数は 1）の非マルチサンプル 2D テクスチャ（またはテクスチャ配列）となります。 マルチサンプルコンテンツは、各レンダリングパスの終了時に、自動的にこのテクスチャに解決されます。

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

void QRhiColorAttachment::setLayer(int layer)

layer のインデックスを設定します。

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

void QRhiColorAttachment::setLevel(int level)

ミップlevel を設定します。

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

[since 6.7] void QRhiColorAttachment::setMultiViewCount(int count)

ビューのcount を設定します。1より大きい値を設定すると、このカラーアタッチメントを持つレンダリングターゲットがマルチビューレンダリングで使用されることを示します。デフォルト値は0です。2より小さい値は、マルチビューレンダリングを行わないことを示します。

count が2 以上に設定されている場合、カラーアタッチメントは2Dテクスチャ配列に関連付けられている必要があります。layer()およびmultiViewCount()を組み合わせて、マルチビューレンダリング中にターゲットとなるテクスチャ配列要素の範囲を定義します。

たとえば、layer が0 で、multiViewCount が2 の場合、テクスチャ配列には2つ（またはそれ以上）の要素が必要であり、マルチビューレンダリングでは要素0と1が対象となります。この場合、シェーダー内のgl_ViewIndex 変数の値は0 または1 となります。ここで、view0 はテクスチャ配列の要素0 に対応し、view1 は配列の要素1 に対応します。

マルチビューレンダリングに関する詳細については、GL_OVR_multiviewを参照してください。なお、Qt OpenGL (ES) 上で実行する場合、GL_OVR_multiview2も必要とする点に注意してください。

マルチビューレンダリングは、isFeatureSupported() からMultiView 機能がサポートされていると報告された場合にのみ利用可能です。

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

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

void QRhiColorAttachment::setRenderBuffer(QRhiRenderBuffer *rb)

レンダリングバッファ「rb 」を設定します。

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

void QRhiColorAttachment::setResolveLayer(int layer)

使用する解像度テクスチャ「layer 」を設定します。

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

void QRhiColorAttachment::setResolveLevel(int level)

使用する解像度テクスチャのミップlevel を設定します。

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

void QRhiColorAttachment::setResolveTexture(QRhiTexture *tex)

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

tex tex は、2Dテクスチャまたは2Dテクスチャ配列であることが想定されます。いずれの場合も、リゾルブ処理は の単一レイヤー（配列要素）の単一ミップレベルを対象とします。ミップレベルと配列レイヤーは、 ()および ()によって指定されます。resolveLevel resolveLayer

例外として、multiview があります。カラーアタッチメントがテクスチャ配列に関連付けられており、マルチビューが有効になっている場合、resolveテクスチャもすべてのビューに対応する十分な要素数を持つテクスチャ配列でなければなりません。この場合、ビューに対応するすべての要素が自動的に解決されます。この動作は、以下の擬似コードに類似しています：

for (i = 0; i < multiViewCount(); ++i)
    resolve texture's layer() + i into resolveTexture's resolveLayer() + i

マルチサンプルテクスチャやレンダリングバッファを、レンダリングパスの終了時に自動的に解決するために、マルチサンプルではないテクスチャを設定することは、マルチサンプルテクスチャを直接扱う（かつ解決用テクスチャを設定しない）場合よりも好ましいことがよくあります。これは、マルチサンプルテクスチャ専用に動作するフラグメントシェーダー（sampler2DMS 、texelFetch 、 など）を扱うために専用のフラグメントシェーダーを記述する必要がなくなり、むしろ、アタッチメントのテクスチャが最初からマルチサンプルでなかった場合と同じように、同じシェーダーを使用できるようになるためです。その代償として、追加のリソース（非マルチサンプルのtex ）が必要となります。

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

void QRhiColorAttachment::setTexture(QRhiTexture *tex)

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

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

QRhiTexture *QRhiColorAttachment::texture() const

このアタッチメント記述が参照するテクスチャを返します。該当するテクスチャがない場合は、nullptr を返します。

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