Using the Developer Version of the Amyuni DOCX Converter

The following is a step-by-step procedure for using the developer version of the Amyuni DOCX Converter.

Copy all distributable files to the application’s main directory.

The application’s main directory is usually where the executable file is located. The list of distributable files is as follows:

Operating Systems	Dynamic Link Libraries (DLLs)
Common to all versions	install.exe, atDocx.txt, amyuni_docx.inf, atdocx.cat., atDocX-PipelineConfig.xml.
Windows 2000 to Windows 10 32-bits	atDocxFlt.dll, atDocxFltCore.dll, atDocXHelper.exe, atDocXHelper.exe.config, atDocxUI.dll, atDocxUICore.dll, atUtilsLibNet.dll.
Windows XP to Windows 10 64-bit, AMD 64 or Xeon-based	atDocxFlt64.dll, atDocxFltCore64.dll, atDocXHelper64.exe, atDocXHelper64.exe.config, atDocxUI64.dll, atDocxUICore64.dll, atUtilsLibNet64.dll.

Initialize the Document Converter printer on the end-user’s system

By launching Install_docx.exe when the main application is installed. Install_docx.exe should be launched with a printer name specific to the developer’s company or application followed by /advancedMode and /registerCDINTF:

E.g.:

Install_docx /s "My Company Printer" /n "Evaluation Developer License" /c "07ABCDA0A12301230123..........." /advancedMode /registerCDINTF

There are other optionsfor the command line:

Command line Parameter		Description
/s	-s	Run in silent mode
/l	-l	Do not generate a log file
/loginit	-loginit	Installer delete any existing log file before starting (default).
/nologinit	-nologinit	Installer will not delete any exising log file before starting
/d	-d	Delete the license from the .ini file after completing the installation
/directprint	-directprint	Install the printer to print directly to the driver rather than through the print spooler (default false)
/u	-u	Uninstall.
"<Printer Name>"		Name of printer as it will appear in the list of printers.
/n "<license Name>"	-n "<license Name>"	License Name
/o "<port name>"	-o "<port name>"	Port name – install the PDF converter to a particular port.
/c "<license code>"	-c "<license code>"	Activation Code
/driver "<driver name>"	-driver "<driver name>"	The installed printer driver will have this name.
/ver "<nnn>"	-ver "<nnn>"	A version suffix to append to file installed names
/prefixSource "<ss>"	-prefixSource "<ss>"	A prefix to use when obtaining to source files from the installation package.
/prefixDest "<dd>"	-prefixDest "<dd>"	A prefix to use when generating to destination files to install on the system.

Note: If there is not space character, the quotes can be removed. The / or - character can be used interchangeably.

[Optional] Copy atDocXFltCore to the system directory atDocXFltCore.dll should be copied to the system directory and renamed to atDocXFltCore650.dll. This is done automatically by Install_docx.exe and is needed only if the developer has chosen some other method for installing the printer.

Register the atDocXFltCore ActiveX. When using the ActiveX interface, the ActiveX control should be registered in the system by calling RegSvr32 from the system directory:

regsvr32 atDocXFltCore650.dll

atDocXFltCore can be also used through the DLL convention without the need for registering or creating an ActiveX.

On 64-bit systems, if the host application is 32-bits, the 32-bit version of atDocXFltCore650.dll should be registered using:

\windows\syswow64\regsvr32 atDocXFltCore650.dll

This is a common problem that confuses many developers.

Initialize the printer at start-up of your application. To initialize the printer, you need to call DriverInit followed by the printer name.

Export to Docx format by printing from your application.

Restore the printer to its previous settings. When printing is over, the developer needs to call FileNameOptions (0) to prevent other applications or users from overwriting the file that has just been generated from the application.

Uninitialize the printer before exiting. Before exiting the application, the DriverEnd function should be called.

INI File SettingsIt is also possible to configure the printer from the INI file using this parameters:

PrinterName="<printer name>" : The installed printer will have this name.

Licensee="<license name>" : Assign this license name to the installed printer.

LicCode="<license code>" : Assign this license code to the installer printer.

PortName="<port name>" : Assign this printer to this port.

PrinterDriverName="<driver name>" : The installed printer driver will have this name.

Version="<nnn>" : A version suffix to append to file installed names.

DriverFilesPrefixSource="<ss>" : A prefix to use when obtaining to source files from the installation package.

DriverFilesPrefixDest="<dd>" : A prefix to use when obtaining to destination files to install on the system.

DirectPrint="<true>|<false>" : Install the printer to print directly to the driver rather than through the print spooler (default false).

InfFileName="<INF file name>" : The name of the INF file to use to install the printer driver.

CatFileName="<CAT file name>" : The name of the CAT file to use to install the printer driver.

Important Note for developers
To avoid confusion with other applications and with the single-user versions of the Document Converter products, developers are required to use a printer name specific to their application or company. Using the default printer names of "Amyuni Document Converter" or "Amyuni DOCX Converter" is not allowed.

The activation code that is provided to you by Amyuni should be kept confidential and not be revealed explicitly to end-users, even in this case where the developer’s products are sub-licensed to other developers.