The RN command terminates the collection of scan data and/or returns collected scan data to MeasureMax+.
Command Format
MLString "RN p1"
Examples
MLString "RN"
If scanning is active, this example shows how to set a wait time to empty the DCC queue and for the final move to be in-tolerance before the system terminates scanning. The software then returns the number of data points to the host.
MLString "RN 0"
If scanning is active, this example shows how to set a wait time to empty the DCC queue and for the final move to be in-tolerance before the system terminates scanning. The software then returns the collected data points (beginning with point number 0) and the number of data points to the host.
Input
p1 = point index (Numeric, optional)
The optional numeric parameter p1 cannot be a negative number. If specified, p1 requests that scan data points be returned to the host beginning with point #p1. Note that the first point collected has index 0 (zero). If you do not specify p1, the software does not return the collected data to the host computer.
Results
The RN command completes a scan data collection operation initiated by the AS command. If scanning is active, it is terminated when the DCC queue becomes empty and the final move to be in-tolerance. If you specify p1, the software returns the collected data points from the scan buffer to the host computer and then stores it in the S9 array. For all scan types except A (for details, see the AK - Automatic Tracking command topic), the software stores the point data in the S9 array in normal X, Y, Z order.
For example, the X coordinate data values are stored in the S9 array location (*, 0), the Y coordinate data values are stored in the S9 array location (*, 1), and the Z coordinate data values are stored in the S9 array location (*, 2).
For a scan of type A, the software stores the polar radius values in the S9 array location (*, 0), the polar angle values are stored in the S9 array location (*, 1), and the third axis values (height) are stored in the S9 array location (*, 2).
The software returns the number of collected data points to variable S7.
Skip Action
Ignored
Error Messages
None