2014-02-10 02:10:30 +01:00
|
|
|
/*************************************************************************/
|
|
|
|
/* editor_plugin.h */
|
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
2017-08-27 14:16:55 +02:00
|
|
|
/* https://godotengine.org */
|
2014-02-10 02:10:30 +01:00
|
|
|
/*************************************************************************/
|
2019-01-01 12:53:14 +01:00
|
|
|
/* Copyright (c) 2007-2019 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* Copyright (c) 2014-2019 Godot Engine contributors (cf. AUTHORS.md) */
|
2014-02-10 02:10:30 +01:00
|
|
|
/* */
|
|
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
|
|
/* a copy of this software and associated documentation files (the */
|
|
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
|
|
/* the following conditions: */
|
|
|
|
/* */
|
|
|
|
/* The above copyright notice and this permission notice shall be */
|
|
|
|
/* included in all copies or substantial portions of the Software. */
|
|
|
|
/* */
|
|
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
|
|
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
|
|
/*************************************************************************/
|
2018-01-05 00:50:27 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
#ifndef EDITOR_PLUGIN_H
|
|
|
|
#define EDITOR_PLUGIN_H
|
|
|
|
|
2018-09-11 18:13:45 +02:00
|
|
|
#include "core/io/config_file.h"
|
|
|
|
#include "core/undo_redo.h"
|
2018-05-17 23:02:16 +02:00
|
|
|
#include "editor/editor_inspector.h"
|
2017-04-09 00:37:31 +02:00
|
|
|
#include "editor/import/editor_import_plugin.h"
|
2017-12-10 01:27:02 +01:00
|
|
|
#include "editor/import/resource_importer_scene.h"
|
2018-06-30 05:08:28 +02:00
|
|
|
#include "editor/script_create_dialog.h"
|
2016-07-24 21:16:02 +02:00
|
|
|
#include "scene/gui/tool_button.h"
|
2014-02-10 02:10:30 +01:00
|
|
|
#include "scene/main/node.h"
|
|
|
|
#include "scene/resources/texture.h"
|
2016-09-10 20:32:17 +02:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
/**
|
|
|
|
@author Juan Linietsky <reduzio@gmail.com>
|
|
|
|
*/
|
|
|
|
|
|
|
|
class EditorNode;
|
|
|
|
class Spatial;
|
|
|
|
class Camera;
|
2016-02-27 04:32:00 +01:00
|
|
|
class EditorSelection;
|
2017-02-20 03:19:30 +01:00
|
|
|
class EditorExport;
|
2016-02-27 04:32:00 +01:00
|
|
|
class EditorSettings;
|
2016-02-28 03:10:44 +01:00
|
|
|
class EditorImportPlugin;
|
|
|
|
class EditorExportPlugin;
|
2018-10-29 11:30:28 +01:00
|
|
|
class EditorSpatialGizmoPlugin;
|
2016-09-10 20:32:17 +02:00
|
|
|
class EditorResourcePreview;
|
2016-09-10 22:34:27 +02:00
|
|
|
class EditorFileSystem;
|
2017-07-06 09:18:20 +02:00
|
|
|
class EditorToolAddons;
|
|
|
|
class ScriptEditor;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-08-26 15:32:15 +02:00
|
|
|
class EditorInterface : public Node {
|
2019-03-19 19:35:57 +01:00
|
|
|
GDCLASS(EditorInterface, Node);
|
|
|
|
|
2017-08-26 15:32:15 +02:00
|
|
|
protected:
|
|
|
|
static void _bind_methods();
|
|
|
|
static EditorInterface *singleton;
|
|
|
|
|
2017-08-28 05:03:34 +02:00
|
|
|
Array _make_mesh_previews(const Array &p_meshes, int p_preview_size);
|
|
|
|
|
2017-08-26 15:32:15 +02:00
|
|
|
public:
|
|
|
|
static EditorInterface *get_singleton() { return singleton; }
|
|
|
|
|
|
|
|
Control *get_editor_viewport();
|
|
|
|
void edit_resource(const Ref<Resource> &p_resource);
|
|
|
|
void open_scene_from_path(const String &scene_path);
|
|
|
|
void reload_scene_from_path(const String &scene_path);
|
|
|
|
|
|
|
|
Node *get_edited_scene_root();
|
|
|
|
Array get_open_scenes() const;
|
|
|
|
ScriptEditor *get_script_editor();
|
|
|
|
|
2017-12-20 21:44:16 +01:00
|
|
|
void select_file(const String &p_file);
|
|
|
|
String get_selected_path() const;
|
|
|
|
|
2017-08-26 15:32:15 +02:00
|
|
|
void inspect_object(Object *p_obj, const String &p_for_property = String());
|
|
|
|
|
|
|
|
EditorSelection *get_selection();
|
|
|
|
//EditorImportExport *get_import_export();
|
2019-07-03 09:49:46 +02:00
|
|
|
Ref<EditorSettings> get_editor_settings();
|
2017-08-26 15:32:15 +02:00
|
|
|
EditorResourcePreview *get_resource_previewer();
|
|
|
|
EditorFileSystem *get_resource_file_system();
|
|
|
|
|
|
|
|
Control *get_base_control();
|
|
|
|
|
2018-01-30 23:11:07 +01:00
|
|
|
void set_plugin_enabled(const String &p_plugin, bool p_enabled);
|
|
|
|
bool is_plugin_enabled(const String &p_plugin) const;
|
|
|
|
|
2019-03-12 07:43:48 +01:00
|
|
|
EditorInspector *get_inspector() const;
|
|
|
|
|
2017-08-26 15:32:15 +02:00
|
|
|
Error save_scene();
|
|
|
|
void save_scene_as(const String &p_scene, bool p_with_preview = true);
|
|
|
|
|
2019-06-26 15:08:25 +02:00
|
|
|
Vector<Ref<Texture> > make_mesh_previews(const Vector<Ref<Mesh> > &p_meshes, Vector<Transform> *p_transforms, int p_preview_size);
|
2017-08-28 05:03:34 +02:00
|
|
|
|
2017-08-26 15:32:15 +02:00
|
|
|
EditorInterface();
|
|
|
|
};
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
class EditorPlugin : public Node {
|
2016-03-09 00:00:52 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
GDCLASS(EditorPlugin, Node);
|
|
|
|
friend class EditorData;
|
2014-02-10 02:10:30 +01:00
|
|
|
UndoRedo *undo_redo;
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
UndoRedo *_get_undo_redo() { return undo_redo; }
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-06-08 19:57:35 +02:00
|
|
|
bool input_event_forwarding_always_enabled;
|
2017-10-29 20:32:09 +01:00
|
|
|
bool force_draw_over_forwarding_enabled;
|
2017-06-08 19:57:35 +02:00
|
|
|
|
2017-07-06 09:18:20 +02:00
|
|
|
String last_main_screen_name;
|
2018-07-19 17:34:22 +02:00
|
|
|
String _dir_cache;
|
2017-07-06 09:18:20 +02:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
protected:
|
|
|
|
static void _bind_methods();
|
2017-03-05 16:44:50 +01:00
|
|
|
UndoRedo &get_undo_redo() { return *undo_redo; }
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
void add_custom_type(const String &p_type, const String &p_base, const Ref<Script> &p_script, const Ref<Texture> &p_icon);
|
|
|
|
void remove_custom_type(const String &p_type);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
public:
|
|
|
|
enum CustomControlContainer {
|
|
|
|
CONTAINER_TOOLBAR,
|
|
|
|
CONTAINER_SPATIAL_EDITOR_MENU,
|
2018-08-21 06:35:48 +02:00
|
|
|
CONTAINER_SPATIAL_EDITOR_SIDE_LEFT,
|
|
|
|
CONTAINER_SPATIAL_EDITOR_SIDE_RIGHT,
|
2014-02-10 02:10:30 +01:00
|
|
|
CONTAINER_SPATIAL_EDITOR_BOTTOM,
|
|
|
|
CONTAINER_CANVAS_EDITOR_MENU,
|
2018-08-21 06:35:48 +02:00
|
|
|
CONTAINER_CANVAS_EDITOR_SIDE_LEFT,
|
|
|
|
CONTAINER_CANVAS_EDITOR_SIDE_RIGHT,
|
2016-05-23 22:10:26 +02:00
|
|
|
CONTAINER_CANVAS_EDITOR_BOTTOM,
|
2019-05-27 22:33:52 +02:00
|
|
|
CONTAINER_PROPERTY_EDITOR_BOTTOM,
|
|
|
|
CONTAINER_PROJECT_SETTING_TAB_LEFT,
|
|
|
|
CONTAINER_PROJECT_SETTING_TAB_RIGHT,
|
2014-02-10 02:10:30 +01:00
|
|
|
};
|
|
|
|
|
2016-02-28 03:10:44 +01:00
|
|
|
enum DockSlot {
|
|
|
|
DOCK_SLOT_LEFT_UL,
|
|
|
|
DOCK_SLOT_LEFT_BL,
|
|
|
|
DOCK_SLOT_LEFT_UR,
|
|
|
|
DOCK_SLOT_LEFT_BR,
|
|
|
|
DOCK_SLOT_RIGHT_UL,
|
|
|
|
DOCK_SLOT_RIGHT_BL,
|
|
|
|
DOCK_SLOT_RIGHT_UR,
|
|
|
|
DOCK_SLOT_RIGHT_BR,
|
|
|
|
DOCK_SLOT_MAX
|
|
|
|
};
|
|
|
|
|
2017-08-08 07:02:49 +02:00
|
|
|
//TODO: send a resource for editing to the editor node?
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2016-02-27 04:32:00 +01:00
|
|
|
void add_control_to_container(CustomControlContainer p_location, Control *p_control);
|
2018-02-13 22:21:19 +01:00
|
|
|
void remove_control_from_container(CustomControlContainer p_location, Control *p_control);
|
2016-07-24 21:16:02 +02:00
|
|
|
ToolButton *add_control_to_bottom_panel(Control *p_control, const String &p_title);
|
2017-03-05 16:44:50 +01:00
|
|
|
void add_control_to_dock(DockSlot p_slot, Control *p_control);
|
2016-02-28 03:10:44 +01:00
|
|
|
void remove_control_from_docks(Control *p_control);
|
2016-02-28 20:58:17 +01:00
|
|
|
void remove_control_from_bottom_panel(Control *p_control);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
void add_tool_menu_item(const String &p_name, Object *p_handler, const String &p_callback, const Variant &p_ud = Variant());
|
|
|
|
void add_tool_submenu_item(const String &p_name, Object *p_submenu);
|
|
|
|
void remove_tool_menu_item(const String &p_name);
|
2016-08-07 16:01:22 +02:00
|
|
|
|
2017-06-08 19:57:35 +02:00
|
|
|
void set_input_event_forwarding_always_enabled();
|
|
|
|
bool is_input_event_forwarding_always_enabled() { return input_event_forwarding_always_enabled; }
|
|
|
|
|
2017-10-29 20:32:09 +01:00
|
|
|
void set_force_draw_over_forwarding_enabled();
|
|
|
|
bool is_force_draw_over_forwarding_enabled() { return force_draw_over_forwarding_enabled; }
|
|
|
|
|
2017-07-06 09:18:20 +02:00
|
|
|
void notify_main_screen_changed(const String &screen_name);
|
|
|
|
void notify_scene_changed(const Node *scn_root);
|
|
|
|
void notify_scene_closed(const String &scene_filepath);
|
2018-01-12 22:43:29 +01:00
|
|
|
void notify_resource_saved(const Ref<Resource> &p_resource);
|
2017-07-06 09:18:20 +02:00
|
|
|
|
2017-10-15 22:33:25 +02:00
|
|
|
virtual bool forward_canvas_gui_input(const Ref<InputEvent> &p_event);
|
2018-09-18 20:00:07 +02:00
|
|
|
virtual void forward_canvas_draw_over_viewport(Control *p_overlay);
|
|
|
|
virtual void forward_canvas_force_draw_over_viewport(Control *p_overlay);
|
|
|
|
|
2017-05-20 17:38:03 +02:00
|
|
|
virtual bool forward_spatial_gui_input(Camera *p_camera, const Ref<InputEvent> &p_event);
|
2018-09-18 20:00:07 +02:00
|
|
|
virtual void forward_spatial_draw_over_viewport(Control *p_overlay);
|
|
|
|
virtual void forward_spatial_force_draw_over_viewport(Control *p_overlay);
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
virtual String get_name() const;
|
2017-12-06 23:27:45 +01:00
|
|
|
virtual const Ref<Texture> get_icon() const;
|
2014-02-10 02:10:30 +01:00
|
|
|
virtual bool has_main_screen() const;
|
|
|
|
virtual void make_visible(bool p_visible);
|
2017-03-05 16:44:50 +01:00
|
|
|
virtual void selected_notify() {} //notify that it was raised by the user, not the editor
|
2014-02-10 02:10:30 +01:00
|
|
|
virtual void edit(Object *p_object);
|
2017-08-12 18:52:50 +02:00
|
|
|
virtual bool handles(Object *p_object) const;
|
2014-02-10 02:10:30 +01:00
|
|
|
virtual Dictionary get_state() const; //save editor state so it can't be reloaded when reloading scene
|
2017-03-05 16:44:50 +01:00
|
|
|
virtual void set_state(const Dictionary &p_state); //restore editor state (likely was saved with the scene)
|
2018-01-18 21:37:17 +01:00
|
|
|
virtual void clear(); // clear any temporary data in the editor, reset it (likely new scene or load another scene)
|
2017-03-05 16:44:50 +01:00
|
|
|
virtual void save_external_data(); // if editor references external resources/scenes, save them
|
|
|
|
virtual void apply_changes(); // if changes are pending in editor, apply them
|
2014-02-10 02:10:30 +01:00
|
|
|
virtual void get_breakpoints(List<String> *p_breakpoints);
|
2017-03-05 16:44:50 +01:00
|
|
|
virtual bool get_remove_list(List<Node *> *p_list);
|
2015-06-22 05:03:19 +02:00
|
|
|
virtual void set_window_layout(Ref<ConfigFile> p_layout);
|
|
|
|
virtual void get_window_layout(Ref<ConfigFile> p_layout);
|
2017-03-05 16:44:50 +01:00
|
|
|
virtual void edited_scene_changed() {} // if changes are pending in editor, apply them
|
2018-01-08 16:55:22 +01:00
|
|
|
virtual bool build(); // builds with external tools. Returns true if safe to continue running scene.
|
2016-09-10 19:44:28 +02:00
|
|
|
|
2017-08-26 15:32:15 +02:00
|
|
|
EditorInterface *get_editor_interface();
|
2018-06-30 05:08:28 +02:00
|
|
|
ScriptCreateDialog *get_script_create_dialog();
|
2016-09-10 19:44:28 +02:00
|
|
|
|
2017-10-29 20:32:09 +01:00
|
|
|
int update_overlays() const;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2016-08-15 19:49:58 +02:00
|
|
|
void queue_save_layout() const;
|
2016-02-27 04:32:00 +01:00
|
|
|
|
2016-09-17 16:59:12 +02:00
|
|
|
void make_bottom_panel_item_visible(Control *p_item);
|
|
|
|
void hide_bottom_panel();
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
virtual void restore_global_state();
|
|
|
|
virtual void save_global_state();
|
|
|
|
|
2017-04-09 00:37:31 +02:00
|
|
|
void add_import_plugin(const Ref<EditorImportPlugin> &p_importer);
|
2017-06-11 11:18:22 +02:00
|
|
|
void remove_import_plugin(const Ref<EditorImportPlugin> &p_importer);
|
2017-04-09 00:37:31 +02:00
|
|
|
|
2017-09-15 00:38:38 +02:00
|
|
|
void add_export_plugin(const Ref<EditorExportPlugin> &p_exporter);
|
|
|
|
void remove_export_plugin(const Ref<EditorExportPlugin> &p_exporter);
|
|
|
|
|
2018-10-29 11:30:28 +01:00
|
|
|
void add_spatial_gizmo_plugin(const Ref<EditorSpatialGizmoPlugin> &p_gizmo_plugin);
|
|
|
|
void remove_spatial_gizmo_plugin(const Ref<EditorSpatialGizmoPlugin> &p_gizmo_plugin);
|
|
|
|
|
2018-05-17 23:02:16 +02:00
|
|
|
void add_inspector_plugin(const Ref<EditorInspectorPlugin> &p_plugin);
|
|
|
|
void remove_inspector_plugin(const Ref<EditorInspectorPlugin> &p_plugin);
|
|
|
|
|
2017-12-07 19:44:20 +01:00
|
|
|
void add_scene_import_plugin(const Ref<EditorSceneImporter> &p_importer);
|
|
|
|
void remove_scene_import_plugin(const Ref<EditorSceneImporter> &p_importer);
|
|
|
|
|
2018-02-14 05:31:38 +01:00
|
|
|
void add_autoload_singleton(const String &p_name, const String &p_path);
|
|
|
|
void remove_autoload_singleton(const String &p_name);
|
|
|
|
|
2018-07-19 17:34:22 +02:00
|
|
|
void set_dir_cache(const String &p_dir) { _dir_cache = p_dir; }
|
|
|
|
String get_dir_cache() { return _dir_cache; }
|
|
|
|
Ref<ConfigFile> get_config();
|
|
|
|
|
2018-06-11 02:59:53 +02:00
|
|
|
void enable_plugin();
|
|
|
|
void disable_plugin();
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
EditorPlugin();
|
|
|
|
virtual ~EditorPlugin();
|
|
|
|
};
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
VARIANT_ENUM_CAST(EditorPlugin::CustomControlContainer);
|
|
|
|
VARIANT_ENUM_CAST(EditorPlugin::DockSlot);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
typedef EditorPlugin *(*EditorPluginCreateFunc)(EditorNode *);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
class EditorPlugins {
|
|
|
|
|
|
|
|
enum {
|
2017-03-05 16:44:50 +01:00
|
|
|
MAX_CREATE_FUNCS = 64
|
2014-02-10 02:10:30 +01:00
|
|
|
};
|
|
|
|
|
|
|
|
static EditorPluginCreateFunc creation_funcs[MAX_CREATE_FUNCS];
|
|
|
|
static int creation_func_count;
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
template <class T>
|
2014-02-10 02:10:30 +01:00
|
|
|
static EditorPlugin *creator(EditorNode *p_node) {
|
2017-03-05 16:44:50 +01:00
|
|
|
return memnew(T(p_node));
|
2014-02-10 02:10:30 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
public:
|
|
|
|
static int get_plugin_count() { return creation_func_count; }
|
2017-03-05 16:44:50 +01:00
|
|
|
static EditorPlugin *create(int p_idx, EditorNode *p_editor) {
|
|
|
|
ERR_FAIL_INDEX_V(p_idx, creation_func_count, NULL);
|
|
|
|
return creation_funcs[p_idx](p_editor);
|
|
|
|
}
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
template <class T>
|
2014-02-10 02:10:30 +01:00
|
|
|
static void add_by_type() {
|
|
|
|
add_create_func(creator<T>);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void add_create_func(EditorPluginCreateFunc p_func) {
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
ERR_FAIL_COND(creation_func_count >= MAX_CREATE_FUNCS);
|
|
|
|
creation_funcs[creation_func_count++] = p_func;
|
2014-02-10 02:10:30 +01:00
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|