class_graphnode.rst 52 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/GraphNode.xml.
  6. .. _class_GraphNode:
  7. GraphNode
  8. =========
  9. **Inherits:** :ref:`GraphElement<class_GraphElement>` **<** :ref:`Container<class_Container>` **<** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  10. A container with connection ports, representing a node in a :ref:`GraphEdit<class_GraphEdit>`.
  11. .. rst-class:: classref-introduction-group
  12. Description
  13. -----------
  14. **GraphNode** allows to create nodes for a :ref:`GraphEdit<class_GraphEdit>` graph with customizable content based on its child controls. **GraphNode** is derived from :ref:`Container<class_Container>` and it is responsible for placing its children on screen. This works similar to :ref:`VBoxContainer<class_VBoxContainer>`. Children, in turn, provide **GraphNode** with so-called slots, each of which can have a connection port on either side.
  15. Each **GraphNode** slot is defined by its index and can provide the node with up to two ports: one on the left, and one on the right. By convention the left port is also referred to as the **input port** and the right port is referred to as the **output port**. Each port can be enabled and configured individually, using different type and color. The type is an arbitrary value that you can define using your own considerations. The parent :ref:`GraphEdit<class_GraphEdit>` will receive this information on each connect and disconnect request.
  16. Slots can be configured in the Inspector dock once you add at least one child :ref:`Control<class_Control>`. The properties are grouped by each slot's index in the "Slot" section.
  17. \ **Note:** While GraphNode is set up using slots and slot indices, connections are made between the ports which are enabled. Because of that :ref:`GraphEdit<class_GraphEdit>` uses the port's index and not the slot's index. You can use :ref:`get_input_port_slot<class_GraphNode_method_get_input_port_slot>` and :ref:`get_output_port_slot<class_GraphNode_method_get_output_port_slot>` to get the slot index from the port index.
  18. .. rst-class:: classref-reftable-group
  19. Properties
  20. ----------
  21. .. table::
  22. :widths: auto
  23. +----------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------+
  24. | :ref:`MouseFilter<enum_Control_MouseFilter>` | mouse_filter | ``0`` (overrides :ref:`Control<class_Control_property_mouse_filter>`) |
  25. +----------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------+
  26. | :ref:`String<class_String>` | :ref:`title<class_GraphNode_property_title>` | ``""`` |
  27. +----------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------+
  28. .. rst-class:: classref-reftable-group
  29. Methods
  30. -------
  31. .. table::
  32. :widths: auto
  33. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  34. | void | :ref:`_draw_port<class_GraphNode_method__draw_port>` **(** :ref:`int<class_int>` slot_index, :ref:`Vector2i<class_Vector2i>` position, :ref:`bool<class_bool>` left, :ref:`Color<class_Color>` color **)** |virtual| |
  35. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  36. | void | :ref:`clear_all_slots<class_GraphNode_method_clear_all_slots>` **(** **)** |
  37. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  38. | void | :ref:`clear_slot<class_GraphNode_method_clear_slot>` **(** :ref:`int<class_int>` slot_index **)** |
  39. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  40. | :ref:`Color<class_Color>` | :ref:`get_input_port_color<class_GraphNode_method_get_input_port_color>` **(** :ref:`int<class_int>` port_idx **)** |
  41. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  42. | :ref:`int<class_int>` | :ref:`get_input_port_count<class_GraphNode_method_get_input_port_count>` **(** **)** |
  43. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`Vector2<class_Vector2>` | :ref:`get_input_port_position<class_GraphNode_method_get_input_port_position>` **(** :ref:`int<class_int>` port_idx **)** |
  45. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  46. | :ref:`int<class_int>` | :ref:`get_input_port_slot<class_GraphNode_method_get_input_port_slot>` **(** :ref:`int<class_int>` port_idx **)** |
  47. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  48. | :ref:`int<class_int>` | :ref:`get_input_port_type<class_GraphNode_method_get_input_port_type>` **(** :ref:`int<class_int>` port_idx **)** |
  49. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  50. | :ref:`Color<class_Color>` | :ref:`get_output_port_color<class_GraphNode_method_get_output_port_color>` **(** :ref:`int<class_int>` port_idx **)** |
  51. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  52. | :ref:`int<class_int>` | :ref:`get_output_port_count<class_GraphNode_method_get_output_port_count>` **(** **)** |
  53. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  54. | :ref:`Vector2<class_Vector2>` | :ref:`get_output_port_position<class_GraphNode_method_get_output_port_position>` **(** :ref:`int<class_int>` port_idx **)** |
  55. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  56. | :ref:`int<class_int>` | :ref:`get_output_port_slot<class_GraphNode_method_get_output_port_slot>` **(** :ref:`int<class_int>` port_idx **)** |
  57. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  58. | :ref:`int<class_int>` | :ref:`get_output_port_type<class_GraphNode_method_get_output_port_type>` **(** :ref:`int<class_int>` port_idx **)** |
  59. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  60. | :ref:`Color<class_Color>` | :ref:`get_slot_color_left<class_GraphNode_method_get_slot_color_left>` **(** :ref:`int<class_int>` slot_index **)** |const| |
  61. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  62. | :ref:`Color<class_Color>` | :ref:`get_slot_color_right<class_GraphNode_method_get_slot_color_right>` **(** :ref:`int<class_int>` slot_index **)** |const| |
  63. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  64. | :ref:`int<class_int>` | :ref:`get_slot_type_left<class_GraphNode_method_get_slot_type_left>` **(** :ref:`int<class_int>` slot_index **)** |const| |
  65. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  66. | :ref:`int<class_int>` | :ref:`get_slot_type_right<class_GraphNode_method_get_slot_type_right>` **(** :ref:`int<class_int>` slot_index **)** |const| |
  67. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  68. | :ref:`HBoxContainer<class_HBoxContainer>` | :ref:`get_titlebar_hbox<class_GraphNode_method_get_titlebar_hbox>` **(** **)** |
  69. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  70. | :ref:`bool<class_bool>` | :ref:`is_slot_draw_stylebox<class_GraphNode_method_is_slot_draw_stylebox>` **(** :ref:`int<class_int>` slot_index **)** |const| |
  71. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  72. | :ref:`bool<class_bool>` | :ref:`is_slot_enabled_left<class_GraphNode_method_is_slot_enabled_left>` **(** :ref:`int<class_int>` slot_index **)** |const| |
  73. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  74. | :ref:`bool<class_bool>` | :ref:`is_slot_enabled_right<class_GraphNode_method_is_slot_enabled_right>` **(** :ref:`int<class_int>` slot_index **)** |const| |
  75. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  76. | void | :ref:`set_slot<class_GraphNode_method_set_slot>` **(** :ref:`int<class_int>` slot_index, :ref:`bool<class_bool>` enable_left_port, :ref:`int<class_int>` type_left, :ref:`Color<class_Color>` color_left, :ref:`bool<class_bool>` enable_right_port, :ref:`int<class_int>` type_right, :ref:`Color<class_Color>` color_right, :ref:`Texture2D<class_Texture2D>` custom_icon_left=null, :ref:`Texture2D<class_Texture2D>` custom_icon_right=null, :ref:`bool<class_bool>` draw_stylebox=true **)** |
  77. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  78. | void | :ref:`set_slot_color_left<class_GraphNode_method_set_slot_color_left>` **(** :ref:`int<class_int>` slot_index, :ref:`Color<class_Color>` color **)** |
  79. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  80. | void | :ref:`set_slot_color_right<class_GraphNode_method_set_slot_color_right>` **(** :ref:`int<class_int>` slot_index, :ref:`Color<class_Color>` color **)** |
  81. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  82. | void | :ref:`set_slot_draw_stylebox<class_GraphNode_method_set_slot_draw_stylebox>` **(** :ref:`int<class_int>` slot_index, :ref:`bool<class_bool>` enable **)** |
  83. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  84. | void | :ref:`set_slot_enabled_left<class_GraphNode_method_set_slot_enabled_left>` **(** :ref:`int<class_int>` slot_index, :ref:`bool<class_bool>` enable **)** |
  85. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  86. | void | :ref:`set_slot_enabled_right<class_GraphNode_method_set_slot_enabled_right>` **(** :ref:`int<class_int>` slot_index, :ref:`bool<class_bool>` enable **)** |
  87. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  88. | void | :ref:`set_slot_type_left<class_GraphNode_method_set_slot_type_left>` **(** :ref:`int<class_int>` slot_index, :ref:`int<class_int>` type **)** |
  89. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  90. | void | :ref:`set_slot_type_right<class_GraphNode_method_set_slot_type_right>` **(** :ref:`int<class_int>` slot_index, :ref:`int<class_int>` type **)** |
  91. +-------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  92. .. rst-class:: classref-reftable-group
  93. Theme Properties
  94. ----------------
  95. .. table::
  96. :widths: auto
  97. +-----------------------------------+-------------------------------------------------------------------------+-----------------------------------+
  98. | :ref:`Color<class_Color>` | :ref:`resizer_color<class_GraphNode_theme_color_resizer_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
  99. +-----------------------------------+-------------------------------------------------------------------------+-----------------------------------+
  100. | :ref:`int<class_int>` | :ref:`port_h_offset<class_GraphNode_theme_constant_port_h_offset>` | ``0`` |
  101. +-----------------------------------+-------------------------------------------------------------------------+-----------------------------------+
  102. | :ref:`int<class_int>` | :ref:`separation<class_GraphNode_theme_constant_separation>` | ``2`` |
  103. +-----------------------------------+-------------------------------------------------------------------------+-----------------------------------+
  104. | :ref:`Texture2D<class_Texture2D>` | :ref:`port<class_GraphNode_theme_icon_port>` | |
  105. +-----------------------------------+-------------------------------------------------------------------------+-----------------------------------+
  106. | :ref:`Texture2D<class_Texture2D>` | :ref:`resizer<class_GraphNode_theme_icon_resizer>` | |
  107. +-----------------------------------+-------------------------------------------------------------------------+-----------------------------------+
  108. | :ref:`StyleBox<class_StyleBox>` | :ref:`panel<class_GraphNode_theme_style_panel>` | |
  109. +-----------------------------------+-------------------------------------------------------------------------+-----------------------------------+
  110. | :ref:`StyleBox<class_StyleBox>` | :ref:`panel_selected<class_GraphNode_theme_style_panel_selected>` | |
  111. +-----------------------------------+-------------------------------------------------------------------------+-----------------------------------+
  112. | :ref:`StyleBox<class_StyleBox>` | :ref:`slot<class_GraphNode_theme_style_slot>` | |
  113. +-----------------------------------+-------------------------------------------------------------------------+-----------------------------------+
  114. | :ref:`StyleBox<class_StyleBox>` | :ref:`titlebar<class_GraphNode_theme_style_titlebar>` | |
  115. +-----------------------------------+-------------------------------------------------------------------------+-----------------------------------+
  116. | :ref:`StyleBox<class_StyleBox>` | :ref:`titlebar_selected<class_GraphNode_theme_style_titlebar_selected>` | |
  117. +-----------------------------------+-------------------------------------------------------------------------+-----------------------------------+
  118. .. rst-class:: classref-section-separator
  119. ----
  120. .. rst-class:: classref-descriptions-group
  121. Signals
  122. -------
  123. .. _class_GraphNode_signal_slot_updated:
  124. .. rst-class:: classref-signal
  125. **slot_updated** **(** :ref:`int<class_int>` slot_index **)**
  126. Emitted when any GraphNode's slot is updated.
  127. .. rst-class:: classref-section-separator
  128. ----
  129. .. rst-class:: classref-descriptions-group
  130. Property Descriptions
  131. ---------------------
  132. .. _class_GraphNode_property_title:
  133. .. rst-class:: classref-property
  134. :ref:`String<class_String>` **title** = ``""``
  135. .. rst-class:: classref-property-setget
  136. - void **set_title** **(** :ref:`String<class_String>` value **)**
  137. - :ref:`String<class_String>` **get_title** **(** **)**
  138. The text displayed in the GraphNode's title bar.
  139. .. rst-class:: classref-section-separator
  140. ----
  141. .. rst-class:: classref-descriptions-group
  142. Method Descriptions
  143. -------------------
  144. .. _class_GraphNode_method__draw_port:
  145. .. rst-class:: classref-method
  146. void **_draw_port** **(** :ref:`int<class_int>` slot_index, :ref:`Vector2i<class_Vector2i>` position, :ref:`bool<class_bool>` left, :ref:`Color<class_Color>` color **)** |virtual|
  147. .. container:: contribute
  148. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  149. .. rst-class:: classref-item-separator
  150. ----
  151. .. _class_GraphNode_method_clear_all_slots:
  152. .. rst-class:: classref-method
  153. void **clear_all_slots** **(** **)**
  154. Disables all slots of the GraphNode. This will remove all input/output ports from the GraphNode.
  155. .. rst-class:: classref-item-separator
  156. ----
  157. .. _class_GraphNode_method_clear_slot:
  158. .. rst-class:: classref-method
  159. void **clear_slot** **(** :ref:`int<class_int>` slot_index **)**
  160. Disables the slot with the given ``slot_index``. This will remove the corresponding input and output port from the GraphNode.
  161. .. rst-class:: classref-item-separator
  162. ----
  163. .. _class_GraphNode_method_get_input_port_color:
  164. .. rst-class:: classref-method
  165. :ref:`Color<class_Color>` **get_input_port_color** **(** :ref:`int<class_int>` port_idx **)**
  166. Returns the :ref:`Color<class_Color>` of the input port with the given ``port_idx``.
  167. .. rst-class:: classref-item-separator
  168. ----
  169. .. _class_GraphNode_method_get_input_port_count:
  170. .. rst-class:: classref-method
  171. :ref:`int<class_int>` **get_input_port_count** **(** **)**
  172. Returns the number of slots with an enabled input port.
  173. .. rst-class:: classref-item-separator
  174. ----
  175. .. _class_GraphNode_method_get_input_port_position:
  176. .. rst-class:: classref-method
  177. :ref:`Vector2<class_Vector2>` **get_input_port_position** **(** :ref:`int<class_int>` port_idx **)**
  178. Returns the position of the input port with the given ``port_idx``.
  179. .. rst-class:: classref-item-separator
  180. ----
  181. .. _class_GraphNode_method_get_input_port_slot:
  182. .. rst-class:: classref-method
  183. :ref:`int<class_int>` **get_input_port_slot** **(** :ref:`int<class_int>` port_idx **)**
  184. Returns the corresponding slot index of the input port with the given ``port_idx``.
  185. .. rst-class:: classref-item-separator
  186. ----
  187. .. _class_GraphNode_method_get_input_port_type:
  188. .. rst-class:: classref-method
  189. :ref:`int<class_int>` **get_input_port_type** **(** :ref:`int<class_int>` port_idx **)**
  190. Returns the type of the input port with the given ``port_idx``.
  191. .. rst-class:: classref-item-separator
  192. ----
  193. .. _class_GraphNode_method_get_output_port_color:
  194. .. rst-class:: classref-method
  195. :ref:`Color<class_Color>` **get_output_port_color** **(** :ref:`int<class_int>` port_idx **)**
  196. Returns the :ref:`Color<class_Color>` of the output port with the given ``port_idx``.
  197. .. rst-class:: classref-item-separator
  198. ----
  199. .. _class_GraphNode_method_get_output_port_count:
  200. .. rst-class:: classref-method
  201. :ref:`int<class_int>` **get_output_port_count** **(** **)**
  202. Returns the number of slots with an enabled output port.
  203. .. rst-class:: classref-item-separator
  204. ----
  205. .. _class_GraphNode_method_get_output_port_position:
  206. .. rst-class:: classref-method
  207. :ref:`Vector2<class_Vector2>` **get_output_port_position** **(** :ref:`int<class_int>` port_idx **)**
  208. Returns the position of the output port with the given ``port_idx``.
  209. .. rst-class:: classref-item-separator
  210. ----
  211. .. _class_GraphNode_method_get_output_port_slot:
  212. .. rst-class:: classref-method
  213. :ref:`int<class_int>` **get_output_port_slot** **(** :ref:`int<class_int>` port_idx **)**
  214. Returns the corresponding slot index of the output port with the given ``port_idx``.
  215. .. rst-class:: classref-item-separator
  216. ----
  217. .. _class_GraphNode_method_get_output_port_type:
  218. .. rst-class:: classref-method
  219. :ref:`int<class_int>` **get_output_port_type** **(** :ref:`int<class_int>` port_idx **)**
  220. Returns the type of the output port with the given ``port_idx``.
  221. .. rst-class:: classref-item-separator
  222. ----
  223. .. _class_GraphNode_method_get_slot_color_left:
  224. .. rst-class:: classref-method
  225. :ref:`Color<class_Color>` **get_slot_color_left** **(** :ref:`int<class_int>` slot_index **)** |const|
  226. Returns the left (input) :ref:`Color<class_Color>` of the slot with the given ``slot_index``.
  227. .. rst-class:: classref-item-separator
  228. ----
  229. .. _class_GraphNode_method_get_slot_color_right:
  230. .. rst-class:: classref-method
  231. :ref:`Color<class_Color>` **get_slot_color_right** **(** :ref:`int<class_int>` slot_index **)** |const|
  232. Returns the right (output) :ref:`Color<class_Color>` of the slot with the given ``slot_index``.
  233. .. rst-class:: classref-item-separator
  234. ----
  235. .. _class_GraphNode_method_get_slot_type_left:
  236. .. rst-class:: classref-method
  237. :ref:`int<class_int>` **get_slot_type_left** **(** :ref:`int<class_int>` slot_index **)** |const|
  238. Returns the left (input) type of the slot with the given ``slot_index``.
  239. .. rst-class:: classref-item-separator
  240. ----
  241. .. _class_GraphNode_method_get_slot_type_right:
  242. .. rst-class:: classref-method
  243. :ref:`int<class_int>` **get_slot_type_right** **(** :ref:`int<class_int>` slot_index **)** |const|
  244. Returns the right (output) type of the slot with the given ``slot_index``.
  245. .. rst-class:: classref-item-separator
  246. ----
  247. .. _class_GraphNode_method_get_titlebar_hbox:
  248. .. rst-class:: classref-method
  249. :ref:`HBoxContainer<class_HBoxContainer>` **get_titlebar_hbox** **(** **)**
  250. Returns the :ref:`HBoxContainer<class_HBoxContainer>` used for the title bar, only containing a :ref:`Label<class_Label>` for displaying the title by default. This can be used to add custom controls to the title bar such as option or close buttons.
  251. .. rst-class:: classref-item-separator
  252. ----
  253. .. _class_GraphNode_method_is_slot_draw_stylebox:
  254. .. rst-class:: classref-method
  255. :ref:`bool<class_bool>` **is_slot_draw_stylebox** **(** :ref:`int<class_int>` slot_index **)** |const|
  256. Returns true if the background :ref:`StyleBox<class_StyleBox>` of the slot with the given ``slot_index`` is drawn.
  257. .. rst-class:: classref-item-separator
  258. ----
  259. .. _class_GraphNode_method_is_slot_enabled_left:
  260. .. rst-class:: classref-method
  261. :ref:`bool<class_bool>` **is_slot_enabled_left** **(** :ref:`int<class_int>` slot_index **)** |const|
  262. Returns ``true`` if left (input) side of the slot with the given ``slot_index`` is enabled.
  263. .. rst-class:: classref-item-separator
  264. ----
  265. .. _class_GraphNode_method_is_slot_enabled_right:
  266. .. rst-class:: classref-method
  267. :ref:`bool<class_bool>` **is_slot_enabled_right** **(** :ref:`int<class_int>` slot_index **)** |const|
  268. Returns ``true`` if right (output) side of the slot with the given ``slot_index`` is enabled.
  269. .. rst-class:: classref-item-separator
  270. ----
  271. .. _class_GraphNode_method_set_slot:
  272. .. rst-class:: classref-method
  273. void **set_slot** **(** :ref:`int<class_int>` slot_index, :ref:`bool<class_bool>` enable_left_port, :ref:`int<class_int>` type_left, :ref:`Color<class_Color>` color_left, :ref:`bool<class_bool>` enable_right_port, :ref:`int<class_int>` type_right, :ref:`Color<class_Color>` color_right, :ref:`Texture2D<class_Texture2D>` custom_icon_left=null, :ref:`Texture2D<class_Texture2D>` custom_icon_right=null, :ref:`bool<class_bool>` draw_stylebox=true **)**
  274. Sets properties of the slot with the given ``slot_index``.
  275. If ``enable_left_port``/``enable_right_port`` is ``true``, a port will appear and the slot will be able to be connected from this side.
  276. With ``type_left``/``type_right`` an arbitrary type can be assigned to each port. Two ports can be connected if they share the same type, or if the connection between their types is allowed in the parent :ref:`GraphEdit<class_GraphEdit>` (see :ref:`GraphEdit.add_valid_connection_type<class_GraphEdit_method_add_valid_connection_type>`). Keep in mind that the :ref:`GraphEdit<class_GraphEdit>` has the final say in accepting the connection. Type compatibility simply allows the :ref:`GraphEdit.connection_request<class_GraphEdit_signal_connection_request>` signal to be emitted.
  277. Ports can be further customized using ``color_left``/``color_right`` and ``custom_icon_left``/``custom_icon_right``. The color parameter adds a tint to the icon. The custom icon can be used to override the default port dot.
  278. Additionally, ``draw_stylebox`` can be used to enable or disable drawing of the background stylebox for each slot. See :ref:`slot<class_GraphNode_theme_style_slot>`.
  279. Individual properties can also be set using one of the ``set_slot_*`` methods.
  280. \ **Note:** This method only sets properties of the slot. To create the slot itself, add a :ref:`Control<class_Control>`-derived child to the GraphNode.
  281. .. rst-class:: classref-item-separator
  282. ----
  283. .. _class_GraphNode_method_set_slot_color_left:
  284. .. rst-class:: classref-method
  285. void **set_slot_color_left** **(** :ref:`int<class_int>` slot_index, :ref:`Color<class_Color>` color **)**
  286. Sets the :ref:`Color<class_Color>` of the left (input) side of the slot with the given ``slot_index`` to ``color``.
  287. .. rst-class:: classref-item-separator
  288. ----
  289. .. _class_GraphNode_method_set_slot_color_right:
  290. .. rst-class:: classref-method
  291. void **set_slot_color_right** **(** :ref:`int<class_int>` slot_index, :ref:`Color<class_Color>` color **)**
  292. Sets the :ref:`Color<class_Color>` of the right (output) side of the slot with the given ``slot_index`` to ``color``.
  293. .. rst-class:: classref-item-separator
  294. ----
  295. .. _class_GraphNode_method_set_slot_draw_stylebox:
  296. .. rst-class:: classref-method
  297. void **set_slot_draw_stylebox** **(** :ref:`int<class_int>` slot_index, :ref:`bool<class_bool>` enable **)**
  298. Toggles the background :ref:`StyleBox<class_StyleBox>` of the slot with the given ``slot_index``.
  299. .. rst-class:: classref-item-separator
  300. ----
  301. .. _class_GraphNode_method_set_slot_enabled_left:
  302. .. rst-class:: classref-method
  303. void **set_slot_enabled_left** **(** :ref:`int<class_int>` slot_index, :ref:`bool<class_bool>` enable **)**
  304. Toggles the left (input) side of the slot with the given ``slot_index``. If ``enable`` is ``true``, a port will appear on the left side and the slot will be able to be connected from this side.
  305. .. rst-class:: classref-item-separator
  306. ----
  307. .. _class_GraphNode_method_set_slot_enabled_right:
  308. .. rst-class:: classref-method
  309. void **set_slot_enabled_right** **(** :ref:`int<class_int>` slot_index, :ref:`bool<class_bool>` enable **)**
  310. Toggles the right (output) side of the slot with the given ``slot_index``. If ``enable`` is ``true``, a port will appear on the right side and the slot will be able to be connected from this side.
  311. .. rst-class:: classref-item-separator
  312. ----
  313. .. _class_GraphNode_method_set_slot_type_left:
  314. .. rst-class:: classref-method
  315. void **set_slot_type_left** **(** :ref:`int<class_int>` slot_index, :ref:`int<class_int>` type **)**
  316. Sets the left (input) type of the slot with the given ``slot_index`` to ``type``. If the value is negative, all connections will be disallowed to be created via user inputs.
  317. .. rst-class:: classref-item-separator
  318. ----
  319. .. _class_GraphNode_method_set_slot_type_right:
  320. .. rst-class:: classref-method
  321. void **set_slot_type_right** **(** :ref:`int<class_int>` slot_index, :ref:`int<class_int>` type **)**
  322. Sets the right (output) type of the slot with the given ``slot_index`` to ``type``. If the value is negative, all connections will be disallowed to be created via user inputs.
  323. .. rst-class:: classref-section-separator
  324. ----
  325. .. rst-class:: classref-descriptions-group
  326. Theme Property Descriptions
  327. ---------------------------
  328. .. _class_GraphNode_theme_color_resizer_color:
  329. .. rst-class:: classref-themeproperty
  330. :ref:`Color<class_Color>` **resizer_color** = ``Color(0.875, 0.875, 0.875, 1)``
  331. The color modulation applied to the resizer icon.
  332. .. rst-class:: classref-item-separator
  333. ----
  334. .. _class_GraphNode_theme_constant_port_h_offset:
  335. .. rst-class:: classref-themeproperty
  336. :ref:`int<class_int>` **port_h_offset** = ``0``
  337. Horizontal offset for the ports.
  338. .. rst-class:: classref-item-separator
  339. ----
  340. .. _class_GraphNode_theme_constant_separation:
  341. .. rst-class:: classref-themeproperty
  342. :ref:`int<class_int>` **separation** = ``2``
  343. The vertical distance between ports.
  344. .. rst-class:: classref-item-separator
  345. ----
  346. .. _class_GraphNode_theme_icon_port:
  347. .. rst-class:: classref-themeproperty
  348. :ref:`Texture2D<class_Texture2D>` **port**
  349. The icon used for representing ports.
  350. .. rst-class:: classref-item-separator
  351. ----
  352. .. _class_GraphNode_theme_icon_resizer:
  353. .. rst-class:: classref-themeproperty
  354. :ref:`Texture2D<class_Texture2D>` **resizer**
  355. The icon used for the resizer, visible when :ref:`GraphElement.resizable<class_GraphElement_property_resizable>` is enabled.
  356. .. rst-class:: classref-item-separator
  357. ----
  358. .. _class_GraphNode_theme_style_panel:
  359. .. rst-class:: classref-themeproperty
  360. :ref:`StyleBox<class_StyleBox>` **panel**
  361. The default background for the slot area of the **GraphNode**.
  362. .. rst-class:: classref-item-separator
  363. ----
  364. .. _class_GraphNode_theme_style_panel_selected:
  365. .. rst-class:: classref-themeproperty
  366. :ref:`StyleBox<class_StyleBox>` **panel_selected**
  367. The :ref:`StyleBox<class_StyleBox>` used for the slot area when selected.
  368. .. rst-class:: classref-item-separator
  369. ----
  370. .. _class_GraphNode_theme_style_slot:
  371. .. rst-class:: classref-themeproperty
  372. :ref:`StyleBox<class_StyleBox>` **slot**
  373. The :ref:`StyleBox<class_StyleBox>` used for each slot of the **GraphNode**.
  374. .. rst-class:: classref-item-separator
  375. ----
  376. .. _class_GraphNode_theme_style_titlebar:
  377. .. rst-class:: classref-themeproperty
  378. :ref:`StyleBox<class_StyleBox>` **titlebar**
  379. The :ref:`StyleBox<class_StyleBox>` used for the title bar of the **GraphNode**.
  380. .. rst-class:: classref-item-separator
  381. ----
  382. .. _class_GraphNode_theme_style_titlebar_selected:
  383. .. rst-class:: classref-themeproperty
  384. :ref:`StyleBox<class_StyleBox>` **titlebar_selected**
  385. The :ref:`StyleBox<class_StyleBox>` used for the title bar of the **GraphNode** when it is selected.
  386. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  387. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  388. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  389. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  390. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  391. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  392. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`