Revision control
++ // Copyright (C) 2024 The Qt Company Ltd.
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
++
++ /*!
++ \example 2d/hellographs
++ \meta tags {Graphs, GraphsView, BarSeries, LineSeries}
++ \examplecategory {Data Visualization}
++ \title HelloGraphs
++ \ingroup qtgraphs_qmlexamples
++ \brief Using Graphs for 2D in a Qt Quick application.
++
++ \e {HelloGraphs} shows how to make a simple 2D bar graph and line graph.
++
++ \image hellographs-example.png
++ {Bar graph for 2024-2026 and line graph with two data series}
++
++ The following sections describe how to create a bar graph using BarSeries
++ and a line graph using LineSeries.
++
++ \include examples-run.qdocinc
++
++ \section1 BarGraph
++
++ The first graph in the example is a bar graph. Creating it starts with a GraphsView
++ component, setting the \l{GraphsView::axisX}{X axis}, \l{GraphsView::axisY}{Y axis} and
++ \l{GraphsView::theme}{theme}. X axis is a BarCategoryAxis with 3 categories.
++ Both the vertical grid and the axis lines are hidden. Y axis is a ValueAxis with visible range
++ between 20 and 100. Major ticks with labels will be shown on every 10 values using
++ \l{ValueAxis::tickInterval}{tickInterval}. Subticks will be shown on every 1 values using
++ \l{ValueAxis::tickInterval}{subTickCount} \c 9, which means that between every major tick
++ there will be 9 minor ones. Lastly, \l{GraphsView::theme}{theme} is added to one which is
++ suitable on dark backgrounds. This theme adjusts the graph background grid, axis lines and labels.
++
++ \snippet 2d/hellographs/qml/hellographs/main.qml bargraph
++ \dots
++
++ To make this a bar graph, add a \l BarSeries.
++
++ \snippet 2d/hellographs/qml/hellographs/main.qml barseries
++ \dots
++
++ Then data is added into \l BarSeries using \l BarSet. There are 3 bars with defined custom bars
++ color and border properties. These properties will override the possible
++ \l{GraphsTheme::seriesColors}{seriesColors} set for the \l GraphsTheme.
++
++ \snippet 2d/hellographs/qml/hellographs/main.qml barset
++
++ \section1 LineGraph
++
++ The second graph of the example is a line graph. It also starts by defining a
++ \l GraphsView element. Custom \l GraphsTheme is created to get a custom appearance.
++ \l GraphsTheme offers quite a wide range of customization possibilities for the background
++ grid and axis, which get applied after the \l{GraphsTheme::theme}{theme}.
++
++ The GraphsView defines \l{GraphsView::axisX}{axisX} and \l{GraphsView::axisY}{axisY}
++ suitable for this graph.
++
++ \snippet 2d/hellographs/qml/hellographs/main.qml linegraph
++ \dots
++
++ Custom \c Delegate component is used to visualize the data points.
++
++ \snippet 2d/hellographs/qml/hellographs/main.qml linemarker
++
++ To make this a line graph, add a \l LineSeries.
++ This sets the \l{XYSeries::pointDelegate}{pointDelegate} to use the custom
++ \c Delegate component that was created earlier. Data points are added using
++ \l XYPoint elements.
++
++ \snippet 2d/hellographs/qml/hellographs/main.qml lineseries1
++
++ The second line series is similar to the first.
++ As this is second \l LineSeries inside the \l GraphsView, second color from the \c seriesColors
++ gets automatically picked.
++
++ \snippet 2d/hellographs/qml/hellographs/main.qml lineseries2
++ */