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¶

Vector3	x	`Vector3( 1, 0, 0 )`
Vector3	y	`Vector3( 0, 1, 0 )`
Vector3	z	`Vector3( 0, 0, 1 )`

Métodos¶

Basis	Basis ( Quat from )
Basis	Basis ( Vector3 from )
Basis	Basis ( Vector3 axis, float phi )
Basis	Basis ( Vector3 x_axis, Vector3 y_axis, Vector3 z_axis )
float	determinant ( )
Vector3	get_euler ( )
int	get_orthogonal_index ( )
Quat	get_rotation_quat ( )
Vector3	get_scale ( )
Basis	inverse ( )
bool	is_equal_approx ( Basis b, float epsilon=1e-05 )
Basis	orthonormalized ( )
Basis	rotated ( Vector3 axis, float phi )
Basis	scaled ( Vector3 scale )
Basis	slerp ( Basis to, float weight )
float	tdotx ( Vector3 with )
float	tdoty ( Vector3 with )
float	tdotz ( Vector3 with )
Basis	transposed ( )
Vector3	xform ( Vector3 v )
Vector3	xform_inv ( Vector3 v )

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

Vector3( 1, 0, 0 )

El vector X de la matriz base (columna 0). Equivalente al índice de la matriz 0.

Vector3 y

Default

Vector3( 0, 1, 0 )

El vector Y de la matriz base (columna 1). Equivalente al índice de la matriz 1.

Vector3 z

Default

Vector3( 0, 0, 1 )

El vector Z de la matriz base (columna 2). Equivalente al índice de la matriz 2.

Descripciones de Métodos¶

Basis Basis ( Quat from )

Construye una matriz de base de rotación pura a partir del cuaternario dado.

Basis Basis ( Vector3 from )

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.

Basis Basis ( Vector3 axis, float phi )

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.

Basis Basis ( Vector3 x_axis, Vector3 y_axis, Vector3 z_axis )

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.

bool is_equal_approx ( Basis b, float epsilon=1e-05 )

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.

Basis rotated ( Vector3 axis, float phi )

Introducir una rotación adicional alrededor del eje dado por phi (radianes). El eje debe ser un vector normalizado.

Basis scaled ( Vector3 scale )

Introducir una escalado adicional especificada por el factor de escala 3D dado.

Basis slerp ( Basis to, float weight )

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.

float tdotx ( Vector3 with )

Producto vectorial transpuesto con el eje X de la matriz.

float tdoty ( Vector3 with )

Producto vectorial transpuesto con el eje Y de la matriz.

float tdotz ( Vector3 with )

Producto vectorial transpuesto con el eje Z de la matriz.

Basis transposed ( )

Devuelve la versión transpuesta de la matriz.

Vector3 xform ( Vector3 v )

Devuelve un vector transformado (multiplicado) por la matriz.

Vector3 xform_inv ( Vector3 v )

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.