Qt Graphs Descripción general de 3D
El módulo Qt Graphs permite desarrollar gráficos 3D dinámicos, complejos y de respuesta rápida para sectores que requieren un alto nivel de análisis, como la investigación académica y el ámbito médico. Qt Graphs ofrece gráficos 3D de barras, de dispersión y de superficie. La combinación de la interacción del usuario con el trazado de gráficos 3D en tiempo real permite crear interfaces de usuario que aprovechan el espacio de forma eficaz. La posibilidad de alternar entre la presentación en 3D y en 2D permite aprovechar al máximo el valor del 3D en la visualización de datos.
El aspecto de los gráficos se puede personalizar utilizando los temas predefinidos o definiendo otros nuevos. Además, las escenas se pueden personalizar especificando ajustes para la cámara, y los elementos individuales se pueden personalizar utilizando mallas predefinidas o definidas por el usuario.
Qt Graphs Ofrece proxies de datos predefinidos que pueden utilizarse para visualizar datos procedentes de modelos de elementos Qt y mapas de altura. Cada tipo de gráfico tiene un tipo de proxy básico, que acepta datos en un formato adecuado para ese gráfico. Para obtener más información, consulta «Qt Graphs: Manejo de datos en 3D».
Los usuarios finales pueden interactuar con los datos presentados en los gráficos de varias formas, entre ellas: girar los gráficos, ampliar y reducir los datos, seleccionar elementos y visualizar secciones 2D de los datos 3D para una mayor legibilidad. Para obtener más información, consulte Qt Graphs Interactuar con datos en 3D.
Tipos de gráficos
El módulo Qt Graphs ofrece los siguientes tipos de gráficos en 3D:
La clase ` Q3DGraphsWidgetItem ` proporciona una API de widgets para sus propias subclases, ` Q3DBarsWidgetItem`, ` Q3DScatterWidgetItem` y ` Q3DSurfaceWidgetItem `, que implementan los diferentes tipos de gráficos: de barras, de dispersión y de superficie. El tipo de gráfico determina cómo se presentan los datos.
Todo el renderizado se lleva a cabo en ` QQuickGraphsItem`, que hereda de ` QQuick3DViewport`, la cual, a su vez, ofrece un ` View3D ` utilizando ` QtQuick3D`. Cuenta con sus propias subclases para ` Bars3D`, ` Scatter3D` y ` Surface3D`.
Gráficos de barras en 3D
Los gráficos de barras 3D presentan los datos como barras tridimensionales agrupadas por categorías. La clase ` Q3DGraphsWidgetItem ` se utiliza para crear un gráfico. Las clases ` QBar3DSeries ` y ` QBarDataProxy ` se utilizan para establecer los datos del gráfico y controlar sus propiedades visuales, como el modo de dibujo y el sombreado. En QML, los tipos correspondientes son ` Bars3D`, ` Bar3DSeries` y ` BarDataProxy`.

Para obtener más información, consulta los ejemplos « How to construct a minimal Q3DBarsWidgetItem graph » y «Simple Bar Graph ».
Gráficos de dispersión en 3D
Los gráficos de dispersión en 3D presentan los datos como un conjunto de puntos o una spline. La clase Q3DScatterWidgetItem se utiliza para crear un gráfico. Las clases QScatter3DSeries o QSpline3DSeries y QScatterDataProxy se utilizan para establecer los datos en el gráfico y para controlar las propiedades visuales del mismo. En QML, los tipos correspondientes son Scatter3D, Scatter3DSeries, Spline3DSeries y ScatterDataProxy.

Para obtener más información, consulta How to construct a minimal Q3DScatterWidgetItem graph y los ejemplos de gráficos de dispersión simples.
Gráficos de superficie 3D
Los gráficos de superficie 3D presentan los datos como gráficos de superficie tridimensionales. La clase ` Q3DSurfaceWidgetItem ` se utiliza para crear un gráfico. Las clases ` QSurface3DSeries ` y ` QSurfaceDataProxy ` se utilizan para establecer los datos del gráfico y controlar sus propiedades visuales. En QML, los tipos correspondientes son ` Surface3D`, ` Surface3DSeries` y ` SurfaceDataProxy`.

Para obtener más información, consulta How to construct a minimal Q3DSurfaceWidgetItem graph, la Galería de gráficos y los ejemplos de la Galería de gráficos de superficie.
Uso de OpenGL ES para renderizar datos
Qt Graphs se basa en QtQuick3D, lo que significa que Qt Graphs utiliza el backend nativo de la plataforma de destino para el renderizado. Sin embargo, si se acaba utilizando OpenGL ES2 en destinos que no admiten versiones superiores, como OpenGL ES3 o Vulkan, no se admiten las siguientes características:
- Objetos volumétricos, ya que utilizan texturas 3D
- Instanciación, lo que significa que QtGraphs3D::OptimizationHint::Default no funciona y, en su lugar, hay que utilizar QtGraphs3D::OptimizationHint::Legacy.
Selección del modo de renderizado
En QML, puedes configurar la propiedad ` GraphsItem3D.RenderingMode ` para determinar si el gráfico se renderizará directamente sobre el fondo de la ventana o en una superficie fuera de pantalla que luego se dibujará durante el renderizado normal de los elementos QML.
Los modos de representación en segundo plano ofrecen un rendimiento ligeramente superior al del modo de representación indirecta, a costa de un comportamiento de QML no estándar. Por ejemplo, los gráficos no admiten suavizado. Por lo tanto, cambiar el modo de representación es una cuestión de rendimiento frente a calidad.
Qt Quick utiliza un grafo de escena específico para el renderizado de datos y, por lo tanto, es la mejor opción para los gráficos.
Ejes 3D
Qt Graphs Admite los siguientes tipos de ejes:
- Eje de valores
- Eje de categoría
Un eje se puede configurar para mostrar una línea o una cuadrícula. Ambos tipos de ejes son especializaciones de la clase « QAbstract3DAxis » o del tipo QML « Abstract3DAxis ».
En el caso de un eje de valores, se puede establecer un rango de valores y el número de segmentos y subsegmentos para dividir dicho rango. De forma predeterminada, se dibujan etiquetas entre cada segmento. De forma predeterminada, se dibujan líneas de cuadrícula entre cada segmento y cada subsegmento. El eje de valores se implementa utilizando la clase ` QValue3DAxis ` o el tipo QML ` Value3DAxis `.
Un eje de categorías tiene rangos con nombre y anchos de rango ajustables. Se divide en categorías de igual tamaño en función del tamaño de la ventana de datos definido por el rango del eje. De forma predeterminada, se dibujan etiquetas en las posiciones de las categorías, si se han proporcionado. De forma predeterminada, se dibujan líneas de cuadrícula entre las categorías. Un eje de categorías se implementa utilizando la clase ` QCategory3DAxis ` o el tipo QML ` Category3DAxis `.
Si no se establecen ejes de forma explícita para un gráfico, se crean ejes predeterminados temporales sin etiquetas. Estos ejes predeterminados pueden modificarse mediante los accesores de ejes, pero tan pronto como se establece explícitamente cualquier eje para una orientación concreta, el eje predeterminado para esa orientación se elimina.
Todos los tipos de gráficos admiten la visualización simultánea de varias series. No es necesario que todas las series contengan el mismo número de filas y columnas. Las etiquetas de filas y columnas se toman de la primera serie añadida, a menos que se definan explícitamente para los ejes de filas y columnas.
Se pueden utilizar formateadores de ejes para personalizar las líneas de cuadrícula y las etiquetas del eje de valores. La clase ` QValue3DAxisFormatter ` y el tipo QML ` Value3DAxisFormatter ` proporcionan reglas de formato para un eje 3D de valores lineales. La clase ` QLogValue3DAxisFormatter ` y el tipo QML ` LogValue3DAxisFormatter ` proporcionan reglas de formato para un eje 3D de valores logarítmicos.
Los ejes horizontales polares se pueden utilizar para gráficos de superficie y de dispersión configurando la propiedad polar. También se puede configurar para gráficos de barras, pero al hacerlo se generará una advertencia y se ignorará.
Personalización de escenas 3D
Dado que « Qt Graphs » se basa en « QtQuick3D », es posible integrar escenas de « QtQuick3D » en escenas de « Qt Graphs ». Para obtener más información, consulta «Qt Graphs: Integración con 3D de Qt Quick ».
Personalización de elementos
Qt Graphs dispone de tipos de malla predefinidos para elementos de barra y de dispersión. El tipo de malla determina el aspecto que tiene un elemento de barra o de dispersión en un gráfico. También se puede especificar una geometría personalizada como archivo de malla. Para obtener más información, consulte QAbstract3DSeries::userDefinedMesh(). Para mayor variedad, se puede establecer un cuaternión para la rotación de la malla.
Además de personalizar elementos individuales, puedes utilizar la clase QCustom3DItem o el tipo QML Custom3DItem para añadir elementos personalizados a los gráficos. Los elementos tienen malla, posición, escala y rotación personalizadas, así como una textura opcional.
Utiliza la clase ` QCustom3DVolume ` y el tipo QML ` Custom3DVolume ` para crear objetos renderizados en volumen que se añadirán a un gráfico. Un objeto renderizado en volumen es una caja con una textura 3D. Se admiten tres planos de corte para el volumen, uno a lo largo de cada eje principal del mismo.
La clase ` QCustom3DLabel ` y el tipo QML ` Custom3DLabel ` permiten implementar etiquetas personalizadas con el texto, la fuente, la posición, el escalado y la rotación especificados. El tema activo determina los colores, los bordes y el fondo de las etiquetas.
Gestión de entradas personalizadas
Qt Graphs Implementa controladores de entrada predeterminados para acciones típicas como seleccionar, rotar y ampliar. Para implementar controladores de entrada personalizados en lugar de los predeterminados, sobrescribe las señales de entrada necesarias.
onTapped: {
// Disable the default input handler
unsetDefaultTapHandler()
// Implement own custom event handler
console.log("Custom tap event handler")
}© 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.