BP

Loads the coordinates of the laser system's mounting point (monument), or requests the current coordinate values for the laser system's monument.

Mnemonic:

Base Point

Syntax:

BP [x, y, z]

x: New X coordinate value, which can legally range from $-(1.7 \times 10^{308})$ to $(1.7 \times 10^{308})$.

y: New Y coordinate value, which can legally range from $-(1.7 \times 10^{308})$ to $(1.7 \times 10^{308})$.

z: New Z coordinate value, which can legally range from $-(1.7 \times 10^{308})$ to $(1.7 \times 10^{308})$.

Return value:

Success:

BP 1, x, y, z

Failure:

BP 0, err_msg

x: The new or current base X coordinate for the laser system's mount.

y: The new or current base Y coordinate for the laser system's mount.

z: The new or current base Z coordinate for the laser system's mount.

err_msg: Should the command fail, this value will be an error message string, explaining the cause of failure. The only failure mode for this command is failure to provide a legal floating point value in parameters x, y or z.

Remarks:

The location of the monument in 3-space is represented by the vector $(x, y, z)$. The coordinate transformation system is dependent upon this point when it determines how to aim the laser at a particular cube. Any changes to the base X, Y, or Z values requires that the encoder coordinates for every cube but the reference be recalculated. Any change to these values will automatically cause the ZY to invalidate (and thus require recalculation) any previously calculated az/el encoder values for all cube objects.

Example:

     send: BP 123.4, 645.2, 52332.0
  receive: BP 1, 123.400, 645.200, 52332.000

     send: BP
  receive: BP 1, 123.400, 645.200, 52332.000

See also:

ALPHA, BETA, EZ, MO, INITZY