bnbwebexpertise/pdf-to-image

Convert a pdf to an image with Imagick extension. Forked from spatie/pdf-to-image

Convert a pdf to an image

This package provides an easy to work with class to convert pdf's to images., _(*1)

Requirements

You should have Imagick and Ghostscript installed., _(*2)

Install

The package can be installed via composer: ``` bash $ composer require bnbwebexpertise/pdf-to-image, _(*3)

## Usage

Converting a pdf to an image is easy.

```php
$pdf = new Bnb\PdfToImage\Pdf($pathToPdf);
$pdf->saveImage($pathToWhereImageShouldBeStored);

If the path you pass to saveImage has the extensions jpg, jpeg, or png the image will be saved in that format. Otherwise the output will be a jpg., _(*4)

Other methods

You can get the total number of pages in the pdf:, _(*5)

$pdf->getNumberOfPages(); //returns an int

By default the first page of the pdf will be rendered. If you want to render another page you can do so:, _(*6)

$pdf->setPage(2)
    ->saveImage($pathToWhereImageShouldBeStored); //saves the second page

You can override the output format:, _(*7)

$pdf->setOutputFormat('png')
    ->saveImage($pathToWhereImageShouldBeStored); //the output wil be a png, no matter what

You can configure custom settings (where page is the page number) :, _(*8)

$beforeImageReadSettings = function (\Imagick $imagick, $page) {
    $imagick->setColorspace(\Imagick::COLORSPACE_SRGB);

    return $imagick;
};

$beforeImageWriteSettings = function (\Imagick $imagick, $page) {
    $imagick->resizeImage(1024, 1024, \Imagick::FILTER_LANCZOS, 0, true);
    $imagick->setImageColorspace(\Imagick::COLORSPACE_GRAY);

    return $imagick;
};

$pdf = new Pdf($this->testFile, $beforeImageReadSettings, $beforeImageWriteSettings)
    ->saveImage($pathToWhereImageShouldBeStored); //the output will be resized to a grayscale image with a best-fit dimension of 1024x1024

Change log

Please see CHANGELOG for more information what has changed recently., _(*9)

Testing

bash $ composer test, _(*10)

Contributing

Please see CONTRIBUTING for details., _(*11)

Security

If you discover any security related issues, please email support@bnb.be instead of using the issue tracker., _(*12)

Credits

• B&B Web Expertise
• Freek Van der Herten

License

The MIT License (MIT). Please see License File for more information., _(*13)