Display Configuration

Reference displays  |  Colour management  |  High-DPI support

PFClean is able to use multiple colour-managed displays to help you ensure that any restoration work you are performing achieves the results you need for your target deliverable.

Reference displays

In addition to the main display where the user interface is shown, PFClean can also take advantage of any other display devices you have attached to your workstation to use as Reference Displays.

Reference displays show the media you are working on at full resolution without any other interface elements visible, whilst you continue to use the PFClean interface on your main display to perform restoration tasks.

Reference displays can be switched on and off in the Reference Display Preferences window, which is opened by clicking the Preferences button at the top-left of the PFClean interface. Please note that you must have a open project before you can enable a reference display.

When viewing a clip in the Cinema window, the current frame will be mirrored on all reference displays that have been enabled. You can also configure each display to change the way image data is scaled to fit the display device if desired.

Colour management

PFClean uses OpenColorIO for colour management to ensure pixel colours encoded in your source media are accurately reproduced on both your main display and any reference displays you have enabled.

Options for configuring colour management are available in the OpenColorIO Preferences section, and further information about how to set up colour spaces for your clips and display are provided in the Colour Management section.

High-DPI support

PFClean 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 PFClean 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 PFClean 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 PFClean 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 PFClean 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 PFClean log file can be examined for the following entries:

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