QRhiVertexInputBinding Class

頂点入力のバインディングについて説明します。詳細...

ヘッダー:	`#include <rhi/qrhi.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS GuiPrivate)` `target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)`
qmake:	`QT += gui-private`
以下のように:	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 &key, 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);

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

注：ストライドは常に4の倍数でなければなりません。

注：これは 互換性の保証が限定されている RHI API です。詳細については、QRhi を参照してください。

QRhiCommandBuffer::setVertexInput()も参照してください 。

メンバ型のドキュメント

enum QRhiVertexInputBinding::Classification

入力データの分類について説明します。

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

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

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

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

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

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

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