GraphicsInfo QML Type (Uncreatable)
Qt Quick 에서 사용하는 씬그래프 백엔드 및 그래픽 API에 대한 정보를 제공합니다. 더 보기...
| Import Statement: | import QtQuick |
| Since: | QtQuick 2.8 |
참고: 이 타입은 생성할 수 없는 타입입니다. QML에서 인스턴스를 생성할 수 없습니다.
속성
- 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 [read-only]
이 속성은 현재 사용 중인 그래픽 API를 설명합니다.
사용 가능한 값은 다음과 같습니다:
| 상수 | 설명 |
|---|---|
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(그래픽 추상화 계층) 위에 구축된 Metal |
GraphicsInfo.Null | 그래픽 추상화 계층인 QRhi 위에 Null(출력 없음) |
majorVersion : int [read-only]
이 속성은 사용 중인 그래픽 API의 주요 버전을 나타냅니다.
OpenGL의 경우 기본 버전은 2.0 입니다.
참고: 이는 OpenGL에만 적용됩니다.
minorVersion 및 profile도 참조하십시오 .
minorVersion : int [read-only]
이 속성은 사용 중인 그래픽 API의 부버전을 나타냅니다.
OpenGL의 경우 기본 버전은 2.0 입니다.
참고: 이는 OpenGL에만 적용됩니다.
majorVersion 및 profile도 참조하십시오 .
profile : enumeration [read-only]
이 속성은 구성된 OpenGL 컨텍스트 프로필을 저장합니다.
사용 가능한 값은 다음과 같습니다.
| 상수 | 설명 |
|---|---|
GraphicsInfo.OpenGLNoProfile | (기본값) OpenGL 버전이 3.2보다 낮거나 OpenGL이 사용되지 않는 경우. |
GraphicsInfo.OpenGLCoreProfile | OpenGL 버전 3.0에서 더 이상 사용되지 않는 기능은 사용할 수 없습니다. |
GraphicsInfo.OpenGLCompatibilityProfile | 이전 OpenGL 버전의 기능은 사용할 수 있습니다. |
재사용 가능한 QML 컴포넌트는 일반적으로 바인딩에서 이 속성을 사용하여 코어 프로파일과 비코어 프로파일 호환 셰이더 소스 중 하나를 선택합니다.
참고: 이는 OpenGL에만 적용됩니다.
majorVersion, minorVersion 및 QSurfaceFormat도 참조하십시오 .
renderableType : enumeration [read-only]
이 속성은 렌더링 가능한 유형을 나타냅니다. 이 값은 OpenGL 이외의 API에서는 의미가 없습니다.
사용 가능한 값은 다음과 같습니다:
| 상수 | 설명 |
|---|---|
GraphicsInfo.SurfaceFormatUnspecified | (기본값) 지정되지 않은 렌더링 방식 |
GraphicsInfo.SurfaceFormatOpenGL | 데스크톱 OpenGL 또는 기타 그래픽 API |
GraphicsInfo.SurfaceFormatOpenGLES | OpenGL ES 참고: 이는 OpenGL에만 적용됩니다. |
QSurfaceFormat도 참조하십시오 .
shaderCompilationType : enumeration [read-only, since QtQuick 2.8]
이 속성에는 애플리케이션이 사용 중인 Qt Quick 백엔드에서 지원하는 셰이더 컴파일 방식의 비트마스크가 포함되어 있습니다.
| 상수 | 값 |
|---|---|
GraphicsInfo.RuntimeCompilation | |
GraphicsInfo.OfflineCompilation |
OpenGL의 경우 값은 ` GraphicsInfo.RuntimeCompilation`이며, 이는 ` ShaderEffect`을 사용하는 전통적인 방식에 해당합니다. 그러나 OpenGL이 아닌 백엔드는 ` GraphicsInfo.OfflineCompilation`에 더 중점을 둘 것으로 예상됩니다.
참고: 이 값은 항목이 창과 연결된 후에야 최신 상태로 업데이트됩니다. 이 값에 의존하는 바인딩은 컴포넌트 초기화가 완료된 후 값이 0 에서 실제 비트 마스크로 변경될 수 있으므로 이 점을 유의해야 합니다. 이는 특히 속성 값으로 설정된 ShaderEffectSource 항목 내부의 ShaderEffect 항목에 해당됩니다.
이 속성은 QtQuick 2.8에서 도입되었습니다.
shaderType 및 shaderSourceType도 참조하십시오 .
shaderSourceType : enumeration [read-only, since QtQuick 2.8]
이 속성은 셰이더 소스를 제공하는 지원되는 방식들의 비트 마스크를 포함합니다.
| 상수 | 값 |
|---|---|
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 [read-only, since QtQuick 2.8]
이 속성에는 애플리케이션이 사용 중인 Qt Quick 백엔드에서 지원하는 셰이딩 언어가 포함되어 있습니다.
| 상수 | 설명 |
|---|---|
GraphicsInfo.UnknownShadingLanguage | 연관된 창 및 씬그래프가 없어 아직 알려지지 않음 |
GraphicsInfo.GLSL | GLSL 또는 GLSL ES |
GraphicsInfo.HLSL | HLSL |
GraphicsInfo.RhiShader | QShader 참고: 이 값은 해당 항목이 윈도우에 연결된 후에야 최신 상태로 업데이트됩니다. 이 값에 의존하는 바인딩은, 컴포넌트 초기화가 완료된 후 값이 ` GraphicsInfo.UnknownShadingLanguage`에서 실제 값으로 변경될 수 있으므로 이 점을 유의해야 합니다. 이는 특히 속성 값으로 설정된 ` ShaderEffectSource ` 항목 내부의 ` ShaderEffect ` 항목에 해당됩니다. |
이 속성은 QtQuick 2.8에서 도입되었습니다.
shaderCompilationType 및 shaderSourceType도 참조하십시오 .
© 2026 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.
