godot-docs/classes/class_remotetransform2d.rst

:github_url: hide

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the RemoteTransform2D.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.

.. _class_RemoteTransform2D:

RemoteTransform2D
=================

**Inherits:** :ref:`Node2D<class_Node2D>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`

**Category:** Core

Brief Description
-----------------

RemoteTransform2D pushes its own :ref:`Transform2D<class_Transform2D>` to another :ref:`CanvasItem<class_CanvasItem>` derived Node in the scene.

Properties
----------

+---------------------------------+----------------------------------------------------------------------------------------+--------------+
| :ref:`NodePath<class_NodePath>` | :ref:`remote_path<class_RemoteTransform2D_property_remote_path>`                       | NodePath("") |
+---------------------------------+----------------------------------------------------------------------------------------+--------------+
| :ref:`bool<class_bool>`         | :ref:`update_position<class_RemoteTransform2D_property_update_position>`               | true         |
+---------------------------------+----------------------------------------------------------------------------------------+--------------+
| :ref:`bool<class_bool>`         | :ref:`update_rotation<class_RemoteTransform2D_property_update_rotation>`               | true         |
+---------------------------------+----------------------------------------------------------------------------------------+--------------+
| :ref:`bool<class_bool>`         | :ref:`update_scale<class_RemoteTransform2D_property_update_scale>`                     | true         |
+---------------------------------+----------------------------------------------------------------------------------------+--------------+
| :ref:`bool<class_bool>`         | :ref:`use_global_coordinates<class_RemoteTransform2D_property_use_global_coordinates>` | true         |
+---------------------------------+----------------------------------------------------------------------------------------+--------------+

Methods
-------

+------+------------------------------------------------------------------------------------------+
| void | :ref:`force_update_cache<class_RemoteTransform2D_method_force_update_cache>` **(** **)** |
+------+------------------------------------------------------------------------------------------+

Description
-----------

RemoteTransform2D pushes its own :ref:`Transform2D<class_Transform2D>` to another :ref:`CanvasItem<class_CanvasItem>` derived Node (called the remote node) in the scene.

It can be set to update another Node's position, rotation and/or scale. It can use either global or local coordinates.

Property Descriptions
---------------------

.. _class_RemoteTransform2D_property_remote_path:

- :ref:`NodePath<class_NodePath>` **remote_path**

+-----------+------------------------+
| *Default* | NodePath("")           |
+-----------+------------------------+
| *Setter*  | set_remote_node(value) |
+-----------+------------------------+
| *Getter*  | get_remote_node()      |
+-----------+------------------------+

The :ref:`NodePath<class_NodePath>` to the remote node, relative to the RemoteTransform2D's position in the scene.

.. _class_RemoteTransform2D_property_update_position:

- :ref:`bool<class_bool>` **update_position**

+-----------+----------------------------+
| *Default* | true                       |
+-----------+----------------------------+
| *Setter*  | set_update_position(value) |
+-----------+----------------------------+
| *Getter*  | get_update_position()      |
+-----------+----------------------------+

If ``true``, the remote node's position is updated.

.. _class_RemoteTransform2D_property_update_rotation:

- :ref:`bool<class_bool>` **update_rotation**

+-----------+----------------------------+
| *Default* | true                       |
+-----------+----------------------------+
| *Setter*  | set_update_rotation(value) |
+-----------+----------------------------+
| *Getter*  | get_update_rotation()      |
+-----------+----------------------------+

If ``true``, the remote node's rotation is updated.

.. _class_RemoteTransform2D_property_update_scale:

- :ref:`bool<class_bool>` **update_scale**

+-----------+-------------------------+
| *Default* | true                    |
+-----------+-------------------------+
| *Setter*  | set_update_scale(value) |
+-----------+-------------------------+
| *Getter*  | get_update_scale()      |
+-----------+-------------------------+

If ``true``, the remote node's scale is updated.

.. _class_RemoteTransform2D_property_use_global_coordinates:

- :ref:`bool<class_bool>` **use_global_coordinates**

+-----------+-----------------------------------+
| *Default* | true                              |
+-----------+-----------------------------------+
| *Setter*  | set_use_global_coordinates(value) |
+-----------+-----------------------------------+
| *Getter*  | get_use_global_coordinates()      |
+-----------+-----------------------------------+

If ``true``, global coordinates are used. If ``false``, local coordinates are used.

Method Descriptions
-------------------

.. _class_RemoteTransform2D_method_force_update_cache:

- void **force_update_cache** **(** **)**

``RemoteTransform2D`` caches the remote node. It may not notice if the remote node disappears; :ref:`force_update_cache<class_RemoteTransform2D_method_force_update_cache>` forces it to update the cache again.