Fork of pdf2pic with proper DPI metadata (PixelsPerInch)
npm install @diegoooo/pdf2picThis package is a modified version of pdf2pic by Yakov Meister.
Original project is licensed under MIT.
This version adds .units("PixelsPerInch") to the image generation process to make sure the output images include proper DPI metadata.
Without this, the images don't reflect the density value set in the options. This can cause issues with OCR, printing, or any process that depends on DPI information.
npm install --save pdf2pic
`
Usage
$3
`javascript
import { fromPath } from "pdf2pic";
const options = {
density: 100,
saveFilename: "untitled",
savePath: "./images",
format: "png",
width: 600,
height: 600
};
const convert = fromPath("/path/to/pdf/sample.pdf", options);
const pageToConvertAsImage = 1;
convert(pageToConvertAsImage, { responseType: "image" })
.then((resolve) => {
console.log("Page 1 is now converted as image");
return resolve;
});
`
$3
More usage example can be found here.
pdf2pic API
- fromPath(filePath, options)
- fromBuffer(buffer, options)
- fromBase64(b64string, options)
$3
Initialize PDF to image conversion by supplying a file path
#### Functions
Convert a specific page of the PDF to Image/Base64/Buffer by supplying a file path
`javascript
fromPath(filePath, options)(page, convertOptions)
`
* filePath - pdf file's path
* options - see options.
* page - page number to convert to an image
* convertOptions - see convertOptions.
---
Converts PDF to Image/Base64/Buffer by supplying a file path
`javascript
fromPath(filePath, options).bulk(pages, convertOptions)
`
* filePath - pdf file's path
* options - see options.
* pages - page numbers to convert to image
* set pages to -1 to convert all pages
* pages also accepts an array indicating the page number e.g. [1,2,3]
* also accepts number e.g. 1
* convertOptions - see convertOptions
---
Set GraphicsMagick's subclass or path
`javascript
fromPath(filePath, options).setGMClass(subClass)
`
NOTE: should be called before calling convert() or bulk().
* filePath - pdf file's path
* options - see options.
* subClass - path to gm binary or set to true to use imagemagick
* set subClass to true to use imagemagick
* supply a valid path as subClass to locate gm path specified
---
$3
Initialize PDF to image conversion by supplying a PDF buffer
#### Functions
Convert a specific page of the PDF to Image/Base64/Buffer by supplying a buffer
`javascript
fromBuffer(buffer, options)(page, convertOptions)
`
Functions same as fromPath(filePath, options)(page, convertOptions) only input is changed
---
Converts PDF to Image/Base64/Buffer by supplying a buffer:
`javascript
fromBuffer(buffer, options).bulk(pages, convertOptions)
`
Functions same as fromPath(filePath, options).bulk(pages, convertOptions) only input is changed
---
Set GraphicsMagick's subclass or path:
`javascript
fromBuffer(buffer, options).setGMClass(subClass)
`
Functions same as fromPath(filePath, options).setGMClass(subClass) only input is changed
---
$3
Initialize PDF to image conversion by supplying a PDF base64 string.
#### Functions
Convert a specific page of the PDF to Image/Base64/Buffer by supplying a base64 string:
`javascript
fromBase64(b64string, options)(page, convertOptions)
`
Functions same as fromPath(filePath, options)(page, convertOptions) only input is changed.
---
Converts PDF to Image/Base64/Buffer by supplying a base64 string:
`javascript
fromBase64(b64string, options).bulk(pages, convertOptions)
`
Functions same as fromPath(filePath, options).bulk(pages, convertOptions) only input is changed.
---
Set GraphicsMagick's subclass or path:
`javascript
fromBase64(b64string, options).setGMClass(subClass)
`
Functions same as fromPath(filePath, options).setGMClass(subClass) only input is changed.
---
$3
Following are the options that can be passed on the pdf2pic api:
| option | default value | description |
|---------------------|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| quality | 0 | Image compression level. Value depends on format, usually from 0 to 100 (more info) |
| format | 'png' | Formatted image characteristics / image format (image characteristics, image format) |
| width | 768 | Output width |
| height | 512 | Output height |
| preserveAspectRatio | false | Maintains the aspect ratio of the image. When set to true and both width and height are specified, they are interpreted as the minimum width and minimum height, respectively. If set to true with only the width specified, the height will be automatically determined while preserving the aspect ratio, and vice versa. |
| density | 72 | Output DPI (dots per inch) (more info) |
| savePath | './' | Path where to save the output |
| saveFilename | 'untitled' | Output filename |
| compression | 'jpeg' | Compression method (more info) |
$3
| option | default value | description |
|--------------|---------------|-------------|
| responseType | image | Response type of the output. Accepts: image, base64 or buffer |
The parameter can also be a boolean, if true then the response type will be base64 and if false then the response type will be image`.