QSGMaterial Class

멤버 함수 문서

[virtual] int QSGMaterial::compare(const QSGMaterial *other) const

이 머티리얼을 other 과 비교하여 같으면 0을 반환하고, other 보다 먼저 정렬해야 하는 경우 -1, other 보다 먼저 정렬해야 하는 경우 1을 반환합니다.

씬 그래프는 지오메트리 노드를 재정렬하여 상태 변화를 최소화할 수 있습니다. 비교 함수는 정렬 프로세스 중에 호출되어 QSGMaterialShader::updateState()를 호출할 때마다 상태 변경을 최소화하도록 머티리얼을 정렬할 수 있습니다.

이 포인터와 other 는 동일한 type()를 갖도록 보장됩니다.

[pure virtual] QSGMaterialShader *QSGMaterial::createShader(QSGRendererInterface::RenderMode renderMode) const

이 함수는 QSGMaterial 의 특정 구현에 대한 지오메트리를 렌더링하는 데 사용되는 QSGMaterialShader 구현의 새 인스턴스를 반환합니다.

이 함수는 머티리얼 유형과 renderMode 의 각 조합에 대해 한 번만 호출되며 내부적으로 캐시됩니다.

대부분의 머티리얼의 경우 renderMode 은 무시할 수 있습니다. 일부 머티리얼은 특정 렌더링 모드에 대한 커스텀 처리가 필요할 수 있습니다. 예를 들어 머티리얼이 RenderMode3D를 사용할 때 원근 변환을 고려해야 하는 방식으로 앤티앨리어싱을 구현하는 경우입니다.

QSGMaterial::Flags QSGMaterial::flags() const

머티리얼의 플래그를 반환합니다.

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

on 이 참이면 이 자료에 flags 플래그를 설정하고, 그렇지 않으면 속성을 지웁니다.

[pure virtual] QSGMaterialType *QSGMaterial::type() const

이 함수는 씬 그래프에서 createShader()로 인스턴스화된 QSGMaterialShader 에 고유한 식별자를 쿼리하기 위해 호출됩니다.

많은 머티리얼의 경우 일반적인 접근 방식은 정적이고 전역적으로 사용 가능한 QSGMaterialType 인스턴스에 대한 포인터를 반환하는 것입니다. QSGMaterialType 은 불투명한 객체입니다. 그 목적은 고유한 머티리얼 식별자를 생성하는 유형 안전하며 간단한 방법으로만 사용됩니다.

QSGMaterialType *type() const override
{
    static QSGMaterialType type;
    return &type;
}

[since 6.8] int QSGMaterial::viewCount() const

멀티뷰 렌더링에 사용되는 머티리얼의 경우 뷰 수를 반환합니다.

일반적으로 반환 값은 1 입니다. 뷰 수가 2보다 크면 멀티뷰 렌더 패스를 의미합니다. 멀티뷰를 지원하는 머티리얼은 createShader() 또는 QSGMaterialShader 생성자에서 viewCount()를 쿼리하여 적절한 셰이더가 선택되었는지 확인해야 합니다. 그런 다음 버텍스 셰이더는 멀티뷰 모드에서 여러 행렬이 있으므로 gl_ViewIndex 을 사용하여 모델뷰-투영 행렬 배열의 인덱싱을 수행해야 합니다. (각 뷰마다 하나씩)

예를 들어 다음의 간단한 버텍스 셰이더를 살펴보겠습니다:

#version 440

layout(location = 0) in vec4 vertexCoord;
layout(location = 1) in vec4 vertexColor;

layout(location = 0) out vec4 color;

layout(std140, binding = 0) uniform buf {
    mat4 matrix[2];
    float opacity;
};

void main()
{
    gl_Position = matrix[gl_ViewIndex] * vertexCoord;
    color = vertexColor * opacity;
}

이 셰이더는 2개의 뷰, 2개의 뷰만 처리하도록 준비되어 있습니다. 다른 뷰 수와 호환되지 않습니다. 셰이더를 컨디셔닝할 때 qsb 도구를 --view-count 2 으로 호출하거나 CMake 통합을 사용하는 경우 VIEW_COUNT 2 을 qt_add_shaders() 명령에 지정해야 합니다.

개발자는 자동으로 주입되는 전처리 변수 QSHADER_VIEW_COUNT 를 사용하여 다양한 조회 수를 간단하게 처리하는 것이 좋습니다. 예를 들어 동일한 소스 파일에서 뷰 수가 2인 비멀티뷰와 멀티뷰를 모두 지원해야 하는 경우 다음과 같이 할 수 있습니다:

#version 440

layout(location = 0) in vec4 vertexCoord;
layout(location = 1) in vec4 vertexColor;

layout(location = 0) out vec4 color;

layout(std140, binding = 0) uniform buf {
#if QSHADER_VIEW_COUNT >= 2
    mat4 matrix[QSHADER_VIEW_COUNT];
#else
    mat4 matrix;
#endif
    float opacity;
};

void main()
{
#if QSHADER_VIEW_COUNT >= 2
    gl_Position = matrix[gl_ViewIndex] * vertexCoord;
#else
    gl_Position = matrix * vertexCoord;
#endif
    color = vertexColor * opacity;
}

이제 동일한 소스 파일을 qsb 또는 qt_add_shaders() 을 통해 조회 수를 지정하지 않고 한 번, 조회 수를 2로 설정하여 한 번 두 번 실행할 수 있습니다. 그러면 자료는 런타임에 viewCount()에 따라 적절한 .qsb 파일을 선택할 수 있습니다.

CMake를 사용하면 다음과 비슷하게 보일 수 있습니다. 이 예제에서 해당 QSGMaterialShader 은 viewCount() 값에 따라 :/shaders/example.vert.qsb 과 :/shaders/multiview/example.vert.qsb 중 하나를 선택해야 합니다. (프래그먼트 셰이더도 마찬가지입니다.)

qt_add_shaders(application "application_shaders"
    PREFIX
        /
    FILES
        shaders/example.vert
        shaders/example.frag
)

qt_add_shaders(application "application_multiview_shaders"
    GLSL
        330,300es
    HLSL
        61
    MSL
        12
    VIEW_COUNT
        2
    PREFIX
        /
    FILES
        shaders/example.vert
        shaders/example.frag
    OUTPUTS
        shaders/multiview/example.vert
        shaders/multiview/example.frag
)

편의를 위해 qt_add_shaders()에 대한 MULTIVIEW 옵션도 있습니다. 먼저 qsb 도구를 정상적으로 실행한 다음 VIEW_COUNT 을 2 으로 재정의하고 GLSL, HLSL, MSL 을 적절한 기본값으로 설정한 다음 qsb 을 다시 실행하여 이번에는 접미사를 추가한 .qsb 파일을 출력합니다. 그런 다음 머티리얼 구현은 viewCount 인수를 받는 QSGMaterialShader::setShaderFileName() 오버로드를 사용하여 올바른 .qsb 파일을 자동으로 선택할 수 있습니다.

따라서 다음은 수동으로 관리되는 출력 파일을 지정할 필요가 없다는 점을 제외하면 위의 예제 호출과 거의 동일합니다. 자동으로 선택된 셰이딩 언어 버전이 충분하지 않은 경우가 있을 수 있으며, 이 경우 애플리케이션에서 모든 것을 명시적으로 계속 지정해야 합니다.

qt_add_shaders(application "application_multiview_shaders"
    MULTIVIEW
    PREFIX
        /
    FILES
        shaders/example.vert
        shaders/example.frag
)

Qt XML의 멀티뷰 지원에 대한 더 낮은 수준의 자세한 내용은 QRhi::MultiView, QRhiColorAttachment::setMultiViewCount() 및 QRhiGraphicsPipeline::setMultiViewCount()를 참조하십시오. Qt Quick 씬 그래프 렌더러는 QQuickRenderTarget::fromRhiRenderTarget() 또는 arraySize 인수가 1보다 큰 fromVulkanImage()와 같은 3D API 전용 함수를 통해 지정하면 멀티뷰 렌더링 대상을 인식하도록 준비됩니다. 그러면 렌더러는 그래픽 파이프라인과 머티리얼에 뷰 수를 전파합니다.

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