RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
632
Undelayed
Short List
Command
set_ellipse
Function Defines the shape of an elliptical arc that can subsequently be marked by
mark_ellipse_abs or mark_ellipse_rel.
Call
set_ellipse( a, b, Phi0, Phi )
Parameters
a
Length of the elliptical half-axis. In bits.
As an unsigned 32-bit value.
Allowed value range: [1…+8,388,607].
Out-of-range positive values are clipped to the boundary values.
b
See
a
.
Phi0
Beginning phase angle (the arc starting point position relative to the end point
of half-axis a). In degrees.
As a 64-bit IEEE floating point value.
A positive sign means “clockwise”.
Phi0
gets normalized to the value range [0…<360°].
Phi
Arc angle (to-be-marked ellipse section). In degrees.
As a 64-bit IEEE floating point value.
A positive sign means “clockwise”.
Allowed value range: [–2,880.0°…+2,880.0°] (±8 full ellipses).
Out-of-range values are clipped to the boundary values.
Comments • Specify the to-be-marked elliptical arc’s position and orientation in the 2D Image Field
by mark_ellipse_abs or mark_ellipse_rel. For descriptions of the individual
parameters, see Section ”Ellipse Commands”, page 138.
• For
a
< 1 and/or
b
< 1, set_ellipse is replaced with a list_nop
(get_last_error return code
RTC6_PARAM_ERROR
).
RTC4RTC6 New command.
In RTC4 Compatibility Mode, the RTC6 multiplies the specified values for
a
and
b
by 16.
The allowed value range decreases accordingly.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
Last change DLL 639, OUT 641: Allowed value range for
Phi
has been reduced (previously:
[–3,600.0°…+3,600.0°] = ±10 full ellipses).
References mark_ellipse_abs, mark_ellipse_rel