RTC
®
4 PC Interface Board
Rev. 1.3 e
10 Commands And Functions
110
innovators for industry
Ctrl Command set_matrix
Function
defines a (2 x 2) transformation matrix which will be used for all subsequent vector outputs.
Parameters
m11, m12,
m21, m22
Matrix coefficients as 64-bit IEEE floating point values
Allowed range: [ – 100 … 100]
Integration
Pascal:
procedure set_matrix(m11, m12, m21, m22: double);
C:
void set_matrix(double m11, double m12, double m21, double m22);
Basic:
sub set_matrix(ByVal m11#, ByVal m12#, ByVal m21#, ByVal m22#)
Comments
• See
chapter 5.1 "Coordinate Transformations", page 40
References
,
List Command
set_matrix_list
Function
sets
one
of the four coefficients of the (2 x 2) transformation matrix during execution
of a list.
Parameters
i, j
Row index and column index [1 or 2] of the matrix coefficient to be changed
m_ij
Matrix coefficient as a 64-bit IEEE floating point value
Allowed range: [ – 100 … 100]
Integration
Pascal:
procedure set_matrix_list(i, j: word; m_ij: double);
C:
void set_matrix_list(unsigned short i, unsigned short j, double m_ij);
Basic:
sub set_matrix_list(ByVal i%, ByVal j%, ByVal m_ij#)
Comments
• The command
only allows changing
one
of the four coefficients at a
time. To change several coefficients during execution of a list, the command has to be
called repeatedly.
• See
chapter 5.1 "Coordinate Transformations", page 40
References
Ctrl Command set_max_counts
Function
defines the maximum number of external list starts
Parameter
max_counts
maximum number of external list starts as a signed 32-bit value.
Allowed range: 0
≤
max_counts
≤
2147483647
Integration
Pascal:
procedure set_max_counts(max_counts: longint);
C:
void set_max_counts(long max_counts);
Basic:
sub set_max_counts(ByVal max_counts&)
Comments
• If the parameter
max_counts
is set to 0, the maximum number of external start signals
is unlimited.
• After a reset of the RTC
®
4 the parameter
max_counts
is set to 0.
• The counter can be read with the command
• When the specified number of external start signals is reached, bit 0 of the
control_mode register is set to zero. Thus no further external start signals are possible.
• To reset the counter, call the command
References