The pdftopic
package offers an advanced solution for converting PDF files into various image formats such as PNG, JPG, etc. With a particular focus on rendering quality, pdftopic
distinguishes itself by producing output of exceptional quality, surpassing the performance of other packages available on the market. Designed to meet the critical needs of demanding users, pdftopic
effectively and reliably solves the rendering quality problems that many other packages present, offering an unrivalled and reliable PDF conversion solution for developers and IT professionals.
IMPORTANT NOTE: We strongly encourage you to support this library by making a donation via PayPal. Your generosity is highly appreciated, and we also welcome contributors with gratitude!
- node >= 12.x
- imagemagick
Follow this guide to install the required dependencies.
npm install --save pdftopic
import pdftopic from "pdftopic";
import fs from "fs";
(async () => {
const curriculum_vitae = fs.readFileSync('./pdf_files/curriculum_vitae.pdf');
const converted_result = await pdftopic.pdftobuffer(curriculum_vitae, 0);
fs.writeFileSync(`./png_files/curriculum_vitae.png`, converted_result[0]);
})();
import pdftopic from "pdftopic";
import fs from "fs";
(async () => {
const curriculum_vitae = fs.readFileSync('./pdf_files/curriculum_vitae.pdf');
const converted_result = await pdftopic.pdftobuffer(curriculum_vitae, [ 1, 3 ]);
converted_result.forEach((file, index) => {
fs.writeFileSync(`./curriculum_vitae-${index}.png`, file);
});
})();
import pdftopic from "pdftopic";
import fs from "fs";
(async () => {
const curriculum_vitae = fs.readFileSync('./pdf_files/curriculum_vitae.pdf');
const converted_result = await pdftopic.pdftobuffer(curriculum_vitae, "all");
converted_result.forEach((file, index) => {
fs.writeFileSync(`./png_files/curriculum_vitae-${index}.png`, file);
});
})();
import pdftopic from "pdftopic";
import fs from "fs";
(async () => {
const curriculum_vitae = fs.readFileSync('./pdf_files/curriculum_vitae.pdf');
const converted_result = await pdftopic.pdftobuffer(curriculum_vitae, "all");
const concat_converted_result = await pdftopic.bufferstoappend(allfiles);
fs.writeFileSync(`./png_files/curriculum_vitae-big.png`, concat_converted_result);
})();
- pdftobuffer(buffer, page, progress)
- bufferstoappend(buffers, progress)
- pdftocount(buffer)
- getDimmentions(buffers)
Initiate the conversion of a PDF to a buffer by supplying the function with a PDF and a specific page number or 'all' for the entire document. The function validates the input and processes the conversion accordingly, with an optional progress bar to track the process.
Convert a specific page of the PDF to Image/Buffer by supplying a file path.
pdftobuffer(buffer, page, progress)
- buffer - buffer pdf file
- page - page number to convert to an image
- progress - progress converting.
Converts PDF to Image/Buffer by supplying a file path
pdftobuffer(buffer, pages, progress)
- buffer - buffer pdf file
- pages - page numbers to convert to image
- set
pages
to"all"
to convert all pages -
pages
also accepts an array indicating the page number e.g.[1,2,3]
- also accepts number e.g.
1
- set
- progress - progress converting
- set
false
to disable progressbar (in default) - set
true
to enable progressbar
- set
Kick-start the concatenation of multiple buffers by feeding the function with an array of buffers.
Concatenate multiple buffers into a single buffer by providing an array of buffers to the function. The function processes each buffer, appends them together, and returns the combined buffer.
bufferstoappend(buffers, progress)
- buffers - array of buffers images
Start the process of counting the number of pages in a PDF by providing a PDF buffer to the function.
Determine the total number of pages in a PDF document by supplying the PDF to the function. The function loads the PDF and returns the page count.
pdftocount(buffer)
- buffer - buffer pdf file
To use the getDimmentions
function, you need to provide an array of buffers as input. Each element of this array must represent an image in buffer form. Make sure that each buffer in the array corresponds to a valid image. Once you've supplied this array of buffers, you can use it as an argument to call the getDimmentions
function.
The getDimmentions
function is an asynchronous function that takes an array of buffers as an argument. The function returns an object containing the following information:
- outputImgWidth: the maximum width of all the images in the array.
- outputImgHeight: the sum total of the heights of all the images in the array.
- dimmentions: an array containing the dimensions (width and height) of each image in {width, height} format.
- channels: the number of elements in the dimensions array, corresponding to the number of images processed.
getDimmentions(buffers)
- buffers - array of buffers images
In line with the latest update, version pdftopic@1.0.2-alpha
now includes TypeScript support. This addition enables developers to harness the benefits of TypeScript within their projects, enhancing code quality, readability, and maintainability. With TypeScript support, users can leverage static typing, improved code intelligence, and a more robust development experience.
As part of this update, a comparative evaluation of conversion speed was carried out on a single file between version pdftopic@0.1.3
and the latest version pdftopic@1.0.0
. This analysis revealed a significant improvement in conversion performance in the latest version, demonstrating a clear acceleration in the conversion process.
In line with this update, a comparative analysis of conversion speed was carried out between the previous version pdftopic@0.1.3
and the current version pdftopic@1.0.0
, based on the processing of several files. This evaluation demonstrated a significant improvement in conversion performance in the more recent version, highlighting a clear acceleration in the conversion process.
In line with this update, the current version of pdftopic@1.0.0
has been enhanced by the integration of an image merge feature, enabling multiple images to be combined into a single visual entity. Although this feature is still in the beta phase, we are currently working on an improved beta version, offering even faster merging speeds than those currently available.