Scanlab RTC 5 PC Interface Board - mark_ellipse_abs

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
355
innovators for industry
Normal
List Command
mark_ellipse_abs
Function moves the laser focus at marking speed along an elliptical arc around the specified
midpoint (absolute coordinate values) within a two-dimensional image field.
Call mark_ellipse_abs( X, Y, Alpha )
Parameters X, Y absolute coordinates of the ellipse midpoint in bits as signed 32-bit values;
allowed range: [–8388608 … 8388607] (out-of-range values will be edge-
clipped).
Alpha Angle (in ° as a 64-bit IEEE floating point value) between elliptical half-axis a
(defined via set_ellipse) and the X axis
(the angle is referenced to the positive X direction, positive angle values
correspond to counterclockwise angles);
Alpha gets normalized to the value range [0…<360°].
Comments • The parameters for mark_ellipse_abs only determine the position and orientation of
the to-be-executed arc. Its shape must be specified via set_ellipse before marking via
mark_ellipse_abs. For descriptions of the individual parameters, also see page 94.
• If the arc starting point defined via mark_ellipse_abs and set_ellipse doesn’t equal the
current position, then a hard jump to the starting point will be executed prior to
marking (also see notes on page 94).
• Also see all comments for arc_abs.
RTC
®
4  RTC
®
5 new command
In RTC
®
4 compatibility mode, the RTC
®
5 multiplies the specified ellipse midpoint
coordinate values by 16 (the permissible range of values is correspondingly reduced to
[–524288 … 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 set_ellipse, mark_ellipse_rel, set_mark_speed, set_scanner_delays, arc_abs