Q3DScatter: First draft

Compiles, but has not been tested yet.
QML -part still completely unimplemented.

Change-Id: Iccf98ea6265d38325168d15f3bef1b609f5a7004
Change-Id: Iccf98ea6265d38325168d15f3bef1b609f5a7004
Reviewed-by: Tomi Korpipää <tomi.korpipaa@digia.com>

1 files changed, 192 insertions, 0 deletions

diff --git a/src/datavis3d/engine/q3dscatter.h b/src/datavis3d/engine/q3dscatter.h
new file mode 100644
index 00000000..13c50415
--- /dev/null
+++ b/src/datavis3d/engine/q3dscatter.h
@@ -0,0 +1,192 @@
+/****************************************************************************
+**
+** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the QtDataVis3D module.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** 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 Digia.  For licensing terms and
+** conditions see http://qt.digia.com/licensing.  For further information
+** use the contact form at http://qt.digia.com/contact-us.
+**
+** 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, Digia gives you certain additional
+** rights.  These rights are described in the Digia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#ifndef Q3DSCATTER_H
+#define Q3DSCATTER_H
+
+#include "qdatavis3dnamespace.h"
+#include "q3dwindow.h"
+#include <QFont>
+
+QT_DATAVIS3D_BEGIN_NAMESPACE
+
+class Q3DScatterPrivate;
+class LabelItem;
+class QAbstractAxis;
+class QCategoryAxis;
+class QScatterDataProxy;
+
+class QT_DATAVIS3D_EXPORT Q3DScatter : public Q3DWindow
+{
+    Q_OBJECT
+    Q_PROPERTY(SelectionMode selectionMode READ selectionMode WRITE setSelectionMode)
+    Q_PROPERTY(LabelTransparency labelTransparency READ labelTransparency WRITE setLabelTransparency)
+    Q_PROPERTY(ShadowQuality shadowQuality READ shadowQuality WRITE setShadowQuality)
+    Q_PROPERTY(QString windowTitle READ windowTitle WRITE setWindowTitle)
+    Q_PROPERTY(QFont font READ font WRITE setFont)
+    Q_PROPERTY(float fontSize READ fontSize WRITE setFontSize)
+    Q_PROPERTY(bool gridVisible READ isGridVisible WRITE setGridVisible)
+    Q_PROPERTY(bool backgroundVisible READ isBackgroundVisible WRITE setBackgroundVisible)
+    Q_ENUMS(SelectionMode)
+    Q_ENUMS(ShadowQuality)
+    Q_ENUMS(LabelTransparency)
+
+public:
+    explicit Q3DScatter();
+    ~Q3DScatter();
+
+    // bar thickness, spacing between bars, and is spacing relative to thickness or absolute
+    // y -component sets the thickness/spacing of z -direction
+    // With relative 0.0f means side-to-side, 1.0f = one thickness in between
+    void setBarSpecs(QSizeF thickness = QSizeF(1.0f, 1.0f),
+                     QSizeF spacing = QSizeF(1.0f, 1.0f),
+                     bool relative = true);
+
+    // bar type; bars (=cubes), pyramids, cones, cylinders, etc.
+    void setBarType(BarStyle style, bool smooth = false);
+
+    // how many samples per row and column, and names for axes
+    // TODO: This defines the data window, needs additional parameters startRow, startColumn
+    void setupSampleSpace(int samplesRow, int samplesColumn);
+
+    // Select preset camera placement
+    void setCameraPreset(CameraPreset preset);
+
+    // Set camera rotation if you don't want to use the presets (in horizontal (-180...180) and
+    // vertical (0...90) (or (-90...90) if there are negative values) angles and distance in
+    // percentage (10...500))
+    void setCameraPosition(qreal horizontal, qreal vertical, int distance = 100);
+
+    // Set theme (bar colors, shaders, window color, background colors, light intensity and text
+    // colors are affected)
+    void setTheme(ColorTheme theme);
+
+    // Set color if you don't want to use themes. Set uniform to false if you want the (height)
+    // color to change from bottom to top
+    void setBarColor(QColor baseColor, QColor heightColor, QColor depthColor,
+                     bool uniform = true);
+
+    // Set tick count and step. Note; tickCount * step should be the maximum possible value of data
+    // set. Minimum is the absolute minimum possible value a bar can have. This is especially
+    // important to set if values can be negative.
+    void setTickCount(int tickCount, qreal step, qreal minimum = 0.0f);
+
+    // override bar type with own mesh
+    void setMeshFileName(const QString &objFileName);
+    // TODO: light placement API
+
+    // Change selection mode; single bar, bar and row, bar and column, or all
+    void setSelectionMode(SelectionMode mode);
+    SelectionMode selectionMode();
+
+    // Set window title
+    void setWindowTitle(const QString &title);
+    QString windowTitle();
+
+    // Font size adjustment
+    void setFontSize(float fontsize);
+    float fontSize();
+
+    // Set font
+    void setFont(const QFont &font);
+    QFont font();
+
+    // Label transparency adjustment
+    void setLabelTransparency(LabelTransparency transparency);
+    LabelTransparency labelTransparency();
+
+    // Enable or disable background grid
+    void setGridVisible(bool visible);
+    bool isGridVisible();
+
+    // TODO: Do these need to be public? Where are they called from?
+    // Size
+    void setWidth(const int width);
+    void setHeight(const int height);
+
+    // Enable or disable background mesh
+    void setBackgroundVisible(bool visible);
+    bool isBackgroundVisible();
+
+    // Adjust shadow quality
+    void setShadowQuality(ShadowQuality quality);
+    ShadowQuality shadowQuality();
+
+    // Axes - row & column axes are fixed to category axes, value axis can be
+    // customized.
+    QCategoryAxis *rowAxis();
+    QCategoryAxis *columnAxis();
+    void setValueAxis(QAbstractAxis *axis);
+    QAbstractAxis *valueAxis();
+
+    // Sets the data proxy. Assumes ownership of the data proxy. Deletes old proxy.
+    void setDataProxy(QtDataVis3D::QScatterDataProxy *proxy);
+    QScatterDataProxy *dataProxy();
+
+public slots:
+    // Used to detect when shadow quality changes autonomously due to e.g. resizing.
+    void handleShadowQualityUpdate(ShadowQuality quality);
+
+signals:
+    // Signals shadow quality changes.
+    void shadowQualityChanged(ShadowQuality quality);
+
+protected:
+    void render();
+
+#if defined(Q_OS_ANDROID)
+    void mouseDoubleClickEvent(QMouseEvent *event);
+    void touchEvent(QTouchEvent *event);
+#endif
+    void mousePressEvent(QMouseEvent *event);
+    void mouseReleaseEvent(QMouseEvent *event);
+    void mouseMoveEvent(QMouseEvent *event);
+    void wheelEvent(QWheelEvent *event);
+    void resizeEvent(QResizeEvent *event);
+
+private:
+    QScopedPointer<Q3DScatterPrivate> d_ptr;
+    Q_DISABLE_COPY(Q3DScatter)
+};
+
+QT_DATAVIS3D_END_NAMESPACE
+
+#endif