Chapter
5
Reference Manual
Ruler E
Ruler API
...
...
0
1
2
3
4
5
1023 1024 1025 1026 1027 1028
(PointsPerProfile *
ProfilesPerBuffer) - 1
x
range
intensity
scatter
Figure 5.2 – How measurement data is stored in the arrays
In addition to the measurement data, the following information is also returned for each
profile by the Ruler object:
id
ID of the profile that the measurement data belongs to (integer).
mark
If
the
Mark
parameter is set, the encoder values are returned in this
array (signed integer).
status
Status and error information for each profile (integer):
Flag Bit
Description
INVALID
0
Set if data was lost during transmission
– 1-15
Reserved
OVER_TRIG
16-23
Number of overtrigs that have occurred
– 24-26
Reserved
ENCODER_B
27
Set if the signal on In2 on the Encoder
connector is high (Encoder Phase 2)
ENCODER_A
28
Set if the signal on In1 on the Encoder
connector is high (Encoder Phase 1)
LASER
29
Set if Laser is on
ENABLE
30
Set if the signal on In1 on the Power I/O
connector is high (Enable)
– 31
Reserved
The
ENABLE
flag in the status information is useful when using an external enable trigger-
ing signal. A profile where the
ENABLE
flag is off (
0
) indicates that the measurement of an
object is finished.
To retrieve measurement data from the Ruler, declare arrays to be filled with the meas-
urement data, and call the Ruler object’s
RequestDataSeparate()
method, and pass
the arrays as arguments:
res = ruler.RequestDataSeparate(id, status, scatter,
x, range, intensity, mark)
3:rd point in
first profile (0)
3:rd point in
second profile (1)
Profile 0
Profile 1
42
SICK IVP • Industrial Sensors • www.sickivp.com • All rights reserved