GraphicsInfo QML Type (Uncreatable)
Fournit des informations sur le moteur de graphisme et l'API graphique utilisés par Qt Quick. En savoir plus...
| Import Statement: | import QtQuick |
| Since: | QtQuick 2.8 |
Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié en QML.
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 associé GraphicsInfo fournit des informations sur le backend du graphe de scène et l'API graphique utilisée pour afficher le contenu de la fenêtre associée.
Si l'élément auquel les propriétés sont associées n'est actuellement associé à aucune fenêtre, les propriétés prennent leurs valeurs par défaut. Lorsque la fenêtre associée change, les propriétés sont mises à jour.
Documentation des propriétés
api : enumeration [read-only]
Cette propriété décrit l'API graphique actuellement utilisée.
Les valeurs possibles sont :
| Constante | Description |
|---|---|
GraphicsInfo.Unknown | valeur par défaut lorsqu'aucun graphe de scène actif n'est associé à l'élément |
GraphicsInfo.Software | Qt QuickLe moteur de rendu logiciel basé sur QPainter avec le moteur de peinture raster |
GraphicsInfo.OpenVG | OpenVG |
GraphicsInfo.OpenGL | OpenGL ou OpenGL ES s’appuyant sur l’ QRhi, une couche d’abstraction graphique |
GraphicsInfo.Direct3D11 | Direct3D 11 s'appuyant sur l'QRhi, une couche d'abstraction graphique |
GraphicsInfo.Direct3D12 | Direct3D 12 s'appuyant sur QRhi, une couche d'abstraction graphique |
GraphicsInfo.Vulkan | Vulkan s'appuyant sur QRhi, une couche d'abstraction graphique |
GraphicsInfo.Metal | Metal s'appuyant sur QRhi, une couche d'abstraction graphique |
GraphicsInfo.Null | Null (aucune sortie) au-dessus d'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 : cela 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 : cela 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 obsolètes 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 utilisent généralement cette propriété dans les liaisons afin de choisir entre des sources de shaders compatibles avec le profil de base et celles compatibles avec les profils non de base.
Remarque : ceci s'applique uniquement à OpenGL.
Voir également majorVersion, minorVersion et QSurfaceFormat.
renderableType : enumeration [read-only]
Cette propriété contient le type de rendu. Sa 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 | OpenGL pour ordinateur de bureau ou autre API graphique |
GraphicsInfo.SurfaceFormatOpenGLES | OpenGL ES Remarque : ceci s'applique uniquement à OpenGL. |
Voir également QSurfaceFormat.
shaderCompilationType : enumeration [read-only, since QtQuick 2.8]
Cette propriété contient un masque de bits indiquant les méthodes 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 à l’utilisation traditionnelle de ShaderEffect. Les backends non OpenGL devraient toutefois privilégier GraphicsInfo.OfflineCompilation.
Remarque : la valeur n’est à jour qu’une fois que l’élément est associé à une fenêtre. Les liaisons qui s’appuient sur cette valeur doivent en tenir compte, car celle-ci peut passer de ` 0 ` au masque de bits réel une fois l’initialisation du composant terminée. Cela concerne particulièrement les éléments ` ShaderEffect ` situés à l’intérieur d’é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 représentant les méthodes prises en charge pour fournir les sources des shaders.
| Constante | Valeur |
|---|---|
GraphicsInfo.ShaderSourceString | |
GraphicsInfo.ShaderSourceFile | |
GraphicsInfo.ShaderByteCode |
Avec OpenGL, la valeur est ` GraphicsInfo.ShaderSourceString`, ce qui correspond à la méthode traditionnelle consistant à intégrer le code source GLSL directement dans le QML. D’autres backends d’ Qt Quick, autres qu’OpenGL, peuvent toutefois décider de ne pas prendre en charge les sources de shaders intégrées, voire de ne pas prendre en charge les sources de shaders du tout. Dans ce cas, les shaders doivent être précompilés dans des formats tels que SPIR-V ou le bytecode de shader D3D.
Remarque : la valeur n’est à jour qu’une fois l’élément associé à une fenêtre. Les liaisons s’appuyant sur cette valeur doivent en tenir compte, car celle-ci peut passer d’ 0 au masque de bits réel une fois l’initialisation du composant terminée. Cela concerne en particulier les éléments « ShaderEffect » situés à l’intérieur d’é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 de shading pris en charge par le backend « Qt Quick » utilisé par l'application.
| Constante | Description |
|---|---|
GraphicsInfo.UnknownShadingLanguage | Inconnue pour l'instant, car aucune fenêtre ni aucun graphe de scène n'est associé |
GraphicsInfo.GLSL | GLSL ou GLSL ES |
GraphicsInfo.HLSL | HLSL |
GraphicsInfo.RhiShader | QShader Remarque : la valeur n’est à jour qu’une fois l’élément associé à une fenêtre. Les liaisons qui s’appuient sur cette valeur doivent en tenir compte, car celle-ci peut passer de « GraphicsInfo.UnknownShadingLanguage » à sa valeur réelle une fois l’initialisation du composant terminée. Cela concerne notamment les éléments « ShaderEffect » situés à l’intérieur d’é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.
