/**************************************************************************** ** ** Copyright (C) 2013 Digia Plc ** All rights reserved. ** For any questions to Digia, please use contact form at http://qt.digia.com ** ** This file is part of the QtDataVis3D module. ** ** Licensees holding valid Qt Enterprise licenses may use this file in ** accordance with the Qt Enterprise 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.digia.com ** ****************************************************************************/ #ifndef Q3DBARS_H #define Q3DBARS_H #include #include #include QT_DATAVIS3D_BEGIN_NAMESPACE class Q3DBarsPrivate; class QCategoryAxis; class QValueAxis; class QBarDataProxy; class QT_DATAVIS3D_EXPORT Q3DBars : public Q3DWindow { Q_OBJECT Q_PROPERTY(QtDataVis3D::QDataVis::SelectionMode selectionMode READ selectionMode WRITE setSelectionMode) Q_PROPERTY(QtDataVis3D::QDataVis::LabelTransparency labelTransparency READ labelTransparency WRITE setLabelTransparency) Q_PROPERTY(QtDataVis3D::QDataVis::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(QtDataVis3D::QDataVis::SelectionMode) Q_ENUMS(QtDataVis3D::QDataVis::ShadowQuality) Q_ENUMS(QtDataVis3D::QDataVis::LabelTransparency) public: explicit Q3DBars(); ~Q3DBars(); // 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(QDataVis::MeshStyle 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); QSize sampleSpace() const; // TODO: Return QRect once data window properly implemented? // Select preset camera placement void setCameraPreset(QDataVis::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(QDataVis::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); // 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(QDataVis::SelectionMode mode); QDataVis::SelectionMode selectionMode() const; // Set window title void setWindowTitle(const QString &title); QString windowTitle() const; // Font size adjustment void setFontSize(float fontsize); float fontSize(); // Set font void setFont(const QFont &font); QFont font() const; // Label transparency adjustment void setLabelTransparency(QDataVis::LabelTransparency transparency); QDataVis::LabelTransparency labelTransparency() const; // Enable or disable background grid void setGridVisible(bool visible); bool isGridVisible() const; // Size void setWidth(const int width); void setHeight(const int height); // Enable or disable background mesh void setBackgroundVisible(bool visible); bool isBackgroundVisible() const; // Adjust shadow quality void setShadowQuality(QDataVis::ShadowQuality quality); QDataVis::ShadowQuality shadowQuality() const; // Axes - row & column axes are fixed to category axes, value axis can be // customized. QCategoryAxis *rowAxis(); QCategoryAxis *columnAxis(); void setValueAxis(QValueAxis *axis); QValueAxis *valueAxis(); // Sets the data proxy. Assumes ownership of the data proxy. Deletes old proxy. void setDataProxy(QBarDataProxy *proxy); QBarDataProxy *dataProxy(); public slots: // Used to detect when shadow quality changes autonomously due to e.g. resizing. void handleShadowQualityUpdate(QDataVis::ShadowQuality quality); signals: // Signals shadow quality changes. void shadowQualityChanged(QDataVis::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 d_ptr; Q_DISABLE_COPY(Q3DBars) }; QT_DATAVIS3D_END_NAMESPACE #endif