Converters

PNDocConvQueueServiceLib uses the converters included with Document Conversion Service to provide conversion of the most commonly used document formats. Most of the included converters use the original document's native application to help it do the conversion. This means that the necessary third-party applications also need to be installed and licensed for the converters you want to use.

Each converter has a unique name and it is this name that needs to be passed down to the Convert method, along with the source file path, to tell Document Conversion Service to use that converter when converting the file. The converter name can be the name of a single converter or a semi-colon separated list of the converter names to try. The first converter in the list that is running is the converter that will be used to convert the document. For example, to convert a PDF file you can use Adobe Acrobat Reader, Ghostscript or the Outside-In AX converter.

 

Code Sample - C#

 

PNDocConvQueueServiceLib.PNDocConvQueueItem item = null;

 

try

{

    // Create the conversion item

    item = new PNDocConvQueueServiceLib.PNDocConvQueueItem();

 

    ....

    // convert the file, using first matching converter

    item.Convert("Adobe Acrobat Reader;Ghostscript;Outside-In AX",

                 @"C:\Test\Report.pdf",

                 @"C:\Test\Out\ConvertedReport");

}

catch (Exception ex) 

{

    MessageBox.Show(this, "An error has occurred.\n\n" + ex.ToString());

}

finally

{

    if (item != null)

    {

        System.Runtime.InteropServices.Marshal.FinalReleaseComObject(item);

    }

    item = null;

}

 

Code Sample - VB

 

Dim item As PNDocConvQueueServiceLib.IPNDocConvQueueItem
 
Try
    ' Create the conversion item
    item = New PNDocConvQueueServiceLib.PNDocConvQueueItem()
 

    ....
 
    ' convert the file, using first matching converter
    item.Convert("Adobe Acrobat Reader;Ghostscript;Outside-In AX", _
                 "C:\Test\Report.pdf", _
                 "C:\Test\Out\ConvertedReport")
 
Catch ex As Exception
    MessageBox.Show(Me"An error has occurred." & vbCrLf & vbCrLf & ex.ToString())
 
Finally
    If IsNothing(item) Then
        System.Runtime.InteropServices.Marshal.FinalReleaseComObject(item)
        item = Nothing
    End If
End Try

 

The table below outlines the file types that can be converted and their required application, if needed.

 

Supported Document Type and Converter Name

Third-Party Application

Converter Name: Adobe Acrobat Reader

 

Adobe PDF Documents ( *.pdf)

Adobe Reader X, XI, DC (32-bit only)

Converter Name: Autodesk Design Review

 

Design Review Drawings (*.dwf)

Autodesk Design Review 2012-2013, 2018

Converter Name: Autodesk Design Review

 

AutoCAD Drawings (*.dwg)

Autodesk Design Review 2012-2013 with DWG TrueView 2012-2013 also installed.

Autodesk Design Review 2018 with DWG TrueView 2018 also installed.

Converter Name: Microsoft Excel

 

Excel Workbooks (*.xlsx, *.xlsm, *.xls)

Excel Templates (*.xltx, *.xltm, *.xlt)

Excel Binary Workbook (*.xlsb)

Microsoft Office 2003 SP3

(with Microsoft Office Compatibility Pack)

Microsoft Office 2007 (32-bit and 64-bit)

Microsoft Office 2010 (32-bit and 64-bit)

Microsoft Office 2013 (32-bit and 64-bit)

Microsoft Office 2016 (32-bit and 64-bit)

Microsoft Office 2019 (32-bit and 64-bit)

Microsoft Office 2021 (32-bit and 64-bit)

Converter Name: Ghostscript

 

Postscript Files (*.ps)

Encapsulated Postscript Files (.eps)

Adobe PDF Documents ( *.pdf)

Ghostscript 9.05 or later

(32-bit only)

 

There are known handle leak issues with earlier 9.0X versions of Ghostscript.

Converter Name: PEERNET Image Converter

 

JPEG images (*.jpg)

TIFF images (*.tif)

High Efficiency Image Files (*.heif, *.heic)

Google WebP Images (*.webp)

AVIF Images (*.avif)

Windows Bitmap images (*.bmp)

ZSoft PCX images (*.pcx)

ZSoft DCX images (*.dcx)

CServe Portable Network Graphics images (*.png)

Graphics Interchange Format image files (*.gif)

Icon Format (*.ico)

Windows Media Photo images (*.wdp, *.hdp, *.jxr)

ImageMagick images (100+ image formats)

Built-in, no additional applications required.

Converter Name: PEERNET Image Converter

 

DejaVu files(*.djvu)

Requires DjVu Shell Extension Pack

 

Converter Name: PEERNET Image Converter

 

45+ image formats and 500+ raw digital camera formats

Requires FastPictureViewer Codec Pack

Converter Name: Internet Explorer

 

HTML Files (*.htm, *.html)

Secure HTML (*.shtm, *.shtml)

Web Archive (*.mht)

Internet Explorer 8.0 - 11.0

Converter Name: Microsoft Outlook

 

Outlook Message Files (*.msg)

Outlook Templates (*.oft)

vCard Files (*.vcf)

vCalendar Appointment Files (*.vcs)

iCalendar Appointment Files (*.ics)

Electronic Mail messages (*.eml)

Microsoft Office 2003 (*.oft and *.msg only)

Microsoft Office 2007 (32-bit and 64-bit)

Microsoft Office 2010 (32-bit and 64-bit)

Microsoft Office 2013 (32-bit and 64-bit)

Microsoft Office 2016 (32-bit and 64-bit)

Microsoft Office 2019 (32-bit and 64-bit)

Microsoft Office 2021 (32-bit and 64-bit)

 

Converter Name: Outside-In AX

 

Supports over 500 common file formats; see the documentation that came with your Outside In Technology product.

Oracle Outside In Viewer Technology (ActiveX)

Converter Name: Microsoft PowerPoint

 

PowerPoint Presentations (*.pptx, *.pptm, *.ppt)

PowerPoint Shows (*.ppsx, *.ppsm, *.pps)

PowerPoint Templates (*potx, *.potm, *.pot)

Microsoft Office 2003 SP3

(with Microsoft Office Compatibility Pack)

Microsoft Office 2007 (32-bit and 64-bit)

Microsoft Office 2010 (32-bit and 64-bit)

Microsoft Office 2013 (32-bit and 64-bit)

Microsoft Office 2016 (32-bit and 64-bit)

Microsoft Office 2019 (32-bit and 64-bit)

Microsoft Office 2021 (32-bit and 64-bit)

Converter Name: Microsoft Publisher

 

Publisher Files (*.pub)

Microsoft Office 2003 SP3

(with Microsoft Office Compatibility Pack)

Microsoft Office 2007 (32-bit and 64-bit)

Microsoft Office 2010 (32-bit and 64-bit)

Microsoft Office 2013 (32-bit and 64-bit)

Microsoft Office 2016 (32-bit and 64-bit)

Microsoft Office 2019 (32-bit and 64-bit)

Microsoft Office 2021 (32-bit and 64-bit)

Converter Name: Microsoft Visio

 

Visio Drawings (*.vsd)

Microsoft Visio 2003

Microsoft Visio 2007

Microsoft Visio 2010 (32-bit and 64-bit)

Microsoft Visio 2013 (32-bit and 64-bit)

Microsoft Visio 2016 (32-bit and 64-bit)

Converter Name: Microsoft Word

 

Word Documents (*.docx, *.docm, *.doc)

Word Templates (*.dotx, *.dotm, *.dot)

Rich Text Documents (*.rtf)

Plain Text Files (*.txt)

Plain Text Log Files (*.log)

Microsoft Office 2003 SP3

(with Microsoft Office Compatibility Pack)

Microsoft Office 2007 (32-bit and 64-bit)

Microsoft Office 2010 (32-bit and 64-bit)

Microsoft Office 2013 (32-bit and 64-bit)

Microsoft Office 2016 (32-bit and 64-bit)

Microsoft Office 2019 (32-bit and 64-bit)

Microsoft Office 2021 (32-bit and 64-bit)

Converter Name: Microsoft XPS

 

XPS Documents (*.xps)

Open XPS Documents (*.oxps)

Uses Windows built-in XPS document support, no additional applications required.

Converter Name: PEERNET Passthrough

 

Any file type

Built-in, passes the file through the system without converting.