2014-02-10 02:10:30 +01:00
|
|
|
/*************************************************************************/
|
|
|
|
/* viewport.h */
|
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
|
|
|
/* http://www.godotengine.org */
|
|
|
|
/*************************************************************************/
|
2017-01-01 22:01:57 +01:00
|
|
|
/* Copyright (c) 2007-2017 Juan Linietsky, Ariel Manzur. */
|
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. */
|
|
|
|
/*************************************************************************/
|
|
|
|
#ifndef VIEWPORT_H
|
|
|
|
#define VIEWPORT_H
|
|
|
|
|
|
|
|
#include "scene/main/node.h"
|
|
|
|
#include "servers/visual_server.h"
|
|
|
|
#include "scene/resources/world_2d.h"
|
|
|
|
#include "math_2d.h"
|
|
|
|
#include "scene/resources/texture.h"
|
|
|
|
/**
|
|
|
|
@author Juan Linietsky <reduzio@gmail.com>
|
|
|
|
*/
|
|
|
|
|
|
|
|
class Camera;
|
2016-07-07 01:35:49 +02:00
|
|
|
class Camera2D;
|
2016-03-20 03:10:04 +01:00
|
|
|
class Listener;
|
2016-01-17 02:41:10 +01:00
|
|
|
class Control;
|
|
|
|
class CanvasItem;
|
|
|
|
class Panel;
|
|
|
|
class Label;
|
|
|
|
class Timer;
|
2014-02-10 02:10:30 +01:00
|
|
|
class Viewport;
|
|
|
|
|
|
|
|
class RenderTargetTexture : public Texture {
|
|
|
|
|
|
|
|
OBJ_TYPE( RenderTargetTexture, Texture );
|
|
|
|
|
2014-04-19 21:46:52 +02:00
|
|
|
int flags;
|
2014-02-10 02:10:30 +01:00
|
|
|
friend class Viewport;
|
|
|
|
Viewport *vp;
|
|
|
|
|
|
|
|
|
|
|
|
public:
|
|
|
|
|
|
|
|
|
|
|
|
virtual int get_width() const;
|
|
|
|
virtual int get_height() const;
|
|
|
|
virtual Size2 get_size() const;
|
|
|
|
virtual RID get_rid() const;
|
|
|
|
|
|
|
|
virtual bool has_alpha() const;
|
|
|
|
|
|
|
|
virtual void set_flags(uint32_t p_flags);
|
|
|
|
virtual uint32_t get_flags() const;
|
|
|
|
|
|
|
|
RenderTargetTexture(Viewport *p_vp=NULL);
|
|
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
class Viewport : public Node {
|
|
|
|
|
|
|
|
OBJ_TYPE( Viewport, Node );
|
|
|
|
public:
|
|
|
|
|
|
|
|
enum RenderTargetUpdateMode {
|
|
|
|
RENDER_TARGET_UPDATE_DISABLED,
|
|
|
|
RENDER_TARGET_UPDATE_ONCE, //then goes to disabled
|
|
|
|
RENDER_TARGET_UPDATE_WHEN_VISIBLE, // default
|
|
|
|
RENDER_TARGET_UPDATE_ALWAYS
|
|
|
|
};
|
|
|
|
|
|
|
|
private:
|
|
|
|
|
|
|
|
friend class RenderTargetTexture;
|
2016-01-18 23:49:11 +01:00
|
|
|
|
|
|
|
|
|
|
|
Control *parent_control;
|
2014-02-10 02:10:30 +01:00
|
|
|
Viewport *parent;
|
|
|
|
|
2016-03-20 03:10:04 +01:00
|
|
|
Listener *listener;
|
|
|
|
Set<Listener*> listeners;
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
Camera *camera;
|
|
|
|
Set<Camera*> cameras;
|
|
|
|
|
|
|
|
RID viewport;
|
|
|
|
RID canvas_item;
|
|
|
|
RID current_canvas;
|
|
|
|
|
|
|
|
bool audio_listener;
|
2016-03-20 03:10:04 +01:00
|
|
|
RID internal_listener;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
bool audio_listener_2d;
|
2016-03-20 03:10:04 +01:00
|
|
|
RID internal_listener_2d;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
Matrix32 canvas_transform;
|
|
|
|
Matrix32 global_canvas_transform;
|
|
|
|
Matrix32 stretch_transform;
|
|
|
|
|
|
|
|
Rect2 rect;
|
2014-04-15 03:43:44 +02:00
|
|
|
Rect2 to_screen_rect;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2015-09-20 18:03:46 +02:00
|
|
|
RID contact_2d_debug;
|
|
|
|
RID contact_3d_debug_multimesh;
|
|
|
|
RID contact_3d_debug_instance;
|
|
|
|
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
bool size_override;
|
|
|
|
bool size_override_stretch;
|
|
|
|
Size2 size_override_size;
|
|
|
|
Size2 size_override_margin;
|
|
|
|
|
2014-10-28 02:54:32 +01:00
|
|
|
Rect2 last_vp_rect;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
bool transparent_bg;
|
2014-04-10 05:18:27 +02:00
|
|
|
bool render_target_vflip;
|
2015-02-21 10:35:06 +01:00
|
|
|
bool render_target_clear_on_new_frame;
|
2014-05-14 06:22:15 +02:00
|
|
|
bool render_target_filter;
|
2014-08-14 15:31:38 +02:00
|
|
|
bool render_target_gen_mipmaps;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2014-09-15 16:33:30 +02:00
|
|
|
bool physics_object_picking;
|
|
|
|
List<InputEvent> physics_picking_events;
|
|
|
|
ObjectID physics_object_capture;
|
|
|
|
ObjectID physics_object_over;
|
|
|
|
Vector2 physics_last_mousepos;
|
|
|
|
void _test_new_mouseover(ObjectID new_collider);
|
2015-03-22 05:46:18 +01:00
|
|
|
Map<ObjectID,uint64_t> physics_2d_mouseover;
|
2014-09-15 16:33:30 +02:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
void _update_rect();
|
|
|
|
|
|
|
|
void _parent_resized();
|
|
|
|
void _parent_draw();
|
|
|
|
void _parent_visibility_changed();
|
|
|
|
|
|
|
|
Ref<World2D> world_2d;
|
|
|
|
Ref<World> world;
|
2014-04-15 03:43:44 +02:00
|
|
|
Ref<World> own_world;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2014-04-10 05:18:27 +02:00
|
|
|
StringName input_group;
|
|
|
|
StringName gui_input_group;
|
|
|
|
StringName unhandled_input_group;
|
|
|
|
StringName unhandled_key_input_group;
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
void _update_listener();
|
|
|
|
void _update_listener_2d();
|
|
|
|
|
|
|
|
void _propagate_enter_world(Node *p_node);
|
|
|
|
void _propagate_exit_world(Node *p_node);
|
2016-05-11 16:46:08 +02:00
|
|
|
void _propagate_viewport_notification(Node *p_node, int p_what);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
|
|
|
|
void _update_stretch_transform();
|
|
|
|
void _update_global_transform();
|
|
|
|
|
|
|
|
bool render_target;
|
|
|
|
RenderTargetUpdateMode render_target_update_mode;
|
|
|
|
RID render_target_texture_rid;
|
|
|
|
Ref<RenderTargetTexture> render_target_texture;
|
|
|
|
|
|
|
|
|
2016-01-17 02:41:10 +01:00
|
|
|
struct GUI {
|
|
|
|
// info used when this is a window
|
|
|
|
|
|
|
|
bool key_event_accepted;
|
|
|
|
Control *mouse_focus;
|
|
|
|
int mouse_focus_button;
|
|
|
|
Control *key_focus;
|
|
|
|
Control *mouse_over;
|
|
|
|
Control *tooltip;
|
|
|
|
Panel *tooltip_popup;
|
|
|
|
Label *tooltip_label;
|
|
|
|
Point2 tooltip_pos;
|
|
|
|
Point2 last_mouse_pos;
|
|
|
|
Point2 drag_accum;
|
|
|
|
bool drag_attempted;
|
|
|
|
Variant drag_data;
|
|
|
|
Control *drag_preview;
|
2016-01-25 14:30:03 +01:00
|
|
|
float tooltip_timer;
|
|
|
|
float tooltip_delay;
|
2016-01-17 02:41:10 +01:00
|
|
|
List<Control*> modal_stack;
|
|
|
|
unsigned int cancelled_input_ID;
|
|
|
|
Matrix32 focus_inv_xform;
|
|
|
|
bool subwindow_order_dirty;
|
|
|
|
List<Control*> subwindows;
|
|
|
|
bool roots_order_dirty;
|
|
|
|
List<Control*> roots;
|
|
|
|
|
|
|
|
|
|
|
|
GUI();
|
|
|
|
} gui;
|
|
|
|
|
|
|
|
bool disable_input;
|
|
|
|
|
|
|
|
void _gui_call_input(Control *p_control,const InputEvent& p_input);
|
|
|
|
void _gui_sort_subwindows();
|
|
|
|
void _gui_sort_roots();
|
|
|
|
void _gui_sort_modal_stack();
|
|
|
|
Control* _gui_find_control(const Point2& p_global);
|
|
|
|
Control* _gui_find_control_at_pos(CanvasItem* p_node,const Point2& p_global,const Matrix32& p_xform,Matrix32& r_inv_xform);
|
|
|
|
|
|
|
|
void _gui_input_event(InputEvent p_event);
|
|
|
|
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
void update_worlds();
|
|
|
|
|
2014-04-18 16:43:54 +02:00
|
|
|
_FORCE_INLINE_ Matrix32 _get_input_pre_xform() const;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2014-11-06 01:20:42 +01:00
|
|
|
void _vp_enter_tree();
|
|
|
|
void _vp_exit_tree();
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2014-04-10 05:18:27 +02:00
|
|
|
void _vp_input(const InputEvent& p_ev);
|
2016-01-17 02:41:10 +01:00
|
|
|
void _vp_input_text(const String& p_text);
|
2014-04-10 05:18:27 +02:00
|
|
|
void _vp_unhandled_input(const InputEvent& p_ev);
|
|
|
|
void _make_input_local(InputEvent& ev);
|
|
|
|
|
2016-01-17 02:41:10 +01:00
|
|
|
|
|
|
|
friend class Control;
|
|
|
|
|
|
|
|
List<Control*>::Element* _gui_add_root_control(Control* p_control);
|
|
|
|
List<Control*>::Element* _gui_add_subwindow_control(Control* p_control);
|
|
|
|
|
|
|
|
void _gui_set_subwindow_order_dirty();
|
|
|
|
void _gui_set_root_order_dirty();
|
|
|
|
|
|
|
|
|
|
|
|
void _gui_remove_modal_control(List<Control*>::Element *MI);
|
|
|
|
void _gui_remove_from_modal_stack(List<Control*>::Element *MI,ObjectID p_prev_focus_owner);
|
|
|
|
void _gui_remove_root_control(List<Control*>::Element *RI);
|
|
|
|
void _gui_remove_subwindow_control(List<Control*>::Element* SI);
|
|
|
|
|
|
|
|
void _gui_cancel_tooltip();
|
|
|
|
void _gui_show_tooltip();
|
|
|
|
|
|
|
|
|
|
|
|
void _gui_remove_control(Control *p_control);
|
|
|
|
void _gui_hid_control(Control *p_control);
|
|
|
|
|
2016-01-20 00:27:27 +01:00
|
|
|
void _gui_force_drag(Control *p_base,const Variant& p_data,Control *p_control);
|
|
|
|
void _gui_set_drag_preview(Control *p_base,Control *p_control);
|
2016-01-17 02:41:10 +01:00
|
|
|
|
|
|
|
bool _gui_is_modal_on_top(const Control* p_control);
|
|
|
|
List<Control*>::Element* _gui_show_modal(Control* p_control);
|
|
|
|
|
|
|
|
void _gui_remove_focus();
|
|
|
|
void _gui_unfocus_control(Control *p_control);
|
|
|
|
bool _gui_control_has_focus(const Control* p_control);
|
|
|
|
void _gui_control_grab_focus(Control* p_control);
|
|
|
|
void _gui_grab_click_focus(Control *p_control);
|
|
|
|
void _gui_accept_event();
|
|
|
|
|
|
|
|
Control *_gui_get_focus_owner();
|
|
|
|
|
2016-09-10 18:29:07 +02:00
|
|
|
Vector2 _get_window_offset() const;
|
|
|
|
|
2016-03-20 03:10:04 +01:00
|
|
|
friend class Listener;
|
|
|
|
void _listener_transform_changed_notify();
|
|
|
|
void _listener_set(Listener* p_listener);
|
|
|
|
bool _listener_add(Listener* p_listener); //true if first
|
|
|
|
void _listener_remove(Listener* p_listener);
|
|
|
|
void _listener_make_next_current(Listener* p_exclude);
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
friend class Camera;
|
|
|
|
void _camera_transform_changed_notify();
|
2016-01-31 19:09:52 +01:00
|
|
|
void _camera_set(Camera* p_camera);
|
|
|
|
bool _camera_add(Camera* p_camera); //true if first
|
|
|
|
void _camera_remove(Camera* p_camera);
|
|
|
|
void _camera_make_next_current(Camera* p_exclude);
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2016-03-09 00:00:52 +01:00
|
|
|
protected:
|
2014-02-10 02:10:30 +01:00
|
|
|
void _notification(int p_what);
|
|
|
|
static void _bind_methods();
|
|
|
|
public:
|
|
|
|
|
2016-03-20 03:10:04 +01:00
|
|
|
Listener* get_listener() const;
|
2014-02-10 02:10:30 +01:00
|
|
|
Camera* get_camera() const;
|
|
|
|
|
|
|
|
void set_as_audio_listener(bool p_enable);
|
|
|
|
bool is_audio_listener() const;
|
|
|
|
|
|
|
|
void set_as_audio_listener_2d(bool p_enable);
|
|
|
|
bool is_audio_listener_2d() const;
|
|
|
|
|
2016-03-09 00:00:52 +01:00
|
|
|
void set_rect(const Rect2& p_rect);
|
2014-02-10 02:10:30 +01:00
|
|
|
Rect2 get_rect() const;
|
|
|
|
Rect2 get_visible_rect() const;
|
|
|
|
RID get_viewport() const;
|
|
|
|
|
|
|
|
void set_world(const Ref<World>& p_world);
|
|
|
|
Ref<World> get_world() const;
|
|
|
|
Ref<World> find_world() const;
|
|
|
|
|
|
|
|
Ref<World2D> find_world_2d() const;
|
|
|
|
|
|
|
|
|
|
|
|
void set_canvas_transform(const Matrix32& p_transform);
|
|
|
|
Matrix32 get_canvas_transform() const;
|
|
|
|
|
|
|
|
void set_global_canvas_transform(const Matrix32& p_transform);
|
|
|
|
Matrix32 get_global_canvas_transform() const;
|
|
|
|
|
|
|
|
Matrix32 get_final_transform() const;
|
|
|
|
|
|
|
|
void set_transparent_background(bool p_enable);
|
|
|
|
bool has_transparent_background() const;
|
|
|
|
|
|
|
|
|
|
|
|
void set_size_override(bool p_enable,const Size2& p_size=Size2(-1,-1),const Vector2& p_margin=Vector2());
|
|
|
|
Size2 get_size_override() const;
|
|
|
|
bool is_size_override_enabled() const;
|
|
|
|
void set_size_override_stretch(bool p_enable);
|
|
|
|
bool is_size_override_stretch_enabled() const;
|
|
|
|
|
|
|
|
void set_as_render_target(bool p_enable);
|
|
|
|
bool is_set_as_render_target() const;
|
2014-04-10 05:18:27 +02:00
|
|
|
|
|
|
|
void set_render_target_vflip(bool p_enable);
|
|
|
|
bool get_render_target_vflip() const;
|
|
|
|
|
2015-02-21 10:35:06 +01:00
|
|
|
void set_render_target_clear_on_new_frame(bool p_enable);
|
|
|
|
bool get_render_target_clear_on_new_frame() const;
|
|
|
|
void render_target_clear();
|
|
|
|
|
2014-05-14 06:22:15 +02:00
|
|
|
void set_render_target_filter(bool p_enable);
|
|
|
|
bool get_render_target_filter() const;
|
|
|
|
|
2014-08-14 15:31:38 +02:00
|
|
|
void set_render_target_gen_mipmaps(bool p_enable);
|
|
|
|
bool get_render_target_gen_mipmaps() const;
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
void set_render_target_update_mode(RenderTargetUpdateMode p_mode);
|
|
|
|
RenderTargetUpdateMode get_render_target_update_mode() const;
|
|
|
|
Ref<RenderTargetTexture> get_render_target_texture() const;
|
|
|
|
|
2014-10-28 02:54:32 +01:00
|
|
|
|
|
|
|
Vector2 get_camera_coords(const Vector2& p_viewport_coords) const;
|
|
|
|
Vector2 get_camera_rect_size() const;
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
void queue_screen_capture();
|
|
|
|
Image get_screen_capture() const;
|
|
|
|
|
2014-04-15 03:43:44 +02:00
|
|
|
void set_use_own_world(bool p_world);
|
|
|
|
bool is_using_own_world() const;
|
|
|
|
|
2014-04-10 05:18:27 +02:00
|
|
|
void input(const InputEvent& p_event);
|
|
|
|
void unhandled_input(const InputEvent& p_event);
|
|
|
|
|
2016-01-17 02:41:10 +01:00
|
|
|
void set_disable_input(bool p_disable);
|
|
|
|
bool is_input_disabled() const;
|
|
|
|
|
2014-04-15 03:43:44 +02:00
|
|
|
void set_render_target_to_screen_rect(const Rect2& p_rect);
|
|
|
|
Rect2 get_render_target_to_screen_rect() const;
|
|
|
|
|
2015-05-12 13:17:09 +02:00
|
|
|
Vector2 get_mouse_pos() const;
|
2015-02-14 23:22:06 +01:00
|
|
|
void warp_mouse(const Vector2& p_pos);
|
|
|
|
|
2014-09-15 16:33:30 +02:00
|
|
|
void set_physics_object_picking(bool p_enable);
|
|
|
|
bool get_physics_object_picking();
|
|
|
|
|
2016-01-17 02:41:10 +01:00
|
|
|
bool gui_has_modal_stack() const;
|
|
|
|
|
2016-05-11 16:46:08 +02:00
|
|
|
Variant gui_get_drag_data() const;
|
2016-06-28 01:14:59 +02:00
|
|
|
Control *get_modal_stack_top() const;
|
2016-01-17 02:41:10 +01:00
|
|
|
|
2016-05-17 23:27:15 +02:00
|
|
|
virtual String get_configuration_warning() const;
|
|
|
|
|
2016-03-09 00:00:52 +01:00
|
|
|
Viewport();
|
2014-02-10 02:10:30 +01:00
|
|
|
~Viewport();
|
|
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
VARIANT_ENUM_CAST(Viewport::RenderTargetUpdateMode);
|
|
|
|
#endif
|