QSGMaterialShader Class

멤버 함수 문서

QSGMaterialShader::QSGMaterialShader()

새로운 QSGMaterialShader 를 생성합니다.

[since 6.4] int QSGMaterialShader::combinedImageSamplerCount(int binding) const

결합된 이미지 샘플러 변수의 요소 수를 binding 에서 반환합니다. 이 값은 셰이더 코드에서 인트로스펙티브됩니다. 변수는 배열일 수 있으며 둘 이상의 차원을 가질 수 있습니다.

카운트는 변수에 결합된 이미지 샘플러 항목의 총 개수를 반영합니다. 다음 예제에서 srcA 의 개수는 1, srcB 은 4, srcC 은 6입니다.

layout (binding = 0) uniform sampler2D srcA;
layout (binding = 1) uniform sampler2D srcB[4];
layout (binding = 2) uniform sampler2D srcC[2][3];

이 카운트는 QSGMaterialShader::updateSampledImage 의 텍스처 파라미터에 있는 QSGTexture 포인터의 수입니다.

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

QSGMaterialShader::updateSampledImage도 참조하십시오 .

QSGMaterialShader::Flags QSGMaterialShader::flags() const

이 머티리얼 셰이더에 현재 설정된 플래그를 반환합니다.

setFlags()도 참조하십시오 .

void QSGMaterialShader::setFlag(QSGMaterialShader::Flags flags, bool on = true)

on 이 참이면 이 머티리얼 셰이더에 flags 을 설정하고, 그렇지 않으면 지정된 플래그를 지웁니다.

void QSGMaterialShader::setFlags(QSGMaterialShader::Flags flags)

이 머티리얼 셰이더에 flags 을 설정합니다.

flags()도 참조하십시오 .

[protected] void QSGMaterialShader::setShader(QSGMaterialShader::Stage stage, const QShader &shader)

지정된 stage 에 대해 shader 을 설정합니다.

[protected] void QSGMaterialShader::setShaderFileName(QSGMaterialShader::Stage stage, const QString &filename)

지정된 stage 에 대한 셰이더의 filename 를 설정합니다.

파일은 직렬화된 QShader 을 포함할 것으로 예상됩니다.

[protected, since 6.8] void QSGMaterialShader::setShaderFileName(QSGMaterialShader::Stage stage, const QString &filename, int viewCount)

지정된 stage 에 대한 셰이더의 filename 를 설정합니다.

파일은 직렬화된 QShader 을 포함할 것으로 예상됩니다.

이 오버로드는 multiview 렌더링을 활성화할 때, 특히 빌드 시스템의 멀티뷰 편의 옵션을 사용할 때 사용됩니다.

viewCount 는 2, 3 또는 4여야 합니다. filename 은 이에 따라 자동으로 조정됩니다.

이 기능은 Qt 6.8에 도입되었습니다.

[virtual] bool QSGMaterialShader::updateGraphicsPipelineState(QSGMaterialShader::RenderState &state, QSGMaterialShader::GraphicsPipelineState *ps, QSGMaterial *newMaterial, QSGMaterial *oldMaterial)

이 함수는 씬 그래프에서 호출되어 머티리얼이 사용자 지정 그래픽 상태 세트를 제공할 수 있도록 합니다. 머티리얼별로 사용자 지정할 수 있는 상태 세트는 블렌딩 및 관련 설정으로 제한됩니다.

반환 값은 ps 의 멤버가 변경될 때마다 true 여야 합니다.

현재 렌더링 state 은 씬 그래프에서 전달됩니다.

서브클래스별 상태는 newMaterial 에서 추출할 수 있습니다. oldMaterial 이 null인 경우 이 셰이더는 방금 활성화된 것입니다.

[virtual] void QSGMaterialShader::updateSampledImage(QSGMaterialShader::RenderState &state, int binding, QSGTexture **texture, QSGMaterial *newMaterial, QSGMaterial *oldMaterial)

이 함수는 셰이더에서 샘플링된 이미지를 사용할 준비를 하기 위해 씬 그래프에서 호출되며, 일반적으로 이미지 샘플러를 결합하는 형태로 사용됩니다.

binding 는 샘플러의 바인딩 번호입니다. 이 함수는 셰이더 코드에서 결합된 이미지 샘플러 변수 각각에 대해 QSGMaterialShader.

texture 는 QSGTexture 포인터의 배열입니다. 배열의 요소 수는 셰이더 코드에 지정된 이미지 샘플러 변수의 요소 수와 일치합니다. 이 변수는 배열일 수 있으며 둘 이상의 차원을 가질 수 있습니다. 배열의 요소 수는 다음을 통해 확인할 수 있습니다. QSGMaterialShader::combinedImageSamplerCount

texture 의 요소가 null인 경우 반환하기 전에 유효한 QSGTexture 포인터로 설정해야 합니다. null이 아닌 경우, 새로운 QSGTexture * 을 저장할지 아니면 이미 알려진 QSGTexture 의 일부 매개변수를 업데이트할지는 머티리얼에 따라 결정됩니다. QSGTexture 의 소유권은 이전되지 않습니다.

현재 렌더링 state 은 씬 그래프에서 전달됩니다. 해당되는 경우 QSGTexture::commitTextureOperations()를 통해 텍스처 데이터 업로드 대기열을 트리거하는 것은 머티리얼에 달려 있습니다.

서브클래스별 상태는 newMaterial 에서 추출할 수 있습니다.

oldMaterial 를 사용하여 변경 사항을 최소화할 수 있습니다. oldMaterial 가 null이면 이 셰이더가 방금 활성화된 것입니다.

QSGMaterialShader::combinedImageSamplerCount 를참조하세요 .

[virtual] bool QSGMaterialShader::updateUniformData(QSGMaterialShader::RenderState &state, QSGMaterial *newMaterial, QSGMaterial *oldMaterial)

이 함수는 셰이더 프로그램의 균일 버퍼의 내용을 업데이트하기 위해 씬 그래프에서 호출됩니다. 이 구현은 실제 그래픽 연산을 수행하지 않고 RenderState::uniformData()에서 반환된 QByteArray 에 데이터를 복사하는 역할만 수행합니다. 씬 그래프는 셰이더에서 해당 버퍼를 표시하는 작업을 처리합니다.

현재 렌더링 state 은 씬 그래프에서 전달됩니다. 상태가 관련 상태가 더티임을 나타내는 경우, 구현은 RenderState::uniformData()를 통해 액세스할 수 있는 버퍼 데이터의 적절한 영역을 업데이트해야 합니다. 매트릭스나 불투명도와 같은 상태가 더럽지 않은 경우 데이터가 영구적이므로 해당 영역을 건드릴 필요가 없습니다.

유니폼 데이터가 변경될 때마다 반환 값은 true 이어야 합니다.

단색 머티리얼의 색상과 같은 서브클래스별 상태는 newMaterial 에서 추출하여 버퍼의 관련 영역을 적절히 업데이트해야 합니다.

oldMaterial 는 머티리얼 상태를 업데이트할 때 버퍼 변경(일반적으로 memcpy 호출)을 최소화하는 데 사용할 수 있습니다. oldMaterial 가 null이면 이 셰이더가 방금 활성화된 것입니다.