Matrix
Schnelle Fakten
| Immobilien | Wert |
|---|---|
| Klasse | CENPyOlpMatrix |
| Modul | cenpylib.CENPyOlpMatrix |
| Paket | cenpylib |
| Veröffentlichung | R2025.2.4 |
| Methoden | 17 |
Schneller Start
# Boilerplate Example
matrix = ... # obtained from the runtime context
result = matrix.GetPosition()Methodenindex
| Methode | Rückgaben | Zusammenfassung |
|---|---|---|
Translate | — | Übersetze 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 gegebene Achse. |
GetPosition | CENPyOlpPoint | Erhalten Sie die Position der Matrix als Punkt. |
GetXDirection | CENPyOlpVector | Erhalte die Matrix x-Richtung als Vektor. |
GetYDirection | CENPyOlpVector | Erhalten Sie die Richtung y der Matrix als Vektor. |
GetZDirection | CENPyOlpVector | Erhalten Sie die Richtung der Matrix z als Vektor. |
Transform | CENPyOlpPoint | Transformiere einen Punkt innerhalb dieser Matrix. |
GetRotation | tuple | Erhalten Sie die Rotationswinkel dieser Matrix. |
Inverse | CENPyOlpMatrix | Invertiere die Matrix. |
Multiply | CENPyOlpMatrix | Multipliziere zwei Matrizen. |
SetRotation | — | Setzt den rotierenden Teil der Matrix wie bestimmt durch die beiden Eingabevektoren. |
SetRotation | — | Setzt den rotierenden Teil der Matrix, wie er durch drei Eingangsvektoren bestimmt wird. |
GetDistance | float | Erhält den Abstand zwischen der Strommatrix und der gegebenen Matrix. |
IsValid | bool | Prüft, ob die Matrix gültig ist. |
Abfragemethoden
GetPosition
def GetPosition() -> CENPyOlpPointErhalten Sie die Position der Matrix als Punkt.
Returns: CENPyOlpPoint — Position als Punkt
GetXDirection
def GetXDirection() -> CENPyOlpVectorErhalte die Matrix x-Richtung als Vektor.
Returns: CENPyOlpVector — Richtung als Vektor
GetYDirection
def GetYDirection() -> CENPyOlpVectorErhalten Sie die Richtung y der Matrix als Vektor.
Returns: CENPyOlpVector — Richtung als Vektor
GetZDirection
def GetZDirection() -> CENPyOlpVectorErhalten Sie die Richtung der Matrix z als Vektor.
Returns: CENPyOlpVector — Richtung als Vektor
GetRotation
def GetRotation(inDegrees: bool=False) -> tupleErhalten Sie die Rotationswinkel dieser Matrix.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
inDegrees | bool | Flagge, die die Einheit angibt: True = Grad, False = Radianten (Standard: False) |
Returns: tuple — Ausgabe von x Winkel, Ausgabe von y Winkel, Ausgabe von z Winkel
GetDistance
def GetDistance(otherMatrix: CENPyOlpMatrix) -> floatErhält den Abstand zwischen der Strommatrix und der gegebenen Matrix.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
otherMatrix | CENPyOlpMatrix | Noch eine Matrix. |
Rückkehrt: float — Die Distanz.
IsValid
def IsValid() -> boolPrüft, ob die Matrix gültig ist.
Gibt zurück: bool — Wahr, wenn die Matrix nicht Nichts ist, sonst Falsch.
Mutationsmethoden
SetRotation
def SetRotation(firstAxis: CENPyOlpVector, secondAxis: CENPyOlpVector, axesPair: int)Setzt den rotierenden Teil der Matrix wie bestimmt durch die beiden Eingabevektoren. Die Eingangsvektoren werden als orthogonal und normalisiert angenommen.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
firstAxis | CENPyOlpVector | Erste Achse |
secondAxis | CENPyOlpVector | Zweite Achse |
axesPair | int | Paar der Rotationsachse |
SetRotation
def SetRotation(xAxis: CENPyOlpVector, yAxis: CENPyOlpVector, zAxis: CENPyOlpVector)Setzt den rotierenden Teil der Matrix, wie er durch drei Eingangsvektoren bestimmt wird. Die Eingangsvektoren werden als orthogonal normalisiert 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 & Handlungen
Transform
def Transform(pyPointToTransform: CENPyOlpPoint) -> CENPyOlpPointTransformiere einen Punkt innerhalb dieser Matrix.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
pyPointToTransform | CENPyOlpPoint | Punkt zum Transformieren |
Rückkehrt: CENPyOlpPoint — der transformierte Punkt
Versorgungsleitungen
Translate
def Translate(x: float, y: float, z: float, withinLocalSystem: bool=True)Übersetze die Matrix.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
x | float | Der x-Wert |
y | float | Der y-Wert |
z | float | Der Z-Wert |
withinLocalSystem | bool | die sich auf das lokale System bezieht (default = True), False für global (default: 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 gegebene Achse.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
angle | float | Rotationswinkel |
axis | CENPyOlpVector | Rotationsachse |
Inverse
def Inverse() -> CENPyOlpMatrixInvertiere die Matrix.
Returns: CENPyOlpMatrix — die invertierte Matrix
Multiply
def Multiply(pyLeftMatrix: CENPyOlpMatrix, pyRightMatrix: CENPyOlpMatrix) -> CENPyOlpMatrixMultipliziere zwei Matrizen.
Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
pyLeftMatrix | CENPyOlpMatrix | Eingabe der linken Matrix |
pyRightMatrix | CENPyOlpMatrix | Eingabe der rechten Matrix |
Returns: CENPyOlpMatrix — Ergebnismatrix
Verwandte Typen
Versionsnotizen
Diese Klasse ist zum Zeitpunkt der Veröffentlichung R2025.2.4 dokumentiert.