summaryrefslogtreecommitdiff
path: root/doc/classes
diff options
context:
space:
mode:
authorRĂ©mi Verschelde <rverschelde@gmail.com>2020-07-27 14:38:55 +0200
committerGitHub <noreply@github.com>2020-07-27 14:38:55 +0200
commit303515981b06a2afd86cfcac53aaebe6c176698c (patch)
tree0e7b00da066a643a5d8681cca0047155d6cc883b /doc/classes
parent6e577a5b805121b3725defc45220d75fcbc6442b (diff)
parent27b09dfc44cd85f5620bac99d624a48f8adedd5a (diff)
Merge pull request #40750 from Calinou/doc-canvasitem-node3d-visible
Improve visibility documentation for CanvasItem and Node3D
Diffstat (limited to 'doc/classes')
-rw-r--r--doc/classes/CanvasItem.xml5
-rw-r--r--doc/classes/Node3D.xml4
2 files changed, 5 insertions, 4 deletions
diff --git a/doc/classes/CanvasItem.xml b/doc/classes/CanvasItem.xml
index be361f93f3..cac4d6f36e 100644
--- a/doc/classes/CanvasItem.xml
+++ b/doc/classes/CanvasItem.xml
@@ -525,7 +525,7 @@
<return type="bool">
</return>
<description>
- Returns [code]true[/code] if the node is present in the [SceneTree], its [member visible] property is [code]true[/code] and its inherited visibility is also [code]true[/code].
+ Returns [code]true[/code] if the node is present in the [SceneTree], its [member visible] property is [code]true[/code] and all its antecedents are also visible. If any antecedent is hidden, this node will not be visible in the scene tree.
</description>
</method>
<method name="make_canvas_position_local" qualifiers="const">
@@ -617,7 +617,8 @@
If [code]true[/code], the parent [CanvasItem]'s [member material] property is used as this one's material.
</member>
<member name="visible" type="bool" setter="set_visible" getter="is_visible" default="true">
- If [code]true[/code], this [CanvasItem] is drawn. For controls that inherit [Popup], the correct way to make them visible is to call one of the multiple [code]popup*()[/code] functions instead.
+ If [code]true[/code], this [CanvasItem] is drawn. The node is only visible if all of its antecedents are visible as well (in other words, [method is_visible_in_tree] must return [code]true[/code]).
+ [b]Note:[/b] For controls that inherit [Popup], the correct way to make them visible is to call one of the multiple [code]popup*()[/code] functions instead.
</member>
</members>
<signals>
diff --git a/doc/classes/Node3D.xml b/doc/classes/Node3D.xml
index 05d00b9f31..02b319fb5a 100644
--- a/doc/classes/Node3D.xml
+++ b/doc/classes/Node3D.xml
@@ -101,7 +101,7 @@
<return type="bool">
</return>
<description>
- Returns whether the node is visible, taking into consideration that its parents visibility.
+ Returns [code]true[/code] if the node is present in the [SceneTree], its [member visible] property is [code]true[/code] and all its antecedents are also visible. If any antecedent is hidden, this node will not be visible in the scene tree.
</description>
</method>
<method name="look_at">
@@ -323,7 +323,7 @@
Local translation of this node.
</member>
<member name="visible" type="bool" setter="set_visible" getter="is_visible" default="true">
- If [code]true[/code], this node is drawn.
+ If [code]true[/code], this node is drawn. The node is only visible if all of its antecedents are visible as well (in other words, [method is_visible_in_tree] must return [code]true[/code]).
</member>
</members>
<signals>