En esta página

Ejemplo de previsión meteorológica

Un ejemplo de formas de Qt Quick que muestra diferentes formas de utilizar las formas en una aplicación.

Aplicación de previsión meteorológica que muestra un mapa vectorial de Europa con las temperaturas de las ciudades y los iconos meteorológicos

Este ejemplo está diseñado para parecerse a una aplicación de previsión meteorológica para Europa. Muestra algunas formas diferentes en las que la API de QtQuick.Shapes puede resultar útil en una aplicación, y cómo las distintas propiedades pueden afectar a la calidad y al rendimiento de la representación.

Todos los gráficos del ejemplo proceden de archivos de « .svg », que se convierten a QML de forma automática mediante la herramienta svgtoqml en el momento de la compilación.

qt_target_qml_from_svg(weatherforecastexample
    OPTIMIZE_PATHS
    ASYNCHRONOUS_SHAPES
    TYPE_NAME "DemoShape"
    COPYRIGHT_STATEMENT "Copyright © 2023 Framework7\\nSPDX-License-Identifier: MIT"
    FILES
        assets/gear-alt-stroke.svg
    OUTPUTS
        Gear_generated.qml
)

Los archivos QML generados se pueden utilizar en el código de la aplicación como cualquier otro.

Diferentes tipos de formas

El módulo QtQuick.Shapes proporciona API para renderizar gráficos vectoriales en una aplicación Qt Quick. Se trata de una alternativa al uso de un mapa de píxeles (raster Image ) para gráficos 2D y resulta útil si no se conoce de antemano el tamaño de destino de la imagen. Con un mapa de píxeles ( Image), el mapa de píxeles rasterizado se crea previamente con un tamaño específico y, al escalar la imagen, se añade o se elimina información. Esto provocará pixelación o desenfoque, dependiendo de si se ha establecido su propiedad « smooth ».

Con QtQuick.Shapes, las formas se describen matemáticamente, como un conjunto de curvas y segmentos de línea, por lo que pueden escalarse arbitrariamente sin introducir artefactos.

Aplicación de previsión meteorológica que muestra un mapa vectorial de Europa con las temperaturas de las ciudades y los iconos meteorológicos

En el ejemplo de la previsión meteorológica, hay tres usos principales de las formas:

  • Iconos de la interfaz de usuario, como los símbolos meteorológicos y la rueda dentada del botón «Configuración».
  • El mapa general de Europa.
  • Etiquetas con los nombres de los países, visibles al ampliar el mapa.
Iconos de la interfaz de usuario

Aunque por motivos de rendimiento suele ser preferible utilizar imágenes ráster del tamaño adecuado para los iconos, esto puede resultar poco práctico si la misma aplicación está destinada a pantallas de muchos tamaños diferentes. Para que los iconos se vean nítidos en todas las pantallas, hay que generar previamente un amplio conjunto de diferentes tamaños. QtQuick.Shapes permite que la aplicación realice esta adaptación en tiempo de ejecución, al incluir los iconos como formas y renderizarlos a un tamaño adecuado para el tamaño actual de la pantalla.

Al ejecutar el ejemplo «Weather Forecast» en un sistema de escritorio, esto se puede observar ampliando o reduciendo la ventana de la aplicación. Los símbolos meteorológicos se adaptan al tamaño de la ventana sin perder calidad.

Además, se pueden añadir efectos animados, como zooms, sin pérdida de calidad. Esto se puede comprobar al pasar el cursor por encima de los símbolos meteorológicos.

Por lo tanto, para cualquier caso de uso en el que se desconozca el tamaño de destino, o en el que el número de posibilidades sea tan grande que resulte poco práctico crear mapas de píxeles específicos para todas ellas, el uso de formas para los iconos puede resultar útil y merecer la pena a pesar del coste de rendimiento que supone la rasterización de las formas en tiempo de ejecución.

Mapa de Europa

El ejemplo «Previsión meteorológica» también utiliza un mapa vectorizado de Europa. Esto facilita la creación de efectos como el zoom en el mapa cuando queremos destacar un país concreto. Además, dado que cada país es una subforma independiente, podemos aplicarles diferentes rellenos y trazos de forma independiente.

Haz clic en el mapa para ampliar un país. La escala se ajustará de modo que la forma del país ocupe toda la ventana y el color de relleno será ligeramente más oscuro.

Vista ampliada de Finlandia con el nombre del país y los iconos meteorológicos ampliados que muestran una tormenta y el sol

Nota: Los símbolos meteorológicos del mapa ampliado son los mismos recursos que en la vista original, pero a un tamaño mucho mayor.

Etiquetas con los nombres de los países

Al ampliar un país, su nombre aparece sobre la forma del país. Esta etiqueta también se crea con QtQuick.Shapes, utilizando el tipo de componente PathText, que convierte una cadena en una forma representable.

Esta no es la forma habitual de crear etiquetas de texto en Qt Quick. En la mayoría de los casos, utilizar el elemento Text es el método más eficiente y práctico. Sin embargo, hay ciertos efectos de visualización compatibles con QtQuick.Shapes que no son compatibles con el elemento Text habitual. Los degradados de relleno son uno de esos efectos.

                        ShapePath {
                            strokeColor:  "transparent"
                            strokeWidth: 1
                            joinStyle: ShapePath.RoundJoin
                            fillRule: ShapePath.WindingFill

                            fillGradient: RadialGradient {
                                centerX: textShape.width / 2
                                centerY: textShape.height / 2
                                centerRadius: textShape.width / 2
                                focalX: centerX; focalY: centerY
                                GradientStop { position: 0; color: "#b0ab9d7f" }
                                GradientStop { position: 1; color: "#5cab9d7f" }
                            }
                            PathText {
                                id: textPath
                                text: textLayer.label
                                font.family: workSansRegular.font.family
                                font.pixelSize: 64
                            }
                        }

Para ilustrarlo, el ejemplo «Previsión meteorológica» aplica un sutil degradado radial a la opacidad de las etiquetas de los países, lo que hace que parezcan fundirse con el mapa en los bordes.

Diferentes tipos de renderizadores

El ejemplo «Weather Forecast» ilustra múltiples casos de uso diferentes para QtQuick.Shapes. Además, puede utilizarse para apreciar las ventajas y desventajas de los distintos renderizadores que admite el módulo.

Haz clic en la rueda dentada de la esquina superior izquierda para abrir un panel de configuración, donde se pueden seleccionar diferentes métodos de rasterización.

Panel de configuración con opciones de renderizador: Renderizador de curvas, Renderizador de geometría y Renderizador de geometría con MSAA 4x

QtQuick.Shapes Admite dos renderizadores diferentes, seleccionables mediante la propiedad ` preferredRendererType `. El renderizador preferido en el ejemplo es ` CurveRenderer`. Este admite curvas aceleradas por hardware y suavizado integrado. No es el renderizador predeterminado en ` QtQuick.Shapes`, pero en el ejemplo se selecciona automáticamente al iniciar.

El renderizador predeterminado en Qt Quick Shapes es GeometryRenderer. Este aplana las curvas de la forma en líneas rectas muy pequeñas y dibuja la forma como un polígono. Redibujar la forma resulta más eficiente que con CurveRenderer, pero a determinadas escalas se apreciará que las curvas se aproximan mediante líneas.

Además, el « GeometryRenderer » no admite suavizado, por lo que normalmente convendrá habilitar el multimuestreo al utilizarlo. Esto se puede hacer renderizando las formas en capas y habilitando el multimuestreo en ellas. Dado que en este modo renderizaremos las formas en búferes fuera de pantalla, se consume memoria gráfica adicional, así como una pasada de renderizado adicional por cada forma.

        layer.enabled: msaaCheckBox.checked
        layer.samples: 4

El panel de configuración también ofrece la opción de utilizar el « GeometryRenderer » junto con el multimuestreo 4x, de modo que se pueda comparar su calidad con el suavizado integrado del « CurveRenderer ».

Ejecución del ejemplo

Puede ejecutar el ejemplo desde:

Proyecto de ejemplo en code.qt.io

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