GraphicsInfo QML Type
Fournit des informations sur le backend scenegraph et l'API graphique utilisés par Qt Quick. Plus d'informations...
| Import Statement: | import QtQuick |
| Since: | QtQuick 2.8 |
Propriétés
- 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)
Description détaillée
Le type GraphicsInfo attaché fournit des informations sur le backend scenegraph et l'API graphique utilisée pour rendre le contenu de la fenêtre associée.
Si l'élément auquel les propriétés sont attachées n'est actuellement associé à aucune fenêtre, les propriétés sont définies sur des valeurs par défaut. Lorsque la fenêtre associée change, les propriétés sont mises à jour.
Documentation sur les propriétés
api : enumeration [read-only]
Cette propriété décrit l'API graphique actuellement utilisée.
Les valeurs possibles sont les suivantes
| Constante | Description |
|---|---|
GraphicsInfo.Unknown | la valeur par défaut lorsqu'aucun graphique de scène actif n'est associé à l'élément |
GraphicsInfo.Software | Qt QuickLe moteur de rendu logiciel d'OpenVG est basé sur QPainter avec le moteur de peinture matricielle. |
GraphicsInfo.OpenVG | OpenVG |
GraphicsInfo.OpenGL | OpenGL ou OpenGL ES au-dessus de QRhi, une couche d'abstraction graphique |
GraphicsInfo.Direct3D11 | Direct3D 11 au-dessus de QRhi, une couche d'abstraction graphique |
GraphicsInfo.Direct3D12 | Direct3D 12 sur QRhi, une couche d'abstraction graphique |
GraphicsInfo.Vulkan | Vulkan au-dessus de QRhi, une couche d'abstraction graphique |
GraphicsInfo.Metal | Metal au-dessus de QRhi, une couche d'abstraction graphique |
GraphicsInfo.Null | Null (pas de sortie) au-dessus de QRhi, une couche d'abstraction graphique |
majorVersion : int [read-only]
Cette propriété contient la version majeure de l'API graphique utilisée.
Avec OpenGL, la version par défaut est 2.0.
Remarque : cette propriété ne s'applique qu'à OpenGL.
Voir également minorVersion et profile.
minorVersion : int [read-only]
Cette propriété contient la version mineure de l'API graphique utilisée.
Avec OpenGL, la version par défaut est 2.0.
Remarque : cette propriété ne s'applique qu'à OpenGL.
Voir également majorVersion et profile.
profile : enumeration [read-only]
Cette propriété contient le profil de contexte OpenGL configuré.
Les valeurs possibles sont les suivantes
| Constante | Description |
|---|---|
GraphicsInfo.OpenGLNoProfile | (par défaut) La version d'OpenGL est inférieure à 3.2 ou OpenGL n'est pas utilisé. |
GraphicsInfo.OpenGLCoreProfile | Les fonctionnalités dépréciées dans la version 3.0 d'OpenGL ne sont pas disponibles. |
GraphicsInfo.OpenGLCompatibilityProfile | Les fonctionnalités des versions antérieures d'OpenGL sont disponibles. |
Les composants QML réutilisables utiliseront généralement cette propriété dans les bindings afin de choisir entre les sources de shaders compatibles avec le profil core et celles qui ne le sont pas.
Remarque : cette propriété ne s'applique qu'à OpenGL.
Voir aussi majorVersion, minorVersion, et QSurfaceFormat.
renderableType : enumeration [read-only]
Cette propriété contient le type de rendu. Cette valeur n'a aucune signification pour les API autres qu'OpenGL.
Les valeurs possibles sont les suivantes
| Constante | Description |
|---|---|
GraphicsInfo.SurfaceFormatUnspecified | (par défaut) Méthode de rendu non spécifiée |
GraphicsInfo.SurfaceFormatOpenGL | Desktop OpenGL ou autre API graphique |
GraphicsInfo.SurfaceFormatOpenGLES | OpenGL ES |
Note : Ceci n'est applicable qu'à OpenGL.
Voir aussi QSurfaceFormat.
shaderCompilationType : enumeration [read-only, since QtQuick 2.8]
Cette propriété contient un masque de bits des approches de compilation des shaders prises en charge par le backend Qt Quick utilisé par l'application.
| Constante | Valeur |
|---|---|
GraphicsInfo.RuntimeCompilation | |
GraphicsInfo.OfflineCompilation |
Avec OpenGL, la valeur est GraphicsInfo.RuntimeCompilation, ce qui correspond à la manière traditionnelle d'utiliser ShaderEffect. Les backends non-OpenGL devraient cependant se concentrer davantage sur GraphicsInfo.OfflineCompilation.
Note : La valeur n'est mise à jour que lorsque l'élément est associé à une fenêtre. Les liaisons qui s'appuient sur cette valeur doivent garder cela à l'esprit car la valeur peut passer de 0 au masque de bits actuel une fois que l'initialisation du composant est terminée. Ceci est particulièrement important pour les éléments ShaderEffect à l'intérieur des éléments ShaderEffectSource définis comme valeurs de propriété.
Cette propriété a été introduite dans QtQuick 2.8.
Voir également shaderType et shaderSourceType.
shaderSourceType : enumeration [read-only, since QtQuick 2.8]
Cette propriété contient un masque de bits des moyens pris en charge pour fournir des sources de shaders.
| Constante | Valeur |
|---|---|
GraphicsInfo.ShaderSourceString | |
GraphicsInfo.ShaderSourceFile | |
GraphicsInfo.ShaderByteCode |
Avec OpenGL, la valeur est GraphicsInfo.ShaderSourceString, ce qui correspond à la manière traditionnelle d'intégrer le code source GLSL dans QML. D'autres backends Qt Quick non OpenGL peuvent cependant décider de ne pas prendre en charge les sources de shaders intégrées, ou même les sources de shaders tout court. Dans ce cas, les shaders doivent être précompilés dans des formats tels que SPIR-V ou D3D shader bytecode.
Remarque : la valeur n'est mise à jour que lorsque l'élément est associé à une fenêtre. Les liaisons qui s'appuient sur cette valeur doivent en tenir compte, car la valeur peut passer de 0 au masque de bits réel une fois l'initialisation du composant terminée. Ceci est particulièrement important pour les éléments ShaderEffect à l'intérieur des éléments ShaderEffectSource définis comme valeurs de propriété.
Cette propriété a été introduite dans QtQuick 2.8.
Voir également shaderType et shaderCompilationType.
shaderType : enumeration [read-only, since QtQuick 2.8]
Cette propriété contient le langage d'ombrage pris en charge par le backend Qt Quick utilisé par l'application.
| Constante | Description de la propriété |
|---|---|
GraphicsInfo.UnknownShadingLanguage | Pas encore connu car il n'y a pas de fenêtre et de graphe de scène associés. |
GraphicsInfo.GLSL | GLSL ou GLSL ES |
GraphicsInfo.HLSL | HLSL |
GraphicsInfo.RhiShader | QShader |
Remarque : la valeur n'est mise à jour que lorsque l'élément est associé à une fenêtre. Les liaisons qui s'appuient sur cette valeur doivent en tenir compte, car la valeur peut passer de GraphicsInfo.UnknownShadingLanguage à la valeur réelle une fois l'initialisation du composant terminée. Ceci est particulièrement important pour les éléments ShaderEffect à l'intérieur des éléments ShaderEffectSource définis comme valeurs de propriété.
Cette propriété a été introduite dans QtQuick 2.8.
Voir également shaderCompilationType et 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.
