Path: blob/master/editor/scene/3d/node_3d_editor_plugin.h
21102 views
/**************************************************************************/1/* node_3d_editor_plugin.h */2/**************************************************************************/3/* This file is part of: */4/* GODOT ENGINE */5/* https://godotengine.org */6/**************************************************************************/7/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */8/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */9/* */10/* Permission is hereby granted, free of charge, to any person obtaining */11/* a copy of this software and associated documentation files (the */12/* "Software"), to deal in the Software without restriction, including */13/* without limitation the rights to use, copy, modify, merge, publish, */14/* distribute, sublicense, and/or sell copies of the Software, and to */15/* permit persons to whom the Software is furnished to do so, subject to */16/* the following conditions: */17/* */18/* The above copyright notice and this permission notice shall be */19/* included in all copies or substantial portions of the Software. */20/* */21/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */22/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */23/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */24/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */25/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */26/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */27/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */28/**************************************************************************/2930#pragma once3132#include "core/math/dynamic_bvh.h"33#include "editor/plugins/editor_plugin.h"34#include "editor/scene/3d/node_3d_editor_gizmos.h"35#include "editor/themes/editor_scale.h"36#include "scene/gui/box_container.h"37#include "scene/gui/button.h"38#include "scene/gui/spin_box.h"39#include "scene/resources/gradient.h"40#include "scene/resources/immediate_mesh.h"4142class AcceptDialog;43class CheckBox;44class ColorPickerButton;45class ConfirmationDialog;46class DirectionalLight3D;47class EditorData;48class EditorSelection;49class EditorSpinSlider;50class HSplitContainer;51class LineEdit;52class MenuButton;53class Node3DEditor;54class Node3DEditorViewport;55class OptionButton;56class PanelContainer;57class ProceduralSkyMaterial;58class SubViewport;59class SubViewportContainer;60class VSeparator;61class VSplitContainer;62class ViewportNavigationControl;63class WorldEnvironment;64class MeshInstance3D;6566class ViewportRotationControl : public Control {67GDCLASS(ViewportRotationControl, Control);6869struct Axis2D {70Vector2 screen_point;71float z_axis = -99.0;72int axis = -1;73bool is_positive = true;74};7576struct Axis2DCompare {77_FORCE_INLINE_ bool operator()(const Axis2D &l, const Axis2D &r) const {78return l.z_axis < r.z_axis;79}80};8182Node3DEditorViewport *viewport = nullptr;83Vector<Color> axis_colors;84Vector<int> axis_menu_options;85Vector2i orbiting_mouse_start;86Point2 original_mouse_pos;87int orbiting_index = -1;88int focused_axis = -2;89bool gizmo_activated = false;9091const float AXIS_CIRCLE_RADIUS = 8.0f * EDSCALE;9293protected:94void _notification(int p_what);95virtual void gui_input(const Ref<InputEvent> &p_event) override;96void _draw();97void _draw_axis(const Axis2D &p_axis);98void _get_sorted_axis(Vector<Axis2D> &r_axis);99void _update_focus();100void _process_click(int p_index, Vector2 p_position, bool p_pressed);101void _process_drag(Ref<InputEventWithModifiers> p_event, int p_index, Vector2 p_position, Vector2 p_relative_position);102103public:104void set_viewport(Node3DEditorViewport *p_viewport);105};106107class Node3DEditorViewport : public Control {108GDCLASS(Node3DEditorViewport, Control);109friend class Node3DEditor;110friend class ViewportNavigationControl;111friend class ViewportRotationControl;112enum {113VIEW_TOP,114VIEW_BOTTOM,115VIEW_LEFT,116VIEW_RIGHT,117VIEW_FRONT,118VIEW_REAR,119VIEW_CENTER_TO_ORIGIN,120VIEW_CENTER_TO_SELECTION,121VIEW_ALIGN_TRANSFORM_WITH_VIEW,122VIEW_ALIGN_ROTATION_WITH_VIEW,123VIEW_PERSPECTIVE,124VIEW_ENVIRONMENT,125VIEW_ORTHOGONAL,126VIEW_SWITCH_PERSPECTIVE_ORTHOGONAL,127VIEW_HALF_RESOLUTION,128VIEW_AUDIO_LISTENER,129VIEW_AUDIO_DOPPLER,130VIEW_GIZMOS,131VIEW_TRANSFORM_GIZMO,132VIEW_GRID,133VIEW_INFORMATION,134VIEW_FRAME_TIME,135136// < Keep in sync with menu.137VIEW_DISPLAY_NORMAL,138VIEW_DISPLAY_WIREFRAME,139VIEW_DISPLAY_OVERDRAW,140VIEW_DISPLAY_LIGHTING,141VIEW_DISPLAY_UNSHADED,142VIEW_DISPLAY_ADVANCED,143// Advanced menu:144VIEW_DISPLAY_DEBUG_PSSM_SPLITS,145VIEW_DISPLAY_NORMAL_BUFFER,146VIEW_DISPLAY_DEBUG_SHADOW_ATLAS,147VIEW_DISPLAY_DEBUG_DIRECTIONAL_SHADOW_ATLAS,148VIEW_DISPLAY_DEBUG_DECAL_ATLAS,149VIEW_DISPLAY_DEBUG_VOXEL_GI_ALBEDO,150VIEW_DISPLAY_DEBUG_VOXEL_GI_LIGHTING,151VIEW_DISPLAY_DEBUG_VOXEL_GI_EMISSION,152VIEW_DISPLAY_DEBUG_SDFGI,153VIEW_DISPLAY_DEBUG_SDFGI_PROBES,154VIEW_DISPLAY_DEBUG_SCENE_LUMINANCE,155VIEW_DISPLAY_DEBUG_SSAO,156VIEW_DISPLAY_DEBUG_SSIL,157VIEW_DISPLAY_DEBUG_GI_BUFFER,158VIEW_DISPLAY_DEBUG_DISABLE_LOD,159VIEW_DISPLAY_DEBUG_CLUSTER_OMNI_LIGHTS,160VIEW_DISPLAY_DEBUG_CLUSTER_SPOT_LIGHTS,161VIEW_DISPLAY_DEBUG_CLUSTER_DECALS,162VIEW_DISPLAY_DEBUG_CLUSTER_REFLECTION_PROBES,163VIEW_DISPLAY_DEBUG_OCCLUDERS,164VIEW_DISPLAY_MOTION_VECTORS,165VIEW_DISPLAY_INTERNAL_BUFFER,166VIEW_DISPLAY_MAX,167// > Keep in sync with menu.168169VIEW_LOCK_ROTATION,170VIEW_CINEMATIC_PREVIEW,171VIEW_AUTO_ORTHOGONAL,172VIEW_MAX173};174175enum ViewType {176VIEW_TYPE_USER,177VIEW_TYPE_TOP,178VIEW_TYPE_BOTTOM,179VIEW_TYPE_LEFT,180VIEW_TYPE_RIGHT,181VIEW_TYPE_FRONT,182VIEW_TYPE_REAR,183};184185public:186static constexpr int32_t GIZMO_BASE_LAYER = 27;187static constexpr int32_t GIZMO_EDIT_LAYER = 26;188static constexpr int32_t GIZMO_GRID_LAYER = 25;189static constexpr int32_t MISC_TOOL_LAYER = 24;190191static constexpr int32_t FRAME_TIME_HISTORY = 20;192193enum NavigationScheme {194NAVIGATION_GODOT = 0,195NAVIGATION_MAYA = 1,196NAVIGATION_MODO = 2,197NAVIGATION_CUSTOM = 3,198NAVIGATION_TABLET = 4,199};200201enum FreelookNavigationScheme {202FREELOOK_DEFAULT,203FREELOOK_PARTIALLY_AXIS_LOCKED,204FREELOOK_FULLY_AXIS_LOCKED,205};206207enum ViewportNavMouseButton {208NAVIGATION_LEFT_MOUSE,209NAVIGATION_MIDDLE_MOUSE,210NAVIGATION_RIGHT_MOUSE,211NAVIGATION_MOUSE_4,212NAVIGATION_MOUSE_5,213};214215private:216double cpu_time_history[FRAME_TIME_HISTORY];217int cpu_time_history_index;218double gpu_time_history[FRAME_TIME_HISTORY];219int gpu_time_history_index;220221Node *ruler = nullptr;222Node3D *ruler_start_point = nullptr;223Node3D *ruler_end_point = nullptr;224Ref<ImmediateMesh> geometry;225MeshInstance3D *ruler_line = nullptr;226MeshInstance3D *ruler_line_xray = nullptr;227Label *ruler_label = nullptr;228Ref<StandardMaterial3D> ruler_material;229Ref<StandardMaterial3D> ruler_material_xray;230231int index;232ViewType view_type;233void _menu_option(int p_option);234void _set_auto_orthogonal();235Node3D *preview_node = nullptr;236bool update_preview_node = false;237Point2 preview_node_viewport_pos;238Vector3 preview_node_pos;239AABB *preview_bounds = nullptr;240Vector<String> selected_files;241AcceptDialog *accept = nullptr;242243Node *target_node = nullptr;244Point2 drop_pos;245246EditorSelection *editor_selection = nullptr;247248Button *translation_preview_button = nullptr;249CheckBox *preview_camera = nullptr;250SubViewportContainer *subviewport_container = nullptr;251252MenuButton *view_display_menu = nullptr;253PopupMenu *display_submenu = nullptr;254255Control *surface = nullptr;256SubViewport *viewport = nullptr;257Camera3D *camera = nullptr;258bool transforming = false;259bool orthogonal;260bool auto_orthogonal;261bool lock_rotation;262bool transform_gizmo_visible = true;263bool collision_reposition = false;264real_t gizmo_scale;265266bool freelook_active;267real_t freelook_speed;268Vector2 previous_mouse_position;269270PanelContainer *info_panel = nullptr;271Label *info_label = nullptr;272Label *cinema_label = nullptr;273Label *locked_label = nullptr;274Label *zoom_limit_label = nullptr;275276Label *preview_material_label = nullptr;277Label *preview_material_label_desc = nullptr;278279VBoxContainer *top_right_vbox = nullptr;280VBoxContainer *bottom_center_vbox = nullptr;281ViewportNavigationControl *position_control = nullptr;282ViewportNavigationControl *look_control = nullptr;283ViewportRotationControl *rotation_control = nullptr;284Gradient *frame_time_gradient = nullptr;285PanelContainer *frame_time_panel = nullptr;286VBoxContainer *frame_time_vbox = nullptr;287Label *cpu_time_label = nullptr;288Label *gpu_time_label = nullptr;289Label *fps_label = nullptr;290291struct _RayResult {292Node3D *item = nullptr;293real_t depth = 0;294_FORCE_INLINE_ bool operator<(const _RayResult &p_rr) const { return depth < p_rr.depth; }295};296297void _update_name();298void _compute_edit(const Point2 &p_point);299void _clear_selected();300bool _is_rotation_arc_visible() const;301void _select_clicked(bool p_allow_locked);302ObjectID _select_ray(const Point2 &p_pos) const;303void _find_items_at_pos(const Point2 &p_pos, Vector<_RayResult> &r_results, bool p_include_locked);304305Transform3D _get_camera_transform() const;306int get_selected_count() const;307void cancel_transform();308void _update_shrink();309310Vector3 _get_camera_position() const;311Vector3 _get_camera_normal() const;312Vector3 _get_screen_to_space(const Vector3 &p_vector3);313314void _select_region();315bool _transform_gizmo_select(const Vector2 &p_screenpos, bool p_highlight_only = false);316void _transform_gizmo_apply(Node3D *p_node, const Transform3D &p_transform, bool p_local);317318void _nav_pan(Ref<InputEventWithModifiers> p_event, const Vector2 &p_relative);319void _nav_zoom(Ref<InputEventWithModifiers> p_event, const Vector2 &p_relative);320void _nav_orbit(Ref<InputEventWithModifiers> p_event, const Vector2 &p_relative);321void _nav_look(Ref<InputEventWithModifiers> p_event, const Vector2 &p_relative);322323bool _is_shortcut_empty(const String &p_name);324bool _is_nav_modifier_pressed(const String &p_name);325int _get_shortcut_input_count(const String &p_name);326327float get_znear() const;328float get_zfar() const;329float get_fov() const;330331ObjectID clicked;332ObjectID material_target;333Vector<Node3D *> selection_results;334Vector<Node3D *> selection_results_menu;335bool clicked_wants_append = false;336bool selection_in_progress = false;337bool movement_threshold_passed = false;338339PopupMenu *selection_menu = nullptr;340341enum NavigationZoomStyle {342NAVIGATION_ZOOM_VERTICAL,343NAVIGATION_ZOOM_HORIZONTAL344};345346enum NavigationMode {347NAVIGATION_NONE,348NAVIGATION_PAN,349NAVIGATION_ZOOM,350NAVIGATION_ORBIT,351NAVIGATION_LOOK,352NAVIGATION_MOVE353};354enum TransformMode {355TRANSFORM_NONE,356TRANSFORM_ROTATE,357TRANSFORM_TRANSLATE,358TRANSFORM_SCALE359};360enum TransformPlane {361TRANSFORM_VIEW,362TRANSFORM_X_AXIS,363TRANSFORM_Y_AXIS,364TRANSFORM_Z_AXIS,365TRANSFORM_YZ,366TRANSFORM_XZ,367TRANSFORM_XY,368};369enum TransformType {370POSITION,371ROTATION,372SCALE,373};374375struct EditData {376TransformMode mode;377TransformPlane plane;378Transform3D original;379Vector3 click_ray;380Vector3 click_ray_pos;381Vector3 center;382Point2 mouse_pos;383Point2 original_mouse_pos;384bool snap = false;385bool show_rotation_line = false;386bool is_trackball = false;387Ref<EditorNode3DGizmo> gizmo;388int gizmo_handle = 0;389bool gizmo_handle_secondary = false;390Variant gizmo_initial_value;391bool original_local;392bool instant;393394// Numeric blender-style transforms (e.g. 'g5x').395// numeric_input tracks the current input value, e.g. 1.23.396// numeric_negate indicates whether '-' has been pressed to negate the value397// while numeric_next_decimal is 0, numbers are input before the decimal point398// after pressing '.', numeric next decimal changes to -1, and decrements after each press.399double numeric_input = 0.0;400bool numeric_negate = false;401int numeric_next_decimal = 0;402403Vector3 rotation_axis;404Vector3 view_axis_local;405double accumulated_rotation_angle = 0.0;406double display_rotation_angle = 0.0;407Vector3 initial_click_vector;408Vector3 previous_rotation_vector;409bool gizmo_initiated = false;410} _edit;411412struct Cursor {413Vector3 pos;414real_t x_rot, y_rot, distance, fov_scale;415real_t unsnapped_x_rot, unsnapped_y_rot;416Vector3 eye_pos; // Used in freelook mode417bool region_select;418Point2 region_begin, region_end;419420Cursor() {421// These rotations place the camera in +X +Y +Z, aka south east, facing north west.422x_rot = 0.5;423y_rot = -0.5;424unsnapped_x_rot = x_rot;425unsnapped_y_rot = y_rot;426distance = 4;427fov_scale = 1.0;428region_select = false;429}430};431// Viewport camera supports movement smoothing,432// so one cursor is the real cursor, while the other can be an interpolated version.433Cursor cursor; // Immediate cursor434Cursor camera_cursor; // That one may be interpolated (don't modify this one except for smoothing purposes)435Cursor previous_cursor; // Storing previous cursor state for canceling purposes436437void scale_fov(real_t p_fov_offset);438void reset_fov();439void scale_cursor_distance(real_t scale);440441struct ShortcutCheckSet {442bool mod_pressed = false;443bool shortcut_not_empty = true;444int input_count = 0;445ViewportNavMouseButton mouse_preference = NAVIGATION_LEFT_MOUSE;446NavigationMode result_nav_mode = NAVIGATION_NONE;447448ShortcutCheckSet() {}449450ShortcutCheckSet(bool p_mod_pressed, bool p_shortcut_not_empty, int p_input_count, const ViewportNavMouseButton &p_mouse_preference, const NavigationMode &p_result_nav_mode) :451mod_pressed(p_mod_pressed), shortcut_not_empty(p_shortcut_not_empty), input_count(p_input_count), mouse_preference(p_mouse_preference), result_nav_mode(p_result_nav_mode) {452}453};454455struct ShortcutCheckSetComparator {456_FORCE_INLINE_ bool operator()(const ShortcutCheckSet &A, const ShortcutCheckSet &B) const {457return A.input_count > B.input_count;458}459};460461NavigationMode _get_nav_mode_from_shortcut_check(ViewportNavMouseButton p_mouse_button, Vector<ShortcutCheckSet> p_shortcut_check_sets, bool p_use_not_empty);462463void set_freelook_active(bool active_now);464void scale_freelook_speed(real_t scale);465466real_t zoom_indicator_delay;467int zoom_failed_attempts_count = 0;468469RID move_gizmo_instance[3], move_plane_gizmo_instance[3], rotate_gizmo_instance[4], scale_gizmo_instance[3], scale_plane_gizmo_instance[3], axis_gizmo_instance[3];470RID trackball_sphere_instance;471472String last_message;473String message;474double message_time;475476void set_message(const String &p_message, float p_time = 5);477478void _view_settings_confirmed(real_t p_interp_delta);479void _update_camera(real_t p_interp_delta);480void _update_navigation_controls_visibility();481Transform3D to_camera_transform(const Cursor &p_cursor) const;482void _draw();483484// These allow tool scripts to set the 3D cursor location by updating the camera transform.485Transform3D last_camera_transform;486bool _camera_moved_externally();487void _apply_camera_transform_to_cursor();488489void _surface_mouse_enter();490void _surface_mouse_exit();491void _surface_focus_enter();492void _surface_focus_exit();493494void input(const Ref<InputEvent> &p_event) override;495void _sinput(const Ref<InputEvent> &p_event);496void _update_freelook(real_t delta);497Node3DEditor *spatial_editor = nullptr;498499Camera3D *previewing = nullptr;500Camera3D *preview = nullptr;501502bool previewing_camera = false;503bool previewing_cinema = false;504bool _is_node_locked(const Node *p_node) const;505void _preview_exited_scene();506void _preview_camera_property_changed();507void _update_centered_labels();508void _toggle_camera_preview(bool);509void _toggle_cinema_preview(bool);510void _init_gizmo_instance(int p_idx);511void _finish_gizmo_instances();512void _selection_result_pressed(int);513void _selection_menu_hide();514void _list_select(Ref<InputEventMouseButton> b);515Point2 _get_warped_mouse_motion(const Ref<InputEventMouseMotion> &p_ev_mouse_motion) const;516517Vector3 _get_instance_position(const Point2 &p_pos, Node3D *p_node) const;518static AABB _calculate_spatial_bounds(const Node3D *p_parent, bool p_omit_top_level = false, const Transform3D *p_bounds_orientation = nullptr);519520Node *_sanitize_preview_node(Node *p_node) const;521522void _create_preview_node(const Vector<String> &files) const;523void _remove_preview_node();524bool _apply_preview_material(ObjectID p_target, const Point2 &p_point) const;525void _reset_preview_material() const;526void _remove_preview_material();527bool _cyclical_dependency_exists(const String &p_target_scene_path, Node *p_desired_node) const;528bool _create_instance(Node *p_parent, const String &p_path, const Point2 &p_point);529bool _create_audio_node(Node *p_parent, const String &p_path, const Point2 &p_point);530void _perform_drop_data();531532bool can_drop_data_fw(const Point2 &p_point, const Variant &p_data, Control *p_from);533void drop_data_fw(const Point2 &p_point, const Variant &p_data, Control *p_from);534535void _project_settings_changed();536537Transform3D _compute_transform(TransformMode p_mode, const Transform3D &p_original, const Transform3D &p_original_local, Vector3 p_motion, double p_extra, bool p_local, bool p_orthogonal, bool p_view_axis);538539void _reset_transform(TransformType p_type);540541void begin_transform(TransformMode p_mode, bool instant);542void commit_transform();543void apply_transform(Vector3 p_motion, double p_snap);544void update_transform(bool p_shift);545void update_transform_numeric();546void finish_transform();547548void register_shortcut_action(const String &p_path, const String &p_name, Key p_keycode, bool p_physical = false);549void shortcut_changed_callback(const Ref<Shortcut> p_shortcut, const String &p_shortcut_path);550551// Supported rendering methods for advanced debug draw mode items.552enum SupportedRenderingMethods {553ALL,554FORWARD_PLUS,555FORWARD_PLUS_MOBILE,556};557558void _set_lock_view_rotation(bool p_lock_rotation);559void _add_advanced_debug_draw_mode_item(PopupMenu *p_popup, const String &p_name, int p_value, SupportedRenderingMethods p_rendering_methods = SupportedRenderingMethods::ALL, const String &p_tooltip = "");560561protected:562void _notification(int p_what);563static void _bind_methods();564565public:566void update_surface() { surface->queue_redraw(); }567void update_transform_gizmo_view();568569void set_can_preview(Camera3D *p_preview);570void set_state(const Dictionary &p_state);571Dictionary get_state() const;572void reset();573bool is_freelook_active() const { return freelook_active; }574575Vector3 get_ray_pos(const Vector2 &p_pos) const;576Vector3 get_ray(const Vector2 &p_pos) const;577Point2 point_to_screen(const Vector3 &p_point);578579void focus_selection();580581void assign_pending_data_pointers(582Node3D *p_preview_node,583AABB *p_preview_bounds,584AcceptDialog *p_accept);585586SubViewport *get_viewport_node() { return viewport; }587Camera3D *get_camera_3d() { return camera; } // return the default camera object.588Control *get_surface() { return surface; }589590Node3DEditorViewport(Node3DEditor *p_spatial_editor, int p_index);591~Node3DEditorViewport();592};593594class Node3DEditorSelectedItem : public Object {595GDCLASS(Node3DEditorSelectedItem, Object);596597public:598AABB aabb;599Transform3D original; // original location when moving600Transform3D original_local;601Transform3D last_xform; // last transform602bool last_xform_dirty;603Node3D *sp = nullptr;604RID sbox_instance;605RID sbox_instance_offset;606RID sbox_instance_xray;607RID sbox_instance_xray_offset;608Ref<EditorNode3DGizmo> gizmo;609HashMap<int, Transform3D> subgizmos; // Key: Subgizmo ID, Value: Initial subgizmo transform.610611Node3DEditorSelectedItem() {612sp = nullptr;613last_xform_dirty = true;614}615~Node3DEditorSelectedItem();616};617618class Node3DEditorViewportContainer : public Container {619GDCLASS(Node3DEditorViewportContainer, Container);620621public:622enum View {623VIEW_USE_1_VIEWPORT,624VIEW_USE_2_VIEWPORTS,625VIEW_USE_2_VIEWPORTS_ALT,626VIEW_USE_3_VIEWPORTS,627VIEW_USE_3_VIEWPORTS_ALT,628VIEW_USE_4_VIEWPORTS,629};630631private:632View view;633bool mouseover;634real_t ratio_h;635real_t ratio_v;636637bool hovering_v;638bool hovering_h;639640bool dragging_v;641bool dragging_h;642Vector2 drag_begin_pos;643Vector2 drag_begin_ratio;644645virtual void gui_input(const Ref<InputEvent> &p_event) override;646647protected:648void _notification(int p_what);649650public:651void set_view(View p_view);652View get_view();653654Node3DEditorViewportContainer();655};656657class Node3DEditor : public VBoxContainer {658GDCLASS(Node3DEditor, VBoxContainer);659660public:661static const unsigned int VIEWPORTS_COUNT = 4;662663enum ToolMode {664TOOL_MODE_TRANSFORM,665TOOL_MODE_MOVE,666TOOL_MODE_ROTATE,667TOOL_MODE_SCALE,668TOOL_MODE_SELECT,669TOOL_MODE_LIST_SELECT,670TOOL_LOCK_SELECTED,671TOOL_UNLOCK_SELECTED,672TOOL_GROUP_SELECTED,673TOOL_UNGROUP_SELECTED,674TOOL_RULER,675TOOL_MAX676};677678enum ToolOptions {679TOOL_OPT_LOCAL_COORDS,680TOOL_OPT_USE_SNAP,681TOOL_OPT_USE_TRACKBALL,682TOOL_OPT_MAX683};684685enum TransformMode {686TRANSFORM_MODE_GLOBAL = 1,687TRANSFORM_MODE_LOCAL = 2,688};689690private:691EditorSelection *editor_selection = nullptr;692693Node3DEditorViewportContainer *viewport_base = nullptr;694Node3DEditorViewport *viewports[VIEWPORTS_COUNT];695int last_used_viewport = 0;696697VSplitContainer *shader_split = nullptr;698HSplitContainer *left_panel_split = nullptr;699HSplitContainer *right_panel_split = nullptr;700701/////702703ToolMode tool_mode = TOOL_MODE_TRANSFORM;704705RID origin_mesh;706RID origin_multimesh;707RID origin_instance;708bool origin_enabled = false;709RID grid[3];710RID grid_instance[3];711bool grid_visible[3] = { false, false, false }; //currently visible712bool grid_enable[3] = { false, false, false }; //should be always visible if true713bool grid_enabled = false;714bool grid_init_draw = false;715Camera3D::ProjectionType grid_camera_last_update_perspective = Camera3D::PROJECTION_PERSPECTIVE;716Vector3 grid_camera_last_update_position;717718Ref<ArrayMesh> move_gizmo[3], move_plane_gizmo[3], rotate_gizmo[4], scale_gizmo[3], scale_plane_gizmo[3], axis_gizmo[3];719Ref<ArrayMesh> trackball_sphere_gizmo;720Ref<StandardMaterial3D> gizmo_color[3];721Ref<StandardMaterial3D> plane_gizmo_color[3];722Ref<ShaderMaterial> rotate_gizmo_color[4];723Ref<StandardMaterial3D> gizmo_color_hl[3];724Ref<StandardMaterial3D> plane_gizmo_color_hl[3];725Ref<ShaderMaterial> rotate_gizmo_color_hl[4];726Ref<StandardMaterial3D> trackball_sphere_material;727Ref<StandardMaterial3D> trackball_sphere_material_hl;728729Ref<Node3DGizmo> current_hover_gizmo;730int current_hover_gizmo_handle;731bool current_hover_gizmo_handle_secondary;732733DynamicBVH gizmo_bvh;734735real_t snap_translate_value;736real_t snap_rotate_value;737real_t snap_scale_value;738739Ref<ArrayMesh> active_selection_box_xray;740Ref<ArrayMesh> active_selection_box;741Ref<ArrayMesh> selection_box_xray;742Ref<ArrayMesh> selection_box;743744Ref<StandardMaterial3D> selection_box_mat = memnew(StandardMaterial3D);745Ref<StandardMaterial3D> selection_box_mat_xray = memnew(StandardMaterial3D);746Ref<StandardMaterial3D> active_selection_box_mat = memnew(StandardMaterial3D);747Ref<StandardMaterial3D> active_selection_box_mat_xray = memnew(StandardMaterial3D);748749RID indicators;750RID indicators_instance;751RID cursor_mesh;752RID cursor_instance;753Ref<ShaderMaterial> origin_mat;754Ref<ShaderMaterial> grid_mat[3];755Ref<StandardMaterial3D> cursor_material;756757// Scene drag and drop support758Node3D *preview_node = nullptr;759AABB preview_bounds;760761Ref<Material> preview_material;762Ref<Material> preview_reset_material;763ObjectID preview_material_target;764int preview_material_surface = -1;765766struct Gizmo {767bool visible = false;768real_t scale = 0;769Transform3D transform;770} gizmo;771772enum MenuOption {773MENU_TOOL_TRANSFORM,774MENU_TOOL_MOVE,775MENU_TOOL_ROTATE,776MENU_TOOL_SCALE,777MENU_TOOL_SELECT,778MENU_TOOL_LIST_SELECT,779MENU_TOOL_LOCAL_COORDS,780MENU_TOOL_USE_SNAP,781MENU_TOOL_USE_TRACKBALL,782MENU_TRANSFORM_CONFIGURE_SNAP,783MENU_TRANSFORM_DIALOG,784MENU_VIEW_USE_1_VIEWPORT,785MENU_VIEW_USE_2_VIEWPORTS,786MENU_VIEW_USE_2_VIEWPORTS_ALT,787MENU_VIEW_USE_3_VIEWPORTS,788MENU_VIEW_USE_3_VIEWPORTS_ALT,789MENU_VIEW_USE_4_VIEWPORTS,790MENU_VIEW_ORIGIN,791MENU_VIEW_GRID,792MENU_VIEW_GIZMOS_3D_ICONS,793MENU_VIEW_CAMERA_SETTINGS,794MENU_LOCK_SELECTED,795MENU_UNLOCK_SELECTED,796MENU_GROUP_SELECTED,797MENU_UNGROUP_SELECTED,798MENU_SNAP_TO_FLOOR,799MENU_RULER,800};801802Button *tool_button[TOOL_MAX];803Button *tool_option_button[TOOL_OPT_MAX];804805MenuButton *transform_menu = nullptr;806PopupMenu *gizmos_menu = nullptr;807MenuButton *view_layout_menu = nullptr;808809AcceptDialog *accept = nullptr;810811ConfirmationDialog *snap_dialog = nullptr;812ConfirmationDialog *xform_dialog = nullptr;813ConfirmationDialog *settings_dialog = nullptr;814815bool snap_enabled = false;816bool snap_key_enabled = false;817EditorSpinSlider *snap_translate = nullptr;818EditorSpinSlider *snap_rotate = nullptr;819EditorSpinSlider *snap_scale = nullptr;820821bool trackball_enabled = false;822823LineEdit *xform_translate[3];824LineEdit *xform_rotate[3];825LineEdit *xform_scale[3];826OptionButton *xform_type = nullptr;827828VBoxContainer *settings_vbc = nullptr;829SpinBox *settings_fov = nullptr;830SpinBox *settings_znear = nullptr;831SpinBox *settings_zfar = nullptr;832833void _snap_changed();834void _snap_update();835void _xform_dialog_action();836void _menu_item_pressed(int p_option);837void _menu_item_toggled(bool pressed, int p_option);838void _menu_gizmo_toggled(int p_option);839// Used for secondary menu items which are displayed depending on the currently selected node840// (such as MeshInstance's "Mesh" menu).841PanelContainer *context_toolbar_panel = nullptr;842HBoxContainer *context_toolbar_hbox = nullptr;843HashMap<Control *, VSeparator *> context_toolbar_separators;844845void _update_context_toolbar();846847void _generate_selection_boxes();848849void _init_indicators();850void _update_gizmos_menu();851void _update_gizmos_menu_theme();852void _init_grid();853void _finish_indicators();854void _finish_grid();855856void _toggle_maximize_view(Object *p_viewport);857void _viewport_clicked(int p_viewport_idx);858859Node *custom_camera = nullptr;860861Object *_get_editor_data(Object *p_what);862863Ref<Environment> viewport_environment;864865Node3D *selected = nullptr;866867Node3DEditorViewport *freelook_viewport = nullptr;868869void _request_gizmo(Object *p_obj);870void _request_gizmo_for_id(ObjectID p_id);871void _set_subgizmo_selection(Object *p_obj, Ref<Node3DGizmo> p_gizmo, int p_id, Transform3D p_transform = Transform3D());872void _clear_subgizmo_selection(Object *p_obj = nullptr);873874bool gizmos_dirty = false;875876static Node3DEditor *singleton;877878void _node_added(Node *p_node);879void _node_removed(Node *p_node);880Vector<Ref<EditorNode3DGizmoPlugin>> gizmo_plugins_by_priority;881Vector<Ref<EditorNode3DGizmoPlugin>> gizmo_plugins_by_name;882883void _register_all_gizmos();884885void _selection_changed();886void _refresh_menu_icons();887888bool do_snap_selected_nodes_to_floor = false;889void _snap_selected_nodes_to_floor();890891// Preview Sun and Environment892893class PreviewSunEnvPopup : public PopupPanel {894GDCLASS(PreviewSunEnvPopup, PopupPanel);895896protected:897virtual void shortcut_input(const Ref<InputEvent> &p_event) override;898};899900uint32_t world_env_count = 0;901uint32_t directional_light_count = 0;902903Button *sun_button = nullptr;904Label *sun_state = nullptr;905Label *sun_title = nullptr;906VBoxContainer *sun_vb = nullptr;907Popup *sun_environ_popup = nullptr;908Control *sun_direction = nullptr;909EditorSpinSlider *sun_angle_altitude = nullptr;910EditorSpinSlider *sun_angle_azimuth = nullptr;911ColorPickerButton *sun_color = nullptr;912EditorSpinSlider *sun_energy = nullptr;913EditorSpinSlider *sun_shadow_max_distance = nullptr;914Button *sun_add_to_scene = nullptr;915916Vector2 sun_rotation;917918Ref<Shader> sun_direction_shader;919Ref<ShaderMaterial> sun_direction_material;920921Button *environ_button = nullptr;922Label *environ_state = nullptr;923Label *environ_title = nullptr;924VBoxContainer *environ_vb = nullptr;925ColorPickerButton *environ_sky_color = nullptr;926ColorPickerButton *environ_ground_color = nullptr;927EditorSpinSlider *environ_energy = nullptr;928Button *environ_ao_button = nullptr;929Button *environ_glow_button = nullptr;930Button *environ_tonemap_button = nullptr;931Button *environ_gi_button = nullptr;932Button *environ_add_to_scene = nullptr;933934Button *sun_environ_settings = nullptr;935936DirectionalLight3D *preview_sun = nullptr;937bool preview_sun_dangling = false;938WorldEnvironment *preview_environment = nullptr;939bool preview_env_dangling = false;940Ref<Environment> environment;941Ref<CameraAttributesPractical> camera_attributes;942Ref<ProceduralSkyMaterial> sky_material;943944bool sun_environ_updating = false;945946void _sun_direction_draw();947void _sun_direction_input(const Ref<InputEvent> &p_event);948void _sun_direction_set_altitude(float p_altitude);949void _sun_direction_set_azimuth(float p_azimuth);950void _sun_set_color(const Color &p_color);951void _sun_set_energy(float p_energy);952void _sun_set_shadow_max_distance(float p_shadow_max_distance);953954void _environ_set_sky_color(const Color &p_color);955void _environ_set_ground_color(const Color &p_color);956void _environ_set_sky_energy(float p_energy);957void _environ_set_ao();958void _environ_set_glow();959void _environ_set_tonemap();960void _environ_set_gi();961962void _load_default_preview_settings();963void _update_preview_environment();964965void _preview_settings_changed();966void _sun_environ_settings_pressed();967968void _add_sun_to_scene(bool p_already_added_environment = false);969void _add_environment_to_scene(bool p_already_added_sun = false);970971void _update_theme();972973protected:974void _notification(int p_what);975//void _gui_input(InputEvent p_event);976virtual void shortcut_input(const Ref<InputEvent> &p_event) override;977978static void _bind_methods();979980public:981static Node3DEditor *get_singleton() { return singleton; }982983static Size2i get_camera_viewport_size(Camera3D *p_camera);984985Vector3 snap_point(Vector3 p_target, Vector3 p_start = Vector3(0, 0, 0)) const;986987float get_znear() const { return settings_znear->get_value(); }988float get_zfar() const { return settings_zfar->get_value(); }989float get_fov() const { return settings_fov->get_value(); }990991Transform3D get_gizmo_transform() const { return gizmo.transform; }992bool is_gizmo_visible() const;993994ToolMode get_tool_mode() const { return tool_mode; }995bool are_local_coords_enabled() const { return tool_option_button[Node3DEditor::TOOL_OPT_LOCAL_COORDS]->is_pressed(); }996void set_local_coords_enabled(bool on) const { tool_option_button[Node3DEditor::TOOL_OPT_LOCAL_COORDS]->set_pressed(on); }997bool is_snap_enabled() const { return snap_enabled ^ snap_key_enabled; }998real_t get_translate_snap() const;999real_t get_rotate_snap() const;1000real_t get_scale_snap() const;10011002bool is_trackball_enabled() const { return trackball_enabled; }10031004Ref<ArrayMesh> get_move_gizmo(int idx) const { return move_gizmo[idx]; }1005Ref<ArrayMesh> get_axis_gizmo(int idx) const { return axis_gizmo[idx]; }1006Ref<ArrayMesh> get_move_plane_gizmo(int idx) const { return move_plane_gizmo[idx]; }1007Ref<ArrayMesh> get_rotate_gizmo(int idx) const { return rotate_gizmo[idx]; }1008Ref<ArrayMesh> get_scale_gizmo(int idx) const { return scale_gizmo[idx]; }1009Ref<ArrayMesh> get_scale_plane_gizmo(int idx) const { return scale_plane_gizmo[idx]; }1010Ref<ArrayMesh> get_trackball_sphere_gizmo() const { return trackball_sphere_gizmo; }10111012void update_grid();1013void update_transform_gizmo();1014void update_all_gizmos(Node *p_node = nullptr);1015void update_gizmo_opacity();1016void snap_selected_nodes_to_floor();1017void select_gizmo_highlight_axis(int p_axis);1018void set_custom_camera(Node *p_camera) { custom_camera = p_camera; }10191020Dictionary get_state() const;1021void set_state(const Dictionary &p_state);10221023Ref<Environment> get_viewport_environment() { return viewport_environment; }10241025void add_control_to_menu_panel(Control *p_control);1026void remove_control_from_menu_panel(Control *p_control);10271028void add_control_to_left_panel(Control *p_control);1029void remove_control_from_left_panel(Control *p_control);10301031void add_control_to_right_panel(Control *p_control);1032void remove_control_from_right_panel(Control *p_control);10331034void move_control_to_left_panel(Control *p_control);1035void move_control_to_right_panel(Control *p_control);10361037VSplitContainer *get_shader_split();10381039Node3D *get_single_selected_node() { return selected; }1040bool is_current_selected_gizmo(const EditorNode3DGizmo *p_gizmo);1041bool is_subgizmo_selected(int p_id);1042Vector<int> get_subgizmo_selection();1043void clear_subgizmo_selection(Object *p_obj = nullptr);1044void refresh_dirty_gizmos();10451046Ref<EditorNode3DGizmo> get_current_hover_gizmo() const { return current_hover_gizmo; }1047void set_current_hover_gizmo(Ref<EditorNode3DGizmo> p_gizmo) { current_hover_gizmo = p_gizmo; }10481049void set_current_hover_gizmo_handle(int p_id, bool p_secondary) {1050current_hover_gizmo_handle = p_id;1051current_hover_gizmo_handle_secondary = p_secondary;1052}10531054int get_current_hover_gizmo_handle(bool &r_secondary) const {1055r_secondary = current_hover_gizmo_handle_secondary;1056return current_hover_gizmo_handle;1057}10581059void set_can_preview(Camera3D *p_preview);10601061void set_preview_material(Ref<Material> p_material) { preview_material = p_material; }1062Ref<Material> get_preview_material() { return preview_material; }1063void set_preview_reset_material(Ref<Material> p_material) { preview_reset_material = p_material; }1064Ref<Material> get_preview_reset_material() const { return preview_reset_material; }1065void set_preview_material_target(ObjectID p_object_id) { preview_material_target = p_object_id; }1066ObjectID get_preview_material_target() const { return preview_material_target; }1067void set_preview_material_surface(int p_surface) { preview_material_surface = p_surface; }1068int get_preview_material_surface() const { return preview_material_surface; }10691070Node3DEditorViewport *get_editor_viewport(int p_idx) {1071ERR_FAIL_INDEX_V(p_idx, static_cast<int>(VIEWPORTS_COUNT), nullptr);1072return viewports[p_idx];1073}1074Node3DEditorViewport *get_last_used_viewport();10751076void set_freelook_viewport(Node3DEditorViewport *p_viewport) { freelook_viewport = p_viewport; }1077Node3DEditorViewport *get_freelook_viewport() const { return freelook_viewport; }10781079void add_gizmo_plugin(Ref<EditorNode3DGizmoPlugin> p_plugin);1080void remove_gizmo_plugin(Ref<EditorNode3DGizmoPlugin> p_plugin);10811082DynamicBVH::ID insert_gizmo_bvh_node(Node3D *p_node, const AABB &p_aabb);1083void update_gizmo_bvh_node(DynamicBVH::ID p_id, const AABB &p_aabb);1084void remove_gizmo_bvh_node(DynamicBVH::ID p_id);1085Vector<Node3D *> gizmo_bvh_ray_query(const Vector3 &p_ray_start, const Vector3 &p_ray_end);1086Vector<Node3D *> gizmo_bvh_frustum_query(const Vector<Plane> &p_frustum);10871088void edit(Node3D *p_spatial);1089void clear();10901091Node3DEditor();1092~Node3DEditor();1093};10941095class Node3DEditorPlugin : public EditorPlugin {1096GDCLASS(Node3DEditorPlugin, EditorPlugin);10971098Node3DEditor *spatial_editor = nullptr;10991100public:1101Node3DEditor *get_spatial_editor() { return spatial_editor; }1102virtual String get_plugin_name() const override { return TTRC("3D"); }1103bool has_main_screen() const override { return true; }1104virtual void make_visible(bool p_visible) override;1105virtual void edit(Object *p_object) override;1106virtual bool handles(Object *p_object) const override;11071108virtual Dictionary get_state() const override;1109virtual void set_state(const Dictionary &p_state) override;1110virtual void clear() override { spatial_editor->clear(); }11111112virtual void edited_scene_changed() override;11131114Node3DEditorPlugin();1115};11161117class ViewportNavigationControl : public Control {1118GDCLASS(ViewportNavigationControl, Control);11191120Node3DEditorViewport *viewport = nullptr;1121Vector2i focused_mouse_start;1122Vector2 focused_pos;1123bool hovered = false;1124int focused_index = -1;1125Node3DEditorViewport::NavigationMode nav_mode = Node3DEditorViewport::NavigationMode::NAVIGATION_NONE;11261127const float AXIS_CIRCLE_RADIUS = 30.0f * EDSCALE;11281129protected:1130void _notification(int p_what);1131virtual void gui_input(const Ref<InputEvent> &p_event) override;1132void _draw();1133void _process_click(int p_index, Vector2 p_position, bool p_pressed);1134void _process_drag(int p_index, Vector2 p_position, Vector2 p_relative_position);1135void _update_navigation();11361137public:1138void set_navigation_mode(Node3DEditorViewport::NavigationMode p_nav_mode);1139void set_viewport(Node3DEditorViewport *p_viewport);1140};114111421143