Node2D¶

Inherits: CanvasItem < Node < Object

Inherited By: AnimatedSprite, AudioStreamPlayer2D, BackBufferCopy, Bone2D, CPUParticles2D, Camera2D, CanvasModulate, CollisionObject2D, CollisionPolygon2D, CollisionShape2D, Joint2D, Light2D, LightOccluder2D, Line2D, Listener2D, MeshInstance2D, MultiMeshInstance2D, Navigation2D, NavigationPolygonInstance, ParallaxLayer, Particles2D, Path2D, PathFollow2D, Polygon2D, Position2D, RayCast2D, RemoteTransform2D, Skeleton2D, Sprite, TileMap, TouchScreenButton, VisibilityNotifier2D, YSort

Un objeto de juego en 2D, heredado por todos los nodos relacionados con el 2D. Tiene una posición, rotación, escala e índice Z.

Descripción¶

Un objeto de juego 2D, con una transformada (posición, rotación y escala). Todos los nodos 2D, incluyendo los objetos de física y los sprites, heredan de Node2D. Utiliza Node2D como nodo padre para mover, escalar y rotar a los niños en un proyecto 2D. También da control del orden de renderización del nodo.

Tutoriales¶

Propiedades¶

Vector2	global_position
float	global_rotation
float	global_rotation_degrees
Vector2	global_scale
Transform2D	global_transform
Vector2	position	`Vector2( 0, 0 )`
float	rotation	`0.0`
float	rotation_degrees	`0.0`
Vector2	scale	`Vector2( 1, 1 )`
Transform2D	transform
bool	z_as_relative	`true`
int	z_index	`0`

Métodos¶

void	apply_scale ( Vector2 ratio )
float	get_angle_to ( Vector2 point ) const
Transform2D	get_relative_transform_to_parent ( Node parent ) const
void	global_translate ( Vector2 offset )
void	look_at ( Vector2 point )
void	move_local_x ( float delta, bool scaled=false )
void	move_local_y ( float delta, bool scaled=false )
void	rotate ( float radians )
Vector2	to_global ( Vector2 local_point ) const
Vector2	to_local ( Vector2 global_point ) const
void	translate ( Vector2 offset )

Descripciones de Propiedades¶

Vector2 global_position

Setter	set_global_position(value)
Getter	get_global_position()

Posición global.

float global_rotation

Setter	set_global_rotation(value)
Getter	get_global_rotation()

Rotación global en radianes.

float global_rotation_degrees

Setter	set_global_rotation_degrees(value)
Getter	get_global_rotation_degrees()

Rotación global en grados.

Vector2 global_scale

Setter	set_global_scale(value)
Getter	get_global_scale()

Escala global.

Transform2D global_transform

Setter	set_global_transform(value)
Getter	get_global_transform()

Transform2D Global.

Vector2 position

Default	`Vector2( 0, 0 )`
Setter	set_position(value)
Getter	get_position()

Posición, relativa al padre del nodo.

float rotation

Default	`0.0`
Setter	set_rotation(value)
Getter	get_rotation()

Rotación en radianes, en relación con el padre del nodo.

float rotation_degrees

Default	`0.0`
Setter	set_rotation_degrees(value)
Getter	get_rotation_degrees()

Rotación en grados, en relación con el padre del nodo.

Vector2 scale

Default	`Vector2( 1, 1 )`
Setter	set_scale(value)
Getter	get_scale()

La escala del nodo. Valor no escalado: (1, 1).

Transform2D transform

Setter	set_transform(value)
Getter	get_transform()

Transform2D Local .

bool z_as_relative

Default	`true`
Setter	set_z_as_relative(value)
Getter	is_z_relative()

Si true, el índice Z del nodo es relativo al índice Z de su padre. Si el índice Z de este nodo es 2 y el índice Z efectivo de su padre es 3, entonces el índice Z efectivo de este nodo será 2 + 3 = 5.

int z_index

Default	`0`
Setter	set_z_index(value)
Getter	get_z_index()

Z index. Controls the order in which the nodes render. A node with a higher Z index will display in front of others. Must be between VisualServer.CANVAS_ITEM_Z_MIN and VisualServer.CANVAS_ITEM_Z_MAX (inclusive).

Descripciones de Métodos¶

void apply_scale ( Vector2 ratio )

Multiplica la escala actual por el vector ratio.

float get_angle_to ( Vector2 point ) const

Returns the angle between the node and the point in radians.

Illustration of the returned angle.

Transform2D get_relative_transform_to_parent ( Node parent ) const

Devuelve el Transform2D relativo al padre de este nodo.

void global_translate ( Vector2 offset )

Añade el vector offset a la posición global del nodo.

void look_at ( Vector2 point )

Gira el nodo para que apunte hacia el punto, que se espera que utilice coordenadas globales.

void move_local_x ( float delta, bool scaled=false )

Aplica una traducción local en el eje X del nodo basada en la delta del Node._process. Si scaled es false, normaliza el movimiento.

void move_local_y ( float delta, bool scaled=false )

Aplica una traducción local en el eje Y del nodo basada en el Node._process's delta. Si scaled es false, normaliza el movimiento.

void rotate ( float radians )

Aplica una rotación al nodo, en radianes, a partir de su rotación actual.

Vector2 to_global ( Vector2 local_point ) const

Transforma la posición local proporcionada en una posición en el espacio de coordenadas globales. Se espera que la entrada sea local en relación con el Node2D al que se llama. Por ejemplo, aplicar este método a las posiciones de los nodos hijos transformará correctamente sus posiciones en el espacio de coordenadas globales, pero aplicarlo a la propia posición de un nodo dará un resultado incorrecto, ya que incorporará la propia transformación del nodo en su posición global.

Vector2 to_local ( Vector2 global_point ) const

Transforma la posición global proporcionada en una posición en el espacio de coordenadas locales. La salida será local en relación con el Node2D al que se llama. Por ejemplo, es apropiado para determinar las posiciones de los nodos hijos, pero no es apropiado para determinar su propia posición en relación con su padre.

void translate ( Vector2 offset )

Traduce el nodo por el offset dado en coordenadas locales.