===============================================================================
Rover - a MicroStation BASIC macro that retrieves measurement results and
displays them in a window so they can be cut and paste into input fields, the
design file as text and/or passed to other applications. 

The procedure to use Rover is to perform a measurement using one of
MicroStation's standard measurement tools, and then activate Rover being sure
to use the same measurement type (i.e., the measure distance tool should be
followed by Rover's measure distance option, not say, Rover's measure angle
option).

Rover will display the results of the measurement in a dialog.  Options at this
point include:

- Copying or cutting the results by highlighting the text and pressing <Ctrl>-C
  or <Ctrl>-X respectively
- Scaling the results based on the scale(s) of attached reference file(s)
- Scaling the results by a multiplier
- Adding or subtracting an offset to the measurement

Defaults and Command Line Switches
Most inputs can be specified as defaults by using configuration variables.
Defaults can also be controlled by command line switches.  Information about
the configuration variables and command line switches can be found in the About
Rover Dialog (Press the "?" button in the Rover dialog to open the About Rover
Dialog).  All configuration variables start with "rv_".  Configuration
variables and command line switches are not case sensitive.  Command line
switches take precedence over configuration variables.


Mode details about coodinating Rover with the measurement tool used:
There is only a single pair of buffers for measurements, so only the most
recent measurement command result is preserved by MicroStation. Rover reads
this buffer and interprets the results according to the user's choice. It is
essential that the choice match the latest measurement command, otherwise the
results will be invalid. In other words, if the last measurement performed in
MicroStation was measure distance, then only the distance option in Rover will
produce valid results. You could not request, say, area or angle and expect the
values to be meaningful. Unfortunately there is no present way to interogate
MicroStation to determine the last measurement type.

This macro could be enhanced to call specific measurement tools and then
retrieve the appropriate known values, thus eliminating any potential for user
error.