2017-09-12 20:42:36 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
2020-02-01 01:03:48 +00:00
<class name= "EditorSpatialGizmo" inherits= "SpatialGizmo" version= "4.0" >
2017-09-12 20:42:36 +00:00
<brief_description >
Custom gizmo for editing Spatial objects.
</brief_description>
<description >
2019-01-25 11:57:32 +00:00
Custom gizmo that is used for providing custom visualization and editing (handles) for 3D Spatial objects. See [EditorSpatialGizmoPlugin] for more information.
2017-09-12 20:42:36 +00:00
</description>
<tutorials >
</tutorials>
<methods >
<method name= "add_collision_segments" >
<return type= "void" >
</return>
2020-02-18 12:59:24 +00:00
<argument index= "0" name= "segments" type= "PackedVector3Array" >
2017-09-12 20:42:36 +00:00
</argument>
<description >
</description>
</method>
<method name= "add_collision_triangles" >
<return type= "void" >
</return>
<argument index= "0" name= "triangles" type= "TriangleMesh" >
</argument>
<description >
2019-06-21 23:04:47 +00:00
Adds collision triangles to the gizmo for picking. A [TriangleMesh] can be generated from a regular [Mesh] too. Call this function during [method redraw].
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "add_handles" >
<return type= "void" >
</return>
2020-02-18 12:59:24 +00:00
<argument index= "0" name= "handles" type= "PackedVector3Array" >
2017-09-12 20:42:36 +00:00
</argument>
2018-08-20 22:35:30 +00:00
<argument index= "1" name= "material" type= "Material" >
2017-09-12 20:42:36 +00:00
</argument>
2018-08-20 22:35:30 +00:00
<argument index= "2" name= "billboard" type= "bool" default= "false" >
</argument>
<argument index= "3" name= "secondary" type= "bool" default= "false" >
2017-09-12 20:42:36 +00:00
</argument>
<description >
2019-06-21 23:04:47 +00:00
Adds a list of handles (points) which can be used to deform the object being edited.
2017-09-12 20:42:36 +00:00
There are virtual functions which will be called upon editing of these handles. Call this function during [method redraw].
</description>
</method>
<method name= "add_lines" >
<return type= "void" >
</return>
2020-02-18 12:59:24 +00:00
<argument index= "0" name= "lines" type= "PackedVector3Array" >
2017-09-12 20:42:36 +00:00
</argument>
<argument index= "1" name= "material" type= "Material" >
</argument>
<argument index= "2" name= "billboard" type= "bool" default= "false" >
</argument>
2020-01-03 14:09:03 +00:00
<argument index= "3" name= "modulate" type= "Color" default= "Color( 1, 1, 1, 1 )" >
</argument>
2017-09-12 20:42:36 +00:00
<description >
2019-06-21 23:04:47 +00:00
Adds lines to the gizmo (as sets of 2 points), with a given material. The lines are used for visualizing the gizmo. Call this function during [method redraw].
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "add_mesh" >
<return type= "void" >
</return>
<argument index= "0" name= "mesh" type= "ArrayMesh" >
</argument>
<argument index= "1" name= "billboard" type= "bool" default= "false" >
</argument>
2019-09-24 13:57:22 +00:00
<argument index= "2" name= "skeleton" type= "SkinReference" default= "null" >
2017-09-12 20:42:36 +00:00
</argument>
2019-02-25 10:21:15 +00:00
<argument index= "3" name= "material" type= "Material" default= "null" >
</argument>
2017-09-12 20:42:36 +00:00
<description >
</description>
</method>
<method name= "add_unscaled_billboard" >
<return type= "void" >
</return>
<argument index= "0" name= "material" type= "Material" >
</argument>
<argument index= "1" name= "default_scale" type= "float" default= "1" >
</argument>
2020-01-03 14:09:03 +00:00
<argument index= "2" name= "modulate" type= "Color" default= "Color( 1, 1, 1, 1 )" >
</argument>
2017-09-12 20:42:36 +00:00
<description >
2019-06-21 23:04:47 +00:00
Adds an unscaled billboard for visualization. Call this function during [method redraw].
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "clear" >
<return type= "void" >
</return>
<description >
</description>
</method>
<method name= "commit_handle" qualifiers= "virtual" >
<return type= "void" >
</return>
<argument index= "0" name= "index" type= "int" >
</argument>
<argument index= "1" name= "restore" type= "Variant" >
</argument>
<argument index= "2" name= "cancel" type= "bool" default= "false" >
</argument>
<description >
2017-10-14 10:45:26 +00:00
Commit a handle being edited (handles must have been previously added by [method add_handles]).
2019-06-21 23:04:47 +00:00
If the [code]cancel[/code] parameter is [code]true[/code], an option to restore the edited value to the original is provided.
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "get_handle_name" qualifiers= "virtual" >
<return type= "String" >
</return>
<argument index= "0" name= "index" type= "int" >
</argument>
<description >
2019-06-21 23:04:47 +00:00
Gets the name of an edited handle (handles must have been previously added by [method add_handles]).
2017-09-12 20:42:36 +00:00
Handles can be named for reference to the user when editing.
</description>
</method>
<method name= "get_handle_value" qualifiers= "virtual" >
<return type= "Variant" >
</return>
<argument index= "0" name= "index" type= "int" >
</argument>
<description >
2019-06-21 23:04:47 +00:00
Gets actual value of a handle. This value can be anything and used for eventually undoing the motion when calling [method commit_handle].
2019-01-25 11:57:32 +00:00
</description>
</method>
<method name= "get_plugin" qualifiers= "const" >
<return type= "EditorSpatialGizmoPlugin" >
</return>
<description >
2019-05-24 02:15:43 +00:00
Returns the [EditorSpatialGizmoPlugin] that owns this gizmo. It's useful to retrieve materials using [method EditorSpatialGizmoPlugin.get_material].
2019-01-25 11:57:32 +00:00
</description>
</method>
<method name= "get_spatial_node" qualifiers= "const" >
<return type= "Spatial" >
</return>
<description >
Returns the Spatial node associated with this gizmo.
</description>
</method>
<method name= "is_handle_highlighted" qualifiers= "virtual" >
<return type= "bool" >
</return>
<argument index= "0" name= "index" type= "int" >
</argument>
<description >
2019-06-21 23:04:47 +00:00
Gets whether a handle is highlighted or not.
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name= "redraw" qualifiers= "virtual" >
<return type= "void" >
</return>
<description >
This function is called when the Spatial this gizmo refers to changes (the [method Spatial.update_gizmo] is called).
</description>
</method>
<method name= "set_handle" qualifiers= "virtual" >
<return type= "void" >
</return>
<argument index= "0" name= "index" type= "int" >
</argument>
<argument index= "1" name= "camera" type= "Camera" >
</argument>
<argument index= "2" name= "point" type= "Vector2" >
</argument>
<description >
This function is used when the user drags a gizmo handle (previously added with [method add_handles]) in screen coordinates.
The [Camera] is also provided so screen coordinates can be converted to raycasts.
</description>
</method>
2018-08-20 22:35:30 +00:00
<method name= "set_hidden" >
<return type= "void" >
</return>
<argument index= "0" name= "hidden" type= "bool" >
</argument>
<description >
</description>
</method>
2017-09-12 20:42:36 +00:00
<method name= "set_spatial_node" >
<return type= "void" >
</return>
<argument index= "0" name= "node" type= "Node" >
</argument>
<description >
</description>
</method>
</methods>
<constants >
</constants>
</class>