Creating a display text package

There are two different methods, creating display text packages. When you have a tool which generates DTXML files, you can generate the packages via command line. When you have a self-written solution for generating DTXML files, you can use the API method.

Via command line

Follow these steps:
Open the command line tool at the path: {across installation folder}\Toolbox\DisplayTextPackageTool\DisplayTextPackageTool.exe.
Enter the command below and replace the examples with the correct file pathes for the dtxml and the images.
```
DisplayTextPackageTool /dtFile:"dtfile.dtxml" /imagesFolder:"C:\myImages" result.dtx
```
Tip
Note that reference images must have a relative path starting from the imagesFolder.
The file will be generated and written into the DisplayTextPackageTool folder.

Via API

If you write a special extension, e. g. a tool that converts CMS data to display text (.dtx), you can use the special assembly from Across: {across installation folder}\Toolbox\DisplayTextPackageTool\Across.DisplayText.Package.dll. The API provides methods which are necessary to work with display text packages.

The API contains the following methods:
Create a display text (DT) package.
Load a DT package from a specified file.
Save a file to a file with a specified path.
Put or get an DTXML document (as a stream).
Add an image (as a stream) with a specified reference to the package. (If an image with existing reference is added the previous image will be replaced with the new one.)
Get an image (as a stream) by reference from the package.