RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
296
innovators for industry
Ctrl Command goto_xy
Function
moves the output point (of the laser focus) along a 2D vector at jump speed from the
current position to the specified position (absolute coordinate values) within a two-
dimensional image field.
Call
goto_xy( X, Y )
Parameters
X, Y
absolute coordinates of the jump vector end point in
bits
as signed 32-bit
values; allowed range: [–524288 … 524287]; (out-of-range values will be
edge-clipped).
Comments
• If the jump speed has not been previously explicitly set via
or
, then the jump will be executed at a predefined jump speed of
10000
bits per ms
.
•
goto_xy
(unlike the list commands
) has no effect on the laser
control signals and also doesn’t set a jump delay.
• During the conversion of specified coordinate values into scan system output values,
any previously defined coordinate transformations, assigned correction tables etc. are
taken into account after successful microvectorization (see
). As of version
DLL 520, OUT 519, coordinate transformation settings that were only collected until
then will possibly take effect via
goto_xy
at_once
= 2).
• The command will be ignored (
return code
:
RTC5_BUSY
) if the board’s
BUSY status is currently set (list is being processed or has been halted via
the board’s INTERNAL-BUSY status is currently set. In contrast, the command is
executed when a list has been paused via
(
PAUSED status set).
• The command will not be executed (
return code
:
RTC5_BUSY
), if an
external stop signal (/STOP, /STOP2 or /Slave STOP) is present.
• The INTERNAL-BUSY status is set while
goto_xy
is executed.
• As of version DLL 527, OUT 529, the
goto_xy
command only returns to the application
after microvectorization has been executed. Therefore, you cannot execute any control
command, while a
goto_xy
-induced jump is being executing.
RTC
®
4
RTC
®
5
• Extended range of values
• The command returns only after microvectorization has been executed (see comments
above).
• The image field coordinates for the X and Y axes are specified as 20-bit values; in RTC
®
4
compatibility mode they are specified as 16-bit values (as with the RTC
®
4) and the
RTC
®
5 multiplies the specified coordinate values by 16 (the permissible range of values
is correspondingly reduced to [–32768 … 32767]).
Version info
Last changes:
• with version DLL 520, OUT 519: behavior for coordinate transformations with
at_once
= 2 (see
)
• with version DLL 527, OUT 529: The command returns only after the motion has
completed.
References