Add lib/libkdchart

2012-02-11 14:34:29 +01:00
parent 67e00fcaa1
commit 9e1686bd6e
278 changed files with 221 additions and 13 deletions
--- a/lib/libkdchart/src/KDChartAbstractCartesianDiagram.h
+++ b/lib/libkdchart/src/KDChartAbstractCartesianDiagram.h
@@ -0,0 +1,132 @@
+/****************************************************************************
+** Copyright (C) 2001-2011 Klaralvdalens Datakonsult AB.  All rights reserved.
+**
+** This file is part of the KD Chart library.
+**
+** Licensees holding valid commercial KD Chart licenses may use this file in
+** accordance with the KD Chart Commercial License Agreement provided with
+** the Software.
+**
+**
+** This file may be distributed and/or modified under the terms of the
+** GNU General Public License version 2 and version 3 as published by the
+** Free Software Foundation and appearing in the file LICENSE.GPL.txt included.
+**
+** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
+** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+**
+** Contact info@kdab.com if any conditions of this licensing are not
+** clear to you.
+**
+**********************************************************************/
+
+#ifndef KDCHARTABSTRACTCARTESIANDIAGRAM_H
+#define KDCHARTABSTRACTCARTESIANDIAGRAM_H
+
+#include "KDChartCartesianCoordinatePlane.h"
+#include "KDChartAbstractDiagram.h"
+#include "KDChartCartesianAxis.h"
+
+namespace KDChart {
+
+    class GridAttributes;
+//    class PaintContext;
+
+    /**
+     * @brief Base class for diagrams based on a cartesian coordianate system.
+     *
+     * The AbstractCartesianDiagram interface adds those elements that are
+     * specific to diagrams based on a cartesian coordinate system to the
+     * basic AbstractDiagram interface.
+     */
+    class KDCHART_EXPORT AbstractCartesianDiagram : public AbstractDiagram
+    {
+        Q_OBJECT
+        Q_DISABLE_COPY( AbstractCartesianDiagram )
+//        KDCHART_DECLARE_PRIVATE_DERIVED( AbstractCartesianDiagram )
+        KDCHART_DECLARE_DERIVED_DIAGRAM( AbstractCartesianDiagram, CartesianCoordinatePlane )
+
+    public:
+        explicit AbstractCartesianDiagram ( QWidget* parent = 0, CartesianCoordinatePlane* plane = 0 );
+        virtual ~AbstractCartesianDiagram();
+
+        /**
+         * Returns true if both diagrams have the same settings.
+         */
+        bool compare( const AbstractCartesianDiagram* other )const;
+
+#if QT_VERSION < 0x040400 || defined(Q_COMPILER_MANGLES_RETURN_TYPE)
+        virtual const int numberOfAbscissaSegments () const = 0;
+        virtual const int numberOfOrdinateSegments () const = 0;
+#else
+        virtual int numberOfAbscissaSegments () const = 0;
+        virtual int numberOfOrdinateSegments () const = 0;
+#endif
+        /**
+         * Add the axis to the diagram. The diagram takes ownership of the axis
+         * and will delete it.
+         *
+         * To gain back ownership (e.g. for assigning the axis to another diagram)
+         * use the takeAxis method, before calling addAxis on the other diagram.
+         *
+         * \sa takeAxis
+        */
+        virtual void addAxis( CartesianAxis * axis );
+        /**
+         * Removes the axis from the diagram, without deleting it.
+         *
+         * The diagram no longer owns the axis, so it is
+         * the caller's responsibility to delete the axis.
+         *
+         * \sa addAxis
+        */
+        virtual void takeAxis( CartesianAxis * axis );
+        /**
+         * @return a list of all axes added to the diagram
+        */
+        virtual KDChart::CartesianAxisList axes () const;
+
+        /**
+          * Triggers layouting of all coordinate planes on the current chart.
+          * Normally you don't need to call this method. It's handled automatically for you.
+         */
+        virtual void layoutPlanes();
+        /** \reimpl */
+        virtual void setCoordinatePlane( AbstractCoordinatePlane* plane );
+
+        /**
+          * Makes this diagram use another diagram \a diagram as reference diagram with relative offset
+          * \a offset.
+          * To share cartesian axes between different diagrams there might be cases when you need that.
+          * Normally you don't.
+          * \sa examples/SharedAbscissa
+          */
+        virtual void setReferenceDiagram( AbstractCartesianDiagram* diagram, const QPointF& offset = QPointF() );
+        /**
+          * @return this diagram's reference diagram
+          *  \sa setReferenceDiagram
+          */
+        virtual AbstractCartesianDiagram* referenceDiagram() const;
+        /**
+          * @return the relative offset of this diagram's reference diagram
+          * \sa setReferenceDiagram
+          */
+        virtual QPointF referenceDiagramOffset() const;
+
+        /* reimpl */
+        void setModel( QAbstractItemModel* model );
+        /* reimpl */
+        void setRootIndex( const QModelIndex& index );
+        /* reimpl */
+        void setAttributesModel( AttributesModel* model );
+
+    protected:
+        /** @return the 3D item depth of the model index \a index */
+        virtual double threeDItemDepth( const QModelIndex& index ) const = 0;
+        /** @return the 3D item depth of the data set \a column */
+        virtual double threeDItemDepth( int column ) const = 0;
+    };
+
+}
+
+#endif