class_editordebuggerplugin.rst 7.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the EditorDebuggerPlugin.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_EditorDebuggerPlugin:
  6. EditorDebuggerPlugin
  7. ====================
  8. **Inherits:** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  9. A base class to implement debugger plugins.
  10. Description
  11. -----------
  12. ``EditorDebuggerPlugin`` provides functions related to the editor side of the debugger.
  13. You don't need to instantiate this class; that is automatically handled by the debugger. :ref:`Control<class_Control>` nodes can be added as child nodes to provide a GUI for the plugin.
  14. Do not free or reparent this node, otherwise it becomes unusable.
  15. To use ``EditorDebuggerPlugin``, register it using the :ref:`EditorPlugin.add_debugger_plugin<class_EditorPlugin_method_add_debugger_plugin>` method first.
  16. Methods
  17. -------
  18. +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  19. | :ref:`bool<class_bool>` | :ref:`has_capture<class_EditorDebuggerPlugin_method_has_capture>` **(** :ref:`StringName<class_StringName>` name **)** |
  20. +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  21. | :ref:`bool<class_bool>` | :ref:`is_breaked<class_EditorDebuggerPlugin_method_is_breaked>` **(** **)** |
  22. +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  23. | :ref:`bool<class_bool>` | :ref:`is_debuggable<class_EditorDebuggerPlugin_method_is_debuggable>` **(** **)** |
  24. +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  25. | :ref:`bool<class_bool>` | :ref:`is_session_active<class_EditorDebuggerPlugin_method_is_session_active>` **(** **)** |
  26. +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  27. | void | :ref:`register_message_capture<class_EditorDebuggerPlugin_method_register_message_capture>` **(** :ref:`StringName<class_StringName>` name, :ref:`Callable<class_Callable>` callable **)** |
  28. +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  29. | void | :ref:`send_message<class_EditorDebuggerPlugin_method_send_message>` **(** :ref:`String<class_String>` message, :ref:`Array<class_Array>` data **)** |
  30. +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  31. | void | :ref:`unregister_message_capture<class_EditorDebuggerPlugin_method_unregister_message_capture>` **(** :ref:`StringName<class_StringName>` name **)** |
  32. +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  33. Signals
  34. -------
  35. .. _class_EditorDebuggerPlugin_signal_breaked:
  36. - **breaked** **(** :ref:`bool<class_bool>` can_debug **)**
  37. Emitted when the game enters a break state.
  38. ----
  39. .. _class_EditorDebuggerPlugin_signal_continued:
  40. - **continued** **(** **)**
  41. Emitted when the game exists a break state.
  42. ----
  43. .. _class_EditorDebuggerPlugin_signal_started:
  44. - **started** **(** **)**
  45. Emitted when the debugging starts.
  46. ----
  47. .. _class_EditorDebuggerPlugin_signal_stopped:
  48. - **stopped** **(** **)**
  49. Emitted when the debugging stops.
  50. Method Descriptions
  51. -------------------
  52. .. _class_EditorDebuggerPlugin_method_has_capture:
  53. - :ref:`bool<class_bool>` **has_capture** **(** :ref:`StringName<class_StringName>` name **)**
  54. Returns ``true`` if a message capture with given name is present otherwise ``false``.
  55. ----
  56. .. _class_EditorDebuggerPlugin_method_is_breaked:
  57. - :ref:`bool<class_bool>` **is_breaked** **(** **)**
  58. Returns ``true`` if the game is in break state otherwise ``false``.
  59. ----
  60. .. _class_EditorDebuggerPlugin_method_is_debuggable:
  61. - :ref:`bool<class_bool>` **is_debuggable** **(** **)**
  62. Returns ``true`` if the game can be debugged otherwise ``false``.
  63. ----
  64. .. _class_EditorDebuggerPlugin_method_is_session_active:
  65. - :ref:`bool<class_bool>` **is_session_active** **(** **)**
  66. Returns ``true`` if there is an instance of the game running with the attached debugger otherwise ``false``.
  67. ----
  68. .. _class_EditorDebuggerPlugin_method_register_message_capture:
  69. - void **register_message_capture** **(** :ref:`StringName<class_StringName>` name, :ref:`Callable<class_Callable>` callable **)**
  70. Registers a message capture with given ``name``. If ``name`` is "my_message" then messages starting with "my_message:" will be called with the given callable.
  71. Callable must accept a message string and a data array as argument. If the message and data are valid then callable must return ``true`` otherwise ``false``.
  72. ----
  73. .. _class_EditorDebuggerPlugin_method_send_message:
  74. - void **send_message** **(** :ref:`String<class_String>` message, :ref:`Array<class_Array>` data **)**
  75. Sends a message with given ``message`` and ``data`` array.
  76. ----
  77. .. _class_EditorDebuggerPlugin_method_unregister_message_capture:
  78. - void **unregister_message_capture** **(** :ref:`StringName<class_StringName>` name **)**
  79. Unregisters the message capture with given name.
  80. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  81. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  82. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  83. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  84. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  85. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`