/****************************************************************************
**
** Copyright (C) 2014 Digia Plc
** All rights reserved.
** For any questions to Digia, please use contact form at http://qt.io
**
** This file is part of the Qt Data Visualization module.
**
** Licensees holding valid commercial license for Qt may use this file in
** accordance with the Qt License Agreement provided with the Software
** or, alternatively, in accordance with the terms contained in a written
** agreement between you and Digia.
**
** If you have questions regarding the use of this file, please use
** contact form at http://qt.io
**
****************************************************************************/
#include "q3dobject_p.h"
#include "q3dscene_p.h"
QT_BEGIN_NAMESPACE_DATAVISUALIZATION
/*!
\class Q3DObject
\inmodule QtDataVisualization
\brief Simple baseclass for all the objects in the 3D scene.
\since QtDataVisualization 1.0
Q3DObject is a baseclass that contains only position information for an object in 3D scene.
The object is considered to be a single point in the coordinate space without dimensions.
*/
/*!
* Constructs a new 3D object with position set to origin by default. An
* optional \a parent parameter can be given and is then passed to QObject constructor.
*/
Q3DObject::Q3DObject(QObject *parent) :
QObject(parent),
d_ptr(new Q3DObjectPrivate(this))
{
}
/*!
* Destroys the 3D object.
*/
Q3DObject::~Q3DObject()
{
}
/*!
* Copies the 3D object position from the given \a source 3D object to this 3D object instance.
*/
void Q3DObject::copyValuesFrom(const Q3DObject &source)
{
d_ptr->m_position = source.d_ptr->m_position;
setDirty(true);
}
/*!
* \property Q3DObject::parentScene
*
* This property contains the parent scene as read only value.
* If the object has no parent scene the value is 0.
*/
Q3DScene *Q3DObject::parentScene()
{
return qobject_cast(parent());
}
/*!
* \property Q3DObject::position
*
* This property contains the 3D position of the object.
*
* \note Currently setting this property has no effect, as the positions of Q3DObjects in the
* scene are handled internally.
*/
QVector3D Q3DObject::position() const
{
return d_ptr->m_position;
}
void Q3DObject::setPosition(const QVector3D &position)
{
if (d_ptr->m_position != position) {
d_ptr->m_position = position;
setDirty(true);
emit positionChanged(d_ptr->m_position);
}
}
/*!
* Sets and clears the \a dirty flag that is used to track
* when the 3D object has changed since last update.
*/
void Q3DObject::setDirty(bool dirty)
{
d_ptr->m_isDirty = dirty;
if (parentScene())
parentScene()->d_ptr->markDirty();
}
/*!
* \return flag that indicates if the 3D object has changed.
*/
bool Q3DObject::isDirty() const
{
return d_ptr->m_isDirty;
}
Q3DObjectPrivate::Q3DObjectPrivate(Q3DObject *q) :
q_ptr(q),
m_isDirty(true)
{
}
Q3DObjectPrivate::~Q3DObjectPrivate()
{
}
QT_END_NAMESPACE_DATAVISUALIZATION