pdf-to-png-converter

Node.js utility to convert PDF file/buffer pages to PNG files/buffers without binary and OS dependencies (except macOS on arm64).

Getting Started

macOS M1 Prerequisites

macOS M1 dependencies prerequisites installation:

arch -arm64 brew install pkg-config cairo pango libpng librsvg

Package Installation

Installation:

npm install -D pdf-to-png-converter

Example

const { pdfToPng } = require('pdf-to-png-converter');

test(`Convert PDF To PNG`, async () => {
    const pngPages = await pdfToPng(pdfFilePath, { // The function accepts PDF file path or a Buffer
        disableFontFace: false, // When `false`, fonts will be rendered using a built-in font renderer that constructs the glyphs with primitive path commands. Default value is true.
        useSystemFonts: false, // When `true`, fonts that aren't embedded in the PDF document will fallback to a system font. Default value is false.
        enableXfa: false, // Render Xfa forms if any. Default value is false.
        viewportScale: 2.0, // The desired scale of PNG viewport. Default value is 1.0.
        outputFolder: 'output/folder', // Folder to write output PNG files. If not specified, PNG output will be available only as a Buffer content, without saving to a file.
        outputFileMaskFunc, // Output filename mask function.
        pdfFilePassword: 'pa$$word', // Password for encrypted PDF.
        pagesToProcess: [1, 3, 11], // Subset of pages to convert (first page = 1), other pages will be skipped if specified.
        strictPagesToProcess: false, // When `true`, will throw an error if specified page number in pagesToProcess is invalid, otherwise will skip invalid page. Default value is false.
        verbosityLevel: 0 // Verbosity level. ERRORS: 0, WARNINGS: 1, INFOS: 5. Default value is 0.
    });
    // Further processing of pngPages
});

Output

The output of the pdfToPng function is an array of objects with the following structure:

{
    pageNumber: number; // Page number in PDF file
    name: string; // PNG page name (use outputFileMaskFunc to change it)
    content: Buffer; // PNG page Buffer content
    path: string; // Path to the rendered PNG page file (empty string if outputFilesFolder is not provided)
    width: number; // PNG page width
    height: number; // PNG page height
}

Buy Me A Coffee

In case you want to support my work: