1
0
mirror of https://github.com/godotengine/godot.git synced 2026-01-05 19:31:35 +00:00

Document hiding a Control when its reference point is behind the camera

See https://github.com/godotengine/godot/issues/1725.
This commit is contained in:
Hugo Locurcio
2020-10-27 17:35:41 +01:00
parent 67f64ef4fe
commit b3a6937c0c

View File

@@ -163,6 +163,13 @@
</argument>
<description>
Returns the 2D coordinate in the [Viewport] rectangle that maps to the given 3D point in worldspace.
[b]Note:[/b] When using this to position GUI elements over a 3D viewport, use [method is_position_behind] to prevent them from appearing if the 3D point is behind the camera:
[codeblock]
# This code block is part of a script that inherits from Node3D.
# `control` is a reference to a node inheriting from Control.
control.visible = not get_viewport().get_camera().is_position_behind(global_transform.origin)
control.rect_position = get_viewport().get_camera().unproject_position(global_transform.origin)
[/codeblock]
</description>
</method>
</methods>