class_editorinterface.rst 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235
  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 EditorInterface.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_EditorInterface:
  6. EditorInterface
  7. ===============
  8. **Inherits:** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  9. **Category:** Core
  10. Brief Description
  11. -----------------
  12. Godot editor's interface.
  13. Methods
  14. -------
  15. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  16. | void | :ref:`edit_resource<class_EditorInterface_method_edit_resource>` **(** :ref:`Resource<class_Resource>` resource **)** |
  17. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  18. | :ref:`Control<class_Control>` | :ref:`get_base_control<class_EditorInterface_method_get_base_control>` **(** **)** |
  19. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  20. | :ref:`Node<class_Node>` | :ref:`get_edited_scene_root<class_EditorInterface_method_get_edited_scene_root>` **(** **)** |
  21. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  22. | :ref:`EditorSettings<class_EditorSettings>` | :ref:`get_editor_settings<class_EditorInterface_method_get_editor_settings>` **(** **)** |
  23. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  24. | :ref:`Control<class_Control>` | :ref:`get_editor_viewport<class_EditorInterface_method_get_editor_viewport>` **(** **)** |
  25. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  26. | :ref:`EditorInspector<class_EditorInspector>` | :ref:`get_inspector<class_EditorInterface_method_get_inspector>` **(** **)** const |
  27. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  28. | :ref:`Array<class_Array>` | :ref:`get_open_scenes<class_EditorInterface_method_get_open_scenes>` **(** **)** const |
  29. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  30. | :ref:`EditorFileSystem<class_EditorFileSystem>` | :ref:`get_resource_filesystem<class_EditorInterface_method_get_resource_filesystem>` **(** **)** |
  31. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  32. | :ref:`EditorResourcePreview<class_EditorResourcePreview>` | :ref:`get_resource_previewer<class_EditorInterface_method_get_resource_previewer>` **(** **)** |
  33. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  34. | :ref:`ScriptEditor<class_ScriptEditor>` | :ref:`get_script_editor<class_EditorInterface_method_get_script_editor>` **(** **)** |
  35. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  36. | :ref:`String<class_String>` | :ref:`get_selected_path<class_EditorInterface_method_get_selected_path>` **(** **)** const |
  37. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  38. | :ref:`EditorSelection<class_EditorSelection>` | :ref:`get_selection<class_EditorInterface_method_get_selection>` **(** **)** |
  39. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  40. | void | :ref:`inspect_object<class_EditorInterface_method_inspect_object>` **(** :ref:`Object<class_Object>` object, :ref:`String<class_String>` for_property="" **)** |
  41. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  42. | :ref:`bool<class_bool>` | :ref:`is_plugin_enabled<class_EditorInterface_method_is_plugin_enabled>` **(** :ref:`String<class_String>` plugin **)** const |
  43. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`Array<class_Array>` | :ref:`make_mesh_previews<class_EditorInterface_method_make_mesh_previews>` **(** :ref:`Array<class_Array>` meshes, :ref:`int<class_int>` preview_size **)** |
  45. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  46. | void | :ref:`open_scene_from_path<class_EditorInterface_method_open_scene_from_path>` **(** :ref:`String<class_String>` scene_filepath **)** |
  47. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  48. | void | :ref:`reload_scene_from_path<class_EditorInterface_method_reload_scene_from_path>` **(** :ref:`String<class_String>` scene_filepath **)** |
  49. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  50. | :ref:`Error<enum_@GlobalScope_Error>` | :ref:`save_scene<class_EditorInterface_method_save_scene>` **(** **)** |
  51. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  52. | void | :ref:`save_scene_as<class_EditorInterface_method_save_scene_as>` **(** :ref:`String<class_String>` path, :ref:`bool<class_bool>` with_preview=true **)** |
  53. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  54. | void | :ref:`select_file<class_EditorInterface_method_select_file>` **(** :ref:`String<class_String>` file **)** |
  55. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  56. | void | :ref:`set_plugin_enabled<class_EditorInterface_method_set_plugin_enabled>` **(** :ref:`String<class_String>` plugin, :ref:`bool<class_bool>` enabled **)** |
  57. +-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
  58. Description
  59. -----------
  60. EditorInterface gives you control over Godot editor's window. It allows customizing the window, saving and (re-)loading scenes, rendering mesh previews, inspecting and editing resources and objects, and provides access to :ref:`EditorSettings<class_EditorSettings>`, :ref:`EditorFileSystem<class_EditorFileSystem>`, :ref:`EditorResourcePreview<class_EditorResourcePreview>`, :ref:`ScriptEditor<class_ScriptEditor>`, the editor viewport, and information about scenes.
  61. Method Descriptions
  62. -------------------
  63. .. _class_EditorInterface_method_edit_resource:
  64. - void **edit_resource** **(** :ref:`Resource<class_Resource>` resource **)**
  65. Edits the given :ref:`Resource<class_Resource>`.
  66. ----
  67. .. _class_EditorInterface_method_get_base_control:
  68. - :ref:`Control<class_Control>` **get_base_control** **(** **)**
  69. Returns the main container of Godot editor's window. You can use it, for example, to retrieve the size of the container and place your controls accordingly.
  70. ----
  71. .. _class_EditorInterface_method_get_edited_scene_root:
  72. - :ref:`Node<class_Node>` **get_edited_scene_root** **(** **)**
  73. Returns the edited (current) scene's root :ref:`Node<class_Node>`.
  74. ----
  75. .. _class_EditorInterface_method_get_editor_settings:
  76. - :ref:`EditorSettings<class_EditorSettings>` **get_editor_settings** **(** **)**
  77. Returns the :ref:`EditorSettings<class_EditorSettings>`.
  78. ----
  79. .. _class_EditorInterface_method_get_editor_viewport:
  80. - :ref:`Control<class_Control>` **get_editor_viewport** **(** **)**
  81. Returns the editor :ref:`Viewport<class_Viewport>`.
  82. ----
  83. .. _class_EditorInterface_method_get_inspector:
  84. - :ref:`EditorInspector<class_EditorInspector>` **get_inspector** **(** **)** const
  85. ----
  86. .. _class_EditorInterface_method_get_open_scenes:
  87. - :ref:`Array<class_Array>` **get_open_scenes** **(** **)** const
  88. Returns an :ref:`Array<class_Array>` with the file paths of the currently opened scenes.
  89. ----
  90. .. _class_EditorInterface_method_get_resource_filesystem:
  91. - :ref:`EditorFileSystem<class_EditorFileSystem>` **get_resource_filesystem** **(** **)**
  92. Returns the :ref:`EditorFileSystem<class_EditorFileSystem>`.
  93. ----
  94. .. _class_EditorInterface_method_get_resource_previewer:
  95. - :ref:`EditorResourcePreview<class_EditorResourcePreview>` **get_resource_previewer** **(** **)**
  96. Returns the :ref:`EditorResourcePreview<class_EditorResourcePreview>`.
  97. ----
  98. .. _class_EditorInterface_method_get_script_editor:
  99. - :ref:`ScriptEditor<class_ScriptEditor>` **get_script_editor** **(** **)**
  100. Returns the :ref:`ScriptEditor<class_ScriptEditor>`.
  101. ----
  102. .. _class_EditorInterface_method_get_selected_path:
  103. - :ref:`String<class_String>` **get_selected_path** **(** **)** const
  104. ----
  105. .. _class_EditorInterface_method_get_selection:
  106. - :ref:`EditorSelection<class_EditorSelection>` **get_selection** **(** **)**
  107. Returns the :ref:`EditorSelection<class_EditorSelection>`.
  108. ----
  109. .. _class_EditorInterface_method_inspect_object:
  110. - void **inspect_object** **(** :ref:`Object<class_Object>` object, :ref:`String<class_String>` for_property="" **)**
  111. Shows the given property on the given ``object`` in the Editor's Inspector dock.
  112. ----
  113. .. _class_EditorInterface_method_is_plugin_enabled:
  114. - :ref:`bool<class_bool>` **is_plugin_enabled** **(** :ref:`String<class_String>` plugin **)** const
  115. Returns the enabled status of a plugin. The plugin name is the same as its directory name.
  116. ----
  117. .. _class_EditorInterface_method_make_mesh_previews:
  118. - :ref:`Array<class_Array>` **make_mesh_previews** **(** :ref:`Array<class_Array>` meshes, :ref:`int<class_int>` preview_size **)**
  119. Returns mesh previews rendered at the given size as an :ref:`Array<class_Array>` of :ref:`Texture<class_Texture>`\ s.
  120. ----
  121. .. _class_EditorInterface_method_open_scene_from_path:
  122. - void **open_scene_from_path** **(** :ref:`String<class_String>` scene_filepath **)**
  123. Opens the scene at the given path.
  124. ----
  125. .. _class_EditorInterface_method_reload_scene_from_path:
  126. - void **reload_scene_from_path** **(** :ref:`String<class_String>` scene_filepath **)**
  127. Reloads the scene at the given path.
  128. ----
  129. .. _class_EditorInterface_method_save_scene:
  130. - :ref:`Error<enum_@GlobalScope_Error>` **save_scene** **(** **)**
  131. Saves the scene. Returns either OK or ERR_CANT_CREATE. See :ref:`@GlobalScope<class_@GlobalScope>` constants.
  132. ----
  133. .. _class_EditorInterface_method_save_scene_as:
  134. - void **save_scene_as** **(** :ref:`String<class_String>` path, :ref:`bool<class_bool>` with_preview=true **)**
  135. Saves the scene as a file at ``path``.
  136. ----
  137. .. _class_EditorInterface_method_select_file:
  138. - void **select_file** **(** :ref:`String<class_String>` file **)**
  139. ----
  140. .. _class_EditorInterface_method_set_plugin_enabled:
  141. - void **set_plugin_enabled** **(** :ref:`String<class_String>` plugin, :ref:`bool<class_bool>` enabled **)**
  142. Sets the enabled status of a plugin. The plugin name is the same as its directory name.