godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2026-01-03 05:48:42 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
551ab512ca48b95eb5297aaf43d9ae571bb46336
godot-docs/classes/class_node2d.rst
Rémi Verschelde 551ab512ca classref: Sync with latest 4.0-alpha
2022-02-01 16:35:13 +01:00

366 lines
19 KiB
ReStructuredText
Raw Blame History

:github_url: hide
.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the Node2D.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.
.. _class_Node2D:
Node2D
======
**Inherits:** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
**Inherited By:** :ref:`AnimatedSprite2D<class_AnimatedSprite2D>`, :ref:`AudioListener2D<class_AudioListener2D>`, :ref:`AudioStreamPlayer2D<class_AudioStreamPlayer2D>`, :ref:`BackBufferCopy<class_BackBufferCopy>`, :ref:`Bone2D<class_Bone2D>`, :ref:`CPUParticles2D<class_CPUParticles2D>`, :ref:`Camera2D<class_Camera2D>`, :ref:`CanvasGroup<class_CanvasGroup>`, :ref:`CanvasModulate<class_CanvasModulate>`, :ref:`CollisionObject2D<class_CollisionObject2D>`, :ref:`CollisionPolygon2D<class_CollisionPolygon2D>`, :ref:`CollisionShape2D<class_CollisionShape2D>`, :ref:`GPUParticles2D<class_GPUParticles2D>`, :ref:`Joint2D<class_Joint2D>`, :ref:`Light2D<class_Light2D>`, :ref:`LightOccluder2D<class_LightOccluder2D>`, :ref:`Line2D<class_Line2D>`, :ref:`MeshInstance2D<class_MeshInstance2D>`, :ref:`MultiMeshInstance2D<class_MultiMeshInstance2D>`, :ref:`NavigationRegion2D<class_NavigationRegion2D>`, :ref:`ParallaxLayer<class_ParallaxLayer>`, :ref:`Path2D<class_Path2D>`, :ref:`PathFollow2D<class_PathFollow2D>`, :ref:`Polygon2D<class_Polygon2D>`, :ref:`Position2D<class_Position2D>`, :ref:`RayCast2D<class_RayCast2D>`, :ref:`RemoteTransform2D<class_RemoteTransform2D>`, :ref:`ShapeCast2D<class_ShapeCast2D>`, :ref:`Skeleton2D<class_Skeleton2D>`, :ref:`Sprite2D<class_Sprite2D>`, :ref:`TileMap<class_TileMap>`, :ref:`TouchScreenButton<class_TouchScreenButton>`, :ref:`VisibleOnScreenNotifier2D<class_VisibleOnScreenNotifier2D>`
A 2D game object, inherited by all 2D-related nodes. Has a position, rotation, scale, and Z index.
Description
-----------
A 2D game object, with a transform (position, rotation, and scale). All 2D nodes, including physics objects and sprites, inherit from Node2D. Use Node2D as a parent node to move, scale and rotate children in a 2D project. Also gives control of the node's render order.
Tutorials
---------
- :doc:`Custom drawing in 2D <../tutorials/2d/custom_drawing_in_2d>`
- `All 2D Demos <https://github.com/godotengine/godot-demo-projects/tree/master/2d>`__
Properties
----------
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`global_position<class_Node2D_property_global_position>` | |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`float<class_float>` | :ref:`global_rotation<class_Node2D_property_global_rotation>` | |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`global_scale<class_Node2D_property_global_scale>` | |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`Transform2D<class_Transform2D>` | :ref:`global_transform<class_Node2D_property_global_transform>` | |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`position<class_Node2D_property_position>` | ``Vector2(0, 0)`` |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`float<class_float>` | :ref:`rotation<class_Node2D_property_rotation>` | ``0.0`` |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`scale<class_Node2D_property_scale>` | ``Vector2(1, 1)`` |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`float<class_float>` | :ref:`skew<class_Node2D_property_skew>` | ``0.0`` |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`Transform2D<class_Transform2D>` | :ref:`transform<class_Node2D_property_transform>` | |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`bool<class_bool>` | :ref:`y_sort_enabled<class_Node2D_property_y_sort_enabled>` | ``false`` |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`bool<class_bool>` | :ref:`z_as_relative<class_Node2D_property_z_as_relative>` | ``true`` |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
| :ref:`int<class_int>` | :ref:`z_index<class_Node2D_property_z_index>` | ``0`` |
+---------------------------------------+-----------------------------------------------------------------+-------------------+
Methods
-------
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`apply_scale<class_Node2D_method_apply_scale>` **(** :ref:`Vector2<class_Vector2>` ratio **)** |
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_angle_to<class_Node2D_method_get_angle_to>` **(** :ref:`Vector2<class_Vector2>` point **)** |const| |
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Transform2D<class_Transform2D>` | :ref:`get_relative_transform_to_parent<class_Node2D_method_get_relative_transform_to_parent>` **(** :ref:`Node<class_Node>` parent **)** |const| |
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`global_translate<class_Node2D_method_global_translate>` **(** :ref:`Vector2<class_Vector2>` offset **)** |
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`look_at<class_Node2D_method_look_at>` **(** :ref:`Vector2<class_Vector2>` point **)** |
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`move_local_x<class_Node2D_method_move_local_x>` **(** :ref:`float<class_float>` delta, :ref:`bool<class_bool>` scaled=false **)** |
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`move_local_y<class_Node2D_method_move_local_y>` **(** :ref:`float<class_float>` delta, :ref:`bool<class_bool>` scaled=false **)** |
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`rotate<class_Node2D_method_rotate>` **(** :ref:`float<class_float>` radians **)** |
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`to_global<class_Node2D_method_to_global>` **(** :ref:`Vector2<class_Vector2>` local_point **)** |const| |
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`to_local<class_Node2D_method_to_local>` **(** :ref:`Vector2<class_Vector2>` global_point **)** |const| |
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`translate<class_Node2D_method_translate>` **(** :ref:`Vector2<class_Vector2>` offset **)** |
+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
Property Descriptions
---------------------
.. _class_Node2D_property_global_position:
- :ref:`Vector2<class_Vector2>` **global_position**
+----------+----------------------------+
| *Setter* | set_global_position(value) |
+----------+----------------------------+
| *Getter* | get_global_position() |
+----------+----------------------------+
Global position.
----
.. _class_Node2D_property_global_rotation:
- :ref:`float<class_float>` **global_rotation**
+----------+----------------------------+
| *Setter* | set_global_rotation(value) |
+----------+----------------------------+
| *Getter* | get_global_rotation() |
+----------+----------------------------+
Global rotation in radians.
----
.. _class_Node2D_property_global_scale:
- :ref:`Vector2<class_Vector2>` **global_scale**
+----------+-------------------------+
| *Setter* | set_global_scale(value) |
+----------+-------------------------+
| *Getter* | get_global_scale() |
+----------+-------------------------+
Global scale.
----
.. _class_Node2D_property_global_transform:
- :ref:`Transform2D<class_Transform2D>` **global_transform**
+----------+-----------------------------+
| *Setter* | set_global_transform(value) |
+----------+-----------------------------+
| *Getter* | get_global_transform() |
+----------+-----------------------------+
Global :ref:`Transform2D<class_Transform2D>`.
----
.. _class_Node2D_property_position:
- :ref:`Vector2<class_Vector2>` **position**
+-----------+---------------------+
| *Default* | ``Vector2(0, 0)`` |
+-----------+---------------------+
| *Setter* | set_position(value) |
+-----------+---------------------+
| *Getter* | get_position() |
+-----------+---------------------+
Position, relative to the node's parent.
----
.. _class_Node2D_property_rotation:
- :ref:`float<class_float>` **rotation**
+-----------+---------------------+
| *Default* | ``0.0`` |
+-----------+---------------------+
| *Setter* | set_rotation(value) |
+-----------+---------------------+
| *Getter* | get_rotation() |
+-----------+---------------------+
Rotation in radians, relative to the node's parent.
----
.. _class_Node2D_property_scale:
- :ref:`Vector2<class_Vector2>` **scale**
+-----------+-------------------+
| *Default* | ``Vector2(1, 1)`` |
+-----------+-------------------+
| *Setter* | set_scale(value) |
+-----------+-------------------+
| *Getter* | get_scale() |
+-----------+-------------------+
The node's scale. Unscaled value: ``(1, 1)``.
----
.. _class_Node2D_property_skew:
- :ref:`float<class_float>` **skew**
+-----------+-----------------+
| *Default* | ``0.0`` |
+-----------+-----------------+
| *Setter* | set_skew(value) |
+-----------+-----------------+
| *Getter* | get_skew() |
+-----------+-----------------+
----
.. _class_Node2D_property_transform:
- :ref:`Transform2D<class_Transform2D>` **transform**
+----------+----------------------+
| *Setter* | set_transform(value) |
+----------+----------------------+
| *Getter* | get_transform() |
+----------+----------------------+
Local :ref:`Transform2D<class_Transform2D>`.
----
.. _class_Node2D_property_y_sort_enabled:
- :ref:`bool<class_bool>` **y_sort_enabled**
+-----------+---------------------------+
| *Default* | ``false`` |
+-----------+---------------------------+
| *Setter* | set_y_sort_enabled(value) |
+-----------+---------------------------+
| *Getter* | is_y_sort_enabled() |
+-----------+---------------------------+
If ``true``, child nodes with the lowest Y position are drawn before those with a higher Y position. If ``false``, Y-sorting is disabled. Y-sorting only affects children that inherit from :ref:`CanvasItem<class_CanvasItem>`.
You can nest nodes with Y-sorting. Child Y-sorted nodes are sorted in the same space as the parent Y-sort. This feature allows you to organize a scene better or divide it into multiple ones without changing your scene tree.
----
.. _class_Node2D_property_z_as_relative:
- :ref:`bool<class_bool>` **z_as_relative**
+-----------+--------------------------+
| *Default* | ``true`` |
+-----------+--------------------------+
| *Setter* | set_z_as_relative(value) |
+-----------+--------------------------+
| *Getter* | is_z_relative() |
+-----------+--------------------------+
If ``true``, the node's Z index is relative to its parent's Z index. If this node's Z index is 2 and its parent's effective Z index is 3, then this node's effective Z index will be 2 + 3 = 5.
----
.. _class_Node2D_property_z_index:
- :ref:`int<class_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 :ref:`RenderingServer.CANVAS_ITEM_Z_MIN<class_RenderingServer_constant_CANVAS_ITEM_Z_MIN>` and :ref:`RenderingServer.CANVAS_ITEM_Z_MAX<class_RenderingServer_constant_CANVAS_ITEM_Z_MAX>` (inclusive).
Method Descriptions
-------------------
.. _class_Node2D_method_apply_scale:
- void **apply_scale** **(** :ref:`Vector2<class_Vector2>` ratio **)**
Multiplies the current scale by the ``ratio`` vector.
----
.. _class_Node2D_method_get_angle_to:
- :ref:`float<class_float>` **get_angle_to** **(** :ref:`Vector2<class_Vector2>` point **)** |const|
Returns the angle between the node and the ``point`` in radians.
\ `Illustration of the returned angle. <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/node2d_get_angle_to.png>`__
----
.. _class_Node2D_method_get_relative_transform_to_parent:
- :ref:`Transform2D<class_Transform2D>` **get_relative_transform_to_parent** **(** :ref:`Node<class_Node>` parent **)** |const|
Returns the :ref:`Transform2D<class_Transform2D>` relative to this node's parent.
----
.. _class_Node2D_method_global_translate:
- void **global_translate** **(** :ref:`Vector2<class_Vector2>` offset **)**
Adds the ``offset`` vector to the node's global position.
----
.. _class_Node2D_method_look_at:
- void **look_at** **(** :ref:`Vector2<class_Vector2>` point **)**
Rotates the node so it points towards the ``point``, which is expected to use global coordinates.
----
.. _class_Node2D_method_move_local_x:
- void **move_local_x** **(** :ref:`float<class_float>` delta, :ref:`bool<class_bool>` scaled=false **)**
Applies a local translation on the node's X axis based on the :ref:`Node._process<class_Node_method__process>`'s ``delta``. If ``scaled`` is ``false``, normalizes the movement.
----
.. _class_Node2D_method_move_local_y:
- void **move_local_y** **(** :ref:`float<class_float>` delta, :ref:`bool<class_bool>` scaled=false **)**
Applies a local translation on the node's Y axis based on the :ref:`Node._process<class_Node_method__process>`'s ``delta``. If ``scaled`` is ``false``, normalizes the movement.
----
.. _class_Node2D_method_rotate:
- void **rotate** **(** :ref:`float<class_float>` radians **)**
Applies a rotation to the node, in radians, starting from its current rotation.
----
.. _class_Node2D_method_to_global:
- :ref:`Vector2<class_Vector2>` **to_global** **(** :ref:`Vector2<class_Vector2>` local_point **)** |const|
Transforms the provided local position into a position in global coordinate space. The input is expected to be local relative to the ``Node2D`` it is called on. e.g. Applying this method to the positions of child nodes will correctly transform their positions into the global coordinate space, but applying it to a node's own position will give an incorrect result, as it will incorporate the node's own transformation into its global position.
----
.. _class_Node2D_method_to_local:
- :ref:`Vector2<class_Vector2>` **to_local** **(** :ref:`Vector2<class_Vector2>` global_point **)** |const|
Transforms the provided global position into a position in local coordinate space. The output will be local relative to the ``Node2D`` it is called on. e.g. It is appropriate for determining the positions of child nodes, but it is not appropriate for determining its own position relative to its parent.
----
.. _class_Node2D_method_translate:
- void **translate** **(** :ref:`Vector2<class_Vector2>` offset **)**
Translates the node by the given ``offset`` in local coordinates.
.. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
.. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
.. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
.. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
.. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
.. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
Reference in New Issue View Git Blame Copy Permalink