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`
이후:	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) 가 버퍼(또는 별도의 버퍼)에 인터리브되지 않은 형식으로 제공된다고 가정해 보겠습니다. 그러면 두 개의 바인딩을 다음과 같이 정의할 수 있습니다:

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()의 두 번째 인수의 인덱스)가 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 로 버텍스 입력 바인딩 설명을 구성합니다.

참고: 1 이외의stepRate 은 QRhi::CustomInstanceStepRate 이 지원되는 것으로 보고된 경우에만 지원됩니다.