search

marcpabst / PdfiumLight

A lightweight C# Library to render PDFs with Google's Pdfium in .NET Core and .NET Framwork Apps.
MIT License
69 stars 29 forks source link

readme

PdfiumLight

A lightweight C# Library to render PDFs with Google's Pdfium in .NET Apps. This is basically a much slimmer version of Pieter van Ginkel's PdfiumViewer with some added functionality.

Getting started

Getting started is easy. Just add PdfiumLight, PdfiumViewer.Native.x86.v8-xfa and / or PdfiumViewer.Native.x86_64.v8-xfa (see below) as NuGet dependencies to your project and you're good to go:

// Load the pdf file and create a new document object
PdfDocument document = new PdfDocument("C:/Users/Tom/Documents/sample.pdf");
// Load the first page
PdfPage page = document.GetPage(0);
// Render the page with a width of 1000px and automatically computed height
var renderedPage = page.Render(1000, 0);

Render part of a page

You can specify a clipping rectangle within the original image that would have been rendered only specifying widht and height. This will render only part of the page, thus beeing much faster than rendering the whole page and clipping afterwards.

// Load the pdf file and create a new document object
PdfDocument document = new PdfDocument("C:/Users/Marc/Documents/sample.pdf");
// Load the first page
PdfPage page = document.GetPage(0);
// Render the page
var renderedPage = page.Render(
         10000, // width in px
         0, // '0' to compute height according to aspect ratio
         0, // x of the top/left of clipping rectangle
         0, // y of the top/left point of clipping rectangle
         1000, // width of clipping reactangle
         1000, // height of clipping reactangle
         PdfRotation.Rotate0, // no rotation
         PdfRenderFlags.None // no render flags
);

You have to provide pdfium.dll

There are many ways to include pdfium.dll, the most easy one is by adding one or both of the following NuGet-dependencies created by @pvginkel:

A very basic packages.config could look like this:

<?xml version="1.0" encoding="utf-8"?>
<packages>
  <package id="PdfiumLight" version="0.0.3" targetFramework="net45" />
  <package id="PdfiumViewer.Native.x86.v8-xfa" version="2018.4.8.256" targetFramework="net45" />
  <package id="PdfiumViewer.Native.x86_64.v8-xfa" version="2018.4.8.256" targetFramework="net45" />
</packages>

Features

(already implemented)