Node2D

继承： CanvasItem < Node < Object

派生： AnimatedSprite2D, AudioListener2D, AudioStreamPlayer2D, BackBufferCopy, Bone2D, Camera2D, CanvasGroup, CanvasModulate, CollisionObject2D, CollisionPolygon2D, CollisionShape2D, CPUParticles2D, GPUParticles2D, Joint2D, Light2D, LightOccluder2D, Line2D, Marker2D, MeshInstance2D, MultiMeshInstance2D, NavigationLink2D, NavigationObstacle2D, NavigationRegion2D, Parallax2D, ParallaxLayer, Path2D, PathFollow2D, Polygon2D, RayCast2D, RemoteTransform2D, ShapeCast2D, Skeleton2D, Sprite2D, TileMap, TileMapLayer, TouchScreenButton, VisibleOnScreenNotifier2D

2D 游戏对象，被所有 2D 相关的节点继承。具有位置、旋转、缩放和 Z 索引。

描述

2D 游戏对象，具有变换（位置、旋转、缩放）。所有的 2D 节点，包括物理对象和精灵，都继承自 Node2D。使用 Node2D 作为父节点来移动、缩放和旋转 2D 项目中的子节点。还可以控制节点的渲染顺序。

教程

• 2D 中的自定义绘图

• 所有 2D 演示

属性

方法

属性说明

Vector2 global_position 🔗

• void set_global_position(value: Vector2)

• Vector2 get_global_position()

全局位置。

float global_rotation 🔗

• void set_global_rotation(value: float)

• float get_global_rotation()

全局旋转，单位为弧度。

float global_rotation_degrees 🔗

• void set_global_rotation_degrees(value: float)

• float get_global_rotation_degrees()

辅助属性，用于按度数访问 global_rotation 而不是弧度数。

Vector2 global_scale 🔗

• void set_global_scale(value: Vector2)

• Vector2 get_global_scale()

全局缩放。

float global_skew 🔗

• void set_global_skew(value: float)

• float get_global_skew()

全局偏斜，单位为弧度。

Transform2D global_transform 🔗

• void set_global_transform(value: Transform2D)

• Transform2D get_global_transform()

全局 Transform2D。

Vector2 position = Vector2(0, 0) 🔗

• void set_position(value: Vector2)

• Vector2 get_position()

位置，相对于父节点。

float rotation = 0.0 🔗

• void set_rotation(value: float)

• float get_rotation()

旋转，单位为弧度，相对于该节点的父节点。

注意：这个属性在检查器中是以度数编辑的。如果你想在脚本中使用度数，请使用 rotation_degrees。

float rotation_degrees 🔗

• void set_rotation_degrees(value: float)

• float get_rotation_degrees()

辅助属性，用于按度数访问 rotation 而不是弧度数。

Vector2 scale = Vector2(1, 1) 🔗

• void set_scale(value: Vector2)

• Vector2 get_scale()

该节点的缩放。未缩放值：(1, 1)。

注意：2D 中，变换矩阵是无法分解出负数的 X 缩放的。由于 Godot 中使用变换矩阵来表示缩放，X 轴上的负数缩放在分解后会变为 Y 轴的负数缩放和一次 180 度的旋转。

float skew = 0.0 🔗

• void set_skew(value: float)

• float get_skew()

使该节点发生倾斜。

注意：偏斜仅适用于 X 轴。

Transform2D transform 🔗

• void set_transform(value: Transform2D)

• Transform2D get_transform()

局部 Transform2D。

方法说明

void apply_scale(ratio: Vector2) 🔗

将当前缩放乘以比例向量 ratio。

float get_angle_to(point: Vector2) const 🔗

返回该节点和 point 之间的夹角，单位为弧度。

返回夹角的示意图。

Transform2D get_relative_transform_to_parent(parent: Node) const 🔗

返回相对于此节点的父节点的 Transform2D。

void global_translate(offset: Vector2) 🔗

将偏移向量 offset 添加到该节点的全局位置。

void look_at(point: Vector2) 🔗

旋转该节点，使其局部 X 轴的正方向指向 point，该参数应使用全局坐标。

point 不应该与该节点的位置相同，否则该节点始终看向右侧。

void move_local_x(delta: float, scaled: bool = false) 🔗

基于 Node._process 的 delta，在节点的 X 轴上应用局部平移。如果 scaled 为 false，则对移动进行归一化。

void move_local_y(delta: float, scaled: bool = false) 🔗

基于 Node._process 的 delta，在节点的 Y 轴上应用局部平移。如果 scaled 为 false，则对移动进行归一化。

void rotate(radians: float) 🔗

从节点的当前旋转开始，以弧度为单位，对节点进行旋转。

Vector2 to_global(local_point: Vector2) const 🔗

将提供的本地位置转换为全局坐标空间的位置。例如，对子节点的位置应用这个方法将正确地把它们的位置转换到全局坐标空间，但对节点自己的位置应用这个方法将得到一个不正确的结果，因为它将把节点自己的变换纳入它的全局位置。

Vector2 to_local(global_point: Vector2) const 🔗

将提供的全局位置转换为本地坐标空间的位置。例如，它适合于确定子节点的位置，但不适合于确定其自身相对于父节点的位置。

void translate(offset: Vector2) 🔗

在局部坐标系中，将该节点按给定的偏移量 offset 进行平移。