Command Line Options

Manifold provides several command line options when launching Manifold from a command line:

 

/activate:serial,key

Activate Manifold System.

/activate:<invalid serial>

Pop open the Activation dialog when an invalid serial number is supplied with the /activate option. Example:

 

manifold.exe /activate:dialog

 

will launch the Activation dialog since "dialog" is not a valid serial number.

/activateExt:serial,key

Activate an extension.

/autoexec:<scriptname> <mapfile>

Run the specified script after opening the MAP file specified.

/cfilter:<path>

Launch Manifold using a command filter.

/clist:<textfile>

Dumps the names of all commands available for user interface scripting using the InvokeCommand method of the UserInterface object into a text file. Example:

manifold.exe /clist:file.txt

/logquerytime

Logs the running time of queries into the History pane.

/logrenderingtime

Logs rendering time for component windows into the History pane.

/logscripttime

Logs execution time of scripts into the History pane.

/logtransformtime

Logs time for drawing, image, surface and table Transform Toolbar operations into the History pane. Also logs execution time for the Surface - Transform dialog, spatial overlays and topology overlays in addition to Transform Toolbar operations.

/slist:<textfile>

Dumps the names of all formatting styles available for areas, labels, lines and points into a text file. Example:

manifold.exe /slist:file.txt

 

The examples shown above for /clist and /slist options will create the specified file.txt file in the same folder as the manifold.exe file, the installation folder used for Manifold.

 

Those examples will not work in Windows Vista if Manifold has been installed in the default installation folder within the C:\Program Files hierarchy, because Vista in general does not allow writing to such folders by default by ordinary user logins.

 

In such cases specify a file location that is known to be writeable by the login in use. For example, if we have a folder called C:\tmp that we know is writeable we could use

 

manifold.exe /slist:C:\tmp\file.txt

 

Command Customization

 

Manifold may be customized to control what commands and menu items are available using command filters.

 

Launching Manifold with the /cfilter:<path> option starts Manifold using a command filter. For example, entering the following at the Windows command prompt (within the installation folder for Manifold) or within a batch file will launch Manifold using a command filter:

 

manifold.exe /cfilter:\myfiles\customizations\mymanifold.xml

 

The above will use the mymanifold.xml command filter file located in the \myfiles\customizations\ folder. See the Command Filters topic for details.

 

Scripting

 

Manifold provides sophisticated scripting to extend the capabilities of the program.

 

The /autoexec:<scriptname> <mapfile> command line switch allows running a script after opening the MAP file specified in the same command line. For example, the following command line will open the mymap.map project file and then run the myscript script found in that project file.

 

 manifold.exe /autoexec:myscript c:\MyProjects\mymap.map

 

See the Scripts topic for details on scripting. See the User Interface Scripting topic for a quick and easy interactive method of discovering command names usable when scripting the user interface.

 

Activation

 

Manifold includes a security system for license authentication that is described in the Activation Keys and Serial Numbers topic. See that topic for a discussion of command line options for activation.

 

Formatting

 

New releases of Manifold may introduce new formatting styles. The /slist command line option provides a handy way for programmers to get a comprehensive list of all area, label, line and point styles available and their names.

 

Technical Note

 

Strictly speaking, it is possible even in Vista to run commands of the form:

 

manifold.exe /slist:file.txt

 

Launching the command prompt window using the Run As Administrator command will allow writing to C:\Program Files even in Windows Vista. If the path to the Manifold installation folder is cited in the PATH variable, the above command can be executed in the context of any folder. However, this is a Vista nuance not related to Manifold so to avoid problems for users who do not have access to Administrator passwords this topic offers the advice to use folders that are known to be explicitly writeable by using commands of the form:

 

manifold.exe /slist:C:\tmp\file.txt

 

See Also

 

Scripts

Customization

Command Filters

Activation Keys and Serial Numbers

View - Panes - History