RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
434
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: primary scan head connector
= 2: secondary scan head connector (activation required)
GalvoGainX,
GalvoGainY
Gain values (as 64-bit IEEE floating point values);
allowed range: [0.01 … 100]
GalvoOffsetX,
GalvoOffsetY
Offset values in bits (as 64-bit IEEE floating point values);
allowed range: [–524288 … 524287]
Comments • For information on using the command, see page 201.
• The specified gain and offset values overwrite the values that were set via auto_cal and
can themselves be overwritten via a subsequent call of auto_cal.
• Changed gain and offset values can trigger hard jumps. To avoid this, the transition is
automatically performed at the predefined jump speed (see set_jump_speed).
• If a parameter value is invalid, then the command will not execute (get_last_error
return code:
RTC5_PARAM_ERROR
). The command will likewise not execute
(get_last_error return code:
RTC5_BUSY
) if the board’s BUSY status is currently set (list
is being processed or has been halted via pause_list) or the board’s INTERNAL-BUSY
status is currently set. In contrast, the command is executed when a list has been
paused via set_wait (PAUSED status set). For
RTC5_PARAM_ERROR
, the BUSY status is not
checked; therefore the return codes
RTC5_BUSY
and
RTC5_PARAM_ERROR
will not arrive
simultaneously.
• If the “second scan head control” option has not been enabled, values specified for the
secondary scan head control will have no effect.
RTC
®
4
RTC
®
5 new command
References auto_cal, get_hi_pos
Ctrl Command set_input_pointer
Function opens the list buffer for writing with list commands and sets the input pointer to the
specified (absolute) address in list memory (“List 1” or “List 2”). The next list command will
be stored at this address and all further list commands at the subsequent addresses in the
selected list.
Call
set_input_pointer( Pos )
Parameter
Pos
Position (absolute memory address) of the input pointer [0 … (2
20
–1)] as an
unsigned 32-bit value
Comments • The set_input_pointer command performs basically like the command
set_start_list_pos (see the comments there). But set_input_pointer sets the input
pointer based on a specified absolute memory address, whereas set_start_list_pos
uses a specified list number and a relative memory address.
•For
Pos
Mem1
+
Mem2
(see config_list),
Pos
is set to 0.
RTC
®
4
RTC
®
5 unchanged functionality
References set_start_list_pos, get_input_pointer
To Next Page
Loading...
