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:
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