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 QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::cbeginTargetBlends() const

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

const QRhiShaderStage *QRhiGraphicsPipeline::cendShaderStages() const

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

const QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::cendTargetBlends() 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()도 참조하세요 .

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()도 참조하세요 .

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. 기본값은 채우기입니다.

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()도 참조하세요 .