QRhiColorAttachment Class

メンバ関数ドキュメント

[constexpr noexcept] QRhiColorAttachment::QRhiColorAttachment()

空のカラーアタッチメント記述を構築します。

QRhiColorAttachment::QRhiColorAttachment(QRhiRenderBuffer *renderBuffer)

関連する色バッファとしてrenderBuffer を指定する色添付記述を構築する。

QRhiColorAttachment::QRhiColorAttachment(QRhiTexture *texture)

関連するカラーバッファとしてtexture を指定するカラーアタッチメント記述を構築します。

int QRhiColorAttachment::layer() const

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

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

int QRhiColorAttachment::level() const

mip レベルを返します。デフォルトは 0。

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

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

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

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

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

QRhiRenderBuffer *QRhiColorAttachment::renderBuffer() const

このアタッチメントの説明が参照するレンダーバッファ、またはない場合はnullptr を返します。

実際には、QRhiRenderBuffer をQRhiColorAttachment に関連付けることは、レンダリングパスの最後に非マルチサンプルテクスチャに解決されるマルチサンプルcolor レンダーバッファを経由してマルチサンプルレンダリングを設定するときに最も理にかなっています。

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

int QRhiColorAttachment::resolveLayer() const

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

setResolveLayer() も参照 。

int QRhiColorAttachment::resolveLevel() const

現在設定されている resolve texture mip level を返します。デフォルトは 0 です。

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

QRhiTexture *QRhiColorAttachment::resolveTexture() const

この添付ファイルの説明が参照する resolve texture を返します。ない場合はnullptr を返します。

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

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

void QRhiColorAttachment::setLayer(int layer)

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

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

void QRhiColorAttachment::setLevel(int level)

miplevel を設定します。

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

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

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

count が2 以上に設定されている場合、カラーアタッチメントは 2D テクスチャ配列に関連付けられている必要があります。layer() とmultiViewCount() を一緒に使用すると、マルチビューレンダリング時に対象となるテクスチャ配列要素の範囲が定義されます。

たとえば、layer が0 で、multiViewCount が2 の場合、テクスチャ配列は 2 つ（またはそれ以上）の要素を持つ必要があり、マルチビューレンダリングは要素 0 と 1 をターゲットにします。シェーダ内の変数gl_ViewIndex は0 または1 の値を持ち、ビュー0 はテクスチャ配列要素0 に対応し、ビュー1 は配列要素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)

使用する resolve texturelayer を設定します。

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

void QRhiColorAttachment::setResolveLevel(int level)

使用する resolve texture miplevel を設定します。

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

void QRhiColorAttachment::setResolveTexture(QRhiTexture *tex)

resolve texturetex を設定します。

tex は 2D テクスチャまたは 2D テクスチャ配列であることが期待されます。いずれの場合も、 の単一レイヤー（配列要素）の単一ミップレベルを対象とします。ミップレベルと配列レイヤーは () と () で指定します。tex 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() も参照して ください。