Conversion programs

For the above reason, several conversion programs have been implemented:

• dmap2dmap
• dmap2html
• dmap2tcl
• dmap2tcl2

The most simple of them is dmap2dmap. It simply reads and rewrites the dmap file, formatting it.

Its syntax is:
dmap2dmap GeoVmeMap dmap filename title

where:

• GeoVmeMap is a GeoVme map.
• dmap is the input dmap file
• filename is the output dmap file
• title is the string to set as the title of the new dmap file

As an example, compare a map before and after the conversion.

A bit more complicated is dmap2html. This program converts the dmap file in a set of HTML files.

Its syntax is:
dmap2html GeoVmeMap dmap file_prefix outdir title

where:

• GeoVmeMap is a GeoVme map.
• dmap is the input dmap file
• file_prefix is the prefix of the HTML files (should not contain any path)
• outdir is the directory where the HTML files will be created (use . for the current directory)
• title is the string to set as the title of the HTML files

As an example, see the result of a conversion.

Sometimes it is useful to have a standalone program that incorporates the document. dmap2tcl and dmap2tcl2 convert the dmap file in a standalone Tcl/Tk program. The two programs generate equivalent Tcl/Tk programs, but dmap2tcl creates shorter ones and should be prefered to dmap2tcl2.

The syntax is the following:
dmap2tcl GeoVmeMap dmap filename title
dmap2tcl2 GeoVmeMap dmap filename title

where:

• GeoVmeMap is a GeoVme map.
• dmap is the input dmap file
• filename is the output Tcl/Tk program
• title is the string to set as the title of the Tcl/Tk program

As an example, the following Tcl/Tk program should be run. If you cannot run Tcl/Tk programs, have a look to the the following picture showing the program in execution.