High-DPI Displays

PFTrack supports High-DPI/Retina displays to provide high resolution media without compromising on the readability of UI elements.

MacOS and Windows

High-DPI display support on macOS and Windows is enabled by default. If you wish to disable this feature, the following environment variables can be used:

- PIXELFARM_DISABLE_HIGHDPI_SCALING: setting this environment variable to any value before launching PFTrack will disable High-DPI/Retina support.

- PIXELFARM_FORCE_DEVICE_PIXEL_RATIO: setting this environment variable to a floating-point number will override the device pixel ratio for your display.

Rocky Linux 8/9

High-DPI display support on Rocky Linux is disabled by default. If you wish to enable this feature, the following environment variables can be used:

- PIXELFARM_ENABLE_HIGHDPI_SCALING: setting this environment variable to any value before launching PFTrack will enable High-DPI/Retina support.

- PIXELFARM_FORCE_DEVICE_PIXEL_RATIO: setting this environment variable to a floating-point number will override the device pixel ratio for your display.

Font scaling

If High-DPI support is disabled, the font that PFTrack uses can be changed if required to improve readability. To do this, use the environmnet variable:

- PIXELFARM_FONT_SIZE: setting this environment variable to a value such as 12px will set the font size used in the application.

Environment variables

To set environment variables using your operating system tools, please consult your system administrator.

Environment variables can be difficult to set on some systems, so to help with this PFTrack will also read from a file called environment.txt located either in the directory where the application is installed (so that it applies to all users) or in a user's Documents directory:

environment.txt

For example the contents of this file could be set as follows to disable High-DPI scaling and set a 10 pixel font:

PIXELFARM_DISABLE_HIGHDPI_SCALING=1
PIXELFARM_FONT_SIZE=10px

After setting environment variables, you can check to see if High-DPI scaling is correctly enabled or disabled, the PFTrack log file can be examined for the following entries:

High-DPI scaling: [Y]
Device pixel ratio: 2