RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
441
Comments •
get_transform_offset( Channel1, Channel2, Offset, Number, Ptr1, Ptr2, Ptr, Code )
– Transfers the data pairs recorded with set_trigger/set_trigger4/set_trigger8 to the
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, Code
)
• Prior to a get_transform_offset call:
– upload_transform must have been executed
– Position values should have been recorded by set_trigger/set_trigger4/set_trigger8
• Prior to a get_transform_offset call or get_waveform_offset call, it can be checked
by measurement_status whether a recording is currently running that has been
started with set_trigger/set_trigger4/set_trigger8.
In addition, measurement_status can be used to read out the number
Pos
of data
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 Chapter 8.1.3 ”Monitoring the
Positioning”, page 214.
• 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_last_e
rror return code
RTC6_PARAM_ERROR
)
with:
– get_transform_offset(
Ptr1
= NULL,
Ptr2
= NULL )
–
Number
= 0
–
Number
> 2
24
• With get_transform_offset(
Ptr
= NULL ), then no backward transformation is
performed. The data recorded by set_trigger/set_trigger4/set_trigger8 is then
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
NULL ), if an error occurred during
execution of get_transform_offset (for example, data referenced by
Ptr
are invalid or
erroneous, z axis inversion not possible). In this case, a get_last_error return code
RTC6_PARAM_ERROR
is generated in addition.
Ctrl Command get_transform_offset
To Next Page
Loading...