RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
229
Variable
List Command
activate_fly_xy
Function activates a set_fly_x/set_fly_y Processing-on-the-fly application without encoder resets
Restriction If the Processing-on-the-fly option is not enabled, then the command terminates the
Processing-on-the-fly process (even though it couldn’t have been activated).
Call
activate_fly_xy( ScaleX, ScaleY )
Parameters
ScaleX,
ScaleY
Scaling factors as for set_fly_x/set_fly_y
Comments • If no Processing-on-the-fly correction is active, then activate_fly_xy will activate
set_fly_x/set_fly_y Processing-on-the-fly correction. Unlike set_fly_x, and set_fly_y,
activate_fly_xy doesn’t thereby reset the encoders, but instead recalculates the last
Processing-on-the-fly-uncorrected coordinate values such that the Processing-on-the-
fly-corrected output matches the current output. If the then-current recalculated coor-
dinate values would have fallen outside the 24-bit virtual image field, then Processing-
on-the-fly correction won’t be activated and an error bit will be set that is queryable via
get_marking_info (bit #9 = 1).
• If Processing-on-the-fly correction is active, then activate_fly_xy will be a short list
command without further effect and merely sets an error bit queryable via
get_marking_info (bit #9 = 1). Therefore, activate_fly_xy can’t be used to modify the
Processing-on-the-fly mode or the scaling factors of the same mode
• You can also query the error bit via the short list command if_not_activated in order
to possibly jump to an appropriate error handling routine.
• Successful activation via activate_fly_xy doesn’t reset any already-set error bit. It will
remain set for get_marking_info until get_marking_info is called.
• If unallowed parameter values are supplied (e.g. for
ScaleX
= 0), then activate_fly_xy
will (already during loading) be replaced by a list_nop (get_last_error return code
RTC5_PARAM_ERROR
).
• activate_fly_xy doesn’t affect the laser signals (“laser active” laser control signals will
remain on/off if they were on/off).
RTC
®
4
RTC
®
5 new command
RTC
®
4 compatibility mode: see set_fly_x/set_fly_y
Version info Available beginning with version DLL 536, OUT 536
References set_fly_x, set_fly_y