RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
659
Ctrl Command set_hi
Function Defines gain and offset values for the galvanometer scanners of the scan system attached
to the specified scan head connector.
Call
set_hi( HeadNo, GalvoGainX, GalvoGainY, GalvoOffsetX, GalvoOffsetY )
Parameters
HeadNo
Number of the scan head connector.
As an unsigned 32-bit value.
Allowed values:
= 1: First scan head connector.
= 2: Second scan head connector.
GalvoGainX
x gain value.
As a 64-bit IEEE floating point value.
Allowed value range: [0.01…100].
GalvoGainY
Like
GalvoGainX
(analogously).
GalvoOffsetX
x offset value. In bits.
As a signed 32-bit value.
Allowed value range: [–524,288…+524,287].
GalvoOffsetY
Like
GalvoOffsetX
(analogously).
Comments • For usage of set_hi, see Section ”Customer-Specific Calibration”, page 278.
• The specified gain and offset values overwrite the values that were set by auto_cal and
can themselves be overwritten by a subsequent call of auto_cal.
• With changed gain and offset values, the transition is automatically performed at the
predefined jump speed (see set_jump_speed).
• set_hi is not executed, if:
– A parameter value is invalid
(get_last_error return code
RTC6_PARAM_ERROR
)
– the BUSY list execution status is set
(get_last_error return code
RTC6_BUSY
)
– the INTERNAL-BUSY list execution status is set
(get_last_error return code
RTC6_BUSY
)
• set_hi is even executed, if:
– a list has been paused by set_wait (PAUSED list execution status set)
• For
RTC6_PARAM_ERROR
, the BUSY list execution status is not checked. Therefore the
return codes
RTC6_BUSY
and
RTC6_PARAM_ERROR
do not occur simultaneously.
• If the Option “Second Scan Head Control” has not been enabled, values specified for
the second scan head control have no effect.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References auto_cal, get_hi_pos, write_hi_pos