RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
403
Ctrl Command get_galvo_controls
Function Returns the corresponding control values for given input values.
Restriction get_galvo_controls can only be executed, if no list is currently being processed
(get_last_error return code
RTC6_BUSY
).
Call
get_galvo_controls( InPtr, OutPtr )
Parameters
InPtr
Pointer (data type ULONG_PTR in C and C++, an unsigned 32-bit or
unsigned 64-bit value) to an array of five unsigned 32-bit values, where the
to-be-outputted settings are specified: X, Y, Z, Defocus, Zoom.
Out-of-range values are clipped to the boundary values.
OutPtr
Pointer (data type ULONG_PTR in C and C++, an unsigned 32-bit or
unsigned 64-bit value) to an array of 4 unsigned 32-bit values, where the
corresponding control values are to be stored: XA, YA, XB, YB.
Value range in each case [–524,288…+524,287].
Returned
parameter
values
XA, YA, XB, YB denote the control values for the x axis/y axis of scan head A/B.
Comments • get_galvo_controls carries-out a virtual jump to the specified coordinates. Though the
galvanometer scanners are not moved.
• All other settings which are not specified within get_galvo_controls (for example,
matrix, offset, angle, etc.; also stretch table) are considered as they are set at the
moment. Make sure to apply these by
at_once > 0
before calling get_galvo_controls!.
The settings are not used, if they just only have been saved by
at_once = 0
.
• Control values are calculated only for channels where a correction table has been
previously assigned by select_cor_table, see the following examples.
select_cor_table(0,0)
: XA = YA = XB = YB = 0
2D correction files: inputs Z, Defocus, Zoom are ignored
select_cor_table(1,0)
: XA, YA calculated, XB, YB = 0
select_cor_table(0,1)
: XA, YA = 0, XB, YB calculated
select_cor_table(1,1)
: XA, YA, XB, YB calculated
(Standard-)3D correction file: input Zoom is ignored
select_cor_table(1,0)
: XA, YA calculated, XB = YB = Zout calculated
select_cor_table(0,1)
: XA= YA = Zout calculated, XB, YB calculated
select_cor_table(1,1)
: same as
select_cor_table(0,0)
3D zoom correction file (only for intelliWELD II with zoom axis):
select_cor_table(1,0)
: XA, YA calculated, XB = Zout, YB = ZoomOut calculated
select_cor_table(0,1)
: XA= Zout, YA = ZoomOut calculated, XB, YB calculated
• The return values are 0, if a get_last_error return code
RTC6_BUSY
has been generated.
To Next Page
Loading...