Revision control
Copy as Markdown
// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\example customitems
\meta tags {DataVisualization, Q3DSurface, QCustom3DItem, Surface Graph}
\meta category {Graphics}
\title Custom Items in Graph
\ingroup qtdatavisualization_examples
\brief Adding custom items to a surface graph.
\since QtDataVisualization 1.1
The custom items example shows how to add your own custom meshes as items to a graph, and how
to remove them.
\image customitems-example.png
\include examples-run.qdocinc
\section1 Adding Custom Meshes to the Application
We'll add the meshes in a resource file:
\code
<RCC>
...
<qresource prefix="/items">
<file>refinery.obj</file>
<file>oilrig.obj</file>
</qresource>
</RCC>
\endcode
\section1 Adding Custom Item to a Graph
In this example we do not have specific textures for our meshes, so we'll just create a small
QImage and fill it with a single color:
\snippet customitems/customitemgraph.cpp 0
Then we'll specify the position for the item in a variable. This way we'll be able to use it
later for removing the correct item:
\snippet customitems/customitemgraph.cpp 1
Then we'll create a new QCustom3DItem with all the parameters:
\snippet customitems/customitemgraph.cpp 2
And finally we'll just add the item:
\snippet customitems/customitemgraph.cpp 3
\section1 Removing Custom Item from a Graph
We'll just call \c removeCustomItemAt() with the position of the item:
\snippet customitems/customitemgraph.cpp 4
\note Removing a custom item from the graph also deletes it. If you want to preserve the item,
you need to use \c releaseCustomItem() method instead.
\section1 Example Contents
*/