Pixel Density Changes

Since Processing 4.4.3, sketches automatically use the pixelDensity(2) on Retina/HiDPI screens. This makes graphics look sharper, but it also means that sketches doing pixel-level work may not look the same as they did in earlier versions of Processing. You may see a warning in the console about the change (see PR #1226).

When this matters

These discrepancies mostly affect sketches that use get() and set() to read or write pixels, access the pixels[] array, use custom shaders that assume a fixed pixel density, or export to SVG or PDF. The underlying issue has been around ever since pixelDensity() was introduced (see Issue #693), but it didn’t affect many people since inconsistencies would only appear on specific sketches, when manually setting pixelDensity(2). Now that pixelDensity(2) is the default for HiDPI displays, more users are running into these cases.

Recommendations

If your sketch behaves incorrectly on a high-DPI display, you have two main options:

• Set pixelDensity(1) in setup() to keep the old behavior everywhere.
• Or, adapt your code to the screen’s density by using displayDensity(), so pixel operations scale consistently.

References

• Issue #693 – SVG export
• Issue #1063 – Shaders
• PR #1226 – added a warning message
• PR #1145 – draft fix