Click here to Skip to main content
15,917,953 members
Articles / Programming Languages / C#

Convert a PDF into a Series of Images using C# and GhostScript

Rate me:
Please Sign up or sign in to vote.
4.86/5 (18 votes)
21 Jun 2013CPOL5 min read 169.3K   15.9K   45   27
How to convert a PDF into a series of images using C# and GhostScript


An application I was recently working on received PDF files from a webservice which it then needed to store in a database. I wanted the ability to display previews of these documents within the application. While there are a number of solutions for creating PDF files from C#, options for viewing a PDF within your application is much more limited, unless you purchase expensive commercial products, or use COM interop to embed Acrobat Reader into your application.

This article describes an alternate solution, in which the pages in a PDF are converted into images using GhostScript, from where you can then display them in your application.

In order to avoid huge walls of text, this article has been split into two parts, the first dealing with the actual conversion of a PDF, and the second demonstrates how to extend the ImageBox control to display the images.

Caveat Emptor

Before we start, some quick points:

  • The method I'm about to demonstrate converts the page of the PDF into an image. This means that it is very suitable for viewing, but interactive elements such as forms, hyperlinks and even good old text selection are not available.
  • GhostScript has a number of licenses associated with it but I can't find any information of the pricing of commercial licenses.
  • The GhostScript API Integration library used by this project isn't complete and I'm not going to go into the bells and whistles of how it works in this pair of articles - once I've completed the outstanding functionality, I'll create a new article for it.

Getting Started

You can download the two libraries used in this article from the links below, these are:

  • Cyotek.GhostScript - core library providing GhostScript integration support
  • Cyotek.GhostScript.PdfConversion - support library for converting a PDF document into images

Please note that the native GhostScript DLL is not included in these downloads, you will need to obtain that from the GhostScript project page.

Using the GhostScriptAPI Class

As mentioned above, the core GhostScript library isn't complete yet, so I'll just give a description of the basic functionality required by the conversion library.

The GhostScriptAPI class handles all communication with GhostScript. When you create an instance of the class, it automatically calls gsapi_new_instance in the native GhostScript DLL. When the class is disposed, it will automatically release any handles and calls the native gsapi_exit and gsapi_delete_instance methods.

In order to actually call GhostScript, you call the Execute method, passing in either a string array of all the arguments to pass to GhostScript, or a typed dictionary of commands and values. The GhostScriptCommand enum contains most of the commands supported by GhostScript, which may be a preferable approach rather than trying to remember the parameter names themselves.

Defining Conversion Settings

The Pdf2ImageSettings class allows you to customize various properties of the output image. The following properties are available:

  • AntiAliasMode - specifies the antialiasing level between Low, Medium and High. This internally will set the dTextAlphaBits and dGraphicsAlphaBits GhostScript switches to appropriate values.
  • Dpi - dots per inch. Internally sets the r switch. This property is not used if a paper size is set.
  • GridFitMode - controls the text readability mode. Internally sets the dGridFitTT switch.
  • ImageFormat - specifies the output image format. Internally sets the sDEVICE switch.
  • PaperSize - specifies a paper size from one of the standard sizes supported by GhostScript.
  • TrimMode - specifies how the image should be sized. Your mileage may vary if you try and use the paper size option. Internally sets either the dFIXEDMEDIA and sPAPERSIZE or the dUseCropBox or the dUseTrimBox switches.

Typical settings could look like this:

Pdf2ImageSettings settings;

settings = new Pdf2ImageSettings();
settings.AntiAliasMode = AntiAliasMode.High;
settings.Dpi = 300;
settings.GridFitMode = GridFitMode.Topological;
settings.ImageFormat = ImageFormat.Png24;
settings.TrimMode = PdfTrimMode.CropBox;

Converting the PDF

To convert a PDF file into a series of images, use the Pdf2Image class. The following properties and methods are offered:

  • ConvertPdfPageToImage - converts a given page in the PDF into an image which is saved to disk
  • GetImage - converts a page in the PDF into an image and returns the image
  • GetImages - converts a range of pages into the PDF into images and returns an image array
  • PageCount - returns the number of pages in the source PDF
  • PdfFilename - returns or sets the filename of the PDF document to convert
  • PdfPassword - returns or sets the password of the PDF document to convert
  • Settings - returns or sets the settings object described above

A typical example to convert the first image in a PDF document:

Bitmap firstPage = new Pdf2Image("sample.pdf").GetImage();

The Inner Workings

Most of the code in the class is taken up with the GetConversionArguments method. This method looks at the various properties of the conversion such as output format, quality, etc. and returns the appropriate commands to pass to GhostScript:

protected virtual IDictionary<GhostScriptCommand, object> 
GetConversionArguments(string pdfFileName, string outputImageFileName, 
int pageNumber, string password, Pdf2ImageSettings settings)
      IDictionary<GhostScriptCommand, object> arguments;

      arguments = new Dictionary<GhostScriptCommand, object>();

      // basic GhostScript setup
      arguments.Add(GhostScriptCommand.Silent, null);
      arguments.Add(GhostScriptCommand.Safer, null);
      arguments.Add(GhostScriptCommand.Batch, null);
      arguments.Add(GhostScriptCommand.NoPause, null);

      // specify the output
      arguments.Add(GhostScriptCommand.OutputFile, outputImageFileName);

      // page numbers
      arguments.Add(GhostScriptCommand.FirstPage, pageNumber);
      arguments.Add(GhostScriptCommand.LastPage, pageNumber);

      // graphics options
      arguments.Add(GhostScriptCommand.UseCIEColor, null);

      if (settings.AntiAliasMode != AntiAliasMode.None)
        arguments.Add(GhostScriptCommand.TextAlphaBits, settings.AntiAliasMode);
        arguments.Add(GhostScriptCommand.GraphicsAlphaBits, settings.AntiAliasMode);

      arguments.Add(GhostScriptCommand.GridToFitTT, settings.GridFitMode);

      // image size
      if (settings.TrimMode != PdfTrimMode.PaperSize)
        arguments.Add(GhostScriptCommand.Resolution, settings.Dpi.ToString());

      switch (settings.TrimMode)
        case PdfTrimMode.PaperSize:
          if (settings.PaperSize != PaperSize.Default)
            arguments.Add(GhostScriptCommand.FixedMedia, true);
            arguments.Add(GhostScriptCommand.PaperSize, settings.PaperSize);
        case PdfTrimMode.TrimBox:
          arguments.Add(GhostScriptCommand.UseTrimBox, true);
        case PdfTrimMode.CropBox:
          arguments.Add(GhostScriptCommand.UseCropBox, true);

      // pdf password
      if (!string.IsNullOrEmpty(password))
        arguments.Add(GhostScriptCommand.PDFPassword, password);

      // pdf filename
      arguments.Add(GhostScriptCommand.InputFile, pdfFileName);

      return arguments;

As you can see from the method above, the commands are being returned as a strongly typed dictionary - the GhostScriptAPI class will convert these into the correct GhostScript commands, but the enum is much easier to work with from your code! The following is an example of the typical GhostScript commands to convert a single page in a PDF document:

-sOutputFile=tmp78BC.tmp -dFirstPage=1 
-dLastPage=1 -dUseCIEColor -dTextAlphaBits=4 -dGraphicsAlphaBits=4 
-dGridFitTT=2 -r150 -dUseCropBox=true sample.pdf

The next step is to call GhostScript and convert the PDF which is done using the ConvertPdfPageToImage method:

public void ConvertPdfPageToImage(string outputFileName, int pageNumber)
  if (pageNumber < 1 || pageNumber > this.PageCount)
    throw new ArgumentException("Page number is out of bounds", "pageNumber");

  using (GhostScriptAPI api = new GhostScriptAPI())
    outputFileName, pageNumber, this.PdfPassword, this.Settings));

As you can see, this is a very simple call - create an instance of the GhostScriptAPI class and then pass in the list of parameters to execute. The GhostScriptAPI class takes care of everything else.

Once the file is saved to disk, you can then load it into a Bitmap or Image object for use in your application. Don't forget to delete the file when you are finished with it!

Alternatively, the GetImage method will convert the file and return the bitmap image for you, automatically deleting the temporary file. This saves you from having to worry about providing and deleting the output file, but it does mean you are responsible for disposing of the returned bitmap.

public Bitmap GetImage(int pageNumber)
  Bitmap result;
  string workFile;

  if (pageNumber < 1 || pageNumber > this.PageCount)
    throw new ArgumentException("Page number is out of bounds", "pageNumber");

  workFile = Path.GetTempFileName();

    this.ConvertPdfPageToImage(workFile, pageNumber);
    using (FileStream stream = new FileStream(workFile, FileMode.Open, FileAccess.Read))
      result = new Bitmap(stream);

  return result;

You could also convert a range of pages at once using the GetImages method:

public Bitmap[] GetImages(int startPage, int lastPage)
  List<Bitmap> results;

  if (startPage < 1 || startPage > this.PageCount)
    throw new ArgumentException
    ("Start page number is out of bounds", "startPage");

  if (lastPage < 1 || lastPage > this.PageCount)
    throw new ArgumentException
    ("Last page number is out of bounds", "lastPage");
  else if (lastPage < startPage)
    throw new ArgumentException
    ("Last page cannot be less than start page", "lastPage");

  results = new List<Bitmap>();
  for (int i = startPage; i <= lastPage; i++)

  return results.ToArray();

In Conclusion

The above methods provide a simple way of providing basic PDF viewing in your applications. In the next part of this series, we describe how to extend the ImageBox component to support conversion and navigation.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Written By
Software Developer (Senior)
United Kingdom United Kingdom
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

QuestionHow to supply password Pin
Rrohit Maheshwari9-Aug-15 21:35
professionalRrohit Maheshwari9-Aug-15 21:35 
AnswerRe: How to supply password Pin
Richard James Moss10-Aug-15 5:35
professionalRichard James Moss10-Aug-15 5:35 
Questioncan support the dll of 64-bit Pin
Eligah.kai28-May-15 18:22
Eligah.kai28-May-15 18:22 
AnswerRe: can support the dll of 64-bit Pin
Richard James Moss29-May-15 19:55
professionalRichard James Moss29-May-15 19:55 
QuestionIs it free to use GhostScript dll in commercial context ? Pin
Ashok Damani8-Dec-14 19:31
Ashok Damani8-Dec-14 19:31 
AnswerRe: Is it free to use GhostScript dll in commercial context ? Pin
Richard James Moss8-Dec-14 19:48
professionalRichard James Moss8-Dec-14 19:48 
QuestionPDF version issues Pin
darkentity19811-Sep-14 7:57
darkentity19811-Sep-14 7:57 
AnswerRe: PDF version issues Pin
Richard James Moss1-Sep-14 19:39
professionalRichard James Moss1-Sep-14 19:39 
GeneralBig Thanks Pin
Member 853554117-Apr-14 1:15
Member 853554117-Apr-14 1:15 
AnswerRe: Big Thanks Pin
Richard James Moss17-Apr-14 5:27
professionalRichard James Moss17-Apr-14 5:27 
QuestionConvert vertical Images Pin
Member 64315616-Nov-13 4:13
Member 64315616-Nov-13 4:13 
AnswerRe: Convert vertical Images Pin
Richard James Moss7-Nov-13 2:42
professionalRichard James Moss7-Nov-13 2:42 
QuestionCompatible for Web apllication ? Pin
Sunny Dhi8-Oct-13 21:24
Sunny Dhi8-Oct-13 21:24 
AnswerRe: Compatible for Web apllication ? Pin
Richard James Moss10-Oct-13 7:58
professionalRichard James Moss10-Oct-13 7:58 
QuestionWould be better if you use better Ghostscript wrapper like.. Pin
Josip.Habjan27-Aug-13 19:53
Josip.Habjan27-Aug-13 19:53 
AnswerRe: Would be better if you use better Ghostscript wrapper like.. Pin
Member 352820816-Oct-14 4:50
professionalMember 352820816-Oct-14 4:50 
Questionruntime exception Pin
Member 101949147-Aug-13 20:33
Member 101949147-Aug-13 20:33 
QuestionOut of memory exception Pin
torti8327-Jun-13 23:52
torti8327-Jun-13 23:52 
AnswerRe: Out of memory exception Pin
Richard James Moss28-Jun-13 5:45
professionalRichard James Moss28-Jun-13 5:45 
GeneralRe: Out of memory exception Pin
matrix3718-Jul-13 23:52
matrix3718-Jul-13 23:52 
AnswerRe: Out of memory exception Pin
Richard James Moss22-Jul-13 6:36
professionalRichard James Moss22-Jul-13 6:36 
GeneralGreat article Pin
hugo moreno8-Jun-13 1:09
hugo moreno8-Jun-13 1:09 
GeneralRe: Great article Pin
codeivan20-Jun-13 12:19
codeivan20-Jun-13 12:19 
Questionjust a remark - no links Pin
peterkmx2-Apr-12 5:54
professionalpeterkmx2-Apr-12 5:54 
AnswerRe: just a remark - no links Pin
keshavcn2-Dec-12 18:31
keshavcn2-Dec-12 18:31 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.