Merge pull request #38578 from Phischermen/transform-notification-doc_update

Mention gotcha about how gizmos affect transform notifications
This commit is contained in:
Rémi Verschelde 2021-01-15 16:17:26 +01:00 committed by GitHub
commit ee41c58b4a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -229,7 +229,7 @@
<argument index="0" name="enable" type="bool"> <argument index="0" name="enable" type="bool">
</argument> </argument>
<description> <description>
Sets whether the node notifies about its global and local transformation changes. [Node3D] will not propagate this by default. Sets whether the node notifies about its global and local transformation changes. [Node3D] will not propagate this by default, unless it is in the editor context and it has a valid gizmo.
</description> </description>
</method> </method>
<method name="show"> <method name="show">
@ -324,7 +324,7 @@
<constants> <constants>
<constant name="NOTIFICATION_TRANSFORM_CHANGED" value="2000"> <constant name="NOTIFICATION_TRANSFORM_CHANGED" value="2000">
Node3D nodes receives this notification when their global transform changes. This means that either the current or a parent node changed its transform. Node3D nodes receives this notification when their global transform changes. This means that either the current or a parent node changed its transform.
In order for [constant NOTIFICATION_TRANSFORM_CHANGED] to work, users first need to ask for it, with [method set_notify_transform]. In order for [constant NOTIFICATION_TRANSFORM_CHANGED] to work, users first need to ask for it, with [method set_notify_transform]. The notification is also sent if the node is in the editor context and it has a valid gizmo.
</constant> </constant>
<constant name="NOTIFICATION_ENTER_WORLD" value="41"> <constant name="NOTIFICATION_ENTER_WORLD" value="41">
Node3D nodes receives this notification when they are registered to new [World3D] resource. Node3D nodes receives this notification when they are registered to new [World3D] resource.