class_graphedit.rst 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
  3. .. _class_GraphEdit:
  4. GraphEdit
  5. =========
  6. **Inherits:** :ref:`Control<class_control>` **<** :ref:`CanvasItem<class_canvasitem>` **<** :ref:`Node<class_node>` **<** :ref:`Object<class_object>`
  7. **Category:** Core
  8. Brief Description
  9. -----------------
  10. GraphEdit is an area capable of showing various GraphNodes. It manages connection events between them.
  11. Member Functions
  12. ----------------
  13. +--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  14. | Error | :ref:`connect_node<class_GraphEdit_connect_node>` **(** :ref:`String<class_string>` from, :ref:`int<class_int>` from_port, :ref:`String<class_string>` to, :ref:`int<class_int>` to_port **)** |
  15. +--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  16. | :ref:`bool<class_bool>` | :ref:`is_node_connected<class_GraphEdit_is_node_connected>` **(** :ref:`String<class_string>` from, :ref:`int<class_int>` from_port, :ref:`String<class_string>` to, :ref:`int<class_int>` to_port **)** |
  17. +--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  18. | void | :ref:`disconnect_node<class_GraphEdit_disconnect_node>` **(** :ref:`String<class_string>` from, :ref:`int<class_int>` from_port, :ref:`String<class_string>` to, :ref:`int<class_int>` to_port **)** |
  19. +--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  20. | :ref:`Array<class_array>` | :ref:`get_connection_list<class_GraphEdit_get_connection_list>` **(** **)** const |
  21. +--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  22. | :ref:`Vector2<class_vector2>` | :ref:`get_scroll_ofs<class_GraphEdit_get_scroll_ofs>` **(** **)** const |
  23. +--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  24. | void | :ref:`set_zoom<class_GraphEdit_set_zoom>` **(** :ref:`float<class_float>` p_zoom **)** |
  25. +--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  26. | :ref:`float<class_float>` | :ref:`get_zoom<class_GraphEdit_get_zoom>` **(** **)** const |
  27. +--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  28. | void | :ref:`set_right_disconnects<class_GraphEdit_set_right_disconnects>` **(** :ref:`bool<class_bool>` enable **)** |
  29. +--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  30. | :ref:`bool<class_bool>` | :ref:`is_right_disconnects_enabled<class_GraphEdit_is_right_disconnects_enabled>` **(** **)** const |
  31. +--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  32. Signals
  33. -------
  34. - **delete_nodes_request** **(** **)**
  35. - **duplicate_nodes_request** **(** **)**
  36. - **popup_request** **(** :ref:`Vector2<class_vector2>` p_position **)**
  37. - **_begin_node_move** **(** **)**
  38. - **disconnection_request** **(** :ref:`String<class_string>` from, :ref:`int<class_int>` from_slot, :ref:`String<class_string>` to, :ref:`int<class_int>` to_slot **)**
  39. - **connection_request** **(** :ref:`String<class_string>` from, :ref:`int<class_int>` from_slot, :ref:`String<class_string>` to, :ref:`int<class_int>` to_slot **)**
  40. - **_end_node_move** **(** **)**
  41. Description
  42. -----------
  43. GraphEdit manages the showing of GraphNodes it contains, as well as connections an disconnections between them. Signals are sent for each of these two events. Disconnection between GraphNodes slots is disabled by default.
  44. It is greatly advised to enable low processor usage mode (see :ref:`OS.set_low_processor_usage_mode<class_OS_set_low_processor_usage_mode>`) when using GraphEdits.
  45. Member Function Description
  46. ---------------------------
  47. .. _class_GraphEdit_connect_node:
  48. - Error **connect_node** **(** :ref:`String<class_string>` from, :ref:`int<class_int>` from_port, :ref:`String<class_string>` to, :ref:`int<class_int>` to_port **)**
  49. Create a connection between 'from_port' slot of 'from' GraphNode and 'to_port' slot of 'to' GraphNode. If the connection already exists, no connection is created.
  50. .. _class_GraphEdit_is_node_connected:
  51. - :ref:`bool<class_bool>` **is_node_connected** **(** :ref:`String<class_string>` from, :ref:`int<class_int>` from_port, :ref:`String<class_string>` to, :ref:`int<class_int>` to_port **)**
  52. Return true if the 'from_port' slot of 'from' GraphNode is connected to the 'to_port' slot of 'to' GraphNode.
  53. .. _class_GraphEdit_disconnect_node:
  54. - void **disconnect_node** **(** :ref:`String<class_string>` from, :ref:`int<class_int>` from_port, :ref:`String<class_string>` to, :ref:`int<class_int>` to_port **)**
  55. Remove the connection between 'from_port' slot of 'from' GraphNode and 'to_port' slot of 'to' GraphNode, if connection exists.
  56. .. _class_GraphEdit_get_connection_list:
  57. - :ref:`Array<class_array>` **get_connection_list** **(** **)** const
  58. Return an Array containing the list of connections. A connection consists in a structure of the form {from_slot: 0, from: "GraphNode name 0", to_slot: 1, to: "GraphNode name 1" }
  59. .. _class_GraphEdit_get_scroll_ofs:
  60. - :ref:`Vector2<class_vector2>` **get_scroll_ofs** **(** **)** const
  61. Return the scroll offset.
  62. .. _class_GraphEdit_set_zoom:
  63. - void **set_zoom** **(** :ref:`float<class_float>` p_zoom **)**
  64. Set the zoom value of the GraphEdit. Zoom value is between :ref:`0.01; 1.728<class_0.01; 1.728>`.
  65. .. _class_GraphEdit_get_zoom:
  66. - :ref:`float<class_float>` **get_zoom** **(** **)** const
  67. Return the current zoom value.
  68. .. _class_GraphEdit_set_right_disconnects:
  69. - void **set_right_disconnects** **(** :ref:`bool<class_bool>` enable **)**
  70. Enable the disconnection of existing connections in the visual GraphEdit by left-clicking a connection and releasing into the void.
  71. .. _class_GraphEdit_is_right_disconnects_enabled:
  72. - :ref:`bool<class_bool>` **is_right_disconnects_enabled** **(** **)** const
  73. Return true is the disconnection of connections is enable in the visual GraphEdit. False otherwise.