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 is enabled by default on macOS and Windows platforms. 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.
Linux
High-DPI display support is disabled by default on Linux platforms due to compatibility issues with some window managers. 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.
Environment variables
Environment variables can be difficult to set on some systems, so to help with this they can be read from an environment.txt
file located either in the directory where the application is installed (so that it applies to all users) or in a specific user's documents directory:
/Users/USERNAME/Documents/The Pixel Farm/PFTrack/environment.txt
For example the contents of this file could be set as follows to disable High-DPI scaling on macOS or Windows:
PIXELFARM_DISABLE_HIGHDPI_SCALING=1
and on Linux platforms, it could be set as follows to enable High-DPI scaling:
PIXELFARM_ENABLE_HIGHDPI_SCALING=1
To 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