Scanlab RTC6 PCIe Board Installation And Operation Manual page 441

Ctrl Command get_transform_offset
• get_transform_offset( Channel1, Channel2, Offset, Number, Ptr1, Ptr2, Ptr, Code )
Comments
– Transfers the data pairs recorded with
PC with
• get_waveform_offset(Channel1, Offset, Number, Ptr1) and
• get_waveform_offset(Channel2, Offset, Number, Ptr2)
– Overwrites the data pairwise with transform( Sig1, Sig2, Ptr,
• Prior to a get_transform_offset call:
– upload_transform
– Position values should have been recorded by
• Prior to a get_transform_offset call or
measurement_status
by
started with set_trigger/set_trigger4/set_trigger8.
In addition,
pairs recorded during the last (or current) measurement. Read out at most Pos+1 data
elements. All other data elements are from previous recordings or initialization.
• You must provide the working memory areas under Ptr1 and Ptr2 with sufficient size
(Number × 4 bytes per channel).
• For backward transformation of position values, see
Positioning", page
• If only Z position values are to be backward transformed (Code Bit #0 = 1), then you
can set the pointer (Ptr1 or Ptr2) for the unused measurement channel to NULL. For
this measurement channel, no date are transferred to the PC and backward
transformed. In this case, make sure that Code Bit #1 is appropriately set.
• For both measurement channels, no data are transferred to the PC and no backward
transformation is performed
– get_transform_offset( Ptr1 = NULL, Ptr2 =
– Number = 0
– Number > 2
• With get_transform_offset( Ptr =
performed. The data recorded by
transferred untransformed to the PC, as with get_waveform(1, Number, Ptr1) and
get_waveform(2, Number, Ptr2).
The same applies for get_transform_offset( Ptr 
execution of get_transform_offset (for example, data referenced by Ptr are invalid or
erroneous, z axis inversion not possible). In this case, a
RTC6_PARAM_ERROR
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
must have been executed
whether a recording is currently running that has been
measurement_status can be used to read out the number
214.
(get_last_error
24
NULL
set_trigger/set_trigger4/set_trigger8
is generated in addition.
set_trigger/set_trigger4/set_trigger8
set_trigger/set_trigger4/set_trigger8
get_waveform_offset call, it can be checked
Chapter 8.1.3 "Monitoring the
return code RTC6_PARAM_ERROR) with:
NULL )
), then no backward transformation is
NULL ), if an error occurred during
get_last_error
to the
Code )
Pos
of data
is then
return code
441