Matrix
Kurzübersicht
| Eigenschaft | Wert |
|---|---|
| Klasse | CENPyOlpMatrix |
| Modul | cenpylib.CENPyOlpMatrix |
| Paket | cenpylib |
| Veröffentlichung | R2025.2.4 |
| Methoden | 17 |
Schnellstart
# Boilerplate Example
matrix = ... # obtained from the runtime context
result = matrix.GetPosition()Methodenindex
| Methode | Gibt zurück | Zusammenfassung |
|---|---|---|
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. |
GetPosition | CENPyOlpPoint | Position der Matrix als Punkt ermitteln. |
GetXDirection | CENPyOlpVector | Richtet die Matrix in x-Richtung als Vektor aus. |
GetYDirection | CENPyOlpVector | Ermitteln Sie die y-Richtung der Matrix als Vektor. |
GetZDirection | CENPyOlpVector | Ermitteln Sie die z-Richtung der Matrix als Vektor. |
Transform | CENPyOlpPoint | Transformieren Sie einen Punkt innerhalb dieser Matrix. |
GetRotation | tuple | Ermitteln Sie die Rotationswinkel dieser Matrix. |
Inverse | CENPyOlpMatrix | Invertieren Sie die Matrix. |
Multiply | CENPyOlpMatrix | Multipliziert 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. |
GetDistance | float | Ermittelt den Abstand zwischen der aktuellen Matrix und der angegebenen Matrix. |
IsValid | bool | Überprüft, ob die Matrix gültig ist. |
Abfragemethoden
GetPosition
def GetPosition() -> CENPyOlpPointPosition der Matrix als Punkt abrufen.
Gibt zurück: CENPyOlpPoint — Position als Punkt
GetXDirection
def GetXDirection() -> CENPyOlpVectorErmittelt die x-Richtung der Matrix als Vektor.
Gibt zurück: CENPyOlpVector — Richtung als Vektor
GetYDirection
def GetYDirection() -> CENPyOlpVectorErmittelt die y-Richtung der Matrix als Vektor.
Gibt zurück: CENPyOlpVector — Richtung als Vektor
GetZDirection
def GetZDirection() -> CENPyOlpVectorErmittelt die Z-Richtung der Matrix als Vektor.
Gibt zurück: CENPyOlpVector — Richtung als Vektor
GetRotation
def GetRotation(inDegrees: bool=False) -> tupleErmitteln Sie die Rotationswinkel dieser Matrix.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
inDegrees | bool | Flag, 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) -> floatErmittelt den Abstand zwischen der aktuellen Matrix und der angegebenen Matrix.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
otherMatrix | CENPyOlpMatrix | Eine 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:
| Name | Typ | Beschreibung |
|---|---|---|
firstAxis | CENPyOlpVector | erste Achse |
secondAxis | CENPyOlpVector | zweite Achse |
axesPair | int | Paar 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:
| Name | Typ | Beschreibung |
|---|---|---|
xAxis | CENPyOlpVector | der Vektor für die X-Achse. |
yAxis | CENPyOlpVector | der Vektor für die Y-Achse. |
zAxis | CENPyOlpVector | der Vektor für die Z-Achse. |
Ausführung & Aktionen
Transform
def Transform(pyPointToTransform: CENPyOlpPoint) -> CENPyOlpPointTransformieren Sie einen Punkt innerhalb dieser Matrix.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
pyPointToTransform | CENPyOlpPoint | zu 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:
| Name | Typ | Beschreibung |
|---|---|---|
x | float | der x-Wert |
y | float | der y-Wert |
z | float | der z-Wert |
withinLocalSystem | bool | der 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:
| Name | Typ | Beschreibung |
|---|---|---|
angle | float | Rotationswinkel |
RotateY
def RotateY(angle: float)Drehen Sie die Matrix um die y-Achse.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
angle | float | Rotationswinkel |
RotateZ
def RotateZ(angle: float)Drehen Sie die Matrix um die z-Achse.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
angle | float | Rotationswinkel |
Rotate
def Rotate(angle: float, axis: CENPyOlpVector)Drehen Sie die Matrix um die angegebene Achse.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
angle | float | Rotationswinkel |
axis | CENPyOlpVector | Rotationsachse |
Inverse
def Inverse() -> CENPyOlpMatrixInvertieren Sie die Matrix.
Gibt zurück: CENPyOlpMatrix — die invertierte Matrix
Multiply
def Multiply(pyLeftMatrix: CENPyOlpMatrix, pyRightMatrix: CENPyOlpMatrix) -> CENPyOlpMatrixMultiplizieren Sie zwei Matrizen.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
pyLeftMatrix | CENPyOlpMatrix | Eingabe der linken Matrix |
pyRightMatrix | CENPyOlpMatrix | Eingabe der rechten Matrix |
Gibt zurück: CENPyOlpMatrix — Ergebnismatrix
Verwandte Typen
Versionshinweise
Diese Klasse ist ab Version R2026.1.1 dokumentiert.