En esta página

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

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:

ConstanteDescripción
GraphicsInfo.Unknownel valor por defecto cuando no hay ningún grafo de escena activo asociado al elemento
GraphicsInfo.SoftwareQt QuickEl renderizador de software del elemento, basado en « QPainter » con el motor de pintura ráster
GraphicsInfo.OpenVGOpenVG
GraphicsInfo.OpenGLOpenGL u OpenGL ES sobre QRhi, una capa de abstracción gráfica
GraphicsInfo.Direct3D11Direct3D 11 sobre QRhi, una capa de abstracción gráfica
GraphicsInfo.Direct3D12Direct3D 12 sobre QRhi, una capa de abstracción gráfica
GraphicsInfo.VulkanVulkan sobre QRhi, una capa de abstracción gráfica
GraphicsInfo.MetalMetal sobre QRhi, una capa de abstracción gráfica
GraphicsInfo.NullNull (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:

ConstanteDescripción
GraphicsInfo.OpenGLNoProfile(por defecto) La versión de OpenGL es inferior a 3.2 o OpenGL no está en uso.
GraphicsInfo.OpenGLCoreProfileLas funciones obsoletas en la versión 3.0 de OpenGL no están disponibles.
GraphicsInfo.OpenGLCompatibilityProfileLas 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:

ConstanteDescripción
GraphicsInfo.SurfaceFormatUnspecified(por defecto) Método de representación no especificado
GraphicsInfo.SurfaceFormatOpenGLOpenGL de escritorio u otra API gráfica
GraphicsInfo.SurfaceFormatOpenGLESOpenGL 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.

ConstanteValor
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.

ConstanteValor
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.

ConstanteDescripción
GraphicsInfo.UnknownShadingLanguageAún se desconoce, ya que no hay ninguna ventana ni grafo de escena asociados
GraphicsInfo.GLSLGLSL o GLSL ES
GraphicsInfo.HLSLHLSL
GraphicsInfo.RhiShaderQShader

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.