Directive Files

The Writer module also supports several directive files. These files can be placed in the output folder and will affect the conversion process.

Parameter

Description

genInfo.txt

The contents of this file are appended to the end of the [General Info] section in the .GTM file created for a project. This file can be used to define additional fonts and other settings.

addInfo.txt

The contents of this file are appended to the end of the .GTM file created for a project. You can use this file to added additional sections to the .GTM file that are not generated by default.

catInfo.txt

The contents of this file are appended to the .GTM file created for a project immediately after the Category assigned to the project graphics and before the Session Graphics Category definition.

catNameMapInfo.txt

This file can be used to assign names and display properties to the GTViewer categories that are generated by the conversion. Every conversion will have at least two categories: 1 - Overview, 2 - data (a third category is also provided as the Session Category and its ID is 999, but it cannot be written to).

If the gti_categoryId property is set to a numeric value, then this file will set Category section entries in the .GTM file to the values provided in the file. The file should be entries like the following:

<catId>|<name>|<display status>|<min>|<max>|<flag>

Only CatId and Name are required. The rest are optional and will default to 0 if not defined.

Display Status is 0 to display and 1 to hide. Min and Max are the zoom level ranges the category will display (0 means that the threshold is ignored). A good default file would be:

1|Overview

2|Features

However, if you plan on using more categories than the default, it might look like:

1|Overview

2|Landbase

3|Gas Features

4|Electric Features

And if you plan on setting the display properties, it might look like:

1|Overview

2|Landbase|0|0|20000

3|Gas Features|0|0|5000

4|Electric Features|1|0|5000

textReplacement.txt

This file can be used to perform text substitution on all Text elements before they are written to the GTViewer format. This file must contain a list of entries like the following:

Source=<text to replace>

Dest=<text to replace with>

.

.

.

This file can contain one or more Source/Dest pairs.

<project_name>_filter_#.flt

Where # is the category Id

This file is generated automatically by the Writer module if it doesn’t already exist. If the file does exist before the conversion begins, its contents will be loaded and its contents will be updated to include any new Filter Id's needed by the data conversion. The reusing of this file ensures that Filter Id’s will stay constant from one conversion to the next.

<project_name>_color.txt

This file is generated automatically by the Writer module if it doesn’t already exist. If the file does exist before the conversion begins, its contents will be loaded and its contents will be updated to include any new Color Ids needed by the data conversion. The reusing of this file ensures that Color Id’s will stay constant from one conversion to the next.

<project_name>_style.map

This file is generated automatically by the Writer module if it doesn’t already exist. If the file does exist before the conversion begins, its contents will be loaded and its contents will be updated to include any new Style to Filter Id mappings needed by the data conversion. The reusing of this file ensures that mappings remain constant from one conversion to the next.

<project_name>_style.def

This file is generated automatically by the Writer module if it doesn’t already exist. If the file does exist before the conversion begins, its contents will be loaded and its contents will be extended to include any new Style Definitions needed by the data conversion. The reusing of this file ensures that Style Definitions remain constant from one conversion to the next and any manual edits to the Style Definitions will be preserved as well.

gtiParameters.txt

This file can be placed in the output folder to specify additional setting for the conversion. The next section describes all of the entries that can be used.