Gocator 2300 & 2880 Series
Software Development Kit • 368
GoDataSet Type
Data are passed to the data handler in a GoDataSet object. The GoDataSet object is a container that can
contain any type of data, including scan data (profiles or surfaces), measurements, and results from
various operations. Data inside the GoDataSet object are represented as messages.
The following illustrates the content of a GoDataSet object of a profile mode setup with two
measurements. The content when using a surface mode setup is identical, except that a GoSurfaceMsg is
sent instead of a GoProfileMsg.
After receiving the GoDataSet object, you should call GoDestroy to dispose the GoDataSet object. You do
not need to dispose objects within the GoDataSet object individually.
All objects that are explicitly created by the user or passed via callbacks should be destroyed
by using the GoDestroy function.
MeasurementValues and Decisions
Measurement values and decisions are 32-bit signed values (k32s). See Value Types on the previous page
for more information on value types.
The following table lists the decisions that can be returned.
Decision Description
1 The measurement value is between the maximum and minimum decision values. This
is a pass decision.
0 The measurement value is outside the maximum and minimum. This is a fail decision.
-1 The measurement is invalid (for example, the target is not within range). Provides the
reason for the failure.
-2 The tool containing the measurement is anchored and has received invalid
measurement data from one of its anchors. Provides the reason for the failure.
Measurement Decisions
Refer to the SetupMeasurement example for details on how to add and configure tools and
measurements. Refer to the ReceiveMeasurement example for details on how to receive measurement
decisions and values.
To Next Page
Loading...
Need help?
General
