AutoXChange DLL

Platforms: Windows and Linux Interface: Java Native Interface (JNI)

Background

The AutoXChange DLL (AXDLL) is a JNI_based interface for calling the base AutoXChange functions. It is packaged as an unmanaged Dynamic Link Library (DLL) on Windows and a Shared Object (so) on Linux. It is available as a 64-bit version on each operating system.

The API is documented in a separate volume:

JNI Interface Documentation

Requirements

Windows

Operating System: Windows 10 or above, Windows Server 2016 or above Compatibility: 64-bit

Linux

Operating System: Linux Kernels using GLIBC++ 2.28 including RHEL/CentOS 8, Debian 10, Ubuntu 20.04 Compatibility: 64-bit

Note: If you need compatibility with pre-GLIBC++ 2.28, please contact us. We can support some of these older Linux Kernels

Operation

AXDLL is called from a Java program. We ship versions for both Java 11 and Java 17, but other versions can be provided upon request. AXDLL can be called separately for each conversion, or as a long running process that converts multiple files.

For a conversion from DWG to DXF:

1. new AxDllConvert()

2. InitDLL

3. Shaker

4. SetOutputFormat(xx) - Optional
   SetPreview(boolean) - Optional

5. For each DWG/DXF
   a. SetInputName(…)
   b. SetOutputName(…)
   c. OpenInputFile()
   d. SaveAsDxf(0) - Not used if SetOutputFormat is used
   e. CloseInputFile

6. UninitDLL - Optional

Shaker must be called and uses a parameter unique to each user.

SetOutputFormat and SetPreview only need to be called once and can come anywhere after Shaker and before OpenInputFile. As they only have to be called once, it is better to put them outside the loop in a multiple-fiile conversion scenario.

SetOutputFormat and SaveAsDxf are mutually exclusive. If SetOutputFormat is used then OpenInputFile will automatically convert to the specified format and SaveAsDxf is not needed. If SetOutputFormat is not called, then OpenInputFile only opens the Input File and does not do a conversion. A subsequent call to SaveAsDxf then makes the same conversion as SetOutputFormat/OpenInputFile would have.

The parameter on SaveAsDxf is the AutoCAD Version. Currently that is 0 to 33. See table below. A value of 0 will use the same Version as in the input file. That is the recommended operation in most cases.

SetPreview controls whether a Preview is added to the output file. The default is to create the Preview.

Output Formats

AutoCAD Versions