5 1 0:HiDPI Display Support

From SEPsesam
Other languages:


Docs latest icon.png Welcome to the latest SEP sesam documentation version 5.1.0 Apollon. For previous documentation version(s), check documentation archive.


Overview


SEP sesam supports HiDPI displays (High Dots Per Inch or high pixel density). 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, HiDPI mode may not be supported by all user interfaces, browsers and other accompanying software. Therefore, the SEP sesam user interface may not be displayed correctly; it may show smaller menus, elements that are too large or too small, blurred text, etc.

To adapt SEP sesam for HiDPI displays, make sure you are using the appropriate Java version. Follow the procedures below depending on OS and specific desktop environments to adapt your SEP sesam for high resolution display.

HiDPI display on Windows

On Windows, HiDPI display and dynamic scaling are supported by default. SEP sesam UI should be scaled accordingly to the Windows display scale factor, so no additional steps are required. If you have problems adjusting the HiDPI display for SEP sesam, refer to the official Windows documentation.

HiDPI display on Linux

On Linux there is a variety of desktop environments supported, but they may not yet fully support HiDPI displays. The following steps can help you adapt your environment for the 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 the article Linux HiDPI.

GNOME

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 that the display should be adjusted. If you are not satisfied with the scaling factor, for example, if the elements are too large, 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.

KDE

You can use KDE's settings to adjust the scaling of fonts, icons, and widgets. 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 desired size.
  3. You have to restart KDE for the changes to take effect.

Adjusting font scaling only

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

Adjusting icon scaling only

  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.

Xfce

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 area 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 use a desktop environment other than GNOME and have scaled the fonts using Xft.dpi, you have to notify a GDK (GUI toolkit) to scale the UI as well. This results in 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 automatically scale applications (e.g., Swing, AWT) based on the scaling factor used by the desktop environment. As of version > Java 8, you have to set the GDK_SCALE environment variable as follows:

export GDK_SCALE=2

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

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


See also

Java Compatibility MatrixLinux HiDPIDisplay Scaling on Windows

Copyright © SEP AG 1999-2024. 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.