Xymappingget - Newport XPS Programmer's Manual

XPS Unified
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
-3.00 -0.00192
-2.00 -0.00453
-1.00 -0.00331
0.00 -0.00787
1.00 -0.00232
2.00 -0.00134
3.00 -0.00789
Prototype
int XYMappingGet(
int SocketID,
char * PositionerName,
int* MappingNumber,
int* LineNumber,
double* Value1,
double* Value2,
...
)
Input parameters
SocketID
PositionerName
MappingNumber
LineNumber
-2.00 -1.00 0.00
-0.00534 -0.00254 0.00023
-0.00322 -0.00676 0.00049
-0.00845 -0.00769 0.00102
0
-0.00228 -0.00787
-0.00210 -0.00342 0.00089
-0.00308 -0.00675 0.00101
-0.00148 -0.00234 0.00121
int Socket identifier gets by the
"TCP_ConnectToServer" function.
char * XY positioner name.
int XY mapping matrix number.
int Mapping line to read.
543
Programmer's Manual
1.00 2.00 3.00
0.00254 0.00534 0.00192
0.00676 0.00322 0.00453
0.00769 0.00845 0.00331
0.00787 0.00228 0.00787
0.00342 0.00210 0.00232
0.00675 0.00308 0.00134
0.00234 0.00148 0.00789
EDH0373En1023 — 01/18
(Line 1)