GraphicsInfo QML Type
Proporciona información sobre el backend scenegraph y la API de gráficos utilizada por Qt Quick. Más...
| Import Statement: | import QtQuick |
| Since: | QtQuick 2.8 |
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 scenegraph y la API de gráficos utilizada para renderizar el contenido de la ventana asociada.
Si el elemento al que se adjuntan las propiedades no está asociado actualmente a ninguna ventana, las propiedades se establecen con los valores predeterminados. Cuando la ventana asociada cambia, las propiedades se actualizan.
Documentación de 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 un scenegraph activo asociado al elemento |
GraphicsInfo.Software | Qt Quick's software renderer based on QPainter con el motor de pintura raster |
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 de gráficos |
GraphicsInfo.Vulkan | Vulkan en la parte superior de QRhi, una capa de abstracción de gráficos |
GraphicsInfo.Metal | Metal sobre QRhi, una capa de abstracción gráfica |
GraphicsInfo.Null | Null (no output) 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 en uso.
Con OpenGL la versión por defecto es 2.0.
Nota: Esto sólo es aplicable a OpenGL.
Véase también minorVersion y profile.
minorVersion : int [read-only]
Esta propiedad contiene la versión menor de la API gráfica en uso.
Con OpenGL la versión por defecto es 2.0.
Nota: Esto sólo es aplicable a OpenGL.
Véase también majorVersion y profile.
profile : enumeration [read-only]
Esta propiedad contiene el perfil de contexto 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 | La funcionalidad obsoleta de la versión 3.0 de OpenGL no está disponible. |
GraphicsInfo.OpenGLCompatibilityProfile | La funcionalidad de versiones anteriores de OpenGL está disponible. |
Los componentes QML reutilizables suelen utilizar esta propiedad en los enlaces para elegir entre fuentes de sombreado compatibles con el perfil principal y no principales.
Nota: Esto sólo es aplicable a OpenGL.
Véase también majorVersion, minorVersion, y QSurfaceFormat.
renderableType : enumeration [read-only]
Esta propiedad contiene el tipo de renderizable. El valor no tiene significado para APIs distintas de OpenGL.
Los valores posibles son:
| Constante | Descripción |
|---|---|
GraphicsInfo.SurfaceFormatUnspecified | (por defecto) Método de renderizado no especificado |
GraphicsInfo.SurfaceFormatOpenGL | OpenGL de escritorio u otra API gráfica |
GraphicsInfo.SurfaceFormatOpenGLES | OpenGL ES |
Nota: Esto sólo 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 enfoques de compilación de shaders soportados por el backend Qt Quick que la aplicación está utilizando.
| Constante | Valor |
|---|---|
GraphicsInfo.RuntimeCompilation | |
GraphicsInfo.OfflineCompilation |
Con OpenGL el valor es GraphicsInfo.RuntimeCompilation, que corresponde a la forma tradicional de utilizar ShaderEffect. Sin embargo, se espera que los backends que no son OpenGL se centren más en GraphicsInfo.OfflineCompilation.
Nota: El valor sólo se actualiza una vez que el elemento está asociado a una ventana. Los enlaces que dependen de este valor deben tenerlo en cuenta, ya que el valor puede cambiar de 0 a la máscara de bits real una vez finalizada la inicialización del componente. Esto es particularmente relevante para 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 de las formas soportadas de proporcionar fuentes de sombreado.
| Constante | Valor |
|---|---|
GraphicsInfo.ShaderSourceString | |
GraphicsInfo.ShaderSourceFile | |
GraphicsInfo.ShaderByteCode |
Con OpenGL el valor es GraphicsInfo.ShaderSourceString, que corresponde a la forma tradicional de insertar el código fuente GLSL en QML. Sin embargo, otros backends de Qt Quick que no sean OpenGL pueden decidir no admitir fuentes de sombreado alineadas, o incluso no admitir fuentes de sombreado en absoluto. En este caso, se espera que los shaders estén precompilados en formatos como SPIR-V o D3D shader bytecode.
Nota: El valor sólo se actualiza una vez que el elemento está asociado a una ventana. Los enlaces que dependen del valor deben tener esto en cuenta, ya que el valor puede cambiar de 0 a la máscara de bits real una vez finalizada la inicialización del componente. Esto es particularmente relevante para 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 soportado por el backend Qt Quick que la aplicación está utilizando.
| Constante | Descripción |
|---|---|
GraphicsInfo.UnknownShadingLanguage | Aún no se conoce debido a que no hay ventana y scenegraph asociados |
GraphicsInfo.GLSL | GLSL o GLSL ES |
GraphicsInfo.HLSL | HLSL |
GraphicsInfo.RhiShader | QShader |
Nota: El valor sólo se actualiza una vez que el elemento está asociado a una ventana. Los enlaces que dependen de este valor deben tenerlo en cuenta, ya que el valor puede cambiar de GraphicsInfo.UnknownShadingLanguage al valor real una vez finalizada la inicialización del componente. Esto es particularmente relevante para 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.
