Set_Mcbsp_Matrix - Scanlab RTC6 PCIe Board Installation And Operation Manual

Ctrl Command set_mcbsp_matrix
Function Activates matrix correction for

set_mcbsp_matrix()

Call
Comments • For
page
• Matrix corrections cannot be used in conjunction with offset and/or rotation
corrections. Any such already-activated options gets deactivated by
set_mcbsp_matrix. Subsequent activation of other options (by set_mcbsp_x,
set_mcbsp_y
• The following restrictions apply to the matrix coefficients transferred over the
McBSP interface
The allowed value range for matrix coefficients is [–50...+50].
Transferred coefficients exceeding this range are ignored.
• You must individually supply as input value M
coefficient Mij of the transformation matrix M
indices i and j as follows:
M
in
with M
Conversely, the RTC6 determines a coefficient from the input value as follows:
M [ M
T
• You must separately fetch each transferred matrix coefficient by
apply_mcbsp_list. We recommend fetching the first coefficient with at_once = 0 and
only the last one with at_once > 0.
• The coefficients get transferred to internal memory location 1 and can be checked
there by querying with read_mcbsp(1).
• The
Processing-on-the-fly applications.
See also
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References set_mcbsp_matrix_list
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
"Local Online Positioning"
"Local Online Positioning", see
228.
or set_mcbsp_rot) deactivates the matrix correction.
(as with set_matrix):
24
= ( integer( Mij * 2 ) << 2 ) + ( i << 1 ) + j
= { M00, M01, M10, M11 } = { m
T
& 0x3 ] = ( M >> 2 ) / 2
in in
McBSP interface cannot be simultaneously used for an
Section "Notes", page
by the
Chapter 8.3.1 ""Local Online Positioning"",
to the McBSP interface
in
as a normalized integer with associated
T
, m , m , m
11 12 21
24
.
230.
McBSP interface.
each matrix
}.
22
apply_mcbsp or
Online Positioning and
693