04 ‐ Ribbon preferences

The preference dialog consists of the following tabs:

• General
• Navigation
• Miscellaneous The settings are not stored in the "RibbonStructure_default.json" file but in FreeCAD itself like all FreeCAD's own settings.
  You can find these settings under Tools -> Parameters

Dialog buttons
With the close and cancel button you can close the dialog with or without saving your settings.

Reset button
With the reset button, all values will be set to their default values.

General settings

There are two main group of settings:

1. Backup settings
2. Ribbon settings

Backup settings
Standard the backup function is enabled. When enabled, every time you update the ribbon design, a backup version of "RibbonStructure_default.json" will be saved in the backup location. Standard this is the folder "Backup" in the location of the addon. You can change the location to another location.

Ribbon settings
Here you can set the following settings:

1. You can currently set the tab style to Icon + Text or text only.
2. The size for the small, medium and large buttons.
3. Enable text for the buttons per size
4. Set a maximum number of columns per panel. The commands that are beyond these columns, will be added to a pulldown menu:
5. Select a stylesheet for the ribbon. Standard is "default.qss" selected, but you can create your own stylesheet.

Navigation settings

Here you can set the following settings:

• Scroll speed for the mouse wheel
• Scroll speed for the scroll buttons

Colors and Icons

You can set your own colors for:

• The borders of the buttons when you hover over them
• The background of the buttons when you hover over them
• The background color for the application button

You can also choose your own icons for:

• The scroll buttons of the tab bar
• The scroll buttons of the ribbon
• The overflow menu for extra command
• The icons for the pin button

Miscellaneous

On this tab, you will find settings that are not categorized. You can set:

• The preferred view panel:
  • Individual views panel
  • View panel (based on the classic FreeCAD views toolbar
  • Views panel (FreeCAD Ribbon specific design, created as a new panel)
• The use of a standard "Tools" panel.
• You can enable the original overlay function of FreeCAD. However, the original overlay function has compatibility issues. Enable this on your own risk.
  This is also the reason that the pinbutton is removed when these functions are enabled.
  In case there is an issue, you can restore the default overlay function by adding a file named "OVERLAY_DISABLED" (No extension) in the folder of the
  add-on.
• The application menu has now a shortcut key. The default is "alt-A". You can change the shortcut if desired. When a shortcut is already taken, a note will show up.

Notes:

1. After unchecking "Use standard Tools panel", you have to remove the panel from the "New panels" tab in the layout menu.
2. The Tools and Views panel can be changed afterwards. Only when the panels are removed, they will be recreated on the next startup.