4 4 3 Beefalo:HiDPI Display Support

From SEPsesam
Jump to: navigation, search
Other languages:
Deutsch • ‎English

Copyright © SEP AG 1999-2021. All rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3 Beefalo/Beefalo V2. For previous documentation version(s), check documentation archive.


SEP sesam 4.4.3 Beefalo introduces support for the HiDPI (High Dots Per Inch or high pixel density) displays. These screens with a high resolution in a relatively small format (e.g., high-end laptops and monitors) provide a very clean and crisp display, however, the HiDPI mode may not be supported by all user interfaces, browsers and other accompanying software. Therefore, SEP sesam v. ≥ 4.4.3 Beefalo user interface might not be appropriately displayed, e.g., it may show smaller menus, too large or too small elements, blurry text, etc.

In order to adjust SEP sesam for HiDPI displays, make sure that you use the relevant Java version. Refer to the following procedures depending on your OS and specific desktop environments to adjust your SEP sesam for high-resolution display.

HiDPI display on Windows

On Windows HiDPI display and dynamic scaling are supported by default. The SEP sesam UI should be scaled accordingly to the Windows display scale factor, so no additional steps are required. In case you are having troubles adjusting the HiDPI display for SEP sesam, see official Windows documentation.

HiDPI display on Linux

On Linux there is a variety of desktop environments supported, however, they may not yet support HiDPI displays completely. The following steps may help you adjust your environment for SEP sesam HiDPI display. Note that these steps are merely suggestions and may not provide an exact solution for every environment and version. For additional information, refer to article Linux HiDPI.


You can enable HiDPI in the GNOME desktop environment in the Settings -> Devices -> Displays, or open the terminal and run the following command:

$ gsettings set org.gnome.settings-daemon.plugins.xsettings overrides "[{'Gdk/WindowScalingFactor', <2>}]"
$ gsettings set org.gnome.desktop.interface scaling-factor 2

This will increase the scaling factor, so the display should be adjusted. If you are not satisfied with the scaling factor, for example, if the elements are too big, try replacing 2 with another value, such as 1.5 or 1.75. To return to the original value, use 1 instead. For details on fractional scaling and text scaling, see GNOME HiDPI.


You can use KDE's settings to adjust font, icon, and widget scaling. Note that this solution affects Qt and GTK applications.

Adjusting font, widget, and icon scaling

  1. Go to System Settings -> Display and Monitor -> Display Configuration -> Scale Display.
  2. Drag the slider to the relevant size.
  3. You have to restart KDE for the changes to take effect.

Adjusting only font scaling

  1. Go to System Settings -> Application Appearance -> Fonts.
  2. Enable Force fonts DPI check box and adjust the DPI level to the relevant value (default value is 96).
  3. This should take effect immediately for newly started applications. On Plasma desktop you have to log out and log in again for the changes to take effect.

Adjusting only icon scaling

  1. Go to System Settings -> Application Appearance -> Icons -> Advanced.
  2. Select the relevant icon size for each listed category, e.g., Desktop, Toolbar, Dialogs, etc. This should take effect immediately.


You can improve your Xfce HiDPI display as follows:

  • Go to Settings Manager -> Appearance -> Fonts -> DPI -> in the Custom DPI setting change the DPI value, e.g., 180.
  • You can also enlarge the system tray icons by right-clicking in the empty space around the icons, and clicking Properties. Then set the maximum icon size to a larger value, e.g., 32, 48 or 64.

For more information, see Xfce HiDPI.

GDK 3 (GTK+ 3)

If you are using another desktop environment than GNOME and you have scaled the fonts using Xft.dpi, you have to notify a GDK (GUI toolkit) to scale the UI as well. This results in a further increase of the font size for GDK applications (Firefox, Chrome, Skype, etc.), so you only have to undo the text scaling.

To scale UI elements by a factor of 2, run the command:

export GDK_SCALE=2

To undo the text scaling, run the following command:

export GDK_DPI_SCALE=0.5

Java applications

On Linux, Java does not scale the applications (e.g., Swing, AWT) based on the scaling factor used by the desktop environment automatically. From version > Java 8, you have to set the GDK_SCALE environment variable as follows:

export GDK_SCALE=2

Note that only non-fractional scaled factors are supported (1=100%, 2=200%, etc.).

For details on how to scale the applications for v. ≤ Java 8, see Java applications.