Matrice
Faits rapides
| Propriété | Valeur |
|---|---|
| Classe | CENPyOlpMatrix |
| Module | cenpylib.CENPyOlpMatrix |
| Paquet | cenpylib |
| Libération | R2025.2.4 |
| Méthodes | 17 |
Départ rapide
# Boilerplate Example
matrix = ... # obtained from the runtime context
result = matrix.GetPosition()Index de la méthode
| Méthode | Retours | Résumé |
|---|---|---|
Translate | — | Traduis la matrice. |
RotateX | — | Faites tourner la matrice autour de l’axe x. |
RotateY | — | Faites pivoter la matrice autour de l’axe y. |
RotateZ | — | Faites pivoter la matrice autour de l’axe z. |
Rotate | — | Faites tourner la matrice autour d’un axe donné. |
GetPosition | CENPyOlpPoint | Obtenez la position de la matrice comme point. |
GetXDirection | CENPyOlpVector | Prends la direction matrice x comme vecteur. |
GetYDirection | CENPyOlpVector | Prenez la direction de la matrice y comme vecteur. |
GetZDirection | CENPyOlpVector | Prenez la direction de la matrice z comme vecteur. |
Transform | CENPyOlpPoint | Transformez un point dans cette matrice. |
GetRotation | tuple | Obtenez les angles de rotation de cette matrice. |
Inverse | CENPyOlpMatrix | Inversez la matrice. |
Multiply | CENPyOlpMatrix | Multipliez deux matrices. |
SetRotation | — | Définit la partie rotationnelle de la matrice telle que déterminée par les deux vecteurs d’entrée. |
SetRotation | — | Définit la partie rotative de la matrice telle que déterminée par trois vecteurs d’entrée. |
GetDistance | float | Obtient la distance entre la matrice de courant et la matrice donnée. |
IsValid | bool | Vérifie si la matrice est valide. |
Méthodes de requête
GetPosition
def GetPosition() -> CENPyOlpPointObtenez la position de la matrice comme point.
Retour : CENPyOlpPoint — position en point
GetXDirection
def GetXDirection() -> CENPyOlpVectorPrends la direction matrice x comme vecteur.
Retourne : CENPyOlpVector — direction comme vecteur
GetYDirection
def GetYDirection() -> CENPyOlpVectorPrenez la direction de la matrice y comme vecteur.
Retourne : CENPyOlpVector — direction comme vecteur
GetZDirection
def GetZDirection() -> CENPyOlpVectorPrenez la direction de la matrice z comme vecteur.
Retourne : CENPyOlpVector — direction comme vecteur
GetRotation
def GetRotation(inDegrees: bool=False) -> tupleObtenez les angles de rotation de cette matrice.
Paramètres :
| Nom | Type | Description |
|---|---|---|
inDegrees | bool | drapeau spécifiant l’unité : Vrai = degré, Faux = radians (par défaut : False) |
Retour : tuple — sortie de l’angle x, sortie de l’angle y, sortie de l’angle z
GetDistance
def GetDistance(otherMatrix: CENPyOlpMatrix) -> floatObtient la distance entre la matrice de courant et la matrice donnée.
Paramètres :
| Nom | Type | Description |
|---|---|---|
otherMatrix | CENPyOlpMatrix | Une autre matrice. |
Retour : float — La distance.
IsValid
def IsValid() -> boolVérifie si la matrice est valide.
Retourne : bool — Vrai si la matrice n’est pas Aucun, sinon Faux.
Méthodes de mutation
SetRotation
def SetRotation(firstAxis: CENPyOlpVector, secondAxis: CENPyOlpVector, axesPair: int)Définit la partie rotationnelle de la matrice telle que déterminée par les deux vecteurs d’entrée. Les vecteurs d’entrée sont supposés orthogonaux et normalisés.
Paramètres :
| Nom | Type | Description |
|---|---|---|
firstAxis | CENPyOlpVector | Premier axe |
secondAxis | CENPyOlpVector | deuxième axe |
axesPair | int | paire d’axe de rotation |
SetRotation
def SetRotation(xAxis: CENPyOlpVector, yAxis: CENPyOlpVector, zAxis: CENPyOlpVector)Définit la partie rotative de la matrice telle que déterminée par trois vecteurs d’entrée. Les vecteurs d’entrée sont supposés être normalisés orthogonalement.
Paramètres :
| Nom | Type | Description |
|---|---|---|
xAxis | CENPyOlpVector | le vecteur pour l’axe X. |
yAxis | CENPyOlpVector | le vecteur pour l’axe Y. |
zAxis | CENPyOlpVector | le vecteur pour l’axe Z. |
Exécution et Actions
Transform
def Transform(pyPointToTransform: CENPyOlpPoint) -> CENPyOlpPointTransformez un point dans cette matrice.
Paramètres :
| Nom | Type | Description |
|---|---|---|
pyPointToTransform | CENPyOlpPoint | point à transformer |
Retours : CENPyOlpPoint — le point transformé
Utilités
Translate
def Translate(x: float, y: float, z: float, withinLocalSystem: bool=True)Traduis la matrice.
Paramètres :
| Nom | Type | Description |
|---|---|---|
x | float | la valeur x |
y | float | la valeur y |
z | float | la valeur z |
withinLocalSystem | bool | le système local (par défaut = Vrai), Faux pour global (par défaut : True) |
RotateX
def RotateX(angle: float)Faites tourner la matrice autour de l’axe x.
Paramètres :
| Nom | Type | Description |
|---|---|---|
angle | float | angle de rotation |
RotateY
def RotateY(angle: float)Faites pivoter la matrice autour de l’axe y.
Paramètres :
| Nom | Type | Description |
|---|---|---|
angle | float | angle de rotation |
RotateZ
def RotateZ(angle: float)Faites pivoter la matrice autour de l’axe z.
Paramètres :
| Nom | Type | Description |
|---|---|---|
angle | float | angle de rotation |
Rotate
def Rotate(angle: float, axis: CENPyOlpVector)Faites tourner la matrice autour d’un axe donné.
Paramètres :
| Nom | Type | Description |
|---|---|---|
angle | float | angle de rotation |
axis | CENPyOlpVector | Axe de rotation |
Inverse
def Inverse() -> CENPyOlpMatrixInversez la matrice.
Retours : CENPyOlpMatrix — la matrice inversée
Multiply
def Multiply(pyLeftMatrix: CENPyOlpMatrix, pyRightMatrix: CENPyOlpMatrix) -> CENPyOlpMatrixMultipliez deux matrices.
Paramètres :
| Nom | Type | Description |
|---|---|---|
pyLeftMatrix | CENPyOlpMatrix | entrée de la matrice gauche |
pyRightMatrix | CENPyOlpMatrix | entrée de la matrice droite |
Retours : CENPyOlpMatrix — matrice des résultats
Types apparentés
Notes de la version
Cette classe est documentée à la version R2025.2.4.