Revision control
- /****************************************************************************
- **
- ** Copyright (C) 2016 The Qt Company Ltd.
- ** Contact: https://www.qt.io/licensing/
- **
- ** This file is part of the documentation of the Qt Toolkit.
- **
- ** $QT_BEGIN_LICENSE:FDL$
- ** Commercial License Usage
- ** Licensees holding valid commercial Qt licenses may use this file in
- ** accordance with the commercial license agreement provided with the
- ** Software or, alternatively, in accordance with the terms contained in
- ** a written agreement between you and The Qt Company. For licensing terms
- ** and conditions see https://www.qt.io/terms-conditions. For further
- ** information use the contact form at https://www.qt.io/contact-us.
- **
- ** GNU Free Documentation License Usage
- ** Alternatively, this file may be used under the terms of the GNU Free
- ** Documentation License version 1.3 as published by the Free Software
- ** Foundation and appearing in the file included in the packaging of
- ** this file. Please review the following information to ensure
- ** the GNU Free Documentation License version 1.3 requirements
- ** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
- ** $QT_END_LICENSE$
- **
- ****************************************************************************/
+ // Copyright (C) 2016 The Qt Company Ltd.
+ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\example customitems
\title Custom Items Example
\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
*/