Qt5 Stream Display Plugin

Table of Contents

• Qt5 Stream Display
• Substream Selector For Qt5 Stream Display
• Basic Usage
• Plot View
  • What the display can do
  • Adding stream elements
  • Overview of selected stream elements
  • Depicting multiple stream elements in different y modes
  • Moving graph area
  • Zooming mode
  • Selecting mode/Measurement Cursor
  • Other functions
  • Shortcuts & mouse buttons

Introduction

This binary provides options to visualize any connected data source on demand, manage substream requests and more.

Qt5 Stream Display

Plugin Information

Plugin Filename	adtf_stream_display.adtfplugin
Plugin Description	adtf_stream_display.plugindescription
Plugin Name	Qt5 Stream Display Plugin
License	ADTF
Support Mail	support@digitalwerk.net
Homepage URL	support.digitalwerk.net

Plugin Versions

Plugin Version	3.99.99
Plugin File Version	1.0
adtf	3.99.99
adtf::ucom	3.1.0

Component Information

Name	Qt5 Stream Display
CID	stream_display.ui_filter.adtf.cid
Description	Use this UI filter to visualize any connected data source on demand, manage substream requests and more.
Type	Filter

Properties

Name	Value	Type	Description	Subproperties
max_show_array_element_count	1024	tUInt64	The maximal count of array elements which are shown in substream treeview.
processing_delay_treshold	500	tUInt32	The maximal accepted delay time between incoming data and last GUI processed data before incoming data thread is slowed down (milliseconds, 0 - switched off, 500ms - default)
request_substreams_format	0	tUInt8	Format of substream requests.	Value List: plain = 0 prefix = 2 wildcard = 3 regex = 4
request_substreams_from_file	$(ADTF_SESSION_DIR)/$(ADTF_SESSION_FILE_NAME_NOEXT)_$(THIS_OBJECT_NAME)_request_substream.txt	cFilename	Line-separated file for substream requests. The input pin must be prefixed.
request_substreams_from_string		cString	Semicolon-separated string for substream requests. The input pin must be prefixed.
request_substreams_mode	1	tUInt8	Mode to interpret substream request list.	Value List: Use property request_substreams_from_file = 1 Use property request_substreams_from_string = 2
save_requested_substreams_on_shutdown	false	tBool	Whether the requested substreams shall be saved on shutdown.
store_settings	true	tBool	Whether the filter state shall be stored in settings.
title		cString	Window title which will be used at runtime within Qt5 ADTF XSystem UI Service.

Input Binding Objects

Name	IID	Proxy OID	Description
stream_view_server	stream_view_server.riddler.adtf.iid		Interface server to provide access to stream view server factory
qtshared_server	qtshared.giant.ui.adtf.iid		Interface server as qtshared interface to provide access to display server factory for QML

Dynamic Pins

Dynamic Input Pins	true
Dynamic Output Pins	false
Dynamic Input Binding Pins	false
Dynamic Output Binding Pins	false

Required Interfaces

IID
qt_xsystem.spider.services.adtf.iid

Substream Selector For Qt5 Stream Display

Plugin Information

Plugin Filename	adtf_stream_display.adtfplugin
Plugin Description	adtf_stream_display.plugindescription
Plugin Name	Qt5 Stream Display Plugin
License	ADTF
Support Mail	support@digitalwerk.net
Homepage URL	support.digitalwerk.net

Plugin Versions

Plugin Version	3.99.99
Plugin File Version	1.0
adtf	3.99.99
adtf::ucom	3.1.0

Component Information

Name	Substream Selector For Qt5 Stream Display
CID	streamdisplay_selector.streaming.adtf.cid
Description	Use this filter to select a substream given by the Qt5 Stream Display.
Type	Filter

Properties

Name	Value	Type	Description	Subproperties
name	Substream Display Selector Name	cString	Name of the selector.

Input Pins

Name	Stream Type	Description
substreams	adtf/substreams	Input substream from which it is selected.

Output Pins

Name	Stream Type	Description
output	qt5_stream_display_plugin_streamdisplay_selector_streaming_adtf_cid_output	Provides a selected substream.

Runner

Name	Activation Type	Data Triggered	Data Input	Thread Triggered	Thread Cyclic	Timer Triggered	Timer Interval	Description
process_substreams	9	1	substreams	0	0	0	0	Default runner port for the input pin 'substreams'

Output Binding Objects

Name	IID	Proxy OID	Description
stream_view_server	stream_view_server.riddler.adtf.iid		Display server object from Qt5 Stream Display.

Dynamic Pins

Dynamic Input Pins	false
Dynamic Output Pins	false
Dynamic Input Binding Pins	false
Dynamic Output Binding Pins	false

Input Pin Stream Types

Pin Name	substreams
Meta Type Name	adtf/substreams
Stream Type Properties	Name Value Type Description Subproperties substreams true tBool

Output Pin Stream Types

Pin Name	output
Meta Type Name
Stream Type Properties

Basic Usage

For a first usage, the example session Visualization using Qt5 Stream Display will show the basic functionality how to create displays on demand at runtime for streams.

Furthermore, it offers a use case to request content for the recorder within UI.

Plot View

This description covers the Plot View which is part of the Qt5 Stream Display plugin.

What the display can do

• Depicting multiple stream elements.
• Auto tracing stream elements.
• Zooming
• Depicting in various y modes
• Selecting a single sample or a range of samples for further operations.
• Exporting stream elements.

The display is split into to main views:

• Left: Overview of selected stream elements to plot.
• Right: The graph area to plot the data points over time.

Adding stream elements

You can add multiple stream elements to the display either via context menu entry or using drag and drop.

Note

Please note that currently only the drag and drop of single elementar stream elements is supported. (Drag and drop of streams, structs, arrays as a block is not possible.)

Overview of selected stream elements

The left view gives an overview of selected stream elements including meta information of the added stream elements like name, minimum/maximum/average value. You can access several stream element administration functions via the context menu on the stream element view:

With the related checkbox of stream element you can set the visibility of the stream element.

Context menu items

• Properties. Shows the properties dialog.
  • Color. Change the color of the stream element graph.
  • Line Style. Controls the line style of the graph.
  • Scale. Causes the graph to be scaled in y direction. This is a relative value.
  • Offset. Causes the graph to be moved in y direction. This value is in units of the quantity
  • Min Value. Set the minimum value of stream element. This is significant for the case if the stream element meta information doesn't contain a minimum value.
  • Max Value. Set the maximum value of stream element. This is significant for the case if the stream element meta information doesn't contain a maximum value.
  • Plot Data Points. Causes the data points of the stream element to be drawn in the graph.
• Show Full stream element Names. Shows the full stream element names.
• Show Short stream element Names. Shows the short stream element names.
• Remove. Removes the stream element.
• Activate. Activates the selected stream elements so that they are visible.
• Deactivate. Deactivates the selected stream elements so that they are invisible.
• Show scales. Shows the scales of the selected stream elements.
• Hide scales. Hides the scales of the selected stream elements.
• Equalize to One Scale. Set the scaling of the selected stream elements to a common scaling. The graph is zoomed so that the common minimal and maximum values are visible.

Depicting multiple stream elements in different y modes

Multiple stream elements can be depicted in different y modes related to the y scale (axis).

• Single scale. The y scales of the stream elements are united in a common scale.
• Independent scale. Each stream element has its own scale.
• Stack scale. Each stream element has its own view. The views are vertically stacked. The graphs are aligned related to the time scale.

The y mode is set via the y mode combobox.

Moving graph area

The graph area can be moved in x direction by holding the middle mouse button (or mouse wheel button) pressed and moving the mouse.

The stream element view has the modes of mouse control: zooming and selecting.

Zooming mode

The zoom direction can be set to horizontal (x/time), vertical (y) or to both variants. These works when

• button "Zoom-in" or button "Zoom-out" is pressed
• the zoom mode is switched on (toggle button ) and spanning by mouse (holding left button pressed) an area that is zoomed in.

Note

Due to technical circumstances, time values are currently only displayed accurately to a level of approximately 10 microseconds in the plot. In very large zoom levels, time values below this level are not displayed accurately.

The zoom direction is set via the respective toggle buttons "Zoom X Only" , "Zoom Y Only" , "Zoom Both"

Selecting mode/Measurement Cursor

You can select a single point (=single selection) or a range (=difference selection).

Based on the current selected range you can e.g. export the values between the two measurement cursors.

The selection can be done horizontally/vertically respectively single point/range. The combination of horizontal/vertical and single/range is mapped by the toggle buttons "Single selection horizontal mode" , "Single selection vertical mode" , "Difference selection horizontal mode" , "Difference selection vertical mode" . These buttons switch on the selecting mode.

Single Point

• A measurment cursor line can set by clicking the left mouse button within the plot
• At the point where the measurement cursor line crosses the axis the corresponding value will be shown within a label

Range

• Two measurment cursor lines can be set by clicking the left mouse button and dragging the mouse.
• The average, min and max value will as well as the difference between the values at the measurement cursors will be shown

Other functions

Follow mode

By default the Plot View starts with following the current time. That is the display permanently scrolls to the last time stamp. To stop this you can switch off the follow mode via toggling the button "Follow mode" . Switching on this button let the display continue following.

Auto y zoom

By clicking the button "Auto Y Zoom" you can fit-in once the stream element in y direction.

Auto y zoom time triggered

By clicking the button "Auto Y Zoom Time Triggered" you can have permanently automatic fitted-in the stream element in y direction. This is often useful when following the current time (follow mode).

Reset Zoom

By clicking the button "Reset Zoom" you can reset the x zoom and thus the visible ranges of the x/time values to their initial settings.

Equalize All Scales

By clicking the button "Equalize All Scales" you can set the scaling of all stream elements to a common scaling. The graph is zoomed so that the common minimal and maximum values are visible.

Reset All Scales

By clicking the button "Reset All Scales" you can reset the y zoom and thus the visible ranges of the y values to their initial settings.

Settings

By clicking the button "Settings" you can change some settings.

• X Range Reserve (relative) Controls the reserve distance between last signal value and right margin on the x axis. The value is relative and refers to the visible x range.
• Y Range Reserve (relative) Controls the reserve distance between last signal value and top margin on the y axis. The value is relative and refers to the visible y range.
• Signal Label Offset (pixel) Controls the x/y the (value) label position to point where measurement cursor line crosses the axis.
• Background Color Controls the background color of the plot.
• Grid color Controls the grid color of the plot.
• Text and Single Scale Color Controls the color of texts and the single scale y axis of the plot.

Shortcuts & mouse buttons

• Shift + left mouse button and moving. Shifting plot in y direction.
• Middle mouse button and moving. Shifting plot in x direction.
• Left mouse button and moving. Spanning selection or zooming into spanned area.
• Right mouse button and moving. Zooming out.
• Ctrl + mouse wheel. Zooming in/out dependent on zoom mode.
• Shift + mouse wheel. Shifting in y direction.
• Mouse wheel only. Shifting in x direction.