From 7bdb5c41a897b44acaaf0309b6190deb3242f577 Mon Sep 17 00:00:00 2001
From: Yuri Sizov <yuris@humnom.net>
Date: Mon, 3 Aug 2020 18:31:27 +0300
Subject: [PATCH] Improve Inspector plugin tutorial with a better example

---
 .../editor/img/inspector_plugin_example.png   | Bin 0 -> 12747 bytes
 .../plugins/editor/inspector_plugins.rst      | 163 ++++++++++++------
 2 files changed, 108 insertions(+), 55 deletions(-)
 create mode 100644 tutorials/plugins/editor/img/inspector_plugin_example.png

diff --git a/tutorials/plugins/editor/img/inspector_plugin_example.png b/tutorials/plugins/editor/img/inspector_plugin_example.png
new file mode 100644
index 0000000000000000000000000000000000000000..774302b99171a2bda7fdc120231b50b97d14610d
GIT binary patch
literal 12747
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

literal 0
HcmV?d00001

diff --git a/tutorials/plugins/editor/inspector_plugins.rst b/tutorials/plugins/editor/inspector_plugins.rst
index 84c7504ed..aa9b82a0e 100644
--- a/tutorials/plugins/editor/inspector_plugins.rst
+++ b/tutorials/plugins/editor/inspector_plugins.rst
@@ -4,53 +4,79 @@ Inspector plugins
 =================
 
 The inspector dock supports custom plugins to create your own widgets for
-editing properties. This tutorial explains how to use the
-:ref:`class_EditorInspectorPlugin` and :ref:`class_EditorProperty` classes to
-write such plugins with the example of creating a custom value editor.
+editing properties. This can be beneficial when working with custom datatypes
+and resources, but may be used to change the default behavior for built-in
+types as well. It is possible to introduce custom controls for specific properties,
+entire objects, and even detached controls associated with particular datatypes.
+
+This tutorial explains how to use the :ref:`class_EditorInspectorPlugin` 
+and :ref:`class_EditorProperty` classes to create a custom control for each
+property of the integer type, replacing the default behavior with a button 
+that generates random values between numbers 0 and 99.
+
+.. figure:: img/inspector_plugin_example.png
+   :align: center
+
+   The default behavior on the left, and the end result on the right.
+
 
 Setup
 -----
 
-Just like :ref:`doc_making_plugins`, we start out by making a new plugin,
-getting a ``plugin.cfg`` file created, and start with our
-:ref:`class_EditorPlugin`.  However, instead of using
-``add_custom_node`` or ``add_control_to_dock`` we'll use
-``add_inspector_plugin``.
+Follow the :ref:`doc_making_plugins` guide to setup the framework for your 
+new plugin. Lets assume you've called your plugin folder ``my_inspector_plugin``.
+If so, you should end up with a new ``addons/my_inspector_plugin`` folder 
+that contains two files: ``plugin.cfg`` and ``plugin.gd``.
+
+As before, ``plugin.gd`` is a script extending :ref:`class_EditorPlugin` and you
+need to introduce new code for its ``_enter_tree`` and ``_exit_tree`` methods. To
+setup your inspector plugin you must load its script and then create and add
+the instance using ``add_inspector_plugin``. If the plugin is disabled you should 
+remove the instance you have added using ``remove_inspector_plugin``.
+
+.. note:: Take note, that here you are loading a script and not a packed scene.
+          Therefore you should use ``new()`` instead of ``instance()``.
 
 .. tabs::
   .. code-tab:: gdscript GDScript
-    # MyEditorPlugin.gd
+    # plugin.gd
     tool
     extends EditorPlugin
 
-
     var plugin
 
 
     func _enter_tree():
-        # EditorInspectorPlugin is a resource, so we use `new()` instead of `instance()`.
-        plugin = preload("res://addons/MyPlugin/MyInspectorPlugin.gd").new()
+        plugin = preload("res://addons/my_inspector_plugin/MyInspectorPlugin.gd").new()
         add_inspector_plugin(plugin)
 
 
     func _exit_tree():
         remove_inspector_plugin(plugin)
 
+
 EditorInspectorPlugin
 ---------------------
 
-To actually connect into the Inspector, we create a
-:ref:`class_EditorInspectorPlugin` class. This script provides the "hooks" to
-the inspector. Thanks to this class, the editor will call the functions within
-the EditorInspectorPlugin while it goes through the process of building the UI
-for the inspector. The script is used to check if we should enable ourselves for
-any :ref:`class_Object` that is currently in the inspector (including any
-:ref:`class_Resource` that is embedded!).
+To be able to interact with the inspector dock, your ``MyInspectorPlugin.gd`` script
+must extend the :ref:`class_EditorInspectorPlugin` class. This class provides 
+several virtual methods that can be implemented to affect the way the inspector 
+is handling properties.
 
-Once enabled, EditorInspectorPlugin has methods that allow for adding
-:ref:`class_EditorProperty` nodes or just custom :ref:`class_Control` nodes to
-the beginning and end of the inspector for that :ref:`class_Object`, or for
-overriding or changing existing property editors.
+To have any effect at all the script must implement the ``can_handle()`` method. This
+function is called for each edited :ref:`class_Object` and must return ``true`` if 
+this plugin should handle the object or its properties (including any :ref:`class_Resource`
+that is embedded!).
+
+There are 4 other methods that can be implemented to add controls to the inspector at
+specific positions. The ``parse_begin()`` and ``parse_end()`` functions are called only once
+at the beginning and the end of parsing for each object, respectively. They can be used to
+add controls at the very top or very bottom of the inspector layout with ``add_custom_control``.
+
+As the object is parsed the ``parse_category()`` and ``parse_property()`` functions are 
+called. In addition to ``add_custom_control`` both ``add_property_editor`` and 
+``add_property_editor_for_multiple_properties`` can be utilized. These methods are used
+specifically to add :ref:`class_EditorProperty`-based controls.
 
 .. tabs::
  .. code-tab:: gdscript GDScript
@@ -58,71 +84,98 @@ overriding or changing existing property editors.
     # MyInspectorPlugin.gd
     extends EditorInspectorPlugin
 
+    var RandomIntEditor = preload("res://addons/my_inspector_plugin/RandomIntEditor.gd")
+
 
     func can_handle(object):
-        # Here you can specify which object types (classes) should be handled by
-        # this plugin. For example if the plugin is specific to your player
-        # class defined with `class_name MyPlayer`, you can do:
-        # `return object is MyPlayer`
-        # In this example we'll support all objects, so:
+        # We will support all objects in this example.
         return true
 
 
     func parse_property(object, type, path, hint, hint_text, usage):
         # We will handle properties of type integer.
         if type == TYPE_INT:
-            # Register *an instance* of the custom property editor that we'll define next.
-            add_property_editor(path, MyIntEditor.new())
-            # We return `true` to notify the inspector that we'll be handling
-            # this integer property, so it doesn't need to parse other plugins
-            # (including built-in ones) for an appropriate editor.
+            # Create an instance of the custom property editor and register
+            # it to a specific property path.
+            add_property_editor(path, RandomIntEditor.new())
+            # Inform the editor to remove the default property editor for 
+            # this property type.
             return true
         else:
             return false
 
+
 EditorProperty
 --------------
 
-Next, we define the actual :ref:`class_EditorProperty` custom value editor that
-we want instantiated to edit integers. This is a custom :ref:`class_Control` and
-we can add any kinds of additional nodes to make advanced widgets to embed in
-the inspector.
+The :ref:`class_EditorProperty` class is a special type of :ref:`class_Control` that
+can interact with edited objects inside of the inspector dock. By itself it doesn't
+display anything, but can house any other control nodes, including complex
+scenes.
+
+There are three essential parts to the script extending :ref:`class_EditorProperty`:
+
+1. There must be the ``_init`` method that sets up the node structure of the control.
+
+2. The ``update_property()`` method should be implemented to handle changes to the 
+   data from the outside.
+
+3. A signal must be emitted at some point to inform the inspector that the control has
+   changed the property using ``emit_changed``.
+
+You can display your custom widget in two ways. Use the default ``add_child`` method
+to display it to the right of the property name, and ``set_bottom_editor`` to position
+it below the name.
 
 .. tabs::
  .. code-tab:: gdscript GDScript
 
-    # MyIntEditor.gd
+    # RandomIntEditor.gd
     extends EditorProperty
-    class_name MyIntEditor
 
 
+    # The main control for editing the property.
+    var property_control = Button.new()
+    # An internal value of the property.
+    var current_value = 0
+    # A guard against internal changes when the property is updated.
     var updating = false
-    var spin = EditorSpinSlider.new()
 
 
     func _init():
-       # We'll add an EditorSpinSlider control, which is the same that the
-       # inspector already uses for integer and float edition.
-       # If you want to put the editor below the property name, use:
-       # `set_bottom_editor(spin)`
-       # Otherwise to put it inline with the property name use:
-       add_child(spin)
-       # To remember focus when selected back:
-       add_focusable(spin)
-       # Setup the EditorSpinSlider
-       spin.set_min(0)
-       spin.set_max(1000)
-       spin.connect("value_changed", self, "_spin_changed")
+        # Add the control as a direct child of EditorProperty node.
+        add_child(property_control)
+        # Make sure the control is able to retain the focus.
+        add_focusable(property_control)
+        # Setup the initial state and connect to the signal to track changes.
+        property_control.text = "Value: " + str(current_value)
+        property_control.connect("pressed", self, "_on_button_pressed")
 
 
-    func _spin_changed(value):
+    func _on_button_pressed():
+        # Ignore the signal if the property is currently being updated.
         if (updating):
             return
-        emit_changed(get_edited_property(), value)
+        
+        # Generate a new random integer between 0 and 99.
+        current_value = randi() % 100
+        property_control.text = "Value: " + str(current_value)
+        emit_changed(get_edited_property(), current_value)
 
 
     func update_property():
+        # Read the current value from the property.
         var new_value = get_edited_object()[get_edited_property()]
+        if (new_value == current_value):
+            return
+        
+        # Update the control with the new value.
         updating = true
-        spin.set_value(new_value)
+        current_value = new_value
+        property_control.text = "Value: " + str(current_value)
         updating = false
+
+
+Using the example code above you should be able to make a custom widget
+that replaces the default :ref:`class_SpinBox` control for integers with
+a :ref:`class_Button` that generates random values.