User Manual

PLUS System Manual Location Software Library 77
Proprietary Information: Do not disclose unless authorized under a Nondisclosure Agreement and the Partner Agreement.
1 - group enabled.
groupFlags is a bit field that controls group characteristics
Bit 0 - Group Tracking Cell is enabled
Bit 3 - Co-linearity check disabled.
Bit 4 - Group can be calibrated – currently this bit is ignored.
Bit 5 - RSSI Sorting, used for groups that only provide 0D or presence detect positions and the Readers
in that group are not synchronized
allowedSolverFlags is a bit field that controls which type of solutions a group can produce.
Bit 0 - 0D or Presence Detect
Bit 1 - 1D
Bit 2 - 2D
mapIndex associates this group to a map.
trackingCellPoints is a buffer containing the points that define a tracking cell. Each point in the tracking cell is
defined by two values in the buffer (x and y).
trackingCellPointsBufferSize is the number of values in the tracking cell. Each point requires two values, an X and Y
value. For example if four points define a tracking cell then the buffer would contain eight values.
trackingCellSnap is used to control the “snap to” feature. If a position is outside the tracking cell, the distance to
the nearest point on the tracking cell boundary is computed. If that distance is less than this value, the position is
replaced with the nearest point on the tracking cell boundary. If the computed distance is larger that this value,
the position is discarded.
Returns
0 - Success
Less than zero - Invalid group parameter
4.5.2.4.2 GetGroup Function
public virtual int GetGroup( int groupId ,
int out groupState,
int out groupFlags,
int out allowedSolverFlags,
int out mapIndex,
double out * trackingCellPoints,
int trackingCellPointsBufferSize,
int out trackingCellPointsBufferUsed,
double out trackingCellSnap)
Retrieves information about a Group from the tracker's Group database. The Group must exist or an error is
returned.
groupId is the ID for the group. Group ID should be greater than or equal to zero. Do not use –1 as a group Id
because that value is used to denote all groups in other interface functions.
groupState denotes that the group is enabled or disabled
0 - group disabled