b087538119
This makes it easier to spot syntax errors when editing the class reference. The schema is referenced locally so validation can still work offline. Each class XML's schema conformance is also checked on GitHub Actions.
155 lines
7.8 KiB
XML
155 lines
7.8 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="EditorSpatialGizmoPlugin" inherits="Resource" version="3.5" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
|
|
<brief_description>
|
|
Used by the editor to define Spatial gizmo types.
|
|
</brief_description>
|
|
<description>
|
|
[EditorSpatialGizmoPlugin] allows you to define a new type of Gizmo. There are two main ways to do so: extending [EditorSpatialGizmoPlugin] for the simpler gizmos, or creating a new [EditorSpatialGizmo] type. See the tutorial in the documentation for more info.
|
|
To use [EditorSpatialGizmoPlugin], register it using the [method EditorPlugin.add_spatial_gizmo_plugin] method first.
|
|
</description>
|
|
<tutorials>
|
|
<link>$DOCS_URL/tutorials/plugins/editor/spatial_gizmos.html</link>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="add_material">
|
|
<return type="void" />
|
|
<argument index="0" name="name" type="String" />
|
|
<argument index="1" name="material" type="SpatialMaterial" />
|
|
<description>
|
|
Adds a new material to the internal material list for the plugin. It can then be accessed with [method get_material]. Should not be overridden.
|
|
</description>
|
|
</method>
|
|
<method name="can_be_hidden" qualifiers="virtual">
|
|
<return type="bool" />
|
|
<description>
|
|
Override this method to define whether the gizmo can be hidden or not. Returns [code]true[/code] if not overridden.
|
|
</description>
|
|
</method>
|
|
<method name="commit_handle" qualifiers="virtual">
|
|
<return type="void" />
|
|
<argument index="0" name="gizmo" type="EditorSpatialGizmo" />
|
|
<argument index="1" name="index" type="int" />
|
|
<argument index="2" name="restore" type="Variant" />
|
|
<argument index="3" name="cancel" type="bool" default="false" />
|
|
<description>
|
|
Override this method to commit gizmo handles. Called for this plugin's active gizmos.
|
|
</description>
|
|
</method>
|
|
<method name="create_gizmo" qualifiers="virtual">
|
|
<return type="EditorSpatialGizmo" />
|
|
<argument index="0" name="spatial" type="Spatial" />
|
|
<description>
|
|
Override this method to return a custom [EditorSpatialGizmo] for the spatial nodes of your choice, return [code]null[/code] for the rest of nodes. See also [method has_gizmo].
|
|
</description>
|
|
</method>
|
|
<method name="create_handle_material">
|
|
<return type="void" />
|
|
<argument index="0" name="name" type="String" />
|
|
<argument index="1" name="billboard" type="bool" default="false" />
|
|
<argument index="2" name="texture" type="Texture" default="null" />
|
|
<description>
|
|
Creates a handle material with its variants (selected and/or editable) and adds them to the internal material list. They can then be accessed with [method get_material] and used in [method EditorSpatialGizmo.add_handles]. Should not be overridden.
|
|
You can optionally provide a texture to use instead of the default icon.
|
|
</description>
|
|
</method>
|
|
<method name="create_icon_material">
|
|
<return type="void" />
|
|
<argument index="0" name="name" type="String" />
|
|
<argument index="1" name="texture" type="Texture" />
|
|
<argument index="2" name="on_top" type="bool" default="false" />
|
|
<argument index="3" name="color" type="Color" default="Color( 1, 1, 1, 1 )" />
|
|
<description>
|
|
Creates an icon material with its variants (selected and/or editable) and adds them to the internal material list. They can then be accessed with [method get_material] and used in [method EditorSpatialGizmo.add_unscaled_billboard]. Should not be overridden.
|
|
</description>
|
|
</method>
|
|
<method name="create_material">
|
|
<return type="void" />
|
|
<argument index="0" name="name" type="String" />
|
|
<argument index="1" name="color" type="Color" />
|
|
<argument index="2" name="billboard" type="bool" default="false" />
|
|
<argument index="3" name="on_top" type="bool" default="false" />
|
|
<argument index="4" name="use_vertex_color" type="bool" default="false" />
|
|
<description>
|
|
Creates an unshaded material with its variants (selected and/or editable) and adds them to the internal material list. They can then be accessed with [method get_material] and used in [method EditorSpatialGizmo.add_mesh] and [method EditorSpatialGizmo.add_lines]. Should not be overridden.
|
|
</description>
|
|
</method>
|
|
<method name="get_handle_name" qualifiers="virtual">
|
|
<return type="String" />
|
|
<argument index="0" name="gizmo" type="EditorSpatialGizmo" />
|
|
<argument index="1" name="index" type="int" />
|
|
<description>
|
|
Override this method to provide gizmo's handle names. Called for this plugin's active gizmos.
|
|
</description>
|
|
</method>
|
|
<method name="get_handle_value" qualifiers="virtual">
|
|
<return type="Variant" />
|
|
<argument index="0" name="gizmo" type="EditorSpatialGizmo" />
|
|
<argument index="1" name="index" type="int" />
|
|
<description>
|
|
Gets actual value of a handle from gizmo. Called for this plugin's active gizmos.
|
|
</description>
|
|
</method>
|
|
<method name="get_material">
|
|
<return type="SpatialMaterial" />
|
|
<argument index="0" name="name" type="String" />
|
|
<argument index="1" name="gizmo" type="EditorSpatialGizmo" default="null" />
|
|
<description>
|
|
Gets material from the internal list of materials. If an [EditorSpatialGizmo] is provided, it will try to get the corresponding variant (selected and/or editable).
|
|
</description>
|
|
</method>
|
|
<method name="get_name" qualifiers="virtual">
|
|
<return type="String" />
|
|
<description>
|
|
Override this method to provide the name that will appear in the gizmo visibility menu.
|
|
</description>
|
|
</method>
|
|
<method name="get_priority" qualifiers="virtual">
|
|
<return type="int" />
|
|
<description>
|
|
Override this method to set the gizmo's priority. Higher values correspond to higher priority. If a gizmo with higher priority conflicts with another gizmo, only the gizmo with higher priority will be used.
|
|
All built-in editor gizmos return a priority of [code]-1[/code]. If not overridden, this method will return [code]0[/code], which means custom gizmos will automatically override built-in gizmos.
|
|
</description>
|
|
</method>
|
|
<method name="has_gizmo" qualifiers="virtual">
|
|
<return type="bool" />
|
|
<argument index="0" name="spatial" type="Spatial" />
|
|
<description>
|
|
Override this method to define which Spatial nodes have a gizmo from this plugin. Whenever a [Spatial] node is added to a scene this method is called, if it returns [code]true[/code] the node gets a generic [EditorSpatialGizmo] assigned and is added to this plugin's list of active gizmos.
|
|
</description>
|
|
</method>
|
|
<method name="is_handle_highlighted" qualifiers="virtual">
|
|
<return type="bool" />
|
|
<argument index="0" name="gizmo" type="EditorSpatialGizmo" />
|
|
<argument index="1" name="index" type="int" />
|
|
<description>
|
|
Gets whether a handle is highlighted or not. Called for this plugin's active gizmos.
|
|
</description>
|
|
</method>
|
|
<method name="is_selectable_when_hidden" qualifiers="virtual">
|
|
<return type="bool" />
|
|
<description>
|
|
Override this method to define whether a Spatial with this gizmo should be selectable even when the gizmo is hidden.
|
|
</description>
|
|
</method>
|
|
<method name="redraw" qualifiers="virtual">
|
|
<return type="void" />
|
|
<argument index="0" name="gizmo" type="EditorSpatialGizmo" />
|
|
<description>
|
|
Callback to redraw the provided gizmo. Called for this plugin's active gizmos.
|
|
</description>
|
|
</method>
|
|
<method name="set_handle" qualifiers="virtual">
|
|
<return type="void" />
|
|
<argument index="0" name="gizmo" type="EditorSpatialGizmo" />
|
|
<argument index="1" name="index" type="int" />
|
|
<argument index="2" name="camera" type="Camera" />
|
|
<argument index="3" name="point" type="Vector2" />
|
|
<description>
|
|
Update the value of a handle after it has been updated. Called for this plugin's active gizmos.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<constants>
|
|
</constants>
|
|
</class>
|