Documented scale, offset, set_scale_offset, _scale and _offset in pv::view::View

[pulseview.git] / pv / view / view.h

diff --git a/pv/view/view.h b/pv/view/view.h
index b7769899b7a09bf9d52988b4c469ed473be9fcca..ac2835a49cb4b6157075741d436c6708bd165727 100644 (file)
--- a/pv/view/view.h
+++ b/pv/view/view.h
@@ -1,5 +1,5 @@
 /*
- * This file is part of the sigrok project.
+ * This file is part of the PulseView project.
  *
  * Copyright (C) 2012 Joel Holdsworth <joel@airwebreathe.org.uk>
  *
@@ -18,18 +18,21 @@
  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
  */
 
-#ifndef PV_VIEW_VIEW_H
-#define PV_VIEW_VIEW_H
+#ifndef PULSEVIEW_PV_VIEW_VIEW_H
+#define PULSEVIEW_PV_VIEW_VIEW_H
 
 #include <stdint.h>
 
 #include <QAbstractScrollArea>
 
+namespace pv {
+
 class SigSession;
 
-namespace pv {
 namespace view {
 
+class Header;
+class Ruler;
 class Viewport;
 
 class View : public QAbstractScrollArea {
@@ -42,30 +45,57 @@ private:
        static const int LabelMarginWidth;
        static const int RulerHeight;
 
+       static const int MaxScrollValue;
+
+public:
+       static const int SignalHeight;
+
 public:
        explicit View(SigSession &session, QWidget *parent = 0);
 
        SigSession& session();
 
+       /**
+        * Returns the view time scale in seconds per pixel.
+        */
        double scale() const;
+
+       /**
+        * Returns the time offset of the left edge of the view in
+        * seconds.
+        */
        double offset() const;
        int v_offset() const;
 
        void zoom(double steps);
+       void zoom(double steps, int offset);
 
+       /**
+        * Sets the scale and offset.
+        * @param scale The new view scale in seconds per pixel.
+        * @param offset The view time offset in seconds.
+        */
        void set_scale_offset(double scale, double offset);
 
+       const QPoint& hover_point() const;
+
+signals:
+       void hover_point_changed();
+
 private:
+       void get_scroll_layout(double &length, double &offset) const;
+       
        void update_scroll();
 
-       void zoom(double steps, int offset);
-
 private:
+       bool eventFilter(QObject *object, QEvent *event);
+
        bool viewportEvent(QEvent *e);
 
        void resizeEvent(QResizeEvent *e);
 
 private slots:
+
        void h_scroll_value_changed(int value);
        void v_scroll_value_changed(int value);
 
@@ -75,18 +105,23 @@ private:
        SigSession &_session;
 
        Viewport *_viewport;
+       Ruler *_ruler;
+       Header *_header;
 
        uint64_t _data_length;
 
+       /// The view time scale in seconds per pixel.
        double _scale;
+
+       /// The view time offset in seconds.
        double _offset;
 
        int _v_offset;
 
-       friend class Viewport;
+       QPoint _hover_point;
 };
 
 } // namespace view
 } // namespace pv
 
-#endif // PV_VIEW_VIEW_H
+#endif // PULSEVIEW_PV_VIEW_VIEW_H