scale_matrixT_scale_matrixScaleMatrixScaleMatrix (Operator)

Name

scale_matrixT_scale_matrixScaleMatrixScaleMatrix — Skaliert eine Matrix.

Signatur

scale_matrix( : : MatrixID, Factor : MatrixScaledID)

Beschreibung

Der Operator scale_matrixscale_matrixScaleMatrixScaleMatrixScaleMatrix skaliert die Matrix MatrixMatrixMatrixMatrixmatrix mit einem konstanten Wert. Die Matrix ist durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixID gegeben. Es wird eine neue Matrix MatrixScaledMatrixScaledMatrixScaledMatrixScaledmatrixScaled mit dem Ergebnis generiert. Der Operator gibt das Matrix Handle MatrixScaledIDMatrixScaledIDMatrixScaledIDMatrixScaledIDmatrixScaledID zurück. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix möglich. Die Formel für die Berechnung lautet:

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.

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control) matrix → (handle)

Matrix Handle der Eingabematrix.

FactorFactorFactorFactorfactor (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

MatrixScaledIDMatrixScaledIDMatrixScaledIDMatrixScaledIDmatrixScaledID (output_control) matrix → (handle)

Matrix Handle mit den skalierten Elementen.

Ergebnis

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

Vorgänger

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix, get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixGetValueMatrix

Alternativen

scale_matrix_modscale_matrix_modScaleMatrixModScaleMatrixModScaleMatrixMod

Siehe auch

mult_element_matrixmult_element_matrixMultElementMatrixMultElementMatrixMultElementMatrix, mult_element_matrix_modmult_element_matrix_modMultElementMatrixModMultElementMatrixModMultElementMatrixMod, div_element_matrixdiv_element_matrixDivElementMatrixDivElementMatrixDivElementMatrix, div_element_matrix_moddiv_element_matrix_modDivElementMatrixModDivElementMatrixModDivElementMatrixMod

Modul

Foundation

Operatoren