Reference Manual
Chapter
5
Ruler E
Ruler API
By setting a transformation for the Ruler object, you can change the coordinate system
and receive the measurements in a coordinate system that suits your environment. This is
particularly useful if you have several Rulers that measure the same object.
You set a transformation by setting the
Transformation
property of the Ruler object.
The transformation consists of two parts:
Transformation.Rotation
A counter-clockwise rotation, specified by the
angle in radians (
Angle
) and a center of rotation
(
Center
), which is a point in the Ruler’s coordi-
nate system
Transformation.Translation
The distance to move the origin of the Ruler’s
coordinate system along the x axis (
x
) and the z
axis (
range
).
Figure 5.4 – Transforming the coordinate system
When you have set a transformation, the Ruler object must be updated for the translation
to take effect.
Note that the transformation is performed on the PC and not in the Ruler. Therefore it is
included in the parameter files, but must be set by your application. If you always want to
use the same transformation with the Ruler, your application should save the transforma-
tion parameters in order to be able to retrieve them when re-initializing the Ruler.
Rotation
Center of
rotation
Global coordinates
Translation (negative)
Local coordinates
SICK IVP • Industrial Sensors • www.sickivp.com • All rights reserved
45
