Interface Customization
Introduction
The LabRPS interface is based on the modern Qt toolkit and has a state-of-the-art organization. Some aspects of the interface can be customized. You can, for example, add custom toolbars, with tools from several workbenches or tools defined in macros, and you can create your own keyboard shortcuts. But the menus and default toolbars that come with LabRPS and its workbenches cannot be changed.
The Customize dialog box
Usage
- The commands available in the Customize dialog box depend on the workbenches that have been loaded in the current LabRPS session. So you should first load all workbenches whose commands you want to have access to.
- There are several ways to invoke the Std DlgCustomize command:
- The Customize dialog box opens. For more information see Options.
- The Help button does not work at this time.
- Press the Close button to close the dialog box.
Options
In the Customize dialog box the following tabs are available:
Keyboard
The Keyboard tab
On this tab custom keyboard shortcuts can be defined. Shortcuts for macro commands can be defined on the Macros tab.
Search
You can search for commands by entering at least 3 characters of their menu text or name in the search field. The search is case-insensitive.
It is also possible to search for shortcuts:
- In the search field special keys in shortcuts must be entered as strings. For example to search for commands that use Ctrl in their shortcut enter
ctrl
(4 letters). - Add parenthesis to search for single character shortcuts, for example:
(c)
. - Add a comma and space between the characters of multi-character shortcuts, for example:
g, b, b
.
Add a shortcut
- Select a command category from the Category dropdown list.
- Select a command from the Commands panel.
- Optionally click the
Command
,Shortcut
orDefault
column headings to reorder the list. - Optionally drag the splitter to the right of the panel to resize it.
- Optionally click the
- The Current shortcut box displays the current short cut, if available.
- Enter a new shortcut in the New shortcut input box. Shortcuts can be up to 4 inputs long. Each input is either a single character, a combination of one or more special keys or a combination of one or more special keys and a character. Use Backspace to correct mistakes.
- Other active commands (see Notes) that already use the shortcut will be listed in the Shortcut priority list.
- Press the Assign button to assign the new shortcut.
- If the Shortcut priority list contains more than one command: optionally change its order by selecting individual commands and pressing the Up button or the Down button. If active commands share the same shortcut, the shortcut will trigger the one that is highest in the list.
Remove a shortcut
- Select a command category from the Category dropdown list.
- Select a command from the Commands panel.
- Press the Clear button.
Restore a default shortcut
- Select a command category from the Category dropdown list.
- Select a command from the Commands panel.
- Press the Reset button.
Restore all default shortcuts
- Press the Reset All button.
Notes
- Shortcuts only work for active commands. Active commands are commands that appear in the standard menu, or in the menu of the active workbench, or commands that appear in a visible toolbar.
Toolbars
The Toolbars tab
On this tab custom toolbars can be created and modified.
Search
See Keyboard.
Select the workbench
- In the dropdown list on the right select the workbench whose custom toolbars you want to modify. The
Global
option is there for custom toolbars that should be available in all workbenches.
Create a toolbar
- Press the New... button.
- Enter a name in the dialog box that opens.
- Press the OK button.
- The new toolbar will appear in the panel on the right.
Rename a toolbar
- Select a toolbar in the panel on the right.
- Press the Rename... button.
- Enter a new name in the dialog box that opens.
- Press the OK button.
Delete a toolbar
- Select a toolbar in the panel on the right.
- Press the Delete button.
Disable a toolbar
- Uncheck the checkbox in front of the toolbar name in the panel on the right.
- A disabled toolbar will be invisible in the LabRPS interface.
Add a command
- At least one custom toolbar is required. See Create a toolbar.
- Select the correct toolbar in the panel on the right. If no toolbar is selected, the command will be added to the first toolbar in the list.
- Select a command category from the Category dropdown list. Macro commands that have been set up on the Macros tab appear in the
Macros
category. - Select a command from the Commands panel, or select
<Separator>
to add a separator (a line between two toolbar buttons).- Optionally drag the splitter to the right of the panel to resize it.
- Press button.
Remove a command
Change a command position
- If required, expand the toolbar in the panel on the right.
- Select a command.
- Press the button or the button.
- Optionally repeat this until the command is in the correct position.
Notes
- Toolbars belonging to the current workbench are updated immediately, but after disabling/re-enabling a toolbar a workbench change is required (switch to a different workbench and then switch back).
- To update global toolbars a workbench change (if commands have been added or removed) or a restart (if the order of a toolbar has changed or a toolbar was renamed) is required.
Macros
The Macros tab
On this tab macro commands can be set up. Once set up, they can be added to custom toolbars. Macros installed with the Addon Manager are set up automatically, and added to a Global
toolbar (see Toolbars), if you confirm the Add button popup during the installation process.
If you want to use a macro downloaded from a different source you will have to install it manually. See How to install macros for more information. Note that LabRPS uses a dedicated folder for macros and only macros in that folder can be set up. Use the Std DlgMacroExecute command to find this folder on your system.
Add a macro command
- In the Macro dropdown list select a macro.
- Enter a Menu text. This will be the name used to identify the macro command and will also appear in the toolbar if there is no icon.
- Optionally enter a Tool tip. This text will appear near the location of the mouse when you hover the toolbar icon.
- Optionally enter a Status text. This text will appear in the status bar when you hover the toolbar icon.
- Optionally enter the wiki page for the macro, if available, in the What's this input box. Enter the page name, not the full URL.
- Optionally enter a shortcut in the Accelerator input box. See Keyboard for more information.
- To add an icon:
- Press the Pixmap ... button.
- The Choose Icon dialog box opens.
- If required press the Icon folders... button to add an icon folder.
- Select an icon from the panel. The Choose Icon dialog box closes automatically.
- Press the Add button.
- The macro command appears in the panel on the left.
- The macro command can now be selected on the Toolbars tab.
Remove a macro command
- Select the macro command in the panel on the left.
- Press the Remove button.
Change a macro command
- Double-click the macro command in the panel on the left.
- Make the required changes. Note that you cannot remove the icon, you can only replace it.
- Press the Replace button.
Themes
LabRPS supports complete theming of the interface, via .qss stylesheets. The qss format is very similar to the css format used in web pages, it basically adds methods to reference the different widgets and elements of the Qt interface. You can change the default theme (which simply takes the style defined by your desktop system) by selecting a style sheet in the LabRPS preferences.
You can also create your own theme if you are not satisfied with the themes that are bundled with LabRPS, for example by editing an existing style sheet. Your new style must be placed in a specific folder for it to be found by LabRPS:
- %APPDATA%/LabRPS/Gui/Stylesheets (on Windows). The %APPDATA% folder can be retrieved by entering
App.getUserAppDataDir()
in the Python console. - $HOME/.LabRPS/Gui/Stylesheets (on Linux).
- $HOME/Library/Application Support/LabRPS/Gui/Stylesheets (on macOS).
Addons
Addons from the Addon Manager offer yet another way to customize the user interface. Several Preference Packs to change the theme are available.
- File: New document, New Table, New Matrix, New Graph, New 2D Plot, New 3D Plot, Open..., Open Recent, Close, Close All, Save, Save As..., Save a Copy..., Save All, Revert, Import..., Export..., Merge project..., Document information..., Print..., Print preview..., Export PDF...Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Select All, Delete, Preferences...
- View: Fullscreen, Workbench, Sync view, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection back, Selection forward, Status bar
- Tools: Edit parameters..., Export dependency graph..., Project utility..., Alphaplot, Line, Scatter, Scatter, Scatter With X Err, Scatter With Y Err, Scatter With XY Err, Line + Symbol, Special Line + Symbol, Vertical Drop Lines, Spline, Vertical Steps, Horizontal Steps, Vertical Bars, Vertical Stacked Bars, Vertical Grouped Bars ,Horizontal Bars, Horizontal Stacked Bars, Horizontal Grouped Bars, Area, Channel Fil, Pie, Half Pie, Vectors XYXY, Vectors XYAM, Statistical Graph, Box Plot, Histogram, Stacked Histogram, 3D Plot, Bar, Scatter, Layout Grids, Vertical 2 Layouts, Horizontal 2 Layouts, 4(2x2) Layouts, 3D Wire Frame, 3D Surface, 3D Wire Frame Surface, Bar, Scatter, Contour + Color Fill, Countour Lines, Gray Scale Map, 3D Wire Frame Polar, 3D Surface Polar, 3D Wire Frame Surface Polar, 3D Scatter Polar, Polar spectrogram, Graph, Add/Remove Plot xy/xy..., Add Function..., Add Error Bars..., Add/Remove Other Plots..., Add/Remove Plot y..., Add/Remove Vector Plot..., Add Axis..., Add Left Axis, Add Bottom Axis, Add Right Axis, Add Top Axis, Legend Reorder, Add Text, Add Time Stamp, Add Image, Draw Line, Draw Arrow, Draw Ellipse, Add Nested Layout, Add Layout, Add Up, Add Down, Add Left, Add Right, Remove Layout, Swap Layouts..., Graph Tolls, Disable Tools, Data Rearder, Screen Reader, Select Data Range, Move Data Points, Remove Bad Data Points..., Drag Range, Zoom Range, Rescale To Show All, Table, Set Column(s) As, X, Y, Z, X Error, Y Error, None, Fill Selection With, Row Numbers, , Random Values, Custom Random, Show Comments, Show Controls, Formula Edit Mode, Edit Column Description, Change Type & Format, Clear Table, Sort Table, Assign Formula, Recalculate, Add Column, Go To Cell, Export ASCII..., Convert To Matrix, Matrix, Hide Controls, Set Coordinates, Set Display Format, Assign Formula, Recalculate, Clear Matrix, Transpose, Mirror Horizontally, Mirror Vertically, Import Image, Go To Cell, Invert, Determinant, Convert To Table, Add text document, Group, Units Calculator,Customize..., RPS Features..., Addon manager
- Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- Help: Help, LabRPS Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, LabRPS Forum, LabRPS FAQ, Report a bug, About LabRPS, What's This
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, AppImage
- Basics: About LabRPS, Interface, RPS Objects, Object name, Preferences, Workbenches, Document structure, Properties, Help LabRPS, Donate
- Hubs: User hub, Power users hub, Developer hub