class_visibilitynotifier.rst 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the VisibilityNotifier.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_VisibilityNotifier:
  6. VisibilityNotifier
  7. ==================
  8. **Inherits:** :ref:`Spatial<class_Spatial>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  9. **Inherited By:** :ref:`VisibilityEnabler<class_VisibilityEnabler>`
  10. **Category:** Core
  11. Brief Description
  12. -----------------
  13. Detects when the node is visible on screen.
  14. Properties
  15. ----------
  16. +-------------------------+-----------------------------------------------------+
  17. | :ref:`AABB<class_AABB>` | :ref:`aabb<class_VisibilityNotifier_property_aabb>` |
  18. +-------------------------+-----------------------------------------------------+
  19. Methods
  20. -------
  21. +-------------------------+-------------------------------------------------------------------------------------+
  22. | :ref:`bool<class_bool>` | :ref:`is_on_screen<class_VisibilityNotifier_method_is_on_screen>` **(** **)** const |
  23. +-------------------------+-------------------------------------------------------------------------------------+
  24. Signals
  25. -------
  26. .. _class_VisibilityNotifier_signal_camera_entered:
  27. - **camera_entered** **(** :ref:`Camera<class_Camera>` camera **)**
  28. Emitted when the VisibilityNotifier enters a :ref:`Camera<class_Camera>`'s view.
  29. ----
  30. .. _class_VisibilityNotifier_signal_camera_exited:
  31. - **camera_exited** **(** :ref:`Camera<class_Camera>` camera **)**
  32. Emitted when the VisibilityNotifier exits a :ref:`Camera<class_Camera>`'s view.
  33. ----
  34. .. _class_VisibilityNotifier_signal_screen_entered:
  35. - **screen_entered** **(** **)**
  36. Emitted when the VisibilityNotifier enters the screen.
  37. ----
  38. .. _class_VisibilityNotifier_signal_screen_exited:
  39. - **screen_exited** **(** **)**
  40. Emitted when the VisibilityNotifier exits the screen.
  41. Description
  42. -----------
  43. The VisibilityNotifier detects when it is visible on the screen. It also notifies when its bounding rectangle enters or exits the screen or a :ref:`Camera<class_Camera>`'s view.
  44. Property Descriptions
  45. ---------------------
  46. .. _class_VisibilityNotifier_property_aabb:
  47. - :ref:`AABB<class_AABB>` **aabb**
  48. +----------+-----------------+
  49. | *Setter* | set_aabb(value) |
  50. +----------+-----------------+
  51. | *Getter* | get_aabb() |
  52. +----------+-----------------+
  53. The VisibilityNotifier's bounding box.
  54. Method Descriptions
  55. -------------------
  56. .. _class_VisibilityNotifier_method_is_on_screen:
  57. - :ref:`bool<class_bool>` **is_on_screen** **(** **)** const
  58. If ``true``, the bounding box is on the screen.
  59. Note: It takes one frame for the node's visibility to be assessed once added to the scene tree, so this method will return ``false`` right after it is instantiated, even if it will be on screen in the draw pass.