diff options
| author | Rémi Verschelde <rverschelde@gmail.com> | 2020-11-10 09:34:32 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-11-10 09:34:32 +0100 |
| commit | e0285dcc0095a2ba2e82c1b2abc07052cb5f25c7 (patch) | |
| tree | 198b312ebc1086bca659c6ee353969ee21b2fb80 | |
| parent | dd851d8f91bfdde7c75e5d195e2d5bc05e85ffc6 (diff) | |
| parent | 5d8b60ac3d3c6df22f4d29642c4139b51bd22e81 (diff) | |
Merge pull request #43356 from KoBeWi/editor_art
Add docs for editor viewport drawing methods
| -rw-r--r-- | doc/classes/EditorPlugin.xml | 16 |
1 files changed, 15 insertions, 1 deletions
diff --git a/doc/classes/EditorPlugin.xml b/doc/classes/EditorPlugin.xml index 3613c408b2..70d2c6b0a9 100644 --- a/doc/classes/EditorPlugin.xml +++ b/doc/classes/EditorPlugin.xml @@ -210,6 +210,17 @@ <argument index="0" name="overlay" type="Control"> </argument> <description> + Called by the engine when the 2D editor's viewport is updated. Use the [code]overlay[/code] [Control] for drawing. You can update the viewport manually by calling [method update_overlays]. + [codeblock] + func forward_canvas_draw_over_viewport(overlay): + # Draw a circle at cursor position. + overlay.draw_circle(overlay.get_local_mouse_position(), 64) + + func forward_canvas_gui_input(event): + if event is InputEventMouseMotion: + # Redraw viewport when cursor is moved. + update_overlays() + [/codeblock] </description> </method> <method name="forward_canvas_force_draw_over_viewport" qualifiers="virtual"> @@ -218,6 +229,8 @@ <argument index="0" name="overlay" type="Control"> </argument> <description> + This method is the same as [method forward_canvas_draw_over_viewport], except it draws on top of everything. Useful when you need an extra layer that shows over anything else. + You need to enable calling of this method by using [method set_force_draw_over_forwarding_enabled]. </description> </method> <method name="forward_canvas_gui_input" qualifiers="virtual"> @@ -550,6 +563,7 @@ <return type="void"> </return> <description> + Enables calling of [method forward_canvas_force_draw_over_viewport] when the 2D editor's viewport is updated. You need to call this method only once and it will work permanently for this plugin. </description> </method> <method name="set_input_event_forwarding_always_enabled"> @@ -581,7 +595,7 @@ <return type="int"> </return> <description> - Updates the overlays of the editor (2D/3D) viewport. + Updates the overlays of the 2D and 3D editor viewport. Causes [method forward_canvas_draw_over_viewport] and [method forward_canvas_force_draw_over_viewport] to be called. </description> </method> </methods> |