User Manual

84 Location Software Library PLUS System Manual
Proprietary Information: Do not disclose unless authorized under a Nondisclosure Agreement and the Partner Agreement.
Returns
0 - Success; the Tag exists and the x, y and z coordinates have been returned.
Less than zero - The Calibration Tag does not exist in the database.
4.5.2.8 Tag Configuration
The functions in this section are used to configure the Location Software’s internal Tag database.
4.5.2.8.1 AddOrUpdateTag Function
public virtual int AddOrUpdateTag( int tagId ,
double nominalZheight )
Adds a Tag (non-Calibration Tag) to the Tag database. If the Tag already exists, it updates the Tag's
configuration. Since the location engine can only track Tags on 2D planes, the Tag's nominal Z height must be
configured beforehand in the nominalZheight parameter. Setting the nominalZHeight is only needed when the Tag
is at a different height than the system default nominalZHeight.
tagId is the ID of Tag.
nominalZheight is the height above floor of the Tag.
Returns
0 - Success
less than zero - Invalid value for nominalZheight (Invalid values are NaN’s)
4.5.2.8.2 GetTag Function
public virtual int GetTag( int tagId ,
double out nominalZheight )
Retrieves a Tag’s nominalZHeight from the Tag database. The Tag must exist or an error is returned.
tagId is the ID of Tag.
nominalZheight is the height above floor of the Tag.
Returns
0 - Success
less than zero – Tag does not exist or invalid value for nominalZheight (Invalid values are NaNs)