GraphicsInfo QML Type
Qt Quick 에서 사용하는 시나리오 그래프 백엔드 및 그래픽 API에 대한 정보를 제공합니다. 더 보기...
Import Statement: | import QtQuick |
Since: | QtQuick 2.8 |
속성
- api : enumeration
- majorVersion : int
- minorVersion : int
- profile : enumeration
- renderableType : enumeration
- shaderCompilationType : enumeration
(since QtQuick 2.8)
- shaderSourceType : enumeration
(since QtQuick 2.8)
- shaderType : enumeration
(since QtQuick 2.8)
상세 설명
GraphicsInfo 첨부 유형은 연결된 창의 콘텐츠를 렌더링하는 데 사용되는 시나리오 백엔드 및 그래픽 API에 대한 정보를 제공합니다.
속성이 첨부된 항목이 현재 어떤 창과도 연결되어 있지 않은 경우 속성은 기본값으로 설정됩니다. 연결된 창이 변경되면 프로퍼티가 업데이트됩니다.
속성 문서
api : enumeration |
이 속성은 현재 사용 중인 그래픽 API를 설명합니다.
가능한 값은 다음과 같습니다:
Constant | 설명 |
---|---|
GraphicsInfo.Unknown | 항목에 연결된 활성 시나리오가 없을 때의 기본값입니다. |
GraphicsInfo.Software | Qt Quick의 래스터 페인트 엔진을 사용하는 QPainter 기반의 소프트웨어 렌더러입니다. |
GraphicsInfo.OpenVG | OpenVG |
GraphicsInfo.OpenGL | QRhi, 그래픽 추상화 레이어 위에 있는 OpenGL 또는 OpenGL ES |
GraphicsInfo.Direct3D11 | QRhi, 그래픽 추상화 레이어 위에 Direct3D 11 사용 |
GraphicsInfo.Direct3D12 | QRhi, 그래픽 추상화 레이어 위에 Direct3D 12 사용 |
GraphicsInfo.Vulkan | QRhi, 그래픽 추상화 레이어 위에 Vulkan 사용 |
GraphicsInfo.Metal | QRhi, 그래픽 추상화 레이어 위에 메탈 사용 |
GraphicsInfo.Null | QRhi, 그래픽 추상화 레이어 위에 Null(출력 없음) |
majorVersion : int |
이 속성은 사용 중인 그래픽 API의 주요 버전을 보유합니다.
OpenGL의 경우 기본 버전은 2.0
입니다.
참고: 이 속성은 OpenGL에만 적용됩니다.
minorVersion 및 profile 을참조하세요 .
minorVersion : int |
이 속성은 사용 중인 그래픽 API의 부 버전을 보유합니다.
OpenGL의 경우 기본 버전은 2.0
입니다.
참고: 이 속성은 OpenGL에만 적용됩니다.
majorVersion 및 profile도 참조 하세요.
profile : enumeration |
이 속성은 구성된 OpenGL 컨텍스트 프로파일을 보유합니다.
가능한 값은 다음과 같습니다:
Constant | 설명 |
---|---|
GraphicsInfo.OpenGLNoProfile | (기본값) OpenGL 버전이 3.2보다 낮거나 OpenGL이 사용되지 않습니다. |
GraphicsInfo.OpenGLCoreProfile | OpenGL 버전 3.0에서 더 이상 사용되지 않는 기능을 사용할 수 없습니다. |
GraphicsInfo.OpenGLCompatibilityProfile | 이전 OpenGL 버전의 기능은 사용할 수 있습니다. |
재사용 가능한 QML 컴포넌트는 일반적으로 코어 프로파일과 비코어 프로파일 호환 셰이더 소스 중에서 선택하기 위해 바인딩에서 이 속성을 사용합니다.
참고: 이는 OpenGL에만 적용됩니다.
majorVersion, minorVersion, QSurfaceFormat 를참조하세요 .
renderableType : enumeration |
이 프로퍼티는 렌더링 가능한 유형을 보유합니다. 이 값은 OpenGL 이외의 API에는 의미가 없습니다.
가능한 값은 다음과 같습니다:
Constant | 설명 |
---|---|
GraphicsInfo.SurfaceFormatUnspecified | (기본값) 지정되지 않은 렌더링 방법 |
GraphicsInfo.SurfaceFormatOpenGL | 데스크톱 OpenGL 또는 기타 그래픽 API |
GraphicsInfo.SurfaceFormatOpenGLES | OpenGL ES |
참고: 이 옵션은 OpenGL에만 적용됩니다.
QSurfaceFormat 를참조하십시오 .
shaderCompilationType : enumeration |
이 속성에는 애플리케이션이 사용 중인 Qt Quick 백엔드에서 지원하는 셰이더 컴파일 방식의 비트마스크가 포함되어 있습니다.
Constant | 값 |
---|---|
GraphicsInfo.RuntimeCompilation | |
GraphicsInfo.OfflineCompilation |
OpenGL의 경우 값은 GraphicsInfo.RuntimeCompilation 이며, 이는 ShaderEffect 을 사용하는 기존 방식에 해당합니다. 그러나 비 OpenGL 백엔드는 GraphicsInfo.OfflineCompilation에 더 중점을 둘 것으로 예상됩니다.
참고: 이 값은 항목이 창과 연결된 경우에만 최신 상태입니다. 컴포넌트 초기화가 완료된 후 값이 0
에서 실제 비트마스크로 변경될 수 있으므로 이 값에 의존하는 바인딩은 이 점을 염두에 두어야 합니다. 이는 특히 속성 값으로 설정된 ShaderEffectSource 항목 내의 ShaderEffect 항목과 관련이 있습니다.
이 프로퍼티는 QtQuick 2.8에 도입되었습니다.
shaderType 및 shaderSourceType 을참조하십시오 .
shaderSourceType : enumeration |
이 속성에는 셰이더 소스를 제공하는 지원되는 방법의 비트 마스크가 포함되어 있습니다.
Constant | Value |
---|---|
GraphicsInfo.ShaderSourceString | |
GraphicsInfo.ShaderSourceFile | |
GraphicsInfo.ShaderByteCode |
OpenGL의 경우 값은 GraphicsInfo.ShaderSourceString이며, 이는 GLSL 소스 코드를 QML에 인라이닝하는 전통적인 방식에 해당합니다. 그러나 OpenGL이 아닌 다른 Qt Quick 백엔드에서는 인라인 셰이더 소스를 지원하지 않거나 심지어 셰이더 소스를 전혀 지원하지 않을 수도 있습니다. 이 경우 셰이더는 SPIR-V 또는 D3D 셰이더 바이트코드와 같은 형식으로 사전 컴파일될 것으로 예상됩니다.
참고: 값은 항목이 창에 연결된 경우에만 최신 상태입니다. 컴포넌트 초기화가 완료된 후 값이 0
에서 실제 비트마스크로 변경될 수 있으므로 이 값에 의존하는 바인딩은 이 점을 염두에 두어야 합니다. 이는 특히 속성 값으로 설정된 ShaderEffectSource 항목 내의 ShaderEffect 항목과 관련이 있습니다.
이 프로퍼티는 QtQuick 2.8에 도입되었습니다.
shaderType 및 shaderCompilationType 을참조하십시오 .
shaderType : enumeration |
이 속성에는 애플리케이션이 사용 중인 Qt Quick 백엔드에서 지원하는 셰이딩 언어가 포함되어 있습니다.
Constant | 설명 |
---|---|
GraphicsInfo.UnknownShadingLanguage | 연결된 창 및 시나리오 그래프가 없기 때문에 아직 알려지지 않았습니다. |
GraphicsInfo.GLSL | GLSL 또는 GLSL ES |
GraphicsInfo.HLSL | HLSL |
GraphicsInfo.RhiShader | QShader |
참고: 이 값은 항목이 창에 연결된 경우에만 최신 상태입니다. 이 값에 의존하는 바인딩은 컴포넌트 초기화가 완료된 후 값이 GraphicsInfo.UnknownShadingLanguage에서 실제 값으로 변경될 수 있으므로 이 점을 염두에 두어야 합니다. 이는 특히 속성 값으로 설정된 ShaderEffectSource 항목 내의 ShaderEffect 항목과 관련이 있습니다.
이 프로퍼티는 QtQuick 2.8에 도입되었습니다.
shaderCompilationType 및 shaderSourceType 을참조하십시오 .
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.