Requirements for conversions to PDF

pdfChip, pdfToolbox and pdfaPilot offer the possibility to convert several file formats to PDF. In order to receive the best results, the applications in which the files have been created are used for this conversion.

Supported applications and files

Application Operating system As of product version
pdfToolbox pdfaPilot
Microsoft Word 2007 Windows 4.5 2.1
Microsoft Word 2010
(32bit and 64bit)
Windows 4.5 2.1
Microsoft Excel 2007 Windows 4.5 2.1
Microsoft Excel 2010
(32bit and 64bit)
Windows 4.5 2.1
Microsoft PowerPoint 2007 Windows 4.5 2.1
Microsoft PowerPoint 2010
(32bit and 64bit)
Windows 5.0 2.3
Microsoft Publisher 2007 Windows 5.0 2.3
Microsoft Publisher 2010
(32bit and 64bit)
Windows 5.0 2.3
Microsoft Visio 2007 Windows 5.0 2.3
Microsoft Visio 2010
(32bit and 64bit)
Windows 5.0 2.3
Microsoft Project 2010
(32bit and 64bit)
Windows 5.0 2.3
Microsoft Word 2013
(32bit and 64bit)
Windows 7.2 5.0
Microsoft Excel 2013
(32bit and 64bit)
Windows 7.2 5.0
Microsoft PowerPoint 2013
(32bit and 64bit)
Windows 7.2 5.0
Microsoft Visio 2013
(32bit and 64bit)
Windows 7.2 5.0
Microsoft Publisher 2013
(32bit and 64bit)
Windows 7.2 5.0
Microsoft Project 2013
(32bit and 64bit)
Windows 7.2 5.0
Microsoft Word 2011 Mac 5.0 2.4
Microsoft Excel 2011 Mac 5.0 2.4
Microsoft PowerPoint 2011 Mac 5.0 2.4
iWork '09 Pages Mac 5.0 2.4
OpenOffice.org 3.2 Windows, Mac and Linux 4.5 2.2
OpenOffice.org 3.3 Windows, Mac and Linux 5.0 2.3
OpenOffice.org 4.x Windows, Mac and Linux 7.0 5.0
LibreOffice 4.x Windows, Mac and Linux 7.0 5.0
LibreOffice 5.x Windows, Mac and Linux 8.2 6.2
PostScript and EPS files All Platforms 5.0 2.4
Image files All Platforms 5.0 2.4

Supported file types

Application File type
Windows Mac Linux
Microsoft Word .doc .docx .dot .dotx .dotm .rtf .txt .xml .doc .docx .txt
Microsoft Excel .xls .xlsx .xlsm .xlt .xltx .xltm .xls .xlsx
Microsoft PowerPoint .ppt .pptx .pps .ppsx .pot .potx .potm .ppa .ppam .ppt .pptx
Microsoft Visio .vsd .vdx .vdw .vss .vsx
Microsoft Project .mpp .mpt .mpd .mpw .mpx
Microsoft Publisher .pub
OpenOffice/LibreOffice Writer .odt .ott .sxw .stw .doc .rtf .sdw .vor .txt .pdb .xml .psw .docx .docm .dotx .dotm .602 .wpd .hwp
OpenOffice/LibreOffice Calc .ods .ots .sxc .stc .dif .dbf .xls .xlt .sdc .vor .slk .csv .pxl .uos .xlc .xlm .xlw .sdc .xlsb .xlsm .xlsx .xltm .xltx .wb2
OpenOffice/LibreOffice Impress .odp .otp .sxi .sti .ppt .pot .sxd .sda .sdd .vor .uop .odg .cgm .pptm .pptx .potm .potx
iWork '09 Pages .pages
PostScript and EPS files .ps .eps
Image files

.tiff .tif .jpeg .jpg .png

HTML

.html .htm

File types that require additional parameters:

Application File type
Windows Mac Linux
Email

.msg .eml
When emails are converted also any attachments are converted, compressed archives (.zip, .gz, .7z, .rar) are uncompressed.

General

  • All Office-applications should be installed with the default options, in order to guarantee that all needed components are available.
  • Install all the latest updates.
  • Start the application at least once and make sure that the setup wizards have been executed successfully.
  • pdfToolbox or pdfaPilot need to be activated. This means, a valid activation request must have been sent and the software must have been activated with the activation file received afterwards.
  • The activation needs to be performed for the user who wants to execute the file conversion.
  • On Windows systems, install the Microsoft .NET Framework Version 4 or newer - this is not automatically installed with the regular Windows Update but belongs to the optional updates.
  • Please ensure, that the Microsoft Visual C++ Redistributable Packages for Visual Studio 2013 was properly installed by the callas installation package. Only the 32bit version of the runtime library is needed because the internal conversion tool is an 32bit application.
  • While conversions to PDF are performed, no other users on this machine should use the applications needed for this process.
  • In particular the file to be processed should not be opened in the respective application.
  • Only one instance of the application that creates PDF must be used at the same time. Therefore in pdfToolbox Server, pdfaPilot Server or in Enfocus Switch the number of instances needs to be set to 1.
  • Although some file types can be processed with several applications it is recommended to process documents with the application where they were created with.

Microsoft applications

  • Please make sure that Microsoft Office is activated. In case Microsoft Office runs as an evaluation version, a warning dialog might pop up during conversion.
  • If there is no “PDF or XPS” entry in the “Save as” menu, install the missing Add-in. You can download it on the Microsoft website.
  • Install the latest service pack for Microsoft Office.
  • When updating the Microsoft Office Suite it is recommended to deinstall previously installed version before to ensure all registry entries are removed and properly set when the new installation of Office takes place. Especially when installing Microsoft Office 2010 on a system with an existing Microsoft Office 2007 such registry entries seems to remain. See Microsoft knowledge base for details how to uninstall.

Word

  • Word documents may contain annotations from the function “Track changes”. They are output into the PDF with the setting “Screen”. When outputting with setting “Print” they are not output. In the Desktop version of pdfToolbox the setting “Print” is default so that annotations are not output. Whereas in pdfaPilot Desktop the setting “Screen” is default so that annotations are output. On the Mac the output of annotations can only be omitted when running the english language version of Word. Moreover “Enable access for assistive devices” need to be enabled in “Universal Access” of the “System preferences”.

Excel

  • If the contents exceed the “print area”, only the parts covered by this “print area” will be output whilst the other parts will not be output.
  • The page format of the output PDF is optimized in order to fit as much content as possible in a well readable way onto a page. For large sheets the content may be spread over several PDF pages.
  • To ensure conversion, the print spooler has to be active. This is the case when the Excel preview shows the content. Otherwise the spooler has to be started in the “Services” configuration of the system settings. After doing this, the “Microsoft XPS Document Writer” shows up in the print dialog of Excel.

Mac

  • A page range can not be specified, the parameter Page range (pagerange) does not have an influence.
  • Images are exported with a resolution of 72 ppi, the parameter Print (topdf_print) does not have an influence.
  • If Microsoft Office 2008 and Microsoft Office 2011 are installed the Office application that is set as default for opening Office documents in the system or the Office application that is already open is used to process Office documents.

Dialog handling

  • Under Windows dialogs appearing in the Office application during processing can be handled.
  • Therefore an empty file named MTPGuiActions.log has to be placed in the user folder here:
    <user>\AppData\Roaming\axaio software\MS Office 12\MadeToPrint\Logfiles\
  • If the Office document that opens a dialog is processed now an ID of the dialog is logged in MTPGuiActions.log
  • This ID needs to be entered in MTPGuiActions.cfg which can be found in the etc/PDFOfficeTool folder next to the executable of pdfToolbox or pdfaPilot Desktop or Server
  • Within MTPGuiActions.cfg the options of the dialog handling is described

Usage when running as a service

  • Sometimes problems may occure when running pdfaPilot/pdfToolbox as a service with Microsoft Office. Automation is not supported by Microsoft officially, but the following workaround was successful in most cases:
    • Create the following folder (with appropriate permissions) on your system:
      • Windows Server 2012 + later:
        C:\Windows\SysWOW64\config\systemprofile\AppData\Local
        \Microsoft\Windows\INetCache
      • Especially when running Office 32Bit on x64 systems, the following folders are required as well:
        • Windows x64: C:\Windows\SysWOW64\config\systemprofile\Desktop
        • Windows x86: C:\Windows\System32\config\systemprofile\Desktop

OpenOffice.org

  • Close all open OpenOffice instances before processing with pdfToolbox or pdfaPilot.
  • Please keep in mind the known restrictions of OpenOffice.org regarding cases where umlauts from Type1 and OpenType fonts might not be output correctly. You will find more information on the current state of this issue on OpenOffice.org.

Mac

  • Please verify that OpenOffice is installed inside the default installation path (e.g. ”/Applications/OpenOffice.org” on Mac OS X systems).
    If it is not, please re-install it to this location.

Linux

  • Support for Office Conversion has been tested thoroughly on Ubuntu 14.04 LTS (Server) with the default installation of LibreOffice and also with an OpenOffice installation.
  • On Ubuntu the required LibreOffice packages are installed via the package manager or via the command line as shown below:
    • sudo aptitude install libreoffice
      (please substitute 'libreoffice' by 'openoffice' if you prefer OpenOffice)
  • On other linux distributions or with other OS versions it might be required to search for packages with different names. E.g install everything found with the following search terms:
    • libreoffice (or openoffice)
    • uno
    • ure
    • headless

iWork '09 Pages

  • A page range can not be specified as it is also via manual PDF export, the parameter Page range (pagerange) does not have an influence.
  • Images are exported with a resolution of 72 ppi as it is also via manual PDF export, the parameter Print (topdf_print) does not have an influence.
  • Documents of iWork '08 Pages can not be processed with pdfToolbox Server application or pdfaPilot Server application because of a changed file format (file packages of Pages version 3 and earlier).

PostScript and EPS files

  • ICC profiles referenced in a PDF settings file need to be copied into the operating system folder for ICC profiles, e.g.:
    • Windows: C:\Windows\system32\spool\drivers\color
    • Mac OS X: /Macintosh HD/Library/ColorSync/Profiles
  • A Color settings file (.csf) that is referenced in the PDF settings file is not necessary for the processing.

In case your problems cannot be solved with these instructions, please send an email with the file to be converted and detailed information on your system environment to support@callassoftware.com.