set_sub_matrix — Setzt eine Teilmatrix in einer Matrix.
set_sub_matrix( : : MatrixID, MatrixSubID, Row, Column : )
Der Operator set_sub_matrix überschreibt
einen Teil der Matrix Matrix mit der Matrix
MatrixSub. Die Eingabematrizen sind durch die Matrix
Handles MatrixID und MatrixSubID gegeben. Die
Parameter Row und Column legen die Position der
oberen linken Ecke der Teilmatrix MatrixSub in der Matrix
Matrix fest.
Es müssen die Bedingungen 0 <= Row < Größe der
Matrix Matrix in Zeilenrichtung, Row + Größe
der Matrix MatrixSub in Zeilenrichtung <= Größe
der Matrix Matrix in Zeilenrichtung, 0 <=
Column < Größe der in Spaltenrichtung und Column +
Größe der Matrix MatrixSub in Spaltenrichtung
<= Größe der Matrix Matrix in Spaltenrichtung
erfüllt sein.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
MatrixID (input_control, Zustand wird modifiziert) matrix → (handle)
Matrix Handle der Eingabematrix.
MatrixSubID (input_control) matrix → (handle)
Matrix Handle der Eingabeteilmatrix.
Row (input_control) integer → (integer)
Obere Zeilenposition der Teilmatrix in der Matrix.
Defaultwert: 0
Wertevorschläge: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100
Restriktion: Row >= 0
Column (input_control) integer → (integer)
Linke Spaltenposition der Teilmatrix in der Matrix.
Defaultwert: 0
Wertevorschläge: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100
Restriktion: Column >= 0
Sind die Parameterwerte korrekt, dann liefert set_sub_matrix
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung
durchgeführt.
get_full_matrix,
get_value_matrix
Foundation