sdrangel/sdrgui/feature
Jon Beniston d1c67c971e Add buttons to stack MDI windows vertically and put in tabs.
Use right click to auto-stack sub-windows, rather than having a
dedicated button.
Allow maximize button to make window full screen, if already maximized.
Add title to device windows, for when displayed in tabs.
Add menu button to workspace toolbar, for Android only, to avoid having
menu bar, which takes up a lot of space.
Add configuration presets button to workspace toolbar.
Add icons for window arangement
2022-12-20 16:10:11 +00:00
..
featuregui.cpp Add buttons to stack MDI windows vertically and put in tabs. 2022-12-20 16:10:11 +00:00
featuregui.h Add buttons to stack MDI windows vertically and put in tabs. 2022-12-20 16:10:11 +00:00
featureuiset.cpp
featureuiset.h
readme.md

readme.md

Feature common controls

The feature windows have common top and bottom bars

Feature window

Top bar

1: Feature index

Displays the index of the feature in the list of features as "F" followed by semicolon and index number.

The tooltip displays the feature type name.

You may click on this area and drag the window with the mouse.

2: Common feature settings

Opens a dialog to update the common feature settings

Feature window

2.1: Window title

Changes the feature window title

2.2: Reset title to default

Resets the title to the feature type name.

2.3: Toggle reverse API feature

Use this checkbox to toggle on/off the reverse API feature. With reverse API engaged the changes in the feature settings are forwarded to an API endpoint given by address (8.2.4), port (8.2.5), feature set index (8.2.6) and feature index (8.2.7) in the same format as the SDRangel REST API feature settings endpoint. With the values of the screenshot the API URL is: http://127.0.0.1:8888/sdrangel/featureeset/0/feature/0/settings The JSON payload follows the same format as the SDRangel REST API feature settings. Using the same example this would be:

{
  "SimplePTTSettings": {
    "reverseAPIAddress": "127.0.0.1",
    "reverseAPIChannelIndex": 0,
    "reverseAPIDeviceIndex": 0,
    "reverseAPIPort": 8888,
    "rgbColor": -65536,
    "rx2TxDelayMs": 200,
    "rxDeviceSetIndex": 0,
    "title": "Simple PTT",
    "tx2RxDelayMs": 200,
    "txDeviceSetIndex": 1,
    "useReverseAPI": 0
  },
  "featureType": "SimplePTT"
}

Note that the PATCH method is used. The full set of parameters is sent with the PUT method only when the reverse API is toggled on or a full settings update is done.

2.4: API address

This is the IP address of the API endpoint

2.5: API port

This is the IP port of the API endpoint

2.6: Feature set index

This is the targeted feature set index

2.7: Feature index

This is the targeted feature index

2.8: Cancel changes and exit dialog

Do not make any changes and exit dialog

2.9: Validate and exit dialog

Validates the data and exits the dialog

3: Title

This is the default feature title or as set with (2.1).

You may click on this area and drag the window with the mouse.

4: Help

Clicking on this button opens the documentation about the feature controls in github in the browser.

5: Move to another workspace

Opens a dialog to choose a destination workspace to move the feature window to. Nothing happens if the same workspace is selected.

6: Shrink window

Click this button to reduce the window to its minimum size

7: Close window

Closes the window and deletes the feature

8: Status

Status messages if any appear here.

You may click on this area and drag the window with the mouse.