QRhiVertexInputBinding Class

頂点入力バインディングを記述します。詳細...

Header:	`#include <rhi/qrhi.h>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Gui)` `target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)`
qmake:	`QT += gui-private`
Since:	Qt 6.6

継承されたメンバを含む、すべてのメンバのリスト

パブリック型

enum	Classification { PerVertex, PerInstance }

パブリック関数

	QRhiVertexInputBinding()
	QRhiVertexInputBinding(quint32 stride, QRhiVertexInputBinding::Classification cls = PerVertex, quint32 stepRate = 1)
QRhiVertexInputBinding::Classification	classification() const
quint32	instanceStepRate() const
void	setClassification(QRhiVertexInputBinding::Classification c)
void	setInstanceStepRate(quint32 rate)
void	setStride(quint32 s)
quint32	stride() const

size_t	qHash(const QRhiVertexInputBinding &v, size_t seed = 0)
bool	operator!=(const QRhiVertexInputBinding &a, const QRhiVertexInputBinding &b)
bool	operator==(const QRhiVertexInputBinding &a, const QRhiVertexInputBinding &b)

詳細説明

ストライド（バイト単位、4の倍数でなければならない）、分類、およびオプションでインスタンスステップレートを指定します。

例として、以下の入力を持つ頂点シェーダを想定します：

layout(location = 0) in vec4 position;
layout(location = 1) in vec2 texcoord;

ここで、3 コンポーネントの頂点位置(x, y, z) と 2 コンポーネントのテクスチャ座標(u, v) が、バッファ（または別個のバッファでも可）にノンインターリーブ形式で提供されるとします。2つのバインディングを定義するには、このようにします：

QRhiVertexInputLayout inputLayout;
inputLayout.setBindings({
    { 3 * sizeof(float) },
    { 2 * sizeof(float) }
});

インスタンス化は使用されないので、ここではストライドのみが興味深い。バインディング番号は、QRhiVertexInputLayout のバインディングベクタのQRhiVertexInputBinding要素のインデックスで与えられます。

この頂点入力レイアウトを持つグラフィックスパイプラインがバインドされると、頂点入力は、最初に位置、次にテクスチャ座標を持つ単一のバッファがあると仮定して、36頂点を持つ立方体を描画するために次のように設定できます：

const QRhiCommandBuffer::VertexInput vbufBindings[] = {
    { cubeBuf, 0 },
    { cubeBuf, 36 * 3 * sizeof(float) }
};
cb->setVertexInput(0, 2, vbufBindings);

i はsetVertexInput() の第2引数のインデックスで、startBinding + i で定義されたインデックスが、QRhiVertexInputLayout のbindings ベクトルの対応するエントリのインデックスと一致することに注意してください。

注：ストライドは常に4の倍数でなければならない。

注：これは互換性保証に制限のあるRHI APIである。詳細はQRhi を参照のこと。

QRhiCommandBuffer::setVertexInput()も参照のこと 。

メンバ型ドキュメント

enum QRhiVertexInputBinding::Classification

入力データの分類を表す。

定数	値	説明
`QRhiVertexInputBinding::PerVertex`	`0`	データは頂点単位
`QRhiVertexInputBinding::PerInstance`	`1`	データはインスタンス単位

メンバ関数説明

`[constexpr noexcept]` QRhiVertexInputBinding::QRhiVertexInputBinding()

デフォルトの頂点入力バインディング記述を構築します。

QRhiVertexInputBinding::QRhiVertexInputBinding(quint32 stride, QRhiVertexInputBinding::Classification cls = PerVertex, quint32 stepRate = 1)

指定されたstride 、分類cls 、インスタンスステップレートstepRate を持つ頂点入力バインディング記述を構築します。

注： QRhi::CustomInstanceStepRate がサポートされていると報告されている場合にのみ、1 以外のstepRate がサポートされます。