Referencing the Assembly and Deployment

You can install DynamicPDF Rasterizer directly using the NuGet Package Manager or manually. You can also install DynamicPDF Rasterizer to run as a Mono application, a .NET Core application, or a UWP application.

The easiest way to reference and deploy DynamicPDF Rasterizer in your project is by installing the NuGet package directly within Visual Studio's Package Manager. Alternatively, follow the instructions here to reference and deploy the assembly manually.

Install Using NuGet Package Manager

Install the NuGet package directly in Visual Studio's Package Manager.

• NuGet: ceTe.DynamicPDF.Rasterizer.NET (https://www.nuget.org/packages/ceTe.DynamicPDF.Rasterizer.NET)

Manual Installation

If you wish manually install Rasterizer rather than using NuGet, install the assemblies manually by downloading the appropriate zip file from the DynamicPDF website. The ZIP file contains one assembly with .NET Standard 2.0 or .NET Core 2.0 or higher.

The following table provides details of the assembly.

.NETCoreApp 2.1 and Higher

.NETStandard 2.0 and Higher

::danger

Using the incorrect assembly prevents your application from compiling.

Deployment

The following table lists the native files that must accompany the .NET assembly.

Licensing

Although you can use the evaluation edition of DynamicPDF Rasterizer, images created include a watermark. You must add a license key to remove the watermark. After purchasing an appropriate serial number, retrieve the license keys from the Customer Area of DynamicPDF's website:  https://www.dynamicpdf.com/CustomerArea. Then add the license key to a .config file or programmatically within your application.

.NET Core (Windows) / Mono (Windows) Deployment

The native file(s) DPDFRenderNative_x86.dll and DPDFRenderNative_x64.dll must be deployed along with the DynamicPDF.Rasterizer.dll if developing a .NET Core/Mono project. These files are located in the:

• bin\DPDFRenderNative\Windows folder in the downloaded zip file.

.NET Core (Linux) / Mono (Linux)Deployment

Mono projects targeting Linux require adding the native file(s) libDPDFRenderNative_x64.so, libDPDFRenderNative_x86.so to your project and must be deployed along with the DynamicPDF.Rasterizer.dll. The DPDFRenderNative.XXX.so file(s) are located in the:

• bin\DPDFRenderNative\Linux folder in the downloaded zip file.

UWP Deployment

UWP projects require adding the native file DPDFRenderNative_x86.dll or DPDFRenderNative_x64.dll to your project, depending upon your platfom.

To deploy, set the Build Action property to Content and deploy it along with the DynamicPDF.Rasterizer.dll. These files are located in the:

• bin\DPDFRenderNative\UWP folder in the downloaded zip file.

Loading Native libraries

Deploy the Native DLLs for DynamicPDF Rasterizer by setting the current directory using the SetCurrentDirectory or SetDllDirectory methods. Examples of both are illustrated in the following code examples.

Using SetCurrentDirectory

The following code deploys the native DLLs using the SetCurrentDirectory method.

String defaultCurrentDir = System.IO.Directory.GetCurrentDirectory();
//Set the current directory and load the native DLL file.
System.IO.Directory.SetCurrentDirectory(@"Folder path");
PdfRasterizer rasterizer = New PdfRasterizer(pdfFilePath);                      
//Once the native DLL is loaded you can change it back to original.
System.IO.Directory.SetCurrentDirectory(defaultCurrentDir);
rasterizer.Draw(pngFilePath, ImageFormat.Png, ImageSize.Dpi72);    

Dim MyDefaultCurrentDir As String = System.IO.Directory.GetCurrentDirectory()
'Set the current directory and load the native DLL file.
System.IO.Directory.SetCurrentDirectory("Folder path")
Dim MyRasterizer As PdfRasterizer = New PdfRasterizer(PdfFilePath);                 
'Once the native DLL is loaded you can change it back to original.                      
System.IO.Directory.SetCurrentDirectory(MyDefaultCurrentDir)                    
MyRasterizer.Draw(PngFilePath, ImageFormat.Png, ImageSize.Dpi72)  

Using SetDllDirectory

The following code deploys the native DLLs using the SetDllDirectory method.

[DllImport("kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
static extern bool SetDllDirectory(string PathName);
static void Main(string[] args)
{
  SetDllDirectory(@"Native Assembly Path");
  int err = Marshal.GetLastWin32Error();
  PdfRasterizer rasterizer = New PdfRasterizer(pdfFilePath);                     
  rasterizer.Draw(pngFilePath, ImageFormat.Png, ImageSize.Dpi72);    
}   

<DllImport("kernel32.dll", CharSet:=CharSet.Unicode, SetLastError:=True)>
Function SetDllDirectory(ByVal lpPathName As String) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function
 Sub Main(ByVal args() As String)
   SetDllDirectory("Native Assembly Path")
   Dim ErrorMsg As String = New System.ComponentModel.Win32Exception(Marshal.GetLastWin32Error()).Message
   Console.WriteLine(ErrorMsg)
   Dim MyRasterizer As PdfRasterizer = New PdfRasterizer(PdfFilePath);    
   MyRasterizer.Draw(PngFilePath, ImageFormat.Png, ImageSize.Dpi72)                
 End Sub