Skip to Content

Matrix

Kurzübersicht

EigenschaftWert
KlasseCENPyOlpMatrix
Modulcenpylib.CENPyOlpMatrix
Paketcenpylib
VeröffentlichungR2025.2.4
Methoden17

Schnellstart

# Boilerplate Example matrix = ... # obtained from the runtime context result = matrix.GetPosition()

Methodenindex

MethodeGibt zurückZusammenfassung
Translate—Verschieben Sie die Matrix.
RotateX—Drehen Sie die Matrix um die x-Achse.
RotateY—Drehen Sie die Matrix um die y-Achse.
RotateZ—Drehen Sie die Matrix um die z-Achse.
Rotate—Drehen Sie die Matrix um die angegebene Achse.
GetPositionCENPyOlpPointPosition der Matrix als Punkt ermitteln.
GetXDirectionCENPyOlpVectorRichtet die Matrix in x-Richtung als Vektor aus.
GetYDirectionCENPyOlpVectorErmitteln Sie die y-Richtung der Matrix als Vektor.
GetZDirectionCENPyOlpVectorErmitteln Sie die z-Richtung der Matrix als Vektor.
TransformCENPyOlpPointTransformieren Sie einen Punkt innerhalb dieser Matrix.
GetRotationtupleErmitteln Sie die Rotationswinkel dieser Matrix.
InverseCENPyOlpMatrixInvertieren Sie die Matrix.
MultiplyCENPyOlpMatrixMultipliziert zwei Matrizen.
SetRotation—Legt den Rotationsanteil der Matrix fest, wie durch die beiden Eingabevektoren bestimmt.
SetRotation—Setzt den Rotationsanteil der Matrix, wie durch drei Eingabevektoren bestimmt.
GetDistancefloatErmittelt den Abstand zwischen der aktuellen Matrix und der angegebenen Matrix.
IsValidboolÜberprüft, ob die Matrix gültig ist.

Abfragemethoden

GetPosition

def GetPosition() -> CENPyOlpPoint

Position der Matrix als Punkt abrufen.

Gibt zurück: CENPyOlpPoint — Position als Punkt

GetXDirection

def GetXDirection() -> CENPyOlpVector

Ermittelt die x-Richtung der Matrix als Vektor.

Gibt zurück: CENPyOlpVector — Richtung als Vektor

GetYDirection

def GetYDirection() -> CENPyOlpVector

Ermittelt die y-Richtung der Matrix als Vektor.

Gibt zurück: CENPyOlpVector — Richtung als Vektor

GetZDirection

def GetZDirection() -> CENPyOlpVector

Ermittelt die Z-Richtung der Matrix als Vektor.

Gibt zurück: CENPyOlpVector — Richtung als Vektor

GetRotation

def GetRotation(inDegrees: bool=False) -> tuple

Ermitteln Sie die Rotationswinkel dieser Matrix.

Parameter:

NameTypBeschreibung
inDegreesboolFlag, die die Einheit angibt: True = Grad, False = Radiant (Standard: False)

Gibt zurück: tuple — Ausgabe des x-Winkels, Ausgabe des y-Winkels, Ausgabe des z-Winkels

GetDistance

def GetDistance(otherMatrix: CENPyOlpMatrix) -> float

Ermittelt den Abstand zwischen der aktuellen Matrix und der angegebenen Matrix.

Parameter:

NameTypBeschreibung
otherMatrixCENPyOlpMatrixEine weitere Matrix.

Gibt zurück: float — Die Entfernung.

IsValid

def IsValid() -> bool

Überprüft, ob die Matrix gültig ist.

Gibt zurück: bool — Wahr, wenn die Matrix nicht None ist, andernfalls Falsch.

Mutationsmethoden

SetRotation

def SetRotation(firstAxis: CENPyOlpVector, secondAxis: CENPyOlpVector, axesPair: int)

Setzt den Rotationsanteil der Matrix, wie durch die beiden Eingangsvektoren bestimmt. ///Die Eingangsvektoren werden als orthogonal und normiert angenommen.

Parameter:

NameTypBeschreibung
firstAxisCENPyOlpVectorerste Achse
secondAxisCENPyOlpVectorzweite Achse
axesPairintPaar von Rotationsachsen

SetRotation

def SetRotation(xAxis: CENPyOlpVector, yAxis: CENPyOlpVector, zAxis: CENPyOlpVector)

Setzt den Rotationsanteil der Matrix, bestimmt durch drei Eingabevektoren. Die Eingangsvektoren werden als orthogonal normiert angenommen.

Parameter:

NameTypBeschreibung
xAxisCENPyOlpVectorder Vektor für die X-Achse.
yAxisCENPyOlpVectorder Vektor für die Y-Achse.
zAxisCENPyOlpVectorder Vektor für die Z-Achse.

Ausführung & Aktionen

Transform

def Transform(pyPointToTransform: CENPyOlpPoint) -> CENPyOlpPoint

Transformieren Sie einen Punkt innerhalb dieser Matrix.

Parameter:

NameTypBeschreibung
pyPointToTransformCENPyOlpPointzu transformierender Punkt

Gibt zurück: CENPyOlpPoint — den transformierten Punkt

Dienstprogramme

Translate

def Translate(x: float, y: float, z: float, withinLocalSystem: bool=True)

Übersetzen Sie die Matrix.

Parameter:

NameTypBeschreibung
xfloatder x-Wert
yfloatder y-Wert
zfloatder z-Wert
withinLocalSystemboolder Bezug auf das lokale System (Standard = True), False für global (Standard: True)

RotateX

def RotateX(angle: float)

Drehen Sie die Matrix um die x-Achse.

Parameter:

NameTypBeschreibung
anglefloatRotationswinkel

RotateY

def RotateY(angle: float)

Drehen Sie die Matrix um die y-Achse.

Parameter:

NameTypBeschreibung
anglefloatRotationswinkel

RotateZ

def RotateZ(angle: float)

Drehen Sie die Matrix um die z-Achse.

Parameter:

NameTypBeschreibung
anglefloatRotationswinkel

Rotate

def Rotate(angle: float, axis: CENPyOlpVector)

Drehen Sie die Matrix um die angegebene Achse.

Parameter:

NameTypBeschreibung
anglefloatRotationswinkel
axisCENPyOlpVectorRotationsachse

Inverse

def Inverse() -> CENPyOlpMatrix

Invertieren Sie die Matrix.

Gibt zurück: CENPyOlpMatrix — die invertierte Matrix

Multiply

def Multiply(pyLeftMatrix: CENPyOlpMatrix, pyRightMatrix: CENPyOlpMatrix) -> CENPyOlpMatrix

Multiplizieren Sie zwei Matrizen.

Parameter:

NameTypBeschreibung
pyLeftMatrixCENPyOlpMatrixEingabe der linken Matrix
pyRightMatrixCENPyOlpMatrixEingabe der rechten Matrix

Gibt zurück: CENPyOlpMatrix — Ergebnismatrix

Verwandte Typen

Versionshinweise

Diese Klasse ist ab Version R2026.1.1 dokumentiert.

Was this page helpful?