Qt5 Downsampler UI

Table of Contents

• Plugin Information
• Plugin Versions
• Component Information
• Properties
• Dynamic Pins
• Required Interfaces
• Introduction
• Workflow downsampling & filtering
  • Stream Visualization
  • Selection and Interaction
  • Processing
  • Configuration and Portability

Plugin Information

Plugin Filename	adtf_qt5.adtfplugin
Plugin Description	adtf_qt5.plugindescription
Plugin Name	Qt5 Plugin
License	ADTF Subscription
Support Mail	support@digitalwerk.net
Homepage URL	https://adtf.dev/

Plugin Versions

Plugin Version	1.99.99
Plugin File Version	1.0
adtf	3.24.0
adtf::ucom	3.1.0

Component Information

Name	Qt5 Downsampler UI
CID	qt5_downsampler.ui_filter.adtf.cid
Description	Use this UI filter to create a 'Substream Reducer' and 'Subsampler' input file. Drag and drop streams from the Qt5 Stream Display.
Type	Filter

Properties

Name	Value	Type	Description	Subproperties
filter_file		cFilename		Value Range: minimum = maximum = Filename Extension Filter: JSON (*.json)
log_channels/default/fatal_action	2	tUInt32	The default action when a fatal error is reported.	Value List: Stop session = 2 Shutdown ADTF = 3 Abort to crash handler = 4Value Range: minimum = maximum = Filename Extension Filter:
log_channels/default/log_level	35	tUInt8	The log level for this channel.	Value List: None = 0 Error = 10 Warning = 20 Info = 30 Detail = 35 Dump = 40 All = 255Value Range: minimum = maximum = Filename Extension Filter:
log_channels/default/recoverable_action	0	tUInt8	The action to perform when a recoverable error is reported.	Value List: Log only = 0 Treat as fatal = 1Value Range: minimum = maximum = Filename Extension Filter:
title		cString	Window title which will be used at runtime within Qt5 ADTF XSystem UI Service.	Value Range: minimum = maximum = Filename Extension Filter:

Dynamic Pins

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

Required Interfaces

IID
qt_xsystem.v1.services.adtf.iid
reference_clock.vision.streaming.adtf.iid

Introduction

The Qt5 Downsampling UI is available for the Substream Reducer and Subsampler filter which are included in the ADTF package. It allows the user to conveniently configure the filter_file property. To do this, a JSON file is generated, which can be edited via the UI. The UI simplifies the process of configuring the filter and subsampling settings. Please note that the subsampling option is also available for selection within the Substream Reducer, just as the filtering option is available within the Subsampler. However, these settings are ignored by the respective filter. To perform correct subsampling combined with filtering, both the Substream Reducer and the Subsampler are required.

Workflow downsampling & filtering

Stream Visualization

The process begins at the Qt5 Stream Display, which serves as the central display for all incoming data.
It fetches and displays a comprehensive list of all available active substreams.
Each stream entry provides essential details (e.g. sample rate) to help the user identify the correct source.

Selection and Interaction

Once the target streams are identified, the user interacts directly with the visual list elements:

• Identification: The user locates the specific sub-stream(s) intended for processing.
• Active Drag-and-Drop: Using a mouse or touch interface, the user grabs the stream(s) from the Qt5 Stream Display and drops them to the Qt5 Downsampler UI

Processing

After saving the changes and restarting the session, only the filtered/downsampled streams are processed.

Configuration and Portability

The system allows for seamless migration and reuse of processing logic through two primary methods:

JSON Import/Load:

• Users can bypass manual configuration by importing pre-existing filter or subsampling JSON files.
• This ensures consistency across different sessions and allows quick deployment of standardized processing templates.
  

Cross-UI Synchronization (Drag-and-Drop Copying):

• If a user e.g. requires downsampling in addition to substream filtering, the user can simply attach a Subsampler filter to the pipeline.
• Instead of manually re-selecting the streams, the user can perform a bulk drag-and-drop of all streams already configured in the Substream Reducer filter.
• By dragging these pre-configured streams into the Subsampler UI of the Subsampler, all source settings are preserved.
• Afterwards the downsampling logic can be modified. This will also work in the other direction. So the user can simply drag a configured stream or filter set from one Qt5 Downsampling UI display and drop it into another.