Display Configuration
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.
They can be switched on and off in the Display Preferences window by clicking the Preferences button at the top-left of the PFClean interface.
You can also configure each display to have a separate colour profile if desired, or change the way image data is scaled to fit the display device.
When viewing a clip in the Cinema window, the current frame will be mirrored on all external displays that have been enabled.
Colour management
PFClean uses OpenColorIO for colour management, and can be configured 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 Preferences section, and further information about how to set up a colour profile 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 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 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.
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 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.
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/PFClean/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 PFClean log file can be examined for the following entries:
High-DPI scaling: [Y]
Device pixel ratio: 2