<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- qmlsurfacelayers.qdoc --> <title>Qt Quick 2 Surface Multiseries Example | Qt Data Visualization 5.12.2</title> <link rel="stylesheet" type="text/css" href="style/offline-simple.css" /> <script type="text/javascript"> document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css"); // loading style sheet breaks anchors that were jumped to before // so force jumping to anchor again setTimeout(function() { var anchor = location.hash; // need to jump to different anchor first (e.g. none) location.hash = "#"; setTimeout(function() { location.hash = anchor; }, 0); }, 0); </script> </head> <body> <div class="header" id="qtdocheader"> <div class="main"> <div class="main-rounded"> <div class="navigationbar"> <table><tr> <td >Qt 5.12</td><td ><a href="qtdatavisualization-index.html">Qt Data Visualization</a></td><td >Qt Quick 2 Surface Multiseries Example</td></tr></table><table class="buildversion"><tr> <td id="buildversion" width="100%" align="right"><a href="qtdatavisualization-index.html">Qt Data Visualization | Commercial or GPLv3</a></td> </tr></table> </div> </div> <div class="content"> <div class="line"> <div class="content mainContent"> <div class="sidebar"> <div class="toc"> <h3><a name="toc">Contents</a></h3> <ul> <li class="level1"><a href="#running-the-example">Running the Example</a></li> <li class="level1"><a href="#adding-data-to-the-graph">Adding Data to the Graph</a></li> <li class="level1"><a href="#controlling-the-graph">Controlling the Graph</a></li> <li class="level1"><a href="#example-contents">Example Contents</a></li> </ul> </div> <div class="sidebar-content" id="sidebar-content"></div></div> <h1 class="title">Qt Quick 2 Surface Multiseries Example</h1> <span class="subtitle"></span> <!-- $$$qmlsurfacelayers-brief --> <p>Using multiple series with <a href="qml-qtdatavisualization-surface3d.html">Surface3D</a> in a QML application.</p> <!-- @@@qmlsurfacelayers --> <!-- $$$qmlsurfacelayers-description --> <div class="descr"> <a name="details"></a> <p>The Qt Quick 2 surface example shows how to make a 3D surface plot displaying 3 layers using <a href="qml-qtdatavisualization-surface3d.html">Surface3D</a> with Qt Quick 2.</p> <p class="centerAlign"><img src="images/qmlsurfacelayers-example.png" alt="" /></p><p>The focus in this example is on generating a multiseries surface plot from 3 different height map images, so in this section we skip explaining the application creation. For a more detailed QML example documentation, see <a href="qtdatavisualization-qmlscatter-example.html">Qt Quick 2 Scatter Example</a>.</p> <a name="running-the-example"></a> <h2 id="running-the-example">Running the Example</h2> <p>To run the example from Qt Creator, open the <b>Welcome</b> mode and select the example from <b>Examples</b>. For more information, visit Building and Running an Example.</p> <a name="adding-data-to-the-graph"></a> <h2 id="adding-data-to-the-graph">Adding Data to the Graph</h2> <p>This example shows how to add several surface series to one graph using using HeightMapSurfaceDataProxies and how to control their visibilities individually.</p> <p>Let's start by creating a specific gradient for each layer:</p> <pre class="qml"> ColorGradient { id: layerOneGradient ColorGradientStop { position: 0.0; color: "black" } ColorGradientStop { position: 0.31; color: "tan" } ColorGradientStop { position: 0.32; color: "green" } ColorGradientStop { position: 0.40; color: "darkslategray" } ColorGradientStop { position: 1.0; color: "white" } } ColorGradient { id: layerTwoGradient ColorGradientStop { position: 0.315; color: "blue" } ColorGradientStop { position: 0.33; color: "white" } } ColorGradient { id: layerThreeGradient ColorGradientStop { position: 0.0; color: "red" } ColorGradientStop { position: 0.15; color: "black" } } </pre> <p>Then we'll create the series themselves. It happens simply by adding 3 separate <a href="qml-qtdatavisualization-surface3dseries.html">Surface3DSeries</a> to the <a href="qml-qtdatavisualization-surface3d.html">Surface3D</a> graph as children:</p> <pre class="cpp"> ... Surface3DSeries { id: layerOneSeries baseGradient: layerOneGradient HeightMapSurfaceDataProxy { heightMapFile: ":/heightmaps/layer_1.png" } flatShadingEnabled: false drawMode: Surface3DSeries.DrawSurface visible: layerOneToggle.checked // bind to checkbox state } Surface3DSeries { id: layerTwoSeries baseGradient: layerTwoGradient HeightMapSurfaceDataProxy { heightMapFile: ":/heightmaps/layer_2.png" } flatShadingEnabled: false drawMode: Surface3DSeries.DrawSurface visible: layerTwoToggle.checked // bind to checkbox state } Surface3DSeries { id: layerThreeSeries baseGradient: layerThreeGradient HeightMapSurfaceDataProxy { heightMapFile: ":/heightmaps/layer_3.png" } flatShadingEnabled: false drawMode: Surface3DSeries.DrawSurface visible: layerThreeToggle.checked // bind to checkbox state } ... </pre> <p>You'll notice we added the created gradients to the <code>baseGradient</code> properties of the series. We could have added them to the <code>baseGradients</code> property of the <a href="qml-qtdatavisualization-theme3d.html">Theme3D</a> in <a href="qml-qtdatavisualization-surface3d.html">Surface3D</a> instead, but doing it this way ensures each gradient is applied to a correct series:</p> <pre class="qml"> Surface3DSeries { id: layerOneSeries baseGradient: layerOneGradient ... </pre> <a name="controlling-the-graph"></a> <h2 id="controlling-the-graph">Controlling the Graph</h2> <p>Let's add some checkboxes to control the visibility of layers:</p> <pre class="qml"> GroupBox { flat: true Layout.fillWidth: true Column { spacing: 10 Label { font.pointSize: fontSize font.bold: true text: "Layer Selection" } CheckBox { id: layerOneToggle checked: true style: CheckBoxStyle { label: Label { font.pointSize: fontSize text: "Show Ground Layer" } } } CheckBox { id: layerTwoToggle checked: true style: CheckBoxStyle { label: Label { font.pointSize: fontSize text: "Show Sea Layer" } } } CheckBox { id: layerThreeToggle checked: true style: CheckBoxStyle { label: Label { font.pointSize: fontSize text: "Show Tectonic Layer" } } } } } </pre> <p>We don't need to do anything on the <code>onCheckedChanged</code> as we bound the <code>checked</code> state to the <code>visible</code> property of the series directly:</p> <pre class="cpp"> ... visible: layerOneToggle.checked // bind to checkbox state ... </pre> <p>Let's add some more checkboxes to control how the layers are displayed, when visible:</p> <pre class="qml"> GroupBox { flat: true Layout.fillWidth: true Column { spacing: 10 Label { font.pointSize: fontSize font.bold: true text: "Layer Style" } CheckBox { id: layerOneGrid style: CheckBoxStyle { label: Label { font.pointSize: fontSize text: "Show Ground as Grid" } } onCheckedChanged: { if (checked) layerOneSeries.drawMode = Surface3DSeries.DrawWireframe else layerOneSeries.drawMode = Surface3DSeries.DrawSurface } } CheckBox { id: layerTwoGrid style: CheckBoxStyle { label: Label { font.pointSize: fontSize text: "Show Sea as Grid" } } onCheckedChanged: { if (checked) layerTwoSeries.drawMode = Surface3DSeries.DrawWireframe else layerTwoSeries.drawMode = Surface3DSeries.DrawSurface } } CheckBox { id: layerThreeGrid style: CheckBoxStyle { label: Label { font.pointSize: fontSize text: "Show Tectonic as Grid" } } onCheckedChanged: { if (checked) layerThreeSeries.drawMode = Surface3DSeries.DrawWireframe else layerThreeSeries.drawMode = Surface3DSeries.DrawSurface } } } } </pre> <p>In addition to these we have three buttons, one of which is of special interest to us. It is used to control whether we want to slice into only one layer, or all of them:</p> <pre class="qml"> NewButton { id: sliceButton text: "Slice All Layers" fontSize: fontSize Layout.fillWidth: true Layout.minimumHeight: 40 onClicked: { if (surfaceLayers.selectionMode & AbstractGraph3D.SelectionMultiSeries) { surfaceLayers.selectionMode = AbstractGraph3D.SelectionRow | AbstractGraph3D.SelectionSlice text = "Slice All Layers" } else { surfaceLayers.selectionMode = AbstractGraph3D.SelectionRow | AbstractGraph3D.SelectionSlice | AbstractGraph3D.SelectionMultiSeries text = "Slice One Layer" } } } </pre> <a name="example-contents"></a> <h2 id="example-contents">Example Contents</h2> <p>Files:</p> <ul> <li><a href="qtdatavisualization-qmlsurfacelayers-main-cpp.html">qmlsurfacelayers/main.cpp</a></li> <li><a href="qtdatavisualization-qmlsurfacelayers-qml-qmlsurfacelayers-newbutton-qml.html">qmlsurfacelayers/qml/qmlsurfacelayers/NewButton.qml</a></li> <li><a href="qtdatavisualization-qmlsurfacelayers-qml-qmlsurfacelayers-main-qml.html">qmlsurfacelayers/qml/qmlsurfacelayers/main.qml</a></li> <li><a href="qtdatavisualization-qmlsurfacelayers-qmlsurfacelayers-pro.html">qmlsurfacelayers/qmlsurfacelayers.pro</a></li> <li><a href="qtdatavisualization-qmlsurfacelayers-qmlsurfacelayers-qrc.html">qmlsurfacelayers/qmlsurfacelayers.qrc</a></li> </ul> <p>Images:</p> <ul> <li><a href="images/used-in-examples/qmlsurfacelayers/layer_1.png">qmlsurfacelayers/layer_1.png</a></li> <li><a href="images/used-in-examples/qmlsurfacelayers/layer_2.png">qmlsurfacelayers/layer_2.png</a></li> <li><a href="images/used-in-examples/qmlsurfacelayers/layer_3.png">qmlsurfacelayers/layer_3.png</a></li> </ul> </div> <!-- @@@qmlsurfacelayers --> </div> </div> </div> </div> </div> <div class="footer"> <p> <acronym title="Copyright">©</acronym> 2019 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners.<br/> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br/> 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. </p> </div> </body> </html>