Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
Basis¶
Tipo de datos de matriz 3×3.
Descripción¶
Matriz de 3×3 usada para la rotación y la escala 3D. Casi siempre se usa como base ortogonal para una Transformación.
Contiene 3 campos vectoriales X, Y y Z como sus columnas, que son típicamente interpretados como los vectores base locales de una transformación. Para tal uso, se compone de una matriz de escalamiento y rotación, en ese orden (M = R.S).
También se puede acceder a ella como matriz de vectores tridimensionales. Estos vectores son normalmente ortogonales entre sí, pero no están necesariamente normalizados (debido a la escala).
Para más información, lea el artículo de documentación "Matrices y transformaciones".
Tutoriales¶
Propiedades¶
|
||
|
||
|
Métodos¶
determinant ( ) |
|
get_euler ( ) |
|
get_scale ( ) |
|
inverse ( ) |
|
is_equal_approx ( Basis b, float epsilon=1e-05 ) |
|
orthonormalized ( ) |
|
transposed ( ) |
|
Constantes¶
IDENTITY = Basis( 1, 0, 0, 0, 1, 0, 0, 0, 1 ) --- La base de la identidad, sin rotación ni escalonamiento aplicado.
Esto es idéntico a llamar a Basis()
sin ningún parámetro. Esta constante puede ser usada para hacer su código más claro, y para la consistencia con C#.
FLIP_X = Basis( -1, 0, 0, 0, 1, 0, 0, 0, 1 ) --- La base que volteará algo a lo largo del eje X cuando se use en una transformación.
FLIP_Y = Basis( 1, 0, 0, 0, -1, 0, 0, 0, 1 ) --- La base que volteará algo a lo largo del eje Y cuando se use en una transformación.
FLIP_Z = Basis( 1, 0, 0, 0, 1, 0, 0, 0, -1 ) --- La base que volteará algo a lo largo del eje Z cuando se use en una transformación.
Descripciones de Propiedades¶
Vector3 x
Default |
|
El vector X de la matriz base (columna 0). Equivalente al índice de la matriz 0
.
Vector3 y
Default |
|
El vector Y de la matriz base (columna 1). Equivalente al índice de la matriz 1
.
Vector3 z
Default |
|
El vector Z de la matriz base (columna 2). Equivalente al índice de la matriz 2
.
Descripciones de Métodos¶
Construye una matriz de base de rotación pura a partir del cuaternario dado.
Construye una matriz de base de rotación pura a partir de los ángulos de Euler dados (en la convención YXZ: al *componer*, primero Y, luego X y Z en último lugar), dados en el formato vectorial como (ángulo X, ángulo Y, ángulo Z).
Considere el uso del constructor Quat en su lugar, que utiliza un cuaternio en lugar de los ángulos de Euler.
Construye una matriz de base de rotación pura, rotada alrededor del axis
dado por el phi
, en radianes. El eje debe ser un vector normalizado.
Construye una matriz base a partir de vectores de 3 ejes (columnas de la matriz).
float determinant ( )
Devuelve el determinante de la matriz base. Si la base está uniformemente escalada, su determinante es el cuadrado de la escala.
Un determinante negativo significa que la base tiene una escala negativa. Un determinante cero significa que la base no es invertible, y normalmente se considera inválida.
Vector3 get_euler ( )
Devuelve la rotación de la base en forma de ángulos de Euler (en la convención YXZ: al descomponerse, primero Z, luego X, y por último Y). El vector devuelto contiene los ángulos de rotación en el formato (ángulo X, ángulo Y, ángulo Z).
Considera usar el método get_rotation_quat en su lugar, que devuelve una cuaternión Quat en lugar de ángulos Euler.
int get_orthogonal_index ( )
Esta función considera una discretización de las rotaciones en 24 puntos de la unidad de la esfera, situados a lo largo de los vectores (x,y,z), siendo cada componente -1, 0, o 1, y devuelve el índice del punto que mejor representa la orientación del objeto. Es utilizado principalmente por el editor GridMap. Para más detalles, consulte el código fuente de Godot.
Quat get_rotation_quat ( )
Devuelve la rotación de la base en forma de cuaternario. Véase get_euler si necesita ángulos de Euler, pero tenga en cuenta que las cuaterniones generalmente deben ser preferidas a los ángulos de Euler.
Vector3 get_scale ( )
Asumiendo que la matriz es la combinación de una rotación y un escalado, devuelve el valor absoluto de los factores de escala a lo largo de cada eje.
Basis inverse ( )
Devuelve el inverso de la matriz.
Returns true
if this basis and b
are approximately equal, by calling is_equal_approx
on each component.
Note: For complicated reasons, the epsilon argument is always discarded. Don't use the epsilon argument, it does nothing.
Basis orthonormalized ( )
Devuelve la versión ortonormalizada de la matriz (útil para llamar de vez en cuando para evitar el error de redondeo de las matrices ortogonales). Realiza una ortonormalización de Gram-Schmidt sobre la base de la matriz.
Introducir una rotación adicional alrededor del eje dado por phi (radianes). El eje debe ser un vector normalizado.
Introducir una escalado adicional especificada por el factor de escala 3D dado.
Asumiendo que la matriz es una matriz de rotación adecuada, slerp realiza una interpolación esférica-lineal con otra matriz de rotación.
Producto vectorial transpuesto con el eje X de la matriz.
Producto vectorial transpuesto con el eje Y de la matriz.
Producto vectorial transpuesto con el eje Z de la matriz.
Basis transposed ( )
Devuelve la versión transpuesta de la matriz.
Devuelve un vector transformado (multiplicado) por la matriz.
Devuelve un vector transformado (multiplicado) por la matriz base transpuesta.
Nota: Esto da como resultado una multiplicación por el inverso de la matriz sólo si representa una rotación-reflexión.