User Manual

PLUS System Manual Location Software Library 85
Proprietary Information: Do not disclose unless authorized under a Nondisclosure Agreement and the Partner Agreement.
4.5.2.8.3 GetNextTag Function
public virtual int GetNextTag( int currentTagId ,
int out nextTagId )
Retrieves next Tag ID given a Tag ID. The next Tag ID is the next higher numbered Tag. To retrieve the first
(lowest numbered) Tag ID, pass -1 in the currentTagId parameter.
Returns
0 - Success
Less than zero – No Tag ID higher than currentTagId (currentTagId is the last Tag ID).
4.5.2.8.4 GetTagPosition Function
public virtual int GetTagPosition( int tagId ,
int out tagType ,
int out positionType,
int out mapIndex ,
double out x ,
double out y ,
double out z ,
int out timestamp,
int out batteryState,
int out buttonEvent,
int out motion ,
int out bestReaderIdLow,
int out bestReaderIdHi ,
int out positionFom )
Retrieves information on the last position calculated for the specified Tag. If a Tag’s position has not been
calculated, this function returns a nonzero value and does not return any Tag information.
tagId is the ID of the Tag.
tagType is the type. It can be either tracking = 1 or calibration Tag = 2.
positionType is the type of position.
0D = 1
1D = 2
2D = 3
mapIndex is the index of the map
x,y,z are the computed coordinates of the Tag.
motionFlag , buttonEvent and battery are snapshots of those values from the Tag at the time the position was
calculated.
timestamp is the time as returned by the Windows API function GetTickCount() at the time the Tag’s position was