AZM

Loads new azimuth encoder coordinate for the specified cube. If no value is specified, requests current value.

Mnemonic:

cube AZiMuth.

Syntax:

AZM $<$c$>$[, e]

c: Cube number or name.

e: New encoder value. Legal values range from $-(2^{30})$ to $(2^{30}) - 1$.

Return value:

Success:

AZM 1, c, e

Failure:

AZM 0, err_msg

c: Cube number.

e: New or current azimuth encoder value.

err_msg: Should the command fail, this value will be an error message string, explaining the cause of failure. This command could fail if the cube specified does not exist in the ZY's cube collection, or if the value of e is outside the range specified above.

Remarks:

This command is used to load a new azimuth encoder coordinate for any cube. The ZY will use this new value when it points to the cube as long as it finds no reason to recompute the azimuth & elevation encoder coordinates for that cube. The azimuth & elevation encoder coordinates are never recomputed for the reference cube. For all other cubes, the values are recomputed (and the old ones overwritten) under the following conditions:

• The specified cube has received new XYZ coordinates, requiring the recalculation of the encoder coordinates for that cube when the cube is illuminated by the laser. An example of when this would happen is if the cube actually moved from a previous location.
• The encoder coordinates for all cubes have been invalidated because the ALPHA, BETA, BP, EZ or MO commands were used to update base coordinate values. Any cube subsequently illuminated by the laser will have to recalculate the encoder coordinates used to aim the laser. An example of when this would happen is if the ZY moved from a previous location.

The ZY uses ``deferred evaluation'' when calculating encoder coordinates, meaning that such calculations are not made unless the values are required to illuminate the cube in question. These values are then cached for future use.

Example:

     send: AZM ZRG, 12345
  receive: AZM 1, 0, 12345

     send: AZM 0
  receive: AZM 1, 0, 12345

See also:

CIL, COO, ELV