Qt Data Visualization Descripción general
El módulo « Qt Data Visualization » ofrece una forma de desarrollar visualizaciones 3D dinámicas, complejas 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 3D La visualización de datos ofrece gráficos de barras, de dispersión y de superficie en 3D. La combinación de la interacción del usuario con las visualizaciones de dibujo 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 plenamente 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 Data Visualization Ofrece proxies de datos ya preparados que pueden utilizarse para visualizar datos procedentes de modelos de elementos Qt y mapas de altura. Cada tipo de gráfico cuenta con un tipo de proxy básico, que acepta datos en un formato adecuado para esa visualización. Para obtener más información, consulte «Qt Data Visualization: Manejo de datos».
Los usuarios finales pueden interactuar con los datos presentados en los gráficos de varias formas, como girar los gráficos, ampliar y reducir los datos, seleccionar elementos y visualizar cortes en 2D de los datos en 3D para una mayor legibilidad. Para obtener más información, consulta «Qt Data Visualization: Interacción con los datos».
Nota: El módulo Qt Data Visualization ha quedado obsoleto desde Qt 6.10. Para proyectos nuevos, utilice en su lugar el Qt Graphs . Qt Graphs utiliza el motor de renderizado nativo de cada plataforma (Metal en macOS, DirectX en Windows, OpenGL o Vulkan en Linux) para lograr un renderizado acelerado por hardware tanto para gráficos 2D como 3D. Para migrar del módulo « Qt Data Visualization » al módulo « Qt Graphs », consulta «Qt Graphs: Migración desde Qt DataVisualization » o el curso de Qt Academy «Migración a Qt Graphs ».
Tipos de gráficos
El módulo « Qt Data Visualization » ofrece los siguientes tipos de gráficos en 3D:
La clase `QAbstract3DGraph` es una subclase de ` QWindow ` y proporciona un bucle de renderizado para sus propias subclases que implementan los diferentes tipos de gráficos: `Q3DBars`, `Q3DScatter` y `Q3DSurface`. El tipo de gráfico determina cómo se presentan los datos.
Gráficos de barras en 3D
Los gráficos de barras 3D presentan los datos como barras tridimensionales agrupadas por categorías. La clase `Q3DBars` se utiliza para crear un gráfico, mientras que las clases `QBar3DSeries` y `QBarDataProxy` sirven para asignar datos al gráfico, así como para 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 Q3DBars graph » y «Simple Bar Graph ».
Gráficos de dispersión en 3D
Los gráficos de dispersión 3D presentan los datos como un conjunto de puntos. La clase Q3DScatter se utiliza para crear un gráfico, y las clases QScatter3DSeries y QScatterDataProxy se utilizan para establecer los datos del gráfico, así como para controlar sus propiedades visuales. En QML, los tipos correspondientes son Scatter3D, Scatter3DSeries y ScatterDataProxy.

Para obtener más información, consulta los ejemplos « How to construct a minimal Q3DScatter graph » y «Simple Scatter Graph ».
Gráficos de superficie en 3D
Los gráficos de superficie 3D presentan los datos como representaciones de superficie tridimensionales. La clase Q3DSurface se utiliza para crear un gráfico, mientras que las clases QSurface3DSeries y QSurfaceDataProxy se utilizan para introducir datos en el gráfico, así como para controlar sus propiedades visuales. En QML, los tipos correspondientes son Surface3D, Surface3DSeries y SurfaceDataProxy.

Para obtener más información, consulta los ejemplos « How to construct a minimal Q3DSurface graph », «Graph Gallery» y «Surface Graph Gallery ».
Uso de OpenGL para el renderizado de datos
Se recomienda utilizar OpenGL 2.1 o una versión posterior para el renderizado de datos. Si se utiliza OpenGL ES2 (incluidas las compilaciones de Angle en Windows), no se admiten las siguientes características:
- Sombras
- Suavizado
- Sombreado plano para superficies
- Objetos volumétricos, ya que utilizan texturas 3D
Solo está disponible la emulación de OpenGL ES2 para el renderizador de software (es decir, cuando se utiliza « QCoreApplication::setAttribute » (Qt::AA_UseSoftwareOpenGL)).
Selección del modo de renderizado
En QML, puedes configurar la propiedad ` AbstractGraph3D.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 respetan el orden z de los elementos QML y no pueden ser parcialmente transparentes. 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 dedicado para la representación de datos y, por lo tanto, es la mejor opción para la visualización de datos.
Ejes 3D
Qt Data Visualization admite los siguientes tipos de ejes:
- Eje de valores
- Eje de categoría
Un eje puede configurarse para mostrar una línea o una cuadrícula. Ambos tipos de eje son especializaciones de la clase QAbstract3DAxis o del tipo QML AbstractAxis3D.
A un eje de valores se le puede asignar un rango de valores y el número de segmentos y subsegmentos en los que se dividirá dicho rango. Las etiquetas se dibujan entre cada segmento. Las líneas de cuadrícula se dibujan entre cada segmento y cada subsegmento. El eje de valores se implementa utilizando la clase QValue3DAxis o el tipo QML ValueAxis3D.
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. Las etiquetas se dibujan en las posiciones de las categorías, si se han proporcionado. Las líneas de cuadrícula se dibujan entre las categorías, si están visibles. Un eje de categorías se implementa mediante la clase QCategory3DAxis o el tipo QML CategoryAxis3D.
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 de los ejes de valores. La clase `QValue3DAxisFormatter` y el tipo QML `ValueAxis3DFormatter` proporcionan reglas de formato para un eje 3D de valores lineales. La clase `QLogValue3DAxisFormatter` y el tipo QML `LogValueAxis3DFormatter` 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 ».
Temas 3D
Un tema es una colección integrada de ajustes relacionados con el estilo de la interfaz de usuario que se aplican a todos los elementos visuales de un gráfico, como los colores, las fuentes y la visibilidad de los elementos, así como la intensidad de la luz y la luz ambiental.
Qt Charts Incluye los siguientes temas predefinidos que pueden utilizarse como base para crear temas personalizados:
- Qt es un tema claro con el verde como color base.
- «Colores primarios » es un tema claro con el amarillo como color base.
- «Digia» es un tema claro con el gris como color base.
- «Stone moss» es un tema de oscuridad media con el amarillo como color base.
- «Army blue» es un tema de luminosidad media con el azul como color base.
- «Retro» es un tema medio claro con el marrón como color base.
- «Ebony» es un tema oscuro con el blanco como color base.
- «Isabelle» es un tema oscuro con el amarillo como color base.
- «User defined» es el tema predeterminado, pensado para ser personalizado. Para obtener más información, consulta Default Theme.
También se pueden crear temas personalizados desde cero.
Si un gráfico muestra los datos de varias series de datos, se pueden especificar algunos ajustes por separado para cada serie. Por ejemplo, se pueden especificar diferentes degradados para las distintas capas del gráfico con el fin de que tenga un aspecto más realista. Para ver un ejemplo, consulta la Galería de gráficos de superficie.
Personalización de escenas 3D
Una escena 3D se implementa utilizando la clase Q3DScene o el tipo QML Scene3D. Una escena contiene una única cámara activa, implementada mediante la clase Q3DCamera o el tipo Camera3D, y una única fuente de luz activa, implementada mediante la clase Q3DLight o el tipo Light3D. La fuente de luz siempre se sitúa en relación con la cámara. Por defecto, la posición de la luz sigue automáticamente a la cámara.
La cámara se puede personalizar especificando su posición preestablecida, su rotación y su nivel de zoom. Para ver un ejemplo, consulta «Gráfico de dispersión sencillo».
Personalización de elementos
Qt Data Visualization dispone de tipos de malla predefinidos para barras, elementos y superficies. El tipo de malla determina el aspecto que tiene una barra, un elemento o una superficie en un gráfico. Se puede especificar una malla definida por el usuario como un archivo de definición geométrica Wavefront OBJ. Para mayor variedad, se puede establecer un cuaternión para la rotación de la malla.
Además de personalizar elementos individuales, se puede utilizar la clase QCustom3DItem o el tipo QML Custom3DItem para añadir elementos personalizados a los gráficos. Los elementos tienen una malla personalizada, posición, escala, rotación y una textura opcional.
La clase QCustom3DVolume y el tipo QML Custom3DVolume pueden utilizarse 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 implementan etiquetas personalizadas con el texto, la fuente, la posición, la escala y la rotación especificados. Los colores de las etiquetas, los bordes y el fondo vienen determinados por el tema activo.
© 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.