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...

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-вузли, включаючи фізичні об’єкти та спрайти, успадковуються від Node2D. Використовуйте Node2D як батьківський вузол для переміщення, масштабування та повороту дочірніх елементів у 2D-проекті. Також дає змогу керувати порядком візуалізації вузла.

Примітка: Оскільки Node2D і Control успадковують CanvasItem, вони мають спільні концепції з класу, наприклад властивості CanvasItem.z_index і CanvasItem.visible.

Посібники

Властивості

Vector2	global_position
float	global_rotation
float	global_rotation_degrees
Vector2	global_scale
float	global_skew
Transform2D	global_transform
Vector2	position	`Vector2(0, 0)`
float	rotation	`0.0`
float	rotation_degrees
Vector2	scale	`Vector2(1, 1)`
float	skew	`0.0`
Transform2D	transform

Методи

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 🔗

void set_global_position(value: Vector2)
Vector2 get_global_position()

Глобальна позиція. Див. також position.

float global_rotation 🔗

void set_global_rotation(value: float)
float get_global_rotation()

Глобальне обертання в радіанах. Див. також rotation.

float global_rotation_degrees 🔗

void set_global_rotation_degrees(value: float)
float get_global_rotation_degrees()

Допоміжна властивість для доступу до global_rotation у градусах замість радіан. Дивіться також rotation_degrees.

Vector2 global_scale 🔗

void set_global_scale(value: Vector2)
Vector2 get_global_scale()

Глобальний масштаб. Див. також scale.

float global_skew 🔗

void set_global_skew(value: float)
float get_global_skew()

Глобальний перекіс у радіанах. Дивіться також skew.

Transform2D global_transform 🔗

void set_global_transform(value: Transform2D)
Transform2D get_global_transform()

Глобальне Transform2D. Див. також transform.

Vector2 position = Vector2(0, 0) 🔗

void set_position(value: Vector2)
Vector2 get_position()

Позиція відносно батьківського вузла. Див. також global_position.

float rotation = 0.0 🔗

void set_rotation(value: float)
float get_rotation()

Поворот у радіанах відносно батьківського вузла. Дивіться також global_rotation.

Примітка: Ця властивість редагується в інспекторі в градусах. Якщо ви хочете використовувати градуси в сценарії, використовуйте rotation_degrees.

float rotation_degrees 🔗

void set_rotation_degrees(value: float)
float get_rotation_degrees()

Допоміжна властивість для доступу до rotation у градусах замість радіанів. Див. також global_rotation_degrees.

Vector2 scale = Vector2(1, 1) 🔗

void set_scale(value: Vector2)
Vector2 get_scale()

Масштаб вузла відносно батьківського вузла. Немасштабоване значення: (1, 1). Дивіться також global_scale.

**Примітка: ** Негативні шкали X у 2D не можна розкласти з матриці трансформації. Завдяки способу представлення масштабу за допомогою матриць трансформації в Godot, негативні масштаби на осі X будуть змінені на негативні масштаби на осі Y і поворот на 180 градусів під час розкладання.

float skew = 0.0 🔗

void set_skew(value: float)
float get_skew()

Якщо встановлено ненульове значення, нахиляє вузол в тому чи іншому напрямку. Це можна використовувати для псевдо-3D-ефектів. Дивіться також global_skew.

**Примітка: ** Нахил виконується лише на осі X і між обертанням і масштабуванням.

Примітка: Ця властивість редагується в інспекторі в градусах. Якщо ви хочете використовувати градуси в скрипті, використовуйте skew = deg_to_rad(value_in_degrees).

Transform2D transform 🔗

void set_transform(value: Transform2D)
Transform2D get_transform()

Transform2D вузла відносно батьківського вузла. Дивіться також global_transform.

Описи методів

void apply_scale(ratio: Vector2) 🔗

Множить поточний масштаб на вектор ratio.

float get_angle_to(point: Vector2) const 🔗

Повертає кут між вузлом та point у радіанах. Див. також look_at().

Ілюстрація повернутого кута.

Transform2D get_relative_transform_to_parent(parent: Node) const 🔗

Повертаємо Transform2D відносно цього материнського вузла.

void global_translate(offset: Vector2) 🔗

Додає вектор offset до глобальної позиції вузла.

void look_at(point: Vector2) 🔗

Повертає вузол так, щоб його локальна вісь +X була спрямована в бік метод rotate, який, як очікується, використовуватиме глобальні координати. Цей метод є комбінацією методів rotate() та get_angle_to().

point() не повинен збігатися з позицією вузла, інакше вузол завжди дивиться праворуч.

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

Застосовує локальне зміщення по осі X вузла на величину, вказану в delta. Якщо scaled має значення false, нормалізує рух, щоб він відбувався незалежно від scale вузла.

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

Застосовує локальне зміщення по осі Y вузла на величину, вказану в delta. Якщо scaled має значення false, нормалізує рух, щоб він відбувався незалежно від scale вузла.

void rotate(radians: float) 🔗

Застосовує поворот до вузла в радіанах, починаючи з його поточного повороту. Це еквівалентно rotation += radians.

Vector2 to_global(local_point: Vector2) const 🔗

Забезпечує місцеву позицію у глобальному координаційному просторі. Введення очікувано буде локальним відносно Node2D. Наприклад: Застосувати цей метод на позиції дочірньих вузлів правильно перетворювати свої позиції в глобальну координацію простору, але застосувати його до власної позиції вершини дасть некоректний результат, оскільки він буде включати в себе власне перетворення вершини в її глобальну позицію.

Vector2 to_local(global_point: Vector2) const 🔗

Перетворює надану глобальну позицію у місцевому координаційному просторі. Вихід буде локальним відносно Node2D його називають. Наприклад: Для визначення позицій дочірніх вузлів, але не підходить для визначення власної позиції щодо її батьків.

void translate(offset: Vector2) 🔗

Зміщує вузол на задане значення offset у локальних координатах. Це еквівалентно position += offset.