RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
228
Variable
List Command
activate_fly_2d
Function activates a set_fly_2d 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_2d( ScaleX, ScaleY )
Parameters
ScaleX,
ScaleY
Scaling factors as for set_fly_2d
Comments • If no Processing-on-the-fly correction is active, then activate_fly_2d will activate
set_fly_2d Processing-on-the-fly correction (see chapter 8.7.4, page 184). Unlike
set_fly_2d, activate_fly_2d doesn’t thereby reset the encoders, but instead recalcu-
lates 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 coordinate 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_2d 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_2d can’t be used to modify the
Processing-on-the-fly mode itself or to modify 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_2d 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_2d
will (already during loading) be replaced by a list_nop (get_last_error return code
RTC5_PARAM_ERROR
).
• activate_fly_2d 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_2d
Version info Available beginning with version DLL 536, OUT 536
References set_fly_2d