class_visibilitynotifier2d.rst 2.9 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 VisibilityNotifier2D.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_VisibilityNotifier2D:
  6. VisibilityNotifier2D
  7. ====================
  8. **Inherits:** :ref:`Node2D<class_Node2D>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  9. **Inherited By:** :ref:`VisibilityEnabler2D<class_VisibilityEnabler2D>`
  10. **Category:** Core
  11. Brief Description
  12. -----------------
  13. Detects when the node is visible on screen.
  14. Properties
  15. ----------
  16. +---------------------------+-------------------------------------------------------+
  17. | :ref:`Rect2<class_Rect2>` | :ref:`rect<class_VisibilityNotifier2D_property_rect>` |
  18. +---------------------------+-------------------------------------------------------+
  19. Methods
  20. -------
  21. +-------------------------+---------------------------------------------------------------------------------------+
  22. | :ref:`bool<class_bool>` | :ref:`is_on_screen<class_VisibilityNotifier2D_method_is_on_screen>` **(** **)** const |
  23. +-------------------------+---------------------------------------------------------------------------------------+
  24. Signals
  25. -------
  26. .. _class_VisibilityNotifier2D_signal_screen_entered:
  27. - **screen_entered** **(** **)**
  28. Emitted when the VisibilityNotifier2D enters the screen.
  29. ----
  30. .. _class_VisibilityNotifier2D_signal_screen_exited:
  31. - **screen_exited** **(** **)**
  32. Emitted when the VisibilityNotifier2D exits the screen.
  33. ----
  34. .. _class_VisibilityNotifier2D_signal_viewport_entered:
  35. - **viewport_entered** **(** :ref:`Viewport<class_Viewport>` viewport **)**
  36. Emitted when the VisibilityNotifier2D enters a :ref:`Viewport<class_Viewport>`'s view.
  37. ----
  38. .. _class_VisibilityNotifier2D_signal_viewport_exited:
  39. - **viewport_exited** **(** :ref:`Viewport<class_Viewport>` viewport **)**
  40. Emitted when the VisibilityNotifier2D exits a :ref:`Viewport<class_Viewport>`'s view.
  41. Description
  42. -----------
  43. The VisibilityNotifier2D detects when it is visible on the screen. It also notifies when its bounding rectangle enters or exits the screen or a viewport.
  44. Property Descriptions
  45. ---------------------
  46. .. _class_VisibilityNotifier2D_property_rect:
  47. - :ref:`Rect2<class_Rect2>` **rect**
  48. +----------+-----------------+
  49. | *Setter* | set_rect(value) |
  50. +----------+-----------------+
  51. | *Getter* | get_rect() |
  52. +----------+-----------------+
  53. The VisibilityNotifier2D's bounding rectangle.
  54. Method Descriptions
  55. -------------------
  56. .. _class_VisibilityNotifier2D_method_is_on_screen:
  57. - :ref:`bool<class_bool>` **is_on_screen** **(** **)** const
  58. If ``true``, the bounding rectangle 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.