| Operatoren |
set_full_matrix — Setzt alle Werte einer Matrix.
Der Operator set_full_matrix setzt alle Werte der Eingangsmatrix Matrix, die durch das Matrix Handle MatrixID gegeben ist. Der Parameter Values ist hierbei ein Tupel von Gleitpunkt- bzw. ganzen Zahlen, welches die Werte enthält, die den Elementen der Matrix Matrix zugewiesen werden. Ganzen Zahlen werden automatisch in Gleitpunktzahlen konvertiert. In dem Parameter Values müssen alle Werte zeilenweise vorliegen, d.h. Zeile für Zeile gespeichert sein. Außerdem muss die Anzahl der in Values übergebenen Werte 1 oder mit der Anzahl aller Elemente der Matrix identisch sein.
Bemerkung: Mit dem Operator create_matrix kann das gleiche Ergebnis erzielt werden. Der Vorteil bei der Nutzung des Operators set_full_matrix liegt darin, dass eine nicht länger benötigte Matrix wiederverwendet werden kann. Dadurch verkürzt sich die Laufzeit der Operation.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Der Wert dieses Parameters darf nicht über mehrere Threads verwendet werden.Matrix Handle der Eingabematrix.
Zu setzende Werte der Matrixelemente.
Sind die Parameterwerte korrekt, dann liefert set_full_matrix den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Foundation
| Operatoren |