Welcome to mirror list, hosted at ThFree Co, Russian Federation.

git.blender.org/blender.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'doc/python_api')
-rw-r--r--doc/python_api/examples/bpy.types.ManipulatorGroup.py29
-rw-r--r--doc/python_api/sphinx_doc_gen.py3
2 files changed, 32 insertions, 0 deletions
diff --git a/doc/python_api/examples/bpy.types.ManipulatorGroup.py b/doc/python_api/examples/bpy.types.ManipulatorGroup.py
new file mode 100644
index 00000000000..fa431bc5a88
--- /dev/null
+++ b/doc/python_api/examples/bpy.types.ManipulatorGroup.py
@@ -0,0 +1,29 @@
+"""
+Manipulator Overview
+--------------------
+
+Manipulators are created using two classes.
+
+- :class:`bpy.types.ManipulatorGroup` - stores a list of manipulators.
+
+ The manipulator group is associated with a space and region type.
+- :class:`bpy.types.Manipulator` - a single item which can be used.
+
+ Each manipulator group has a collection of manipulators which it manages.
+
+The following example shows a manipulator group with a single,
+manipulator used to control a lamp objects energy.
+
+.. literalinclude:: __/__/__/release/scripts/templates_py/manipulator_simple.py
+
+
+It's also possible to use a manipulator to run an operator.
+
+.. literalinclude:: __/__/__/release/scripts/templates_py/manipulator_operator_target.py
+
+This more comprehensive example shows how an operator can create a temporary manipulator group to adjust its settings.
+
+.. literalinclude:: __/__/__/release/scripts/templates_py/manipulator_operator.py
+
+"""
+
diff --git a/doc/python_api/sphinx_doc_gen.py b/doc/python_api/sphinx_doc_gen.py
index a6ae89ffd6a..b3aebcf6188 100644
--- a/doc/python_api/sphinx_doc_gen.py
+++ b/doc/python_api/sphinx_doc_gen.py
@@ -332,6 +332,9 @@ except ImportError:
# to avoid having to match Blender's source tree.
EXTRA_SOURCE_FILES = (
"../../../release/scripts/templates_py/bmesh_simple.py",
+ "../../../release/scripts/templates_py/manipulator_operator.py",
+ "../../../release/scripts/templates_py/manipulator_operator_target.py",
+ "../../../release/scripts/templates_py/manipulator_simple.py",
"../../../release/scripts/templates_py/operator_simple.py",
"../../../release/scripts/templates_py/ui_panel_simple.py",
"../../../release/scripts/templates_py/ui_previews_custom_icon.py",