RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
356
Normal
List Command
mark_ellipse_rel
Function moves the laser focus at marking speed along an elliptical arc around the specified
midpoint (relative coordinate values) within a two-dimensional image field.
Call
mark_ellipse_rel( dX, dY, Alpha )
Parameters
dX,dY
relative 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 (see mark_ellipse_abs)
Comments • The coordinates for the ellipse midpoint are to be supplied as relative coordinates with
respect to the current position. Otherwise, the command is identical to
mark_ellipse_abs (see the comments there).
• The current coordinates will be clipped to [–524288 … 524287] (real image field size)
during runtime directly prior to use of the correction table.
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 mark_ellipse_abs, set_ellipse
Normal
List Command
mark_rel
Function moves the laser focus at marking speed along a 2D vector from the current position to the
specified position (relative coordinate values) within a two-dimensional image field.
Call
mark_rel( dX, dY )
Parameters
dX, dY
relative coordinates of the mark vector end point in bits as signed 32-bit
values; allowed range: [–8388608 … 8388607] (out-of-range values will be
edge-clipped). The complete value range [–8388608 … 8388607] is only
usable as a virtual image field e.g. for (enabled) Processing-on-the-fly
applications. The current coordinates will be clipped to [–524288 … 524287]
(real image field size) during runtime directly prior to use of the correction
table.
Comments • The coordinates for the mark vector’s end point are to be supplied as relative coordi-
nates with respect to the current position. Otherwise, the command is identical to
mark_abs (see the comments there).
RTC
®
4
RTC
®
5 unchanged functionality (except for the extended range of values).
In RTC
®
4 compatibility mode, the RTC
®
5 multiplies the specified coordinate values by 16
(the permissible range of values is correspondingly reduced).
References mark_abs, mark_rel_3d, timed_mark_rel
To Next Page
Loading...
