Add files ported from research/qt3d

Fill repo with some of the files from the research/qt3d project.  At
present the new project builds under MacOSX.  To-dos include getting it
building under linux, windows, harmattan and maemo/meego; updating the
documentation to reflect the new QtQuick focus; and fixing the issues
with private headers.

1 files changed, 112 insertions, 0 deletions

diff --git a/src/threed/graphicsview/qgraphicstransform3d.cpp b/src/threed/graphicsview/qgraphicstransform3d.cpp
new file mode 100644
index 000000000..8e72d2a62
--- /dev/null
+++ b/src/threed/graphicsview/qgraphicstransform3d.cpp
@@ -0,0 +1,112 @@
+/****************************************************************************
+**
+** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the QtQuick3D module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "qgraphicstransform3d.h"
+
+QT_BEGIN_NAMESPACE
+
+/*!
+    \class QGraphicsTransform3D
+    \brief The QGraphicsTransform3D class is an abstract base class for building 3D transformations.
+    \since 4.8
+    \ingroup qt3d
+    \ingroup qt3d::graphicsview
+
+    QGraphicsTransform3D lets you create and control advanced transformations
+    that can be configured independently using specialized properties.
+    Scene nodes have an associated list of transforms, which are applied
+    in order, one at a time, to the modelview matrix.  Transformations are
+    computed in true 3D space using QMatrix4x4.
+
+    QGraphicsTransform3D is particularly useful for animations. Whereas
+    QGLPainter::modelViewMatrix() lets you assign any transform directly,
+    there is no direct way to interpolate between two different
+    transformations (e.g., when transitioning between two states, each for
+    which the item has a different arbitrary transform assigned). Using
+    QGraphicsTransform3D you can interpolate the property values of each
+    independent transformation. The resulting operation is then combined into a
+    single transform which is applied to the modelview matrix during drawing.
+
+    If you want to create your own configurable transformation, you can create
+    a subclass of QGraphicsTransform3D (or any or the existing subclasses), and
+    reimplement the pure virtual applyTo() function, which takes a pointer to a
+    QMatrix4x4. Each operation you would like to apply should be exposed as
+    properties (e.g., customTransform->setVerticalShear(2.5)). Inside you
+    reimplementation of applyTo(), you can modify the provided transform
+    respectively.
+
+    \sa QGraphicsScale3D, QGraphicsRotation3D, QGraphicsTranslation3D
+    \sa QGraphicsBillboardTransform
+*/
+
+/*!
+    \fn QGraphicsTransform3D::QGraphicsTransform3D(QObject *parent)
+
+    Constructs a 3D transformation and attaches it to \a parent.
+*/
+
+/*!
+    \fn QGraphicsTransform3D::~QGraphicsTransform3D()
+
+    Destroys this 3D transformation.
+*/
+
+/*!
+    \fn void QGraphicsTransform3D::applyTo(QMatrix4x4 *matrix) const
+
+    Applies the effect of this transformation to the specified
+    modelview \a matrix.
+*/
+
+/*!
+    \fn QGraphicsTransform3D *QGraphicsTransform3D::clone(QObject *parent) const
+
+    Clones a copy of this transformation and attaches the clone to \a parent.
+*/
+
+/*!
+    \fn void QGraphicsTransform3D::transformChanged()
+
+    Signal that is emitted whenever any of the transformation's
+    parameters are changed.
+*/
+
+QT_END_NAMESPACE