RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
322
Multiple List
Command
activate_fly_2d_encoder
Function Activates a set_fly_2d Processing-on-the-fly application with encoder reset and encoder
offsets.
Restriction If the Option Processing-on-the-fly is not enabled, then activate_fly_2d_encoder
terminates the Processing-on-the-fly process (even though it could not have been
activated).
Call
activate_fly_2d_encoder( ScaleX, ScaleY, EncX, EncY )
Parameters
ScaleX
Scaling factor as for set_fly_2d.
ScaleY
Like
ScaleX
.
EncX
Encoder offset.
As a signed 32-bit value.
EncY
Like
EncX
.
Comments • activate_fly_2d_encoder occupies two RTC6 List Memory positions and also needs
two 10 µs clock cycles to execute (the first part of activate_fly_2d_encoder is not a
short list command).
• activate_fly_2d_encoder is a combination of set_fly_2d (encoder reset) and
activate_fly_2d (see also comments there). However, in activate_fly_2d_encoder the
current (reset) encoder values are not used to calculate the Processing-on-the-fly-
uncorrected virtual Image Field coordinates, but the parameter values
EncX
and
EncY
.
For the error handling, see comments of activate_fly_2d.
• Because of this combination, activate_fly_2d_encoder saves the positioning stage
movement (which is often long but may be necessary for the Processing-on-the-fly
activation without this command) from the initialization position (for example, at the
lower left corner) to the center and back again.
• Subsequently all encoder values are offset with
EncX
and
EncY
, before the
Processing-on-the-fly correction is applied. All other encoder related commands refer
to the actual encoder values and behave as before.
• If the value of
EncX
or
EncY
is not allowed (that is, the Processing-on-the-fly-corrected
virtual Image Field coordinates are outside the virtual
Image Field li
mits), then
activate_fly_2d_encoder is replaced by a list_nop (get_last_error return code
RTC6_PARAM_ERROR
).
• If the value of
ScaleX
or
ScaleY
is not allowed (see set_fly_2d), the first part is
transferred to the board (and thus executes the encoder reset). However, the second
part is replaced by a list_nop (get_last_error return code
RTC6_PARAM_ERROR
).
• With active Processing-on-the-fly correction, activate_fly_2d_encoder is a short
list command without further effect and merely sets an error bit queryable by
get_marking_info (
Bit #9
). Therefore, activate_fly_2d_encoder cannot be used to
modify the Processing-on-the-fly mode itself nor the scaling factors or encoder offsets
of the same mode.
To Next Page
Loading...