Quellcode durchsuchen

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

See https://github.com/godotengine/godot/issues/1725.

(cherry picked from commit b3a6937c0c36fcca761d4c18a6d711bdb24a967e)
Hugo Locurcio vor 5 Jahren
Ursprung
Commit
7746afec94
1 geänderte Dateien mit 7 neuen und 0 gelöschten Zeilen
  1. 7 0
      doc/classes/Camera.xml

+ 7 - 0
doc/classes/Camera.xml

@@ -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 Spatial.
+				# `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>