GraphicsInfo QML Type (Uncreatable)
Proporciona información sobre el motor de gráficos y la API gráfica que utiliza Qt Quick. Más información...
| Import Statement: | import QtQuick |
| Since: | QtQuick 2.8 |
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
Propiedades
- 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)
Descripción detallada
El tipo adjunto GraphicsInfo proporciona información sobre el backend del grafo de escena y la API gráfica utilizada para renderizar el contenido de la ventana asociada.
Si el elemento al que se asocian las propiedades no está asociado actualmente a ninguna ventana, las propiedades se establecen en sus valores por defecto. Cuando cambie la ventana asociada, las propiedades se actualizarán.
Documentación de las propiedades
api : enumeration [read-only]
Esta propiedad describe la API gráfica que se está utilizando actualmente.
Los valores posibles son:
| Constante | Descripción |
|---|---|
GraphicsInfo.Unknown | el valor por defecto cuando no hay ningún grafo de escena activo asociado al elemento |
GraphicsInfo.Software | Qt QuickEl renderizador de software del elemento, basado en « QPainter » con el motor de pintura ráster |
GraphicsInfo.OpenVG | OpenVG |
GraphicsInfo.OpenGL | OpenGL u OpenGL ES sobre QRhi, una capa de abstracción gráfica |
GraphicsInfo.Direct3D11 | Direct3D 11 sobre QRhi, una capa de abstracción gráfica |
GraphicsInfo.Direct3D12 | Direct3D 12 sobre QRhi, una capa de abstracción gráfica |
GraphicsInfo.Vulkan | Vulkan sobre QRhi, una capa de abstracción gráfica |
GraphicsInfo.Metal | Metal sobre QRhi, una capa de abstracción gráfica |
GraphicsInfo.Null | Null (sin salida) sobre QRhi, una capa de abstracción gráfica |
majorVersion : int [read-only]
Esta propiedad contiene la versión principal de la API gráfica que se está utilizando.
Con OpenGL, la versión predeterminada es 2.0.
Nota: Esto solo es aplicable a OpenGL.
Véase también minorVersion y profile.
minorVersion : int [read-only]
Esta propiedad contiene la versión secundaria de la API gráfica que se está utilizando.
Con OpenGL, la versión predeterminada es 2.0.
Nota: Esto solo es aplicable a OpenGL.
Véase también majorVersion y profile.
profile : enumeration [read-only]
Esta propiedad contiene el perfil del contexto de OpenGL configurado.
Los valores posibles son:
| Constante | Descripción |
|---|---|
GraphicsInfo.OpenGLNoProfile | (por defecto) La versión de OpenGL es inferior a 3.2 o OpenGL no está en uso. |
GraphicsInfo.OpenGLCoreProfile | Las funciones obsoletas en la versión 3.0 de OpenGL no están disponibles. |
GraphicsInfo.OpenGLCompatibilityProfile | Las funcionalidades de versiones anteriores de OpenGL están disponibles. |
Los componentes QML reutilizables suelen utilizar esta propiedad en los enlaces para elegir entre fuentes de sombreadores compatibles con el perfil básico y con el perfil no básico.
Nota: Esto solo es aplicable a OpenGL.
Véase también majorVersion, minorVersion y QSurfaceFormat.
renderableType : enumeration [read-only]
Esta propiedad contiene el tipo renderizable. El valor no tiene ningún significado para las API distintas de OpenGL.
Los valores posibles son:
| Constante | Descripción |
|---|---|
GraphicsInfo.SurfaceFormatUnspecified | (por defecto) Método de representación no especificado |
GraphicsInfo.SurfaceFormatOpenGL | OpenGL de escritorio u otra API gráfica |
GraphicsInfo.SurfaceFormatOpenGLES | OpenGL ES Nota: Esto solo es aplicable a OpenGL. |
Véase también QSurfaceFormat.
shaderCompilationType : enumeration [read-only, since QtQuick 2.8]
Esta propiedad contiene una máscara de bits de los métodos de compilación de shaders compatibles con el backend « Qt Quick » que utiliza la aplicación.
| Constante | Valor |
|---|---|
GraphicsInfo.RuntimeCompilation | |
GraphicsInfo.OfflineCompilation |
Con OpenGL, el valor es ` GraphicsInfo.RuntimeCompilation`, lo que se corresponde con la forma tradicional de utilizar ` ShaderEffect`. Sin embargo, se espera que los backends que no sean de OpenGL se centren más en ` GraphicsInfo.OfflineCompilation`.
Nota: El valor solo está actualizado una vez que el elemento se ha asociado a una ventana. Los enlaces que dependan de este valor deben tener esto en cuenta, ya que el valor puede cambiar de ` 0 ` a la máscara de bits real una vez completada la inicialización del componente. Esto es especialmente relevante para los elementos ` ShaderEffect ` dentro de elementos ` ShaderEffectSource ` establecidos como valores de propiedad.
Esta propiedad se introdujo en QtQuick 2.8.
Véase también shaderType y shaderSourceType.
shaderSourceType : enumeration [read-only, since QtQuick 2.8]
Esta propiedad contiene una máscara de bits que indica las formas compatibles de proporcionar los códigos fuente de los shaders.
| Constante | Valor |
|---|---|
GraphicsInfo.ShaderSourceString | |
GraphicsInfo.ShaderSourceFile | |
GraphicsInfo.ShaderByteCode |
Con OpenGL, el valor es ` GraphicsInfo.ShaderSourceString`, lo que se corresponde con la forma tradicional de integrar el código fuente GLSL directamente en QML. Sin embargo, otros backends de « Qt Quick » que no sean OpenGL pueden decidir no admitir fuentes de shaders integradas, o incluso no admitir fuentes de shaders en absoluto. En este caso, se espera que los sombreadores estén precompilados en formatos como SPIR-V o el código de bytes de sombreadores D3D.
Nota: El valor solo está actualizado una vez que el elemento se ha asociado a una ventana. Los enlaces que dependan de este valor deben tener esto en cuenta, ya que el valor puede cambiar de 0 a la máscara de bits real una vez completada la inicialización del componente. Esto es especialmente relevante para los elementos « ShaderEffect » dentro de elementos « ShaderEffectSource » establecidos como valores de propiedad.
Esta propiedad se introdujo en QtQuick 2.8.
Véase también « shaderType » y « shaderCompilationType ».
shaderType : enumeration [read-only, since QtQuick 2.8]
Esta propiedad contiene el lenguaje de sombreado compatible con el backend « Qt Quick » que utiliza la aplicación.
| Constante | Descripción |
|---|---|
GraphicsInfo.UnknownShadingLanguage | Aún se desconoce, ya que no hay ninguna ventana ni grafo de escena asociados |
GraphicsInfo.GLSL | GLSL o GLSL ES |
GraphicsInfo.HLSL | HLSL |
GraphicsInfo.RhiShader | QShader Nota: El valor solo está actualizado una vez que el elemento se ha asociado a una ventana. Los enlaces que dependan de este valor deben tener esto en cuenta, ya que el valor puede cambiar de ` GraphicsInfo.UnknownShadingLanguage` al valor real una vez completada la inicialización del componente. Esto es especialmente relevante para los elementos ` ShaderEffect ` dentro de elementos ` ShaderEffectSource ` establecidos como valores de propiedad. |
Esta propiedad se introdujo en QtQuick 2.8.
Véase también shaderCompilationType y 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.