X-Git-Url: http://git.code-monkey.de/?a=blobdiff_plain;f=pv%2Fviews%2Ftrace%2Ftrace.hpp;h=777ea5001198a3cb355540006a43bfbc2f222e82;hb=8c3397413149b87d2755494fe73186f27edab369;hp=88b4ea6b032a7d202896e4aa9264bb0ccb3aa7fe;hpb=1573bf16ba50d1c023ad3a9ce596f0ab6eaeacff;p=pulseview.git diff --git a/pv/views/trace/trace.hpp b/pv/views/trace/trace.hpp index 88b4ea6..777ea50 100644 --- a/pv/views/trace/trace.hpp +++ b/pv/views/trace/trace.hpp @@ -49,10 +49,39 @@ class Popup; namespace views { namespace trace { +/** + * The Trace class represents a @ref TraceTreeItem which occupies some vertical + * space on the canvas and spans across its entire width, essentially showing + * a time series of values, events, objects or similar. While easily confused + * with @ref Signal, the difference is that Trace may represent anything that + * can be drawn, not just numeric values. One example is a @ref DecodeTrace. + * + * For this reason, Trace is more generic and contains properties and helpers + * that benefit any kind of time series items. + */ class Trace : public TraceTreeItem { Q_OBJECT +public: + /** + * Allowed values for the multi-segment display mode. + * + * Note: Consider these locations when updating the list: + * * + * @ref View::set_segment_display_mode + * @ref AnalogSignal::get_analog_segment_to_paint + * @ref AnalogSignal::get_logic_segment_to_paint + * @ref LogicSignal::get_logic_segment_to_paint + */ + enum SegmentDisplayMode { + ShowLastSegmentOnly = 1, + ShowLastCompleteSegmentOnly, + ShowSingleSegmentOnly, + ShowAllSegments, + ShowAccumulatedIntensity + }; + private: static const QPen AxisPen; static const int LabelHitPadding; @@ -79,6 +108,11 @@ public: */ virtual void set_colour(QColor colour); + /** + * Configures the segment display mode to use. + */ + virtual void set_segment_display_mode(SegmentDisplayMode mode); + /** * Paints the signal label. * @param p the QPainter to paint into. @@ -98,6 +132,10 @@ public: */ QRectF label_rect(const QRectF &rect) const; + void set_current_segment(const int segment); + + int get_current_segment() const; + protected: /** * Paints the background layer of the signal with a QPainter. @@ -134,6 +172,12 @@ private Q_SLOTS: protected: shared_ptr base_; + QPen axis_pen_; + + SegmentDisplayMode segment_display_mode_; + + /// The ID of the currently displayed segment + int current_segment_; private: pv::widgets::Popup *popup_;