GraphicsInfo QML Type (Uncreatable)
Enthält Informationen zum Scenegraph-Backend und zur Grafik-API, die von Qt Quick verwendet werden. Mehr...
| Import Statement: | import QtQuick |
| Since: | QtQuick 2.8 |
Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.
Eigenschaften
- 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)
Ausführliche Beschreibung
Der angehängte Typ „GraphicsInfo“ liefert Informationen über das Szenengraph-Backend und die Grafik-API, die zum Rendern des Inhalts des zugehörigen Fensters verwendet werden.
Wenn das Element, dem die Eigenschaften zugeordnet sind, derzeit keinem Fenster zugeordnet ist, werden die Eigenschaften auf Standardwerte gesetzt. Wenn sich das zugehörige Fenster ändert, werden die Eigenschaften aktualisiert.
Dokumentation zu den Eigenschaften
api : enumeration [read-only]
Diese Eigenschaft beschreibt die derzeit verwendete Grafik-API.
Die möglichen Werte sind:
| Konstante | Beschreibung |
|---|---|
GraphicsInfo.Unknown | Der Standardwert, wenn dem Element kein aktiver Szenengrafikbaum zugeordnet ist |
GraphicsInfo.Software | Qt QuickSoftware-Renderer des Elements, basierend auf „ QPainter “ mit der Raster-Paint-Engine |
GraphicsInfo.OpenVG | OpenVG |
GraphicsInfo.OpenGL | OpenGL oder OpenGL ES auf Basis von „ QRhi “, einer Grafik-Abstraktionsschicht |
GraphicsInfo.Direct3D11 | Direct3D 11 auf Basis von „ QRhi “, einer Grafikabstraktionsschicht |
GraphicsInfo.Direct3D12 | Direct3D 12 auf Basis von „ QRhi “, einer Grafikabstraktionsschicht |
GraphicsInfo.Vulkan | Vulkan auf Basis von „ QRhi “, einer Grafik-Abstraktionsschicht |
GraphicsInfo.Metal | Metal auf Basis von „ QRhi “, einer Grafikabstraktionsschicht |
GraphicsInfo.Null | Null (keine Ausgabe) auf Basis von „ QRhi “, einer Grafikabstraktionsschicht |
majorVersion : int [read-only]
Diese Eigenschaft enthält die Hauptversion der verwendeten Grafik-API.
Bei OpenGL lautet die Standardversion „ 2.0 “.
Hinweis: Dies gilt nur für OpenGL.
Siehe auch „ minorVersion “ und „ profile “.
minorVersion : int [read-only]
Diese Eigenschaft enthält die Nebenversion der verwendeten Grafik-API.
Bei OpenGL lautet die Standardversion „ 2.0 “.
Hinweis: Dies gilt nur für OpenGL.
Siehe auch „ majorVersion “ und „ profile “.
profile : enumeration [read-only]
Diese Eigenschaft enthält das konfigurierte OpenGL-Kontextprofil.
Mögliche Werte sind:
| Konstant | Beschreibung |
|---|---|
GraphicsInfo.OpenGLNoProfile | (Standard) Die OpenGL-Version ist niedriger als 3.2 oder OpenGL wird nicht verwendet. |
GraphicsInfo.OpenGLCoreProfile | In OpenGL-Version 3.0 als veraltet markierte Funktionen sind nicht verfügbar. |
GraphicsInfo.OpenGLCompatibilityProfile | Funktionen aus früheren OpenGL-Versionen sind verfügbar. |
Wiederverwendbare QML-Komponenten verwenden diese Eigenschaft in der Regel in Bindungen, um zwischen Shader-Quellen zu wählen, die mit dem Core-Profil kompatibel sind, und solchen, die es nicht sind.
Hinweis: Dies gilt nur für OpenGL.
Siehe auch majorVersion, minorVersion und QSurfaceFormat.
renderableType : enumeration [read-only]
Diese Eigenschaft enthält den darstellbaren Typ. Der Wert hat für andere APIs als OpenGL keine Bedeutung.
Mögliche Werte sind:
| Konstante | Beschreibung |
|---|---|
GraphicsInfo.SurfaceFormatUnspecified | (Standard) Nicht spezifizierte Darstellungsmethode |
GraphicsInfo.SurfaceFormatOpenGL | Desktop-OpenGL oder eine andere Grafik-API |
GraphicsInfo.SurfaceFormatOpenGLES | OpenGL ES Hinweis: Dies gilt nur für OpenGL. |
Siehe auch QSurfaceFormat.
shaderCompilationType : enumeration [read-only, since QtQuick 2.8]
Diese Eigenschaft enthält eine Bitmaske der Shader-Kompilierungsansätze, die vom „ Qt Quick “-Backend unterstützt werden, das die Anwendung verwendet.
| Konstante | Wert |
|---|---|
GraphicsInfo.RuntimeCompilation | |
GraphicsInfo.OfflineCompilation |
Bei OpenGL lautet der Wert „ GraphicsInfo.RuntimeCompilation“, was der herkömmlichen Verwendung von „ ShaderEffect “ entspricht. Bei Nicht-OpenGL-Backends wird jedoch erwartet, dass der Schwerpunkt eher auf „ GraphicsInfo.OfflineCompilation“ liegt.
Hinweis: Der Wert ist erst dann aktuell, wenn das Element einem Fenster zugeordnet ist. Bindungen, die sich auf diesen Wert stützen, müssen dies berücksichtigen, da sich der Wert nach Abschluss der Komponenteninitialisierung von ` 0 ` auf die tatsächliche Bitmaske ändern kann. Dies ist insbesondere für ` ShaderEffect `-Elemente innerhalb von ` ShaderEffectSource `-Elementen relevant, die als Eigenschaftswerte festgelegt sind.
Diese Eigenschaft wurde in QtQuick 2.8 eingeführt.
Siehe auch „ shaderType “ und „ shaderSourceType “.
shaderSourceType : enumeration [read-only, since QtQuick 2.8]
Diese Eigenschaft enthält eine Bitmaske der unterstützten Methoden zur Bereitstellung von Shader-Quellen.
| Konstante | Wert |
|---|---|
GraphicsInfo.ShaderSourceString | |
GraphicsInfo.ShaderSourceFile | |
GraphicsInfo.ShaderByteCode |
Bei OpenGL lautet der Wert „ GraphicsInfo.ShaderSourceString“, was der herkömmlichen Methode entspricht, GLSL-Quellcode in QML einzubinden. Andere, nicht auf OpenGL Qt Quick -basierte Backends unterstützen jedoch möglicherweise keine eingebetteten Shader-Quellen oder gar keine Shader-Quellen. In diesem Fall wird erwartet, dass Shader vorab in Formate wie SPIR-V oder D3D-Shader-Bytecode kompiliert werden.
Hinweis: Der Wert ist erst dann aktuell, wenn das Element einem Fenster zugeordnet ist. Bindungen, die sich auf diesen Wert stützen, müssen dies berücksichtigen, da sich der Wert nach Abschluss der Komponenteninitialisierung von „ 0 “ zur tatsächlichen Bitmaske ändern kann. Dies ist insbesondere für „ ShaderEffect “-Elemente innerhalb von „ ShaderEffectSource “-Elementen relevant, die als Eigenschaftswerte festgelegt sind.
Diese Eigenschaft wurde in QtQuick 2.8 eingeführt.
Siehe auch „ shaderType “ und „ shaderCompilationType “.
shaderType : enumeration [read-only, since QtQuick 2.8]
Diese Eigenschaft enthält die Shading-Sprache, die vom „ Qt Quick “-Backend unterstützt wird, das die Anwendung verwendet.
| Konstante | Beschreibung |
|---|---|
GraphicsInfo.UnknownShadingLanguage | Noch nicht bekannt, da kein Fenster und kein Szenengraph zugeordnet sind |
GraphicsInfo.GLSL | GLSL oder GLSL ES |
GraphicsInfo.HLSL | HLSL |
GraphicsInfo.RhiShader | QShader Hinweis: Der Wert ist erst dann aktuell, wenn das Element einem Fenster zugeordnet ist. Bindungen, die auf diesem Wert basieren, müssen dies berücksichtigen, da sich der Wert nach Abschluss der Komponenteninitialisierung von „ GraphicsInfo.UnknownShadingLanguage“ auf den tatsächlichen Wert ändern kann. Dies ist insbesondere für „ ShaderEffect “-Elemente innerhalb von „ ShaderEffectSource “-Elementen relevant, die als Eigenschaftswerte festgelegt sind. |
Diese Eigenschaft wurde in QtQuick 2.8 eingeführt.
Siehe auch „ shaderCompilationType “ und „ 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.
