PDF to PNG using Ruby

The Ruby gem for converting PDF documents to PNG images and thumbnails.

PDF to PNG features

Convert PDF documents to PNG images, create hi-res PNGs, and thumbnail images from PDF. Adjust PNG image resolution, dimension, and quality.

ConvertAPI Ruby library install

ConvertAPI provides a Ruby Gem that allows you to perform a PDF to PNG conversion with just a few lines of code. First, install the ConvertAPI Ruby SDK:

        Add this line to your application's Gemfile:
    
gem 'convert_api'

Ruby Gem GitHub

Authenticate your Ruby library

You can obtain your secret key by signing up for a free account. Once you sign up, you'll receive 250 free conversions instantly! Grab your authentication secret from the account dashboard, and authenticate the ConvertAPI Ruby library like this:

# get your secret key here: https://www.convertapi.com/a/auth


        ConvertApi.configure do |config|
        

           config.api_credentials = 'secret_or_token'
        

        end

Convert PDF to PNG using Ruby in no time!

Once you have your authentication in place, simply copy-paste this pdf to png conversion code snippet into your Ruby project:

// Code snippet is using the ConvertAPI JavaScript Client: https://github.com/ConvertAPI/convertapi-js

// Code snippet is using the ConvertAPI Node.js Client: https://github.com/ConvertAPI/convertapi-nodejs

// Code snippet is using the ConvertAPI PHP Client: https://github.com/ConvertAPI/convertapi-php

// Code snippet is using the ConvertAPI Java Client: https://github.com/ConvertAPI/convertapi-java

// Code snippet is using the ConvertAPI C# Client: https://github.com/ConvertAPI/convertapi-dotnet

# Code snippet is using the ConvertAPI Ruby Client: https://github.com/ConvertAPI/convertapi-ruby

# Code snippet is using the ConvertAPI Python Client: https://github.com/ConvertAPI/convertapi-python

// Code snippet is using the ConvertAPI Go Client: https://github.com/ConvertAPI/convertapi-go

REM Code snippet is using the command line utility program: https://github.com/ConvertAPI/convertapi-cli

Try the conversion online - no coding required!

You can try out advanced conversion parameters and test the conversion result online using our interactive demo tool. This tool will produce the same conversion output as if you were using the library from your solution, and it will auto-generate the code snippet for you!

Try for FREE!

Conversion parameters

Password String

Sets the password to open protected PDF.

PageRange String

Set PDF page range to convert. Example 1-10 or 1,2,5.

Rotate Collection

Set PDF page rotation before converting to image.

Values: default none rotate90 rotate180 rotate270

CropTo Collection

Defines the options for cropping the page.

Values: BoundingBox TrimBox MediaBox ArtBox BleedBox

ImageResolution Integer

Set output image resolution in dpi.

ImageHeight Integer

Image height in pixels.

ImageWidth Integer

Image width in pixels.

BackgroundColor Color

Applies a color to the transparent PDF background, thereby setting the background color of the generated images. You can specify a color name (e.g. white or black), or use color codes such as RGB (e.g. 255,0,0) or HEX (e.g. #FF0000). To preserve transparency, set the property value to transparent.