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 .... |
The table below outlines the file types that can be converted and their required application, if needed.
Caution |
|
The Adobe PDF - Builtin, Cadd - Builtin, Image - Builtin, and Text - Builtin converters are not supported on Microsoft® Windows Server 2008 R2 and Microsoft® Windows 7. |
Supported Document Type and Converter Name |
Third-Party Application |
---|---|
Converter Name: Adobe PDF - Builtin
•Adobe PDF Documents ( *.pdf) |
Built-in, no additional applications required. |
Converter Name: Adobe Acrobat Reader
•Adobe PDF Documents ( *.pdf) |
Adobe Reader X, XI, DC (32-bit only) |
Converter Name: Cadd - Builtin
•AutoDesk 2D Drawings ( *.dwf, *.dwfx) •HPGL Plot files (*.plt) •Gerber RS-274D, Gerber RS-274X, Gerber X2 (*.gbx) |
Built-in, no additional applications required. |
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) Microsoft Office 365 (32-bit and 64-bit) |
Converter Name: Image - Builtin, 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, includes optional support for animated images and movies with ffmpeg.exe. |
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) Microsoft Office 365 (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: 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: 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) Microsoft Office 365 (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) Microsoft Office 365 (32-bit and 64-bit) |
Converter Name: Text - Builtin
•Text Files (*.txt) •Logging Files (*.log) •Source Files(*.c, *.cpp, *.cs, etc.) •Config and INI Files (.config, *.ini) •PowerShell (*.ps1) •Batch Files (*.cmd, *.bat) •Any other text-based file |
Built-in, no additional applications required. |
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) |
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) Microsoft Office 365 (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. |