<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- qtdatavisualization-qml-scatter3d.qdoc --> <title>Scatter3D QML Type | Qt Data Visualization 5.12.6</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 ><a href="qtdatavisualization-qmlmodule.html">QML Types</a></td><td >Scatter3D QML Type</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="#properties">Properties</a></li> <li class="level1"><a href="#methods">Methods</a></li> <li class="level1"><a href="#details">Detailed Description</a></li> </ul> </div> <div class="sidebar-content" id="sidebar-content"></div></div> <h1 class="title">Scatter3D QML Type</h1> <span class="subtitle"></span> <!-- $$$Scatter3D-brief --> <p>3D scatter graph. <a href="#details">More...</a></p> <!-- @@@Scatter3D --> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft rightAlign topAlign"> Import Statement:</td><td class="memItemRight bottomAlign"> import QtDataVisualization 1.2</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Since:</td><td class="memItemRight bottomAlign"> QtDataVisualization 1.0</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Inherits:</td><td class="memItemRight bottomAlign"> <p><a href="qml-qtdatavisualization-abstractgraph3d.html">AbstractGraph3D</a></p> </td></tr></table></div><ul> <li><a href="qml-qtdatavisualization-scatter3d-members.html">List of all members, including inherited members</a></li> </ul> <a name="properties"></a> <h2 id="properties">Properties</h2> <ul> <li class="fn"><b><b><a href="qml-qtdatavisualization-scatter3d.html#axisX-prop">axisX</a></b></b> : ValueAxis3D</li> <li class="fn"><b><b><a href="qml-qtdatavisualization-scatter3d.html#axisY-prop">axisY</a></b></b> : ValueAxis3D</li> <li class="fn"><b><b><a href="qml-qtdatavisualization-scatter3d.html#axisZ-prop">axisZ</a></b></b> : ValueAxis3D</li> <li class="fn"><b><b><a href="qml-qtdatavisualization-scatter3d.html#selectedSeries-prop">selectedSeries</a></b></b> : Scatter3DSeries</li> <li class="fn"><b><b><a href="qml-qtdatavisualization-scatter3d.html#seriesList-prop">seriesList</a></b></b> : list<Scatter3DSeries></li> </ul> <a name="methods"></a> <h2 id="methods">Methods</h2> <ul> <li class="fn">void <b><b><a href="qml-qtdatavisualization-scatter3d.html#addSeries-method">addSeries</a></b></b>(Scatter3DSeries <i>series</i>)</li> <li class="fn">void <b><b><a href="qml-qtdatavisualization-scatter3d.html#removeSeries-method">removeSeries</a></b></b>(Scatter3DSeries <i>series</i>)</li> </ul> <!-- $$$Scatter3D-description --> <a name="details"></a> <h2 id="details">Detailed Description</h2> <p>This type enables developers to render scatter graphs in 3D with Qt Quick 2.</p> <p>You will need to import data visualization module to use this type:</p> <pre class="cpp"> import <span class="type">QtDataVisualization</span> <span class="number">1.2</span> </pre> <p>After that you can use <a href="qml-qtdatavisualization-scatter3d.html">Scatter3D</a> in your qml files:</p> <pre class="cpp"> import <span class="type">QtQuick</span> <span class="number">2.0</span> import <span class="type">QtDataVisualization</span> <span class="number">1.2</span> Item { width: <span class="number">640</span> height: <span class="number">480</span> Scatter3D { width: parent<span class="operator">.</span>width height: parent<span class="operator">.</span>height Scatter3DSeries { ItemModelScatterDataProxy { itemModel: dataModel <span class="comment">// Mapping model roles to scatter series item coordinates.</span> xPosRole: <span class="string">"xPos"</span> yPosRole: <span class="string">"yPos"</span> zPosRole: <span class="string">"zPos"</span> } } } ListModel { id: dataModel ListElement{ xPos: <span class="string">"2.754"</span>; yPos: <span class="string">"1.455"</span>; zPos: <span class="string">"3.362"</span>; } ListElement{ xPos: <span class="string">"3.164"</span>; yPos: <span class="string">"2.022"</span>; zPos: <span class="string">"4.348"</span>; } ListElement{ xPos: <span class="string">"4.564"</span>; yPos: <span class="string">"1.865"</span>; zPos: <span class="string">"1.346"</span>; } ListElement{ xPos: <span class="string">"1.068"</span>; yPos: <span class="string">"1.224"</span>; zPos: <span class="string">"2.983"</span>; } ListElement{ xPos: <span class="string">"2.323"</span>; yPos: <span class="string">"2.502"</span>; zPos: <span class="string">"3.133"</span>; } } } </pre> <p>See <a href="qtdatavisualization-qmlscatter-example.html">Qt Quick 2 Scatter Example</a> for more thorough usage example.</p> <p><b>See also </b><a href="qml-qtdatavisualization-scatter3dseries.html">Scatter3DSeries</a>, <a href="qml-qtdatavisualization-scatterdataproxy.html">ScatterDataProxy</a>, <a href="qml-qtdatavisualization-bars3d.html">Bars3D</a>, <a href="qml-qtdatavisualization-surface3d.html">Surface3D</a>, and <a href="qtdatavisualization-module.html">Qt Data Visualization C++ Classes</a>.</p> <!-- @@@Scatter3D --> <h2>Property Documentation</h2> <!-- $$$axisX --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="axisX-prop"> <td class="tblQmlPropNode"><p> <a name="axisX-prop"></a><span class="name">axisX</span> : <span class="type"><a href="qml-qtdatavisualization-valueaxis3d.html">ValueAxis3D</a></span></p></td></tr> </table></div> </div><div class="qmldoc"><p>The active x-axis.</p> <p>If an axis is not given, a temporary default axis with no labels and an automatically adjusting range is created. This temporary axis is destroyed if another axis is explicitly set to the same orientation.</p> </div></div><!-- @@@axisX --> <br/> <!-- $$$axisY --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="axisY-prop"> <td class="tblQmlPropNode"><p> <a name="axisY-prop"></a><span class="name">axisY</span> : <span class="type"><a href="qml-qtdatavisualization-valueaxis3d.html">ValueAxis3D</a></span></p></td></tr> </table></div> </div><div class="qmldoc"><p>The active y-axis.</p> <p>If an axis is not given, a temporary default axis with no labels and an automatically adjusting range is created. This temporary axis is destroyed if another axis is explicitly set to the same orientation.</p> </div></div><!-- @@@axisY --> <br/> <!-- $$$axisZ --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="axisZ-prop"> <td class="tblQmlPropNode"><p> <a name="axisZ-prop"></a><span class="name">axisZ</span> : <span class="type"><a href="qml-qtdatavisualization-valueaxis3d.html">ValueAxis3D</a></span></p></td></tr> </table></div> </div><div class="qmldoc"><p>The active z-axis.</p> <p>If an axis is not given, a temporary default axis with no labels and an automatically adjusting range is created. This temporary axis is destroyed if another axis is explicitly set to the same orientation.</p> </div></div><!-- @@@axisZ --> <br/> <!-- $$$selectedSeries --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="selectedSeries-prop"> <td class="tblQmlPropNode"><p> <a name="selectedSeries-prop"></a><span class="name">selectedSeries</span> : <span class="type"><a href="qml-qtdatavisualization-scatter3dseries.html">Scatter3DSeries</a></span></p></td></tr> </table></div> </div><div class="qmldoc"><p>The selected series or null.</p> </div></div><!-- @@@selectedSeries --> <br/> <!-- $$$seriesList --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="seriesList-prop"> <td class="tblQmlPropNode"><p> <a name="seriesList-prop"></a><span class="qmldefault">[default] </span><span class="name">seriesList</span> : <span class="type">list</span><<span class="type"><a href="qml-qtdatavisualization-scatter3dseries.html">Scatter3DSeries</a></span>></p></td></tr> </table></div> </div><div class="qmldoc"><p>This property holds the series of the graph. By default, this property contains an empty list. To set the series, either use the <a href="qml-qtdatavisualization-scatter3d.html#addSeries-method">addSeries()</a> method or define them as children of the graph.</p> </div></div><!-- @@@seriesList --> <br/> <h2>Method Documentation</h2> <!-- $$$addSeries --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="addSeries-method"> <td class="tblQmlFuncNode"><p> <a name="addSeries-method"></a><span class="type">void</span> <span class="name">addSeries</span>(<span class="type"><a href="qml-qtdatavisualization-scatter3dseries.html">Scatter3DSeries</a></span> <i>series</i>)</p></td></tr> </table></div> </div><div class="qmldoc"><p>Adds the <i>series</i> to the graph. A graph can contain multiple series, but has only one set of axes. If the newly added series has specified a selected item, it will be highlighted and any existing selection will be cleared. Only one added series can have an active selection.</p> </div></div><!-- @@@addSeries --> <br/> <!-- $$$removeSeries --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="removeSeries-method"> <td class="tblQmlFuncNode"><p> <a name="removeSeries-method"></a><span class="type">void</span> <span class="name">removeSeries</span>(<span class="type"><a href="qml-qtdatavisualization-scatter3dseries.html">Scatter3DSeries</a></span> <i>series</i>)</p></td></tr> </table></div> </div><div class="qmldoc"><p>Remove the <i>series</i> from the graph.</p> </div></div><!-- @@@removeSeries --> <br/> </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>