Pixels Per Inch

Set the internal resolution which determines the page size at 100% zoom/scaling.

The default size of a unit in the PDF coordinate system is 1/ 72 inch (72 units per inch). However, the majority of PDF readers display PDF files at either 96 or 110 PPI (pixels per inch). This means that at 100% zoom/scaling, most PDF Readers actually apply an internal scaling of ~1.33 (110/ 96) or ~1.528 (110/ 72).

BuildVu uses the same technique by using a default resolution of 110 PPI, which is why the pixel values in the output produced are approximately 1.5x the units defined within the PDF file.

This configuration option can be used to modify the resolution, for example using a value of 72 would mean the pixel values align with the units defined within the PDF file.

Note: Other settings (such as scaling, maxPageWidth and maxPageHeight) also affect the size of the converted document.

Note: This setting should not be thought of as affecting pixel density. Instead, it determines the page size at default zoom/scaling.

Expected values:

• Any positive integer value, although in practice a value such as 72, 96 or 110 would be typical.

Default: 110

Since: 2024.08

Usage Examples

Command Line

-Dorg.jpedal.pdf2html.pixelsPerInch=72

Cloud

{ "org.jpedal.pdf2html.pixelsPerInch": 72 }

Java

conversionOptions.setPixelsPerInch(72);