scale_matrix_modT_scale_matrix_modScaleMatrixModScaleMatrixModscale_matrix_mod (Operator)

Name

scale_matrix_modT_scale_matrix_modScaleMatrixModScaleMatrixModscale_matrix_mod — Skaliert eine Matrix.

Signatur

scale_matrix_mod( : : MatrixID, Factor : )

Beschreibung

Der Operator scale_matrix_modscale_matrix_modScaleMatrixModScaleMatrixModScaleMatrixModscale_matrix_mod skaliert die Matrix Matrix mit einem konstanten Wert. Die Matrix ist durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id gegeben. Die Eingabematrix wird mit dem Ergebnis überschrieben. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix möglich. Die Formel für die Berechnung lautet:

Beispiel:

FactorFactorFactorFactorfactorfactor = 1.5

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id

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.

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control, Zustand wird modifiziert) matrix → (handle)

Matrix Handle der Eingabematrix.

FactorFactorFactorFactorfactorfactor (input_control) number → (real / integer)

Skalierungsfaktor.

Defaultwert: 2.0

Wertevorschläge: 0.1, 0.2, 0.3, 0.5, 0.7, 1.0, 1.5, 2.0, 3.0, 5.0, 10.0

Ergebnis

Sind die Parameterwerte korrekt, dann liefert scale_matrix_modscale_matrix_modScaleMatrixModScaleMatrixModScaleMatrixModscale_matrix_mod den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrixcreate_matrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix, get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixGetValueMatrixget_value_matrix

Alternativen

scale_matrixscale_matrixScaleMatrixScaleMatrixScaleMatrixscale_matrix

Siehe auch

mult_element_matrixmult_element_matrixMultElementMatrixMultElementMatrixMultElementMatrixmult_element_matrix, mult_element_matrix_modmult_element_matrix_modMultElementMatrixModMultElementMatrixModMultElementMatrixModmult_element_matrix_mod, div_element_matrixdiv_element_matrixDivElementMatrixDivElementMatrixDivElementMatrixdiv_element_matrix, div_element_matrix_moddiv_element_matrix_modDivElementMatrixModDivElementMatrixModDivElementMatrixModdiv_element_matrix_mod

Modul

Foundation

Operatoren