Newport XPS-D - Xymappingget

XPS Unified Programmer’s Manual
7.2.1.373 XYMappingGet
Name
XYMappingGet – Read data of a line of an XY mapping matrix in the controller.
Input tests
- Refer to section 7.1: “Input Tests Common to all XPS Functions”.
- Checks the positioner name (must be a XY positioner): (-18)
- Checks the secondary positioner (must not be a secondary positioner): (-24)
- Checks MappingNumber (must be > 0 and ≤ 1 (standard firmware) or 3 (Precision
Platform firmware)): (-9)
- Checks LineNumber (must be ≥ 1 and ≤ MappingLineNumber): (-9)
- Checks the number of parameters (must be > 3 and ≤ MappingColumnNumber+3):
(-9)
- Checks mapping enable state (must be Enabled): (-121)
Description
Read data of a line of a XY mapping matrix in the controller.
Example:
0
-3.00
-2.00
-1.00
0.00
1.00
2.00
3.00
-3.00
-0.00192
-0.00534
-0.00254
0.00023
0.00254
0.00534
0.00192
(Line 1)
-2.00
-0.00453
-0.00322
-0.00676
0.00049
0.00676
0.00322
0.00453
-1.00
-0.00331
-0.00845
-0.00769
0.00102
0.00769
0.00845
0.00331
0.00
-0.00787
-0.00228
-0.00787
0
0.00787
0.00228
0.00787
1.00
-0.00232
-0.00210
-0.00342
0.00089
0.00342
0.00210
0.00232
2.00
-0.00134
-0.00308
-0.00675
0.00101
0.00675
0.00308
0.00134
3.00
-0.00789
-0.00148
-0.00234
0.00121
0.00234
0.00148
0.00789
Prototype
int XYMappingGet(
int SocketID,
char * PositionerName,
int* MappingNumber,
int* LineNumber,
double* Value1,
double* Value2,
…
)
Input parameters
SocketID int Socket identifier gets by the
“TCP_ConnectToServer” function.
PositionerName char * XY positioner name.
MappingNumber int XY mapping matrix number.
LineNumber int Mapping line to read.
543 EDH0373En1023 — 01/18