Set_Ellipse - Scanlab RTC6 PCIe Board Installation And Operation Manual

Undelayed

set_ellipse

Short List
Command
Function Defines the shape of an elliptical arc that can subsequently be marked by
mark_ellipse_abs
Call set_ellipse( a, b, Phi0, Phi )
Parameters a
b
Phi0
Phi
Comments • Specify the to-be-marked elliptical arc's position and orientation in the 2D
by mark_ellipse_abs
parameters, see
• For a < 1 and/or b < 1, set_ellipse is replaced with a
(get_last_error
RTC4RTC6 New command.
In RTC4 Compatibility
The allowed value range decreases accordingly.
RTC5RTC6 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,
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
or mark_ellipse_rel.
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.
See a.
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°].
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.
or mark_ellipse_rel. For descriptions of the individual
Section "Ellipse Commands", page
return code RTC6_PARAM_ERROR).
Mode, the RTC6 multiplies the specified values for a and b by 16.
mark_ellipse_rel
Image Field
138.
list_nop
632