Node2D¶
继承¶
CanvasItem
简要描述¶
由所有2D相关节点继承的2D游戏对象。
描述¶
具有变换(位置,旋转和比例)的2D游戏对象。所有2D节点,包括物理对象和精灵,都继承自Node2D。使用Node2D作为父节点来移动、缩放和旋转2D项目中的子节点。还可以控制节点的渲染顺序。
成员¶
| 类型 | 属性名 | 默认值 |
|---|---|---|
| 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 |
方法¶
| 返回值类型 | 方法名称 |
|---|---|
| void | apply_scale(ratio: Vector2) |
| float | get_angle_to(point: Vector2) const |
| Transform2D | get_relative_transform_to_parent(parent: Node) const |
| void | global_translate(offset: Vector2) |
| void | look_at(point: Vector2) |
| void | move_local_x(delta: float, scaled: bool = false) |
| void | move_local_y(delta: float, scaled: bool = false) |
| void | rotate(radians: float) |
| Vector2 | to_global(local_point: Vector2) const |
| Vector2 | to_local(global_point: Vector2) const |
| void | translate(offset: Vector2) |
常量¶
成员说明¶
- Vector2 global_position
| setter | set_global_position(value) |
|---|---|
| getter | get_global_position |
- float global_rotation
| setter | set_global_rotation(value) |
|---|---|
| getter | get_global_rotation |
- float global_rotation_degrees
| setter | set_global_rotation_degrees(value) |
|---|---|
| getter | get_global_rotation_degrees |
- Vector2 global_scale
| setter | set_global_scale(value) |
|---|---|
| getter | get_global_scale |
- Transform2D global_transform
| setter | set_global_transform(value) |
|---|---|
| getter | get_global_transform |
- Vector2 position
| Default | Vector2( 0, 0 ) |
|---|---|
| setter | set_position(value) |
| getter | get_position |
- float rotation
| Default | 0.0 |
|---|---|
| setter | set_rotation(value) |
| getter | get_rotation |
- float rotation_degrees
| Default | 0.0 |
|---|---|
| setter | set_rotation_degrees(value) |
| getter | get_rotation_degrees |
- Vector2 scale
| Default | Vector2( 1, 1 ) |
|---|---|
| setter | set_scale(value) |
| getter | get_scale |
- Transform2D transform
| setter | set_transform(value) |
|---|---|
| getter | get_transform |
- bool z_as_relative
| Default | true |
|---|---|
| setter | set_z_as_relative(value) |
| getter | is_z_relative |
- int z_index
| Default | 0 |
|---|---|
| setter | set_z_index(value) |
| getter | get_z_index |
方法说明¶
- apply_scale apply_scale(ratio: Vector2)
将当前比例乘以ratio向量。
- get_angle_to get_angle_to(point: Vector2) const
以弧度返回节点和point之间的角度。
- get_relative_transform_to_parent get_relative_transform_to_parent(parent: Node) const
返回相对于此节点的父级的Transform2D。
- global_translate global_translate(offset: Vector2)
将offset向量添加到节点的全局位置。
- look_at look_at(point: Vector2)
旋转节点,使其指向要使用全局坐标的point。
- move_local_x move_local_x(delta: float, scaled: bool = false)
基于Node._process的delta在节点的X轴上应用局部平移。如果scaled是false,将移动正常化。
- move_local_y move_local_y(delta: float, scaled: bool = false)
根据Node._process的delta在节点的Y轴上应用局部平移。如果scaled是false,将移动正常化。
- rotate rotate(radians: float)
从节点当前的旋转开始,以弧度为单位向节点施加旋转。
- to_global to_global(local_point: Vector2) const
将局部点的坐标转换为全局坐标。
- to_local to_local(global_point: Vector2) const
将全局点的坐标转换为局部坐标。
- translate translate(offset: Vector2)
按照给定的offset在本地坐标中转换节点。