pdf-to-png-converter

pdf-to-png-converter

A Node.js utility to convert PDF file/buffer pages to PNG files/buffers without binary and OS dependencies. This utility is ideal for applications that need to process and convert PDF documents into image formats for easier viewing, sharing, or further image processing. It supports various options for rendering fonts, handling encrypted PDFs, and specifying output details, making it a versatile tool for developers working with PDF files in different environments.

Getting Started

Package Installation

Installation:

npm install -D pdf-to-png-converter

Note: This package requires Node.js version 22 or higher.

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: (pageNum) => `page_${pageNum}.png`, // Function to generate custom output filenames. Example: (pageNum) => `page_${pageNum}.png`
        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 outputFolder 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: