GraphicsInfo QML Type
Bietet Informationen über das Scenegraph-Backend und die von Qt Quick verwendete Grafik-API. Mehr...
| Import Statement: | import QtQuick |
| Since: | QtQuick 2.8 |
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)
Detaillierte Beschreibung
Der angehängte Typ GraphicsInfo liefert Informationen über das Scenegraph-Backend und die Grafik-API, die zum Rendern des Inhalts des zugehörigen Fensters verwendet wird.
Wenn das Element, dem die Eigenschaften zugeordnet sind, derzeit mit keinem Fenster verbunden ist, werden die Eigenschaften auf Standardwerte gesetzt. Wenn sich das zugehörige Fenster ändert, werden die Eigenschaften aktualisiert.
Eigenschaft Dokumentation
api : enumeration |
Diese Eigenschaft beschreibt die Grafik-API, die derzeit verwendet wird.
Die möglichen Werte sind:
| Konstante | Beschreibung |
|---|---|
GraphicsInfo.Unknown | der Standardwert, wenn dem Element keine aktive Szenengrafik zugeordnet ist |
GraphicsInfo.Software | Qt QuickDer Software-Renderer des Objekts basiert auf QPainter mit der Raster Paint Engine |
GraphicsInfo.OpenVG | OpenVG |
GraphicsInfo.OpenGL | OpenGL oder OpenGL ES auf der Grundlage von QRhi, einer Grafikabstraktionsschicht |
GraphicsInfo.Direct3D11 | Direct3D 11 auf der Grundlage von QRhi, einer Grafikabstraktionsebene |
GraphicsInfo.Direct3D12 | Direct3D 12 über QRhi, eine Grafikabstraktionsschicht |
GraphicsInfo.Vulkan | Vulkan über QRhi, eine Grafikabstraktionsschicht |
GraphicsInfo.Metal | Metal über QRhi, eine Grafikabstraktionsschicht |
GraphicsInfo.Null | Null (keine Ausgabe) oberhalb von QRhi, einer Grafikabstraktionsschicht |
majorVersion : int |
Diese Eigenschaft enthält die Hauptversion der verwendeten Grafik-API.
Bei OpenGL ist die Standardversion 2.0.
Hinweis: Dies gilt nur für OpenGL.
Siehe auch minorVersion und profile.
minorVersion : int |
Diese Eigenschaft enthält die Nebenversion der verwendeten Grafik-API.
Bei OpenGL ist die Standardversion 2.0.
Hinweis: Dies gilt nur für OpenGL.
Siehe auch majorVersion und profile.
profile : enumeration |
Diese Eigenschaft enthält das konfigurierte OpenGL-Kontextprofil.
Die möglichen Werte sind:
| Konstante | Beschreibung |
|---|---|
GraphicsInfo.OpenGLNoProfile | (Standard) OpenGL-Version ist niedriger als 3.2 oder OpenGL wird nicht verwendet. |
GraphicsInfo.OpenGLCoreProfile | Funktionen, die in OpenGL Version 3.0 veraltet sind, sind nicht verfügbar. |
GraphicsInfo.OpenGLCompatibilityProfile | Funktionalitäten aus früheren OpenGL-Versionen sind verfügbar. |
Wiederverwendbare QML-Komponenten werden diese Eigenschaft typischerweise in Bindungen verwenden, um zwischen Core- und nicht Core-Profil kompatiblen Shader-Quellen zu wählen.
Hinweis: Dies gilt nur für OpenGL.
Siehe auch majorVersion, minorVersion, und QSurfaceFormat.
renderableType : enumeration |
Diese Eigenschaft enthält den renderbaren Typ. Der Wert hat keine Bedeutung für andere APIs als OpenGL.
Die möglichen Werte sind:
| Konstante | Beschreibung |
|---|---|
GraphicsInfo.SurfaceFormatUnspecified | (Standard) Nicht spezifizierte Rendering-Methode |
GraphicsInfo.SurfaceFormatOpenGL | Desktop OpenGL oder andere Grafik-API |
GraphicsInfo.SurfaceFormatOpenGLES | OpenGL ES |
Hinweis: Dies gilt nur für OpenGL.
Siehe auch QSurfaceFormat.
shaderCompilationType : enumeration |
Diese Eigenschaft enthält eine Bitmaske der Shader-Kompilierungsansätze, die von dem Qt Quick Backend unterstützt werden, das die Anwendung verwendet.
| Konstante | Wert |
|---|---|
GraphicsInfo.RuntimeCompilation | |
GraphicsInfo.OfflineCompilation |
Bei OpenGL ist der Wert GraphicsInfo.RuntimeCompilation, was dem traditionellen Weg der Verwendung von ShaderEffect entspricht. Bei Nicht-OpenGL-Backends wird jedoch erwartet, dass sie sich mehr auf GraphicsInfo.OfflineCompilation konzentrieren.
Hinweis: Der Wert ist nur aktuell, wenn das Element mit einem Fenster verbunden ist. Bindungen, die sich auf den Wert verlassen, müssen dies berücksichtigen, da sich der Wert von 0 zur aktuellen Bitmaske ändern kann, nachdem die Initialisierung der Komponente abgeschlossen ist. Dies ist besonders relevant für ShaderEffect Elemente innerhalb von ShaderEffectSource Elementen, die als Eigenschaftswerte gesetzt sind.
Diese Eigenschaft wurde in QtQuick 2.8 eingeführt.
Siehe auch shaderType und shaderSourceType.
shaderSourceType : enumeration |
Diese Eigenschaft enthält eine Bitmaske der unterstützten Möglichkeiten zur Bereitstellung von Shader-Quellen.
| Konstante | Wert |
|---|---|
GraphicsInfo.ShaderSourceString | |
GraphicsInfo.ShaderSourceFile | |
GraphicsInfo.ShaderByteCode |
Bei OpenGL ist der Wert GraphicsInfo.ShaderSourceString, was dem traditionellen Weg des Inlinings von GLSL-Quellcode in QML entspricht. Andere, nicht-OpenGL Qt Quick Backends können sich jedoch entscheiden, keine Inline-Shader-Quellen oder überhaupt keine Shader-Quellen zu unterstützen. In diesem Fall wird erwartet, dass Shader in Formate wie SPIR-V oder D3D Shader Bytecode vorkompiliert werden.
Hinweis: Der Wert ist nur aktuell, wenn das Element mit einem Fenster verbunden ist. Bindungen, die sich auf den Wert verlassen, müssen dies berücksichtigen, da sich der Wert von 0 zur tatsächlichen Bitmaske ändern kann, nachdem die Initialisierung der Komponente abgeschlossen ist. Dies ist besonders relevant für ShaderEffect Elemente innerhalb von ShaderEffectSource Elementen, die als Eigenschaftswerte gesetzt sind.
Diese Eigenschaft wurde in QtQuick 2.8 eingeführt.
Siehe auch shaderType und shaderCompilationType.
shaderType : enumeration |
Diese Eigenschaft enthält die Schattierungssprache, die von dem Qt Quick Backend unterstützt wird, das die Anwendung verwendet.
| Konstante | Beschreibung |
|---|---|
GraphicsInfo.UnknownShadingLanguage | Noch nicht bekannt, da keine Fenster und Szenegraphen zugeordnet sind |
GraphicsInfo.GLSL | GLSL oder GLSL ES |
GraphicsInfo.HLSL | HLSL |
GraphicsInfo.RhiShader | QShader |
Hinweis: Der Wert ist nur aktuell, wenn das Element mit einem Fenster verknüpft ist. Bindungen, die sich auf den Wert verlassen, müssen dies berücksichtigen, da sich der Wert von GraphicsInfo.UnknownShadingLanguage auf den aktuellen Wert ändern kann, nachdem die Initialisierung der Komponente abgeschlossen ist. Dies ist besonders relevant für ShaderEffect Elemente innerhalb von ShaderEffectSource Elementen, die als Eigenschaftswerte gesetzt sind.
Diese Eigenschaft wurde in QtQuick 2.8 eingeführt.
Siehe auch shaderCompilationType und 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.
