HiDPI support
HiDPI support refers to the issue of displaying raster graphics (fonts, cursors, images) on high-resolution displays.
The issue is that the physical size of a display remains the same while its resolution increases.
Display resolutions
Device pixel ratio
It's a well-known concept for Web and Android developers. But not so much for desktop developers.
Basically, it's the ratio between physical pixels and device-independent pixels.
First things first. UI positioning and size (x, y, width, height) are historically defined in pixels.
But as more variety of displays resolutions become available at many different physical sizes, it's become a problem software developers need to be aware of.
FreeCAD development was started in 2002, long before such a problem was even foreseen.
Ok, why not just increase DPI, you ask. Well, the issue is that you still want to benefit from the high-resolution display.
All the raster graphics need to contain more pixels, while vector graphics (fonts and icons) should be of the same physical size as visible on the display.
If you just change DPI, you would scale everything up and down. But in fact, you need all the pixel sizes to remain the same, while resources (images) to be displayed in a higher resolution.
So the concept of "Device-independent pixels" was introduced. The idea was that developers could keep not worrying about the physical size of a display and design UIs in virtual pixels.
But the reality is that if you use raster graphics, it becomes pixelized, blurry, or aliased as it is displayed in non-native resolution. So developers now need to provide multiple versions of raster images, for each device pixel ratio. Usually, it's whole numbers: 1, 2, 3, 4. But it can also be fractional (125%, 150%, 175% = 1.25, 1.5, 1.75) meaning that there's still some scaling involved, but not as apparent.
- https://stackoverflow.com/questions/8785643/what-exactly-is-device-pixel-ratio
- https://stackoverflow.com/questions/13911786/what-is-device-pixel-ratio-for
How to test HiDPI support
OS X
- Open "Display"
- Choose "Scaled"
- Choose "Larger text" - this increases device pixel ratio
Video: https://www.youtube.com/watch?v=4U3eh_fMo4o
X Window
Useful commands:
~$ xrdb -query *customization: -color Xft.dpi: 192 Xft.antialias: 1 Xft.hinting: 1 Xft.hintstyle: hintslight Xft.rgba: rgb Xcursor.size: 128 Xcursor.theme: DMZ-White
~$ xdpyinfo | grep -B 2 resolution screen #0: dimensions: 3840x2160 pixels (1016x572 millimeters) resolution: 96x96 dots per inch
Ubuntu (GNOME Shell)
- Open "Displays" (Settings > Devices > Displays)
- Select the highest resolution available
Issues
- Raster images (cursors, icons)
- Fonts (defined in pixels rather than points)
- Cursor hot point
- Zoom/Rotate origin
- Snap distance
- Selection distance (the hot area around selectable objects)
Forum threads
- Improve support of high DPI displays - general Qt support
- News: Qt 5.14 Is Bringing Significantly Better HiDPI Support - general Qt support
- Custom cursors and high dpi (Windows and MacOS testers needed) - raster cursor image issue
- HiDPI Support in Sketcher View - selection distance issue
- High DPI Improvements - PR "High DPI Fixes" https://github.com/FreeCAD/FreeCAD/pull/54, bad quality, 2015
- High dpi - experimental build with "High DPI Improvements" PR
- GUI font size - font size issue and the QT_SCALE_FACTOR workaround
- BUG? Cropped icons - issues with HiDPI on multiple displays
- FreeCAD 0.17 on macOS Update (Qt 5 builds now available) - issues with HiDPI on OS X after upgrade to Qt5
- Ticket #3537 - Draft Edit mode not working on MacOS X (HiDPi issue) - OS X + HiDPI, Qt5
- Menu distorted on MAC external display - OS X + HiDPI, external display
- macOS Qt5 plan and status - OS X dropped support for Qt4, HiDPI issues
- https://www.google.com/search?q=freecad+hidpi+site:forum.freecadweb.org
Relevant changes
- a14b99e77
- 2f2d50535
- bb6e4e6ad
- 23ecb8eac
- ca7770b80
- 51fcdd2c0
- 805ccd8deb
- 347156403
- 094dda5900d
- 925cffc1535
- 7dfeb801a
Bugtracker Issues
- Tickets tagged with HiDPI