QRhiGraphicsPipeline Class

QRhiShaderResourceBindings *srb;
QRhiRenderPassDescriptor *rpDesc;
QShader vs, fs;
// ...

QRhiVertexInputLayout inputLayout;
inputLayout.setBindings({ { 3 * sizeof(float) } });
inputLayout.setAttributes({ { 0, 0, QRhiVertexInputAttribute::Float3, 0 } });

QRhiGraphicsPipeline *ps = rhi->newGraphicsPipeline();
ps->setShaderStages({ { QRhiShaderStage::Vertex, vs }, { QRhiShaderStage::Fragment, fs } });
ps->setVertexInputLayout(inputLayout);
ps->setShaderResourceBindings(srb);
ps->setRenderPassDescriptor(rpDesc);
if (!ps->create()) { error(); }

멤버 함수 문서

const QRhiShaderStage *QRhiGraphicsPipeline::cbeginShaderStages() const

셰이더 스테이지 목록의 첫 번째 항목을 가리키는 const 이터레이터를 반환합니다.

const QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::cbeginTargetBlends() const

렌더 타겟 블렌드 설정 목록의 첫 번째 항목을 가리키는 const 이터레이터를 반환합니다.

const QRhiShaderStage *QRhiGraphicsPipeline::cendShaderStages() const

셰이더 스테이지 목록의 마지막 항목 바로 뒤를 가리키는 const 이터레이터를 반환합니다.

const QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::cendTargetBlends() const

렌더 타겟 블렌드 설정 목록의 마지막 항목 바로 다음을 가리키는 const 이터레이터를 반환합니다.

[pure virtual] bool QRhiGraphicsPipeline::create()

해당 네이티브 그래픽 리소스를 생성합니다. 이전에 destroy() 호출 없이 create()를 호출하여 이미 리소스가 존재하는 경우, 먼저 destroy()가 암시적으로 호출됩니다.

성공 시 true 를 반환하고, 그래픽 작업이 실패한 경우 false 를 반환합니다. 반환 값과 관계없이 destroy()를 호출하는 것은 항상 안전합니다.

QRhiGraphicsPipeline::CullMode QRhiGraphicsPipeline::cullMode() const

현재 설정된 면 켈링 모드를 반환합니다.

setCullMode()도 참조하십시오 .

int QRhiGraphicsPipeline::depthBias() const

현재 설정된 깊이 바이어스를 반환합니다.

setDepthBias()도 참조하십시오 .

QRhiGraphicsPipeline::CompareOp QRhiGraphicsPipeline::depthOp() const

깊이 비교 함수를 반환합니다.

setDepthOp()도 참조하십시오 .

QRhiGraphicsPipeline::Flags QRhiGraphicsPipeline::flags() const

현재 설정된 플래그를 반환합니다.

setFlags()도 참조하십시오 .

QRhiGraphicsPipeline::FrontFace QRhiGraphicsPipeline::frontFace() const

현재 설정된 전면 모드 정보를 반환합니다.

setFrontFace()도 참조하십시오 .

[since 6.11] bool QRhiGraphicsPipeline::hasDepthClamp() const

깊이 클램프가 활성화되어 있으면 true를 반환합니다.

이 함수는 Qt 6.11부터 도입되었습니다.

bool QRhiGraphicsPipeline::hasDepthTest() const

깊이 검사가 활성화되어 있으면 true를 반환합니다.

bool QRhiGraphicsPipeline::hasDepthWrite() const

심도 쓰기가 활성화되어 있으면 true를 반환합니다.

bool QRhiGraphicsPipeline::hasStencilTest() const

스텐실 테스트가 활성화되어 있으면 true를 반환합니다.

float QRhiGraphicsPipeline::lineWidth() const

현재 설정된 선 두께를 반환합니다. 기본값은 1.0f입니다.

setLineWidth()도 참조하십시오 .

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

조회수 카운트를 반환합니다. 기본값은 0이며, 이는 멀티뷰 렌더링이 없음을 나타냅니다.

이 함수는 Qt 6.7에서 도입되었습니다.

setMultiViewCount()도 참조하십시오 .

int QRhiGraphicsPipeline::patchControlPointCount() const

현재 설정된 패치 제어점의 개수를 반환합니다.

setPatchControlPointCount()도 참조하십시오 .

QRhiGraphicsPipeline::PolygonMode QRhiGraphicsPipeline::polygonMode() const

다각형 모드를 반환합니다.

setPolygonMode()도 참조하십시오 .

QRhiRenderPassDescriptor *QRhiGraphicsPipeline::renderPassDescriptor() const

현재 설정된 QRhiRenderPassDescriptor 를 반환합니다.

setRenderPassDescriptor()도 참조하십시오 .

[override virtual] QRhiResource::Type QRhiGraphicsPipeline::resourceType() const

QRhiResource::resourceType() const를 재구현합니다.

리소스 유형을 반환합니다.

int QRhiGraphicsPipeline::sampleCount() const

현재 설정된 샘플 수를 반환합니다. 1은 멀티샘플 앤티앨리어싱이 적용되지 않음을 의미합니다.

setSampleCount()도 참조하십시오 .

void QRhiGraphicsPipeline::setCullMode(QRhiGraphicsPipeline::CullMode mode)

지정된 면 켈링 mode 을 설정합니다.

cullMode()도 참조하십시오 .

void QRhiGraphicsPipeline::setDepthBias(int bias)

bias 의 깊이를 설정합니다. 기본값은 0입니다.

depthBias()도 참조하십시오 .

[since 6.11] void QRhiGraphicsPipeline::setDepthClamp(bool enable)

enable 가 true인 경우 깊이 클램핑을 활성화합니다. 깊이 클램핑이 활성화되면, 일반적으로 근거리 또는 원거리 클립 평면에 의해 잘려나갔을 프라이미티브가 래스터화되며, 해당 프라이미티브의 깊이 값은 깊이 범위로 제한됩니다. 비활성화된 경우(기본값), 이러한 프라이미티브는 잘려나갑니다.

이 함수는 Qt 6.11에서 도입되었습니다.

hasDepthClamp()도 참조하십시오 .

void QRhiGraphicsPipeline::setDepthOp(QRhiGraphicsPipeline::CompareOp op)

op 의 깊이 비교 함수를 설정합니다.

depthOp()도 참조하십시오 .

void QRhiGraphicsPipeline::setDepthTest(bool enable)

enable 에 따라 깊이 테스트를 활성화하거나 비활성화합니다. 기본적으로 깊이 테스트와 깊이 데이터 쓰기 모두 비활성화되어 있습니다.

hasDepthTest() 및 setDepthWrite()도 참조하십시오 .

void QRhiGraphicsPipeline::setDepthWrite(bool enable)

enable 에 따라 깊이 버퍼에 깊이 데이터를 기록하는 기능을 제어합니다. 기본적으로 이 기능은 비활성화되어 있습니다. 깊이 기록은 일반적으로 깊이 테스트와 함께 활성화됩니다.

hasDepthWrite() 및 setDepthTest()도 참조하십시오 .

void QRhiGraphicsPipeline::setFlags(QRhiGraphicsPipeline::Flags f)

f 플래그를 설정합니다.

flags()도 참조하십시오 .

void QRhiGraphicsPipeline::setFrontFace(QRhiGraphicsPipeline::FrontFace f)

전면 모드 f 를 설정합니다.

frontFace()도 참조하십시오 .

void QRhiGraphicsPipeline::setLineWidth(float width)

width 줄을 설정합니다. 런타임 시 ‘ QRhi::WideLines ’ 기능이 지원되지 않는 것으로 보고될 경우, 1.0f 이외의 값은 무시됩니다.

lineWidth()도 참조하십시오 .

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

멀티뷰 렌더링을 위한 뷰의 ‘ count ’을 설정합니다. 기본값은 0이며, 이는 멀티뷰 렌더링을 수행하지 않음을 의미합니다. 멀티뷰 렌더링을 활성화하려면 ‘ count ’ 값이 2 이상이어야 합니다.

멀티뷰는 MultiView feature 가 지원되는 것으로 보고된 경우에만 사용할 수 있습니다. 렌더 타깃은 2D 텍스처 배열이어야 하며, 렌더 타깃의 컬러 어태치먼트에는 동일한 count 가 설정되어 있어야 합니다.

멀티뷰 렌더링에 대한 자세한 내용은 QRhiColorAttachment::setMultiViewCount()을 참조하십시오.

이 함수는 Qt 6.7에서 도입되었습니다.

multiViewCount(), QRhi::MultiView 및 QRhiColorAttachment::setMultiViewCount()도 참조하십시오 .

void QRhiGraphicsPipeline::setPatchControlPointCount(int count)

패치 제어점의 개수를 count 로 설정합니다. 기본값은 3입니다. 이 설정은 토폴로지가 Patches 로 설정된 경우에만 사용됩니다.

patchControlPointCount()도 참조하십시오 .

void QRhiGraphicsPipeline::setPolygonMode(QRhiGraphicsPipeline::PolygonMode mode)

다각형을 ‘ mode ’로 설정합니다. 기본값은 ‘Fill’입니다.

polygonMode() 및 QRhi::NonFillPolygonMode도 참조하십시오 .

void QRhiGraphicsPipeline::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

지정된 QRhiRenderPassDescriptor desc 과 연결됩니다.

renderPassDescriptor()도 참조하십시오 .

void QRhiGraphicsPipeline::setSampleCount(int s)

샘플 수를 설정합니다. s 의 일반적인 값은 1, 4 또는 8입니다. 파이프라인은 항상 렌더 타깃과 호환되어야 하며, 즉 샘플 수가 일치해야 합니다.

sampleCount() 및 QRhi::supportedSampleCounts()도 참조하십시오 .

void QRhiGraphicsPipeline::setShaderResourceBindings(QRhiShaderResourceBindings *srb)

srb 와 연관되어 있으며, 리소스 바인딩 레이아웃과 리소스(QRhiBuffer, QRhiTexture) 자체를 설명합니다. 파이프라인 생성 시에는 레이아웃만 중요하므로 후자는 선택 사항입니다. 따라서, 여기에 전달된 srb 는 드로우 호출을 기록하기 전에 setShaderResources()를 통해 바인딩된 다른 layout-compatible QRhiShaderResourceBindings 가 존재하는 한, 실제 버퍼나 텍스처 객체를 명시하지 않아도 됩니다(nullptr).

shaderResourceBindings()도 참조하십시오 .

void QRhiGraphicsPipeline::setShaderStages(std::initializer_list<QRhiShaderStage> list)

셰이더 스테이지의 list 를 설정합니다.

template <typename InputIterator> void QRhiGraphicsPipeline::setShaderStages(InputIterator first, InputIterator last)

first 및 last 이터레이터에서 셰이더 스테이지 목록을 설정합니다.

void QRhiGraphicsPipeline::setSlopeScaledDepthBias(float bias)

경사 스케일링 깊이 bias 를 설정합니다. 기본값은 0입니다.

slopeScaledDepthBias()도 참조하십시오 .

void QRhiGraphicsPipeline::setStencilBack(const QRhiGraphicsPipeline::StencilOpState &state)

뒷면의 스텐실 테스트 state 를 설정합니다.

stencilBack()도 참조하십시오 .

void QRhiGraphicsPipeline::setStencilFront(const QRhiGraphicsPipeline::StencilOpState &state)

전면 면에 대한 스텐실 테스트 state 를 설정합니다.

stencilFront()도 참조하십시오 .

void QRhiGraphicsPipeline::setStencilReadMask(quint32 mask)

mask 의 스텐실 읽기 설정을 지정합니다. 기본값은 0xFF입니다.

stencilReadMask()도 참조하십시오 .

void QRhiGraphicsPipeline::setStencilTest(bool enable)

enable 에 따라 스텐실 테스트를 활성화하거나 비활성화합니다. 기본적으로 이 기능은 비활성화되어 있습니다.

hasStencilTest()도 참조하십시오 .

void QRhiGraphicsPipeline::setStencilWriteMask(quint32 mask)

스텐실 쓰기 mask 를 설정합니다. 기본값은 0xFF입니다.

stencilWriteMask()도 참조하십시오 .

void QRhiGraphicsPipeline::setTargetBlends(std::initializer_list<QRhiGraphicsPipeline::TargetBlend> list)

렌더 타겟 블렌드 설정의 ‘ list ’을 설정합니다. 이는 리스트 형식입니다. 여러 렌더 타겟이 사용될 경우(예: ‘ QRhiColorAttachment ’이 두 개 이상인 ‘ QRhiTextureRenderTarget ’), 렌더 타겟(컬러 어태치먼트)마다 하나의 ‘ TargetBlend ’ 구조체가 필요하기 때문입니다.

기본적으로 기본 생성된 TargetBlend 세트가 하나 있습니다.

QRhi::MaxColorAttachments도 참조하십시오 .

template <typename InputIterator> void QRhiGraphicsPipeline::setTargetBlends(InputIterator first, InputIterator last)

first 및 last 이터레이터에서 렌더 타겟 블렌드 설정 목록을 설정합니다.

void QRhiGraphicsPipeline::setTopology(QRhiGraphicsPipeline::Topology t)

t 의 기본 토폴로지를 설정합니다.

topology()도 참조하십시오 .

void QRhiGraphicsPipeline::setVertexInputLayout(const QRhiVertexInputLayout &layout)

layout 의 정점 입력을 지정합니다.

vertexInputLayout()도 참조하십시오 .

QRhiShaderResourceBindings *QRhiGraphicsPipeline::shaderResourceBindings() const

현재 연결된 QRhiShaderResourceBindings 객체를 반환합니다.

setShaderResourceBindings()도 참조하십시오 .

const QRhiShaderStage *QRhiGraphicsPipeline::shaderStageAt(qsizetype index) const

지정된 index 의 셰이더 스테이지를 반환합니다.

qsizetype QRhiGraphicsPipeline::shaderStageCount() const

이 파이프라인에 포함된 셰이더 스테이지의 수를 반환합니다.

float QRhiGraphicsPipeline::slopeScaledDepthBias() const

현재 설정된 기울기 스케일링된 깊이 바이어스를 반환합니다.

setSlopeScaledDepthBias()도 참조하십시오 .

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilBack() const

뒷면의 현재 스텐실 테스트 상태를 반환합니다.

setStencilBack()도 참조하십시오 .

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilFront() const

전면 면에 대한 현재 스텐실 테스트 상태를 반환합니다.

setStencilFront()도 참조하십시오 .

quint32 QRhiGraphicsPipeline::stencilReadMask() const

현재 스텐실 읽기 마스크를 반환합니다.

setStencilReadMask()도 참조하십시오 .

quint32 QRhiGraphicsPipeline::stencilWriteMask() const

현재 스텐실 쓰기 마스크를 반환합니다.

setStencilWriteMask()도 참조하십시오 .

const QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::targetBlendAt(qsizetype index) const

지정된 index 의 렌더 타겟 블렌드 설정을 반환합니다.

qsizetype QRhiGraphicsPipeline::targetBlendCount() const

렌더 타겟 블렌드 설정의 개수를 반환합니다.

QRhiGraphicsPipeline::Topology QRhiGraphicsPipeline::topology() const

현재 설정된 프리미티브 토폴로지를 반환합니다.

setTopology()도 참조하십시오 .

QRhiVertexInputLayout QRhiGraphicsPipeline::vertexInputLayout() const

현재 설정된 정점 입력 레이아웃 사양을 반환합니다.

setVertexInputLayout()도 참조하십시오 .