Scanlab RTC 5 PC Interface Board, Installation And Operation Manual

Page: 417 / 622

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
417
innovators for industry
Undelayed
Short
List Command set_ellipse
Function defines the shape of an elliptical arc that can subsequently be marked via
mark_ellipse_abs or mark_ellipse_rel .
Call
set_ellipse( a, b, Phi0, Phi )
Parameters
a, b
Lengths of the elliptical half-axes in bits as unsigned 32-bit values;
allowed range: [1 … 8388607];
out-of-range positive values will be edge-clipped.
Phi0
Beginning phase angle in ° (the arc starting point’s position relative to the end
point of half-axis a) as a 64-bit IEEE floating point value
(positive angle values correspond to clockwise angles);
Phi0
gets normalized to the value range [0…<360°].
Phi
arc angle in ° (to-be-marked ellipse section) as a 64-bit IEEE floating point
value (positive angle values correspond to clockwise angles);
allowed range: [–3600.0° … +3600.0°] (±10 full ellipses);
an out-of-range value will be edge-clipped.
Comments • Specify the to-be-marked elliptical arc’s position and orientation in the two-dimen-
sional image field via mark_ellipse_abs or mark_ellipse_rel . For descriptions of the
individual parameters, also see page 94 .
• For
a
< 1 or/and
b
< 1, set_ellipse is replaced with a list_nop ( get_last_error return
code :
RTC5_PARAM_ERROR
).
RTC
®
4

RTC
®
5 new command
In RTC
®
4 compatibility mode, the RTC
®
5 multiplies the length values specified for the
elliptical half-axes by 16 (the permissible range of values is correspondingly reduced to
[1 … 524287]).
Version info • Available beginning with version DLL 518, OUT 517, RBF 515
• For older RTC
®
5 boards with DSP version numbers < 2 ( get_rtc_version bits #16-23),
the command is neither executed nor replaced by list_nop ( get_last_error return code :
RTC5_TYPE_REJECTED
).
References mark_ellipse_abs , mark_ellipse_rel