X-Git-Url: https://sigrok.org/gitweb/?p=pulseview.git;a=blobdiff_plain;f=pv%2Fviews%2Ftrace%2Ftrace.hpp;h=410d82cd14e8c9121e9a758024dee4c5d540204f;hp=88b4ea6b032a7d202896e4aa9264bb0ccb3aa7fe;hb=f228f00ed2c11ce4c9c36e0b758132a075e251da;hpb=1573bf16ba50d1c023ad3a9ce596f0ab6eaeacff

diff --git a/pv/views/trace/trace.hpp b/pv/views/trace/trace.hpp
index 88b4ea6b..410d82cd 100644
--- a/pv/views/trace/trace.hpp
+++ b/pv/views/trace/trace.hpp
@@ -49,16 +49,47 @@ 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 View::on_segment_changed
+	 * @ref AnalogSignal::get_analog_segment_to_paint
+	 * @ref AnalogSignal::get_logic_segment_to_paint
+	 * @ref LogicSignal::get_logic_segment_to_paint
+	 * @ref StandardBar
+	 */
+	enum SegmentDisplayMode {
+		ShowLastSegmentOnly = 1,
+		ShowLastCompleteSegmentOnly,
+		ShowSingleSegmentOnly,
+		ShowAllSegments,
+		ShowAccumulatedIntensity
+	};
+
 private:
 	static const QPen AxisPen;
 	static const int LabelHitPadding;
 
-	static const QColor BrightGrayBGColour;
-	static const QColor DarkGrayBGColour;
+	static const QColor BrightGrayBGColor;
+	static const QColor DarkGrayBGColor;
 
 protected:
 	Trace(shared_ptr<data::SignalBase> channel);
@@ -70,14 +101,9 @@ public:
 	shared_ptr<data::SignalBase> base() const;
 
 	/**
-	 * Sets the name of the signal.
+	 * Configures the segment display mode to use.
 	 */
-	virtual void set_name(QString name);
-
-	/**
-	 * Set the colour of the signal.
-	 */
-	virtual void set_colour(QColor colour);
+	virtual void set_segment_display_mode(SegmentDisplayMode mode);
 
 	/**
 	 * Paints the signal label.
@@ -98,6 +124,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.
@@ -114,7 +144,7 @@ protected:
 	 */
 	void paint_axis(QPainter &p, ViewItemPaintParams &pp, int y);
 
-	void add_colour_option(QWidget *parent, QFormLayout *form);
+	void add_color_option(QWidget *parent, QFormLayout *form);
 
 	void create_popup_form();
 
@@ -123,17 +153,23 @@ protected:
 protected Q_SLOTS:
 	virtual void on_name_changed(const QString &text);
 
-	virtual void on_colour_changed(const QColor &colour);
+	virtual void on_color_changed(const QColor &color);
 
 	void on_popup_closed();
 
 private Q_SLOTS:
 	void on_nameedit_changed(const QString &name);
 
-	void on_colouredit_changed(const QColor &colour);
+	void on_coloredit_changed(const QColor &color);
 
 protected:
 	shared_ptr<data::SignalBase> base_;
+	QPen axis_pen_;
+
+	SegmentDisplayMode segment_display_mode_;
+
+	/// The ID of the currently displayed segment
+	int current_segment_;
 
 private:
 	pv::widgets::Popup *popup_;