Godot
/
godot-docs
镜像来自 https://github.com/godotengine/godot-docs.git


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280
							:github_url: hide

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the EditorInterface.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.

.. _class_EditorInterface:

EditorInterface
===============

**Inherits:** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`

Godot editor's interface.

Description
-----------

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.

**Note:** This class shouldn't be instantiated directly. Instead, access the singleton using :ref:`EditorPlugin.get_editor_interface<class_EditorPlugin_method_get_editor_interface>`.

Properties
----------

+-------------------------+------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`distraction_free_mode<class_EditorInterface_property_distraction_free_mode>` |
+-------------------------+------------------------------------------------------------------------------------+

Methods
-------

+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                                      | :ref:`edit_resource<class_EditorInterface_method_edit_resource>` **(** :ref:`Resource<class_Resource>` resource **)**                                          |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Control<class_Control>`                             | :ref:`get_base_control<class_EditorInterface_method_get_base_control>` **(** **)**                                                                             |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>`                               | :ref:`get_current_path<class_EditorInterface_method_get_current_path>` **(** **)** const                                                                       |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Node<class_Node>`                                   | :ref:`get_edited_scene_root<class_EditorInterface_method_get_edited_scene_root>` **(** **)**                                                                   |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`EditorSettings<class_EditorSettings>`               | :ref:`get_editor_settings<class_EditorInterface_method_get_editor_settings>` **(** **)**                                                                       |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Control<class_Control>`                             | :ref:`get_editor_viewport<class_EditorInterface_method_get_editor_viewport>` **(** **)**                                                                       |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`FileSystemDock<class_FileSystemDock>`               | :ref:`get_file_system_dock<class_EditorInterface_method_get_file_system_dock>` **(** **)**                                                                     |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`EditorInspector<class_EditorInspector>`             | :ref:`get_inspector<class_EditorInterface_method_get_inspector>` **(** **)** const                                                                             |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Array<class_Array>`                                 | :ref:`get_open_scenes<class_EditorInterface_method_get_open_scenes>` **(** **)** const                                                                         |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`EditorFileSystem<class_EditorFileSystem>`           | :ref:`get_resource_filesystem<class_EditorInterface_method_get_resource_filesystem>` **(** **)**                                                               |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`EditorResourcePreview<class_EditorResourcePreview>` | :ref:`get_resource_previewer<class_EditorInterface_method_get_resource_previewer>` **(** **)**                                                                 |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`ScriptEditor<class_ScriptEditor>`                   | :ref:`get_script_editor<class_EditorInterface_method_get_script_editor>` **(** **)**                                                                           |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>`                               | :ref:`get_selected_path<class_EditorInterface_method_get_selected_path>` **(** **)** const                                                                     |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`EditorSelection<class_EditorSelection>`             | :ref:`get_selection<class_EditorInterface_method_get_selection>` **(** **)**                                                                                   |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                                      | :ref:`inspect_object<class_EditorInterface_method_inspect_object>` **(** :ref:`Object<class_Object>` object, :ref:`String<class_String>` for_property="" **)** |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`                                   | :ref:`is_plugin_enabled<class_EditorInterface_method_is_plugin_enabled>` **(** :ref:`String<class_String>` plugin **)** const                                  |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :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 **)**    |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                                      | :ref:`open_scene_from_path<class_EditorInterface_method_open_scene_from_path>` **(** :ref:`String<class_String>` scene_filepath **)**                          |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                                      | :ref:`reload_scene_from_path<class_EditorInterface_method_reload_scene_from_path>` **(** :ref:`String<class_String>` scene_filepath **)**                      |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Error<enum_@GlobalScope_Error>`                     | :ref:`save_scene<class_EditorInterface_method_save_scene>` **(** **)**                                                                                         |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                                      | :ref:`save_scene_as<class_EditorInterface_method_save_scene_as>` **(** :ref:`String<class_String>` path, :ref:`bool<class_bool>` with_preview=true **)**       |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                                      | :ref:`select_file<class_EditorInterface_method_select_file>` **(** :ref:`String<class_String>` file **)**                                                      |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                                      | :ref:`set_main_screen_editor<class_EditorInterface_method_set_main_screen_editor>` **(** :ref:`String<class_String>` name **)**                                |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                                      | :ref:`set_plugin_enabled<class_EditorInterface_method_set_plugin_enabled>` **(** :ref:`String<class_String>` plugin, :ref:`bool<class_bool>` enabled **)**     |
+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+

Property Descriptions
---------------------

.. _class_EditorInterface_property_distraction_free_mode:

- :ref:`bool<class_bool>` **distraction_free_mode**

+----------+------------------------------------+
| *Setter* | set_distraction_free_mode(value)   |
+----------+------------------------------------+
| *Getter* | is_distraction_free_mode_enabled() |
+----------+------------------------------------+

If ``true``, enables distraction-free mode which hides side docks to increase the space available for the main view.

Method Descriptions
-------------------

.. _class_EditorInterface_method_edit_resource:

- void **edit_resource** **(** :ref:`Resource<class_Resource>` resource **)**

Edits the given :ref:`Resource<class_Resource>`.

----

.. _class_EditorInterface_method_get_base_control:

- :ref:`Control<class_Control>` **get_base_control** **(** **)**

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.

----

.. _class_EditorInterface_method_get_current_path:

- :ref:`String<class_String>` **get_current_path** **(** **)** const

----

.. _class_EditorInterface_method_get_edited_scene_root:

- :ref:`Node<class_Node>` **get_edited_scene_root** **(** **)**

Returns the edited (current) scene's root :ref:`Node<class_Node>`.

----

.. _class_EditorInterface_method_get_editor_settings:

- :ref:`EditorSettings<class_EditorSettings>` **get_editor_settings** **(** **)**

Returns the :ref:`EditorSettings<class_EditorSettings>`.

----

.. _class_EditorInterface_method_get_editor_viewport:

- :ref:`Control<class_Control>` **get_editor_viewport** **(** **)**

Returns the editor :ref:`Viewport<class_Viewport>`.

----

.. _class_EditorInterface_method_get_file_system_dock:

- :ref:`FileSystemDock<class_FileSystemDock>` **get_file_system_dock** **(** **)**

----

.. _class_EditorInterface_method_get_inspector:

- :ref:`EditorInspector<class_EditorInspector>` **get_inspector** **(** **)** const

----

.. _class_EditorInterface_method_get_open_scenes:

- :ref:`Array<class_Array>` **get_open_scenes** **(** **)** const

Returns an :ref:`Array<class_Array>` with the file paths of the currently opened scenes.

----

.. _class_EditorInterface_method_get_resource_filesystem:

- :ref:`EditorFileSystem<class_EditorFileSystem>` **get_resource_filesystem** **(** **)**

Returns the :ref:`EditorFileSystem<class_EditorFileSystem>`.

----

.. _class_EditorInterface_method_get_resource_previewer:

- :ref:`EditorResourcePreview<class_EditorResourcePreview>` **get_resource_previewer** **(** **)**

Returns the :ref:`EditorResourcePreview<class_EditorResourcePreview>`.

----

.. _class_EditorInterface_method_get_script_editor:

- :ref:`ScriptEditor<class_ScriptEditor>` **get_script_editor** **(** **)**

Returns the :ref:`ScriptEditor<class_ScriptEditor>`.

----

.. _class_EditorInterface_method_get_selected_path:

- :ref:`String<class_String>` **get_selected_path** **(** **)** const

----

.. _class_EditorInterface_method_get_selection:

- :ref:`EditorSelection<class_EditorSelection>` **get_selection** **(** **)**

Returns the :ref:`EditorSelection<class_EditorSelection>`.

----

.. _class_EditorInterface_method_inspect_object:

- void **inspect_object** **(** :ref:`Object<class_Object>` object, :ref:`String<class_String>` for_property="" **)**

Shows the given property on the given ``object`` in the Editor's Inspector dock.

----

.. _class_EditorInterface_method_is_plugin_enabled:

- :ref:`bool<class_bool>` **is_plugin_enabled** **(** :ref:`String<class_String>` plugin **)** const

Returns the enabled status of a plugin. The plugin name is the same as its directory name.

----

.. _class_EditorInterface_method_make_mesh_previews:

- :ref:`Array<class_Array>` **make_mesh_previews** **(** :ref:`Array<class_Array>` meshes, :ref:`int<class_int>` preview_size **)**

Returns mesh previews rendered at the given size as an :ref:`Array<class_Array>` of :ref:`Texture<class_Texture>`\ s.

----

.. _class_EditorInterface_method_open_scene_from_path:

- void **open_scene_from_path** **(** :ref:`String<class_String>` scene_filepath **)**

Opens the scene at the given path.

----

.. _class_EditorInterface_method_reload_scene_from_path:

- void **reload_scene_from_path** **(** :ref:`String<class_String>` scene_filepath **)**

Reloads the scene at the given path.

----

.. _class_EditorInterface_method_save_scene:

- :ref:`Error<enum_@GlobalScope_Error>` **save_scene** **(** **)**

Saves the scene. Returns either ``OK`` or ``ERR_CANT_CREATE`` (see :ref:`@GlobalScope<class_@GlobalScope>` constants).

----

.. _class_EditorInterface_method_save_scene_as:

- void **save_scene_as** **(** :ref:`String<class_String>` path, :ref:`bool<class_bool>` with_preview=true **)**

Saves the scene as a file at ``path``.

----

.. _class_EditorInterface_method_select_file:

- void **select_file** **(** :ref:`String<class_String>` file **)**

Selects the file, with the path provided by ``file``, in the FileSystem dock.

----

.. _class_EditorInterface_method_set_main_screen_editor:

- void **set_main_screen_editor** **(** :ref:`String<class_String>` name **)**

----

.. _class_EditorInterface_method_set_plugin_enabled:

- void **set_plugin_enabled** **(** :ref:`String<class_String>` plugin, :ref:`bool<class_bool>` enabled **)**

Sets the enabled status of a plugin. The plugin name is the same as its directory name.