QRhiColorAttachment Class

멤버 함수 설명서

[constexpr noexcept default] QRhiColorAttachment::QRhiColorAttachment()

빈 색상 첨부 설명 항목을 생성합니다.

QRhiColorAttachment::QRhiColorAttachment(QRhiRenderBuffer *renderBuffer)

renderBuffer 를 관련 색상 버퍼로 지정하는 색상 첨부 설명 정보를 생성합니다.

QRhiColorAttachment::QRhiColorAttachment(QRhiTexture *texture)

texture 를 관련 색상 버퍼로 지정하는 색상 첨부 설명 정보를 생성합니다.

int QRhiColorAttachment::layer() const

레이어 인덱스(큐브맵 면 또는 배열 레이어)를 반환합니다. 기본값은 0입니다.

setLayer()도 참조하십시오 .

int QRhiColorAttachment::level() const

미프 레벨을 반환합니다. 기본값은 0입니다.

setLevel()도 참조하십시오 .

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

현재 설정된 뷰 수를 반환합니다. 기본값은 0이며, 이는 해당 색상 어태치먼트가 있는 렌더 타겟이 멀티뷰 렌더링에 사용되지 않을 것임을 나타냅니다.

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

setMultiViewCount()도 참조하십시오 .

QRhiRenderBuffer *QRhiColorAttachment::renderBuffer() const

이 어태치먼트 설명이 참조하는 렌더 버퍼를 반환하며, 해당 버퍼가 없는 경우에는 ` nullptr `를 반환합니다.

실제로 QRhiRenderBuffer 를 QRhiColorAttachment 에 연결하는 것은, 멀티샘플 color 렌더 버퍼를 통해 멀티샘플 렌더링을 설정하고, 렌더 패스가 끝날 때 이를 비멀티샘플 텍스처로 변환할 때 가장 적합합니다.

setRenderBuffer()도 참조하십시오 .

int QRhiColorAttachment::resolveLayer() const

현재 설정된 해상도 텍스처 레이어를 반환합니다. 기본값은 0입니다.

setResolveLayer()도 참조하십시오 .

int QRhiColorAttachment::resolveLevel() const

현재 설정된 텍스처 미프 레벨을 반환합니다. 기본값은 0입니다.

setResolveLevel()도 참조하십시오 .

QRhiTexture *QRhiColorAttachment::resolveTexture() const

이 어태치먼트 설명이 참조하는 리졸브 텍스처를 반환하며, 참조하는 텍스처가 없는 경우 ` nullptr `를 반환합니다.

부착물이 멀티샘플 텍스처나 렌더 버퍼를 참조하는 경우, null이 아닌 resolve 텍스처를 설정할 수 있습니다. 이 경우 resolveTexture()의 QRhiTexture 는 동일한 크기(단, 샘플 수는 1)를 가진 비멀티샘플 2D 텍스처(또는 텍스처 배열)가 됩니다. 멀티샘플 콘텐츠는 각 렌더 패스가 끝날 때마다 이 텍스처로 자동 변환됩니다.

setResolveTexture()도 참조하십시오 .

void QRhiColorAttachment::setLayer(int layer)

layer 인덱스를 설정합니다.

layer()도 참조하십시오 .

void QRhiColorAttachment::setLevel(int level)

미프 level 를 설정합니다.

level()도 참조하십시오 .

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

뷰의 ‘ count ’를 설정합니다. 1보다 큰 값을 설정하면 이 컬러 어태치먼트가 있는 렌더 타겟이 멀티뷰 렌더링에 사용됨을 나타냅니다. 기본값은 0입니다. 2보다 작은 값은 멀티뷰 렌더링이 없음을 나타냅니다.

count 가 2 이상으로 설정된 경우, 색상 어태치먼트는 2D 텍스처 배열과 연결되어야 합니다. layer() 및 multiViewCount()는 함께 멀티뷰 렌더링 중에 대상이 되는 텍스처 배열 요소의 범위를 정의합니다.

예를 들어, layer 이 0 이고 multiViewCount 이 2 인 경우, 텍스처 배열은 2개(또는 그 이상)의 요소를 가져야 하며, 멀티뷰 렌더링은 요소 0과 1을 대상으로 합니다. 이때 셰이더의 gl_ViewIndex 변수의 값은 0 또는 1 가 되며, 여기서 view 0 는 텍스처 배열 요소 0 에, view 1 는 배열 요소 1 에 각각 대응합니다.

멀티뷰 렌더링에 대한 자세한 내용은 GL_OVR_multiview를 참조하십시오. Qt OpenGL(ES)에서 실행될 때 GL_OVR_multiview2도 필요로 한다는 점에 유의하십시오.

멀티뷰 렌더링은 isFeatureSupported()에서 MultiView 기능이 지원된다고 보고된 경우에만 사용할 수 있습니다.

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

multiViewCount()도 참조하십시오 .

void QRhiColorAttachment::setRenderBuffer(QRhiRenderBuffer *rb)

렌더 버퍼 rb 를 설정합니다.

renderBuffer()도 참조하십시오 .

void QRhiColorAttachment::setResolveLayer(int layer)

사용할 리졸브 텍스처 layer 를 설정합니다.

resolveLayer()도 참조하십시오 .

void QRhiColorAttachment::setResolveLevel(int level)

사용할 리졸브 텍스처 밉 level 을 설정합니다.

resolveLevel()도 참조하십시오 .

void QRhiColorAttachment::setResolveTexture(QRhiTexture *tex)

해상도 텍스처를 tex 로 설정합니다.

tex tex 는 2D 텍스처 또는 2D 텍스처 배열이어야 합니다. 두 경우 모두, resolve는 의 단일 레이어(배열 요소)에 속한 단일 밉 레벨을 대상으로 합니다. 밉 레벨과 배열 레이어는 () 및 () 함수를 통해 지정됩니다. resolveLevel resolveLayer

단, multiview 의 경우는 예외입니다. 컬러 어태치먼트가 텍스처 배열과 연결되어 있고 멀티뷰가 활성화된 경우, resolve 텍스처 역시 모든 뷰를 처리할 수 있는 충분한 요소를 가진 텍스처 배열이어야 합니다. 이 경우 뷰에 해당하는 모든 요소가 자동으로 해결되며, 이 동작은 다음의 의사 코드와 유사합니다:

for (i = 0; i < multiViewCount(); ++i)
    resolve texture's layer() + i into resolveTexture's resolveLayer() + i

렌더 패스 종료 시점에 멀티샘플 텍스처나 렌더 버퍼를 자동으로 해결하도록 비멀티샘플 텍스처를 설정하는 것은, 멀티샘플 텍스처를 직접 다루는 것(그리고 resolve 텍스처를 설정하지 않는 것)보다 종종 더 바람직합니다. 이는 멀티샘플 텍스처 전용으로 작동하는 별도의 프래그먼트 셰이더(sampler2DMS, texelFetch, 등)을 위해 전용 프래그먼트 셰이더를 작성할 필요가 없으며, 애초에 어태치먼트의 텍스처가 멀티샘플이 아닌 경우와 마찬가지로 동일한 셰이더를 사용할 수 있게 해주기 때문입니다. 다만, 이를 위해서는 추가 리소스(비멀티샘플 tex)가 소요됩니다.

resolveTexture()도 참조하십시오 .

void QRhiColorAttachment::setTexture(QRhiTexture *tex)

tex 텍스처를 설정합니다.

texture()도 참조하십시오 .

QRhiTexture *QRhiColorAttachment::texture() const

이 어태치먼트 설명이 참조하는 텍스처를 반환하며, 텍스처가 없는 경우에는 ` nullptr `를 반환합니다.

setTexture()도 참조하십시오 .