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 textureレイヤーを返します。デフォルトは 0 です。

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

int QRhiColorAttachment::resolveLevel() const

現在設定されているresolve texture mip levelを返します。デフォルトは 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)

miplevel を設定する。

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 の値を持ち、ビュー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()も参照してください 。