Panel de control de la turbina eólica
Un panel de control de un aerogenerador con gráficos en 2D y 3D.
El ejemplo «Cuadro de mando de una turbina eólica» muestra cómo utilizar gráficos tanto en 2D como en 3D en una aplicación simulada del mundo real.

Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en « Examples ». Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Descripción general de la aplicación
El ejemplo muestra un panel de control de aerogeneradores, denominado «Aerospace Hub», que muestra datos simulados de un parque eólico imaginario. Se emplean diversos tipos de gráficos para visualizar diferentes clases de datos. Por ejemplo, un gráfico 2D con una serie de splines ilustra la potencia generada por hora, mientras que una serie de área adjunta representa la potencia acumulada durante el mismo periodo. Hay disponibles múltiples vistas de datos, lo que permite a los usuarios explorar y analizar la información desde diferentes perspectivas.
La interfaz principal cuenta con una barra de herramientas de configuración a la izquierda. Dependiendo del modo seleccionado, el diseño puede incluir un panel de estado, un panel de control con gráficos más pequeños, un gráfico principal de gran tamaño o un panel de configuración detallado, ya sea de forma individual o combinada. Este diseño flexible permite a los usuarios personalizar su vista y centrarse en los datos más relevantes para su análisis actual.
Vista de panel de control
La vista de panel de control presenta el estado actual del sistema junto con un panel desplazable que muestra vistas previas en miniatura de los distintos gráficos. Se muestran hasta cuatro gráficos simultáneamente, lo que permite a los usuarios navegar cómodamente por las seis visualizaciones disponibles y evaluar rápidamente las métricas clave de rendimiento de un solo vistazo.

Vista detallada
La vista detallada, a la que se accede seleccionando un gráfico en miniatura del panel de control, permite a los usuarios examinar la visualización elegida con mayor profundidad y a mayor escala. Dependiendo del tipo de gráfico, los usuarios pueden ampliar, desplazar o rotar la vista para explorar los datos de forma interactiva. Además, al pasar el cursor por encima de puntos de datos individuales o hacer clic en ellos, se muestra información más detallada sobre el elemento específico de interés.

Vista de configuración
La vista de configuración, a la que se accede haciendo clic en el botón de configuración de la barra de herramientas o en un gráfico en miniatura, permite a los usuarios ajustar el tema visual de los gráficos y modificar los ajustes específicos de cada tipo de gráfico. Algunas configuraciones se mantienen tras salir de la vista de configuración, mientras que otras solo se aplican dentro de la vista actual, lo que ofrece flexibilidad tanto para ajustes temporales como permanentes.

Simulación de datos
Todos los datos de los gráficos se generan mediante una jerarquía de clases de simulador implementadas en C++. La clase base, ` DataSimulator`, genera valores aleatorios dentro de un rango configurable de ` min ` a ` max `. La propiedad ` order ` controla si la secuencia es ` Ascending`, ` Descending` o ` NotSorted`, y la propiedad ` deviation ` limita en qué medida cada valor puede diferir del anterior. Cuando « live » se establece en « true », los datos se actualizan automáticamente en el intervalo especificado por « updatePeriod ». Las actualizaciones se ejecutan en un hilo de fondo dedicado, simulando una fuente de datos real.
Cada subclase es un elemento QML destinado a un tipo de serie específico:
LineSimulator— rellena QSplineSeries con los valores generados.BarSimulator— rellena QBarSeries, agrupando los valores en conjuntos de barras según la propiedadnumberOfCategory.PieSimulator— rellena QPieSeries, creando una sección por cada valor generado.Data3DSimulator— alimenta un `SimulatedDataModel` (`QAbstractListModel`) utilizado por los tipos de gráficos 3D. Las propiedades `numberOfRows` y `numberOfColumns` definen las dimensiones de la cuadrícula de los datos.
Detalles de implementación
Todo en la aplicación se ha diseñado de forma modular. La vista principal, que es el archivo « Main.qml », es un « ApplicationWindow », que instancia los simuladores de datos para cada gráfico, así como el « Item » raíz que contiene todos los elementos de la interfaz de usuario.
El FontLoader se utiliza para aplicar una fuente global a toda la interfaz de usuario.
ApplicationWindow {
...
FontLoader { ... }
font.family: interFont.name
// Data simulators
PieSimulator {
id: piesim
...
}
BarSimulator {
id: barsim
...
}
LineSimulator {
id: linesim
...
}
Data3DSimulator {
id: barDataSimulator
...
}
Data3DSimulator {
id: scatterDataSimulator
...
}
Data3DSimulator {
id: surfaceDataSimulator
...
}
// Root item
Item {...}
}El elemento raíz contiene los gráficos de fondo y un « Layout » que se encarga de la colocación de cada elemento de la interfaz de usuario en la vista:
// Background image
Image {
anchors.fill: parent
source: root.state === "ShowSettings" ? "images/settings-bg.png"
: "images/dashboard-bg.png"
fillMode: Image.PreserveAspectCrop
}
// Everything except background image
ColumnLayout {
anchors.fill: parent
...La mayoría de los elementos se han extraído del propio archivo « Main.qml » y se han trasladado a sus propios componentes QML para utilizarlos en los diseños, como el « ToolBarItem » del fragmento de código siguiente:
// Vertical toolbar
ToolBarItem {
Layout.preferredWidth: GlobalSettings.toolbarwidth
Layout.fillHeight: true
}
// Everything except vertical toolbar, header, and background image
ColumnLayout {
id: maincontentview
Layout.fillWidth: true
Layout.fillHeight: true
...Las transiciones entre las diferentes vistas se gestionan mediante states y transitions:
states: [
State {
name: "ShowDashboard"
},
State {
name: "ShowSettings"
PropertyChanges {
maincontent.opacity: 0
settingscontent.opacity: 1
}
PropertyChanges {
viewtextdesc.text: "/ Settings"
}
},
...
// Use transitions to bring the selected view to the front
transitions: [
Transition {
NumberAnimation {
properties: "opacity"
easing.type: Easing.InOutCubic
duration: 1000
}
}
]Panel de control
El panel de control forma parte del contenido principal; se trata de otro RowLayout dentro de la jerarquía de Layout:
// Main content
RowLayout {
id: maincontent
Layout.fillWidth: true
Layout.fillHeight: true
...Está compuesto por un panel de estado y un panel de control:
// Status area; turbine image, notification, status texts, and turbine name
StatusPane {
id: statuspane
Layout.preferredWidth: GlobalSettings.statusimagewidth
Layout.fillHeight: true
}
// Scrollable dashboard graph area, shown when in ShowDashboard state
DashboardPane {
id: dashboardpane
contentheight: statuspane.height * 1.5
Layout.preferredWidth: GlobalSettings.dashboardwidth
Layout.fillHeight: true
}Panel de estado
El panel de estado también se compone de elementos más pequeños, implementados en sus propios componentes QML:
// Masking the turbine image of the background image
ImageItem {
anchors.fill: parent
}
// Notification
NotificationItem {
anchors.top: turbineimage.top
anchors.horizontalCenter: turbineimage.horizontalCenter
anchors.topMargin: GlobalSettings.doublespacing
width: turbineimage.width / 1.25
}
// Status
StatusItem {
anchors.centerIn: turbineimage
width: turbineimage.width / 1.5
height: turbineimage.width / 1.75
}
// Turbine name
Label {
...La implementación de estos no es relevante, por lo que se omitirá esa parte.
Panel del panel de control
El panel de control es el elemento que contiene las seis pequeñas vistas previas de gráficos. Solo cuatro de ellas son visibles a la vez, por lo que deben añadirse dentro de un elemento que permita el desplazamiento. En este caso, se hace mediante un « Flickable », que contiene un « GridLayout »:
Flickable {
property alias contentheight: content.height
clip: true
contentHeight: contentheight
boundsBehavior: Flickable.StopAtBounds
interactive: true
visible: opacity > 0.5
Item {
id: content
width: parent.width
GridLayout {
id: grid
columns: 2
...Las vistas previas de los gráficos se añaden dentro del diseño de cuadrícula y, al igual que la mayoría de los demás elementos, se han implementado dentro de sus propios elementos:
// Graph 1: Power output over time
SmallGraphItem {
Layout.fillWidth: true
Layout.fillHeight: true
state: "Area2D"
linesimulator: linesim
}
// Graph 2: Energy production x Turbine
SmallGraphItem {
Layout.fillWidth: true
Layout.fillHeight: true
state: "Bar2D"
barsimulator: barsim
}
...El elemento ` SmallGraphItem ` es genérico y contiene en su interior todos los tipos de gráficos diferentes; el tipo requerido se le indica mediante un ` state`.
SmallGraphItem tiene:
- Un elemento de encabezado
- Una instancia de cada tipo de gráfico, cuya visibilidad está establecida en «false» por defecto mediante un activador de opacidad
- Un rectángulo para oscurecer la vista previa
- Un área de ratón para gestionar el desplazamiento del cursor y los clics del ratón sobre la vista previa
Pie2DGraph {
id: pie2d
anchors.topMargin: header.height + GlobalSettings.defaultspacing
anchors.rightMargin: GlobalSettings.defaultspacing
anchors.fill: parent
opacity: 0
piesimulator: smallgraph.piesimulator
}
Bar3DGraph {
id: bar3d
anchors.topMargin: header.height + GlobalSettings.defaultspacing
anchors.bottomMargin: GlobalSettings.defaultspacing
anchors.fill: parent
opacity: 0
cameraZoomLevel: GlobalSettings.defaultzoom
cameraPreset: GlobalSettings.defaultpreset
}
...Las opacidades se utilizan para las animaciones de transición, por lo que se han establecido en 0 de forma predeterminada en las vistas previas. Cuando la opacidad se anima por encima de 0,5, el propio gráfico de la vista previa se muestra visible:
Bars3D {
id: graph
visible: opacity > 0.5
...Detalles
«Detalles» también forma parte del contenido principal y utiliza el mismo « RowLayout » dentro de la jerarquía « Layout ». Se compone del mismo panel de estado que el «Dashboard» y de un panel de detalles:
// Details graph, shown when in correct state
BigGraphItem {
id: detailspane
Layout.preferredWidth: GlobalSettings.dashboardwidth
Layout.fillHeight: true
state: root.state
radius: GlobalSettings.defaultradius
piesimulator: piesim
barsimulator: barsim
linesimulator: linesim
detailsview: true
}El panel de detalles, BigGraphItem, es similar a SmallGraphItem en el sentido de que también contiene una instancia de cada gráfico, además de otros elementos:
// Graphs
Area2DGraph {
id: area2dbig
Layout.fillWidth: true
Layout.fillHeight: true
Layout.margins: GlobalSettings.defaultmargin
opacity: 0
panStyle: GraphsView.PanStyle.Drag
zoomStyle: GraphsView.ZoomStyle.Center
linesimulator: biggraph.linesimulator
onVisibleChanged: {
if (visible)
biggraph.activegraph = area2dbig
}
}
Bar2DGraph {
id: bar2dbig
Layout.fillWidth: true
Layout.fillHeight: true
Layout.margins: GlobalSettings.defaultmargin
opacity: 0
panStyle: GraphsView.PanStyle.Drag
zoomStyle: GraphsView.ZoomStyle.Center
barsimulator: biggraph.barsimulator
onVisibleChanged: {
if (visible)
biggraph.activegraph = bar2dbig
}
}
...Otros elementos incluidos son un cuadro combinado desplegable para seleccionar el tipo de gráfico, botones de control para girar, desplazar y ampliar o reducir —dependiendo del tipo de gráfico— y una descripción emergente para los botones. Al igual que SmallGraphItem, el tipo de gráfico que se muestra se determina en función del estado.
Configuración
La configuración se ha situado fuera del contenido principal Layout, ya que no utiliza ninguna parte de las vistas «Dashboard » ni «Details »:
// Settings
SettingsItem {
id: settingscontent
anchors.fill: parent
...La vista «Configuración» contiene otro BigGraphItem para mostrar el gráfico y un panel de configuración para ajustar las propiedades de GraphsTheme o algunas propiedades específicas del tipo de gráfico seleccionado.
// Graph detail
BigGraphItem {
id: settingsgraph
width: GlobalSettings.settingsgraphwidth
anchors.top: parent.top
anchors.bottom: parent.bottom
anchors.topMargin: GlobalSettings.graphdetailmargin
radius: GlobalSettings.defaultradius
opacity: parent.opacity
piesimulator: settingsitem.piesimulator
barsimulator: settingsitem.barsimulator
linesimulator: settingsitem.linesimulator
}
// Settings pane
Loader {
active: settingsitem.visible
asynchronous: true
anchors.left: settingsgraph.right
anchors.right: parent.right
anchors.top: parent.top
anchors.bottom: parent.bottom
anchors.leftMargin: GlobalSettings.doublespacing
sourceComponent: Item {
StackLayout {
id: settingspane
anchors.fill: parent
...Tema global
La configuración de la pestaña « General Settings » afecta a todos los gráficos de la aplicación. Se ha implementado un GraphsTheme global como un Singleton en GlobalSettings.qml:
pragma Singleton
...
QtObject {
id: global
...
// Common graph theme
property var theme: GraphsTheme {
plotAreaBackgroundVisible: false
backgroundVisible: false
colorScheme: GraphsTheme.ColorScheme.Dark
theme: GraphsTheme.Theme.BlueSeries
labelTextColor: "#AEAEAE"
labelBackgroundVisible: true
labelFont.pointSize: global.fontsize28px
grid.mainColor: "#AEAEAE"
grid.mainWidth: 1
baseGradients: [ global.customgradient ]
}Este tema global compartido se establece en cada gráfico como tema:
theme: GlobalSettings.themeAl tratarse de un singleton, el GlobalSettings.qml también debe etiquetarse como tal en el CMakeLists.txt para que pueda utilizarse en la aplicación:
set_source_files_properties(qml/GlobalSettings.qml
PROPERTIES QT_QML_SINGLETON_TYPE TRUE)Configuración del gráfico
Los ajustes de la pestaña « Graph Settings » (Ajustes del gráfico) solo afectan al gráfico seleccionado actualmente. Estos ajustes no modifican el tema global, sino únicamente las series del gráfico 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.