Bone Circle operator and support for 3.2+

Author: arocull

.vscode/settings.json

@@ -1,10 +1,10 @@
 {
     "python.autoComplete.extraPaths": [
-        "blender_autocomplete/3.0"
+        "blender_autocomplete/3.2"
     ],
     "python.linting.pylintArgs": [
         "--init-hook",
-        "import sys; sys.path.append('blender_autocomplete/3.0')"
+        "import sys; sys.path.append('blender_autocomplete/3.2')"
     ],
     "python.analysis.extraPaths": [
         "blender_autocomplete/3.0"

README.md

@@ -1,22 +1,23 @@
 # BoneJuice
 Armature utility plugin for Blender, for niche cases I encounter where it would be a lot nicer to have something do the work for me!
 
-Version 0.0.7 which supports Blender 3.0+
+Version 0.0.8 which supports Blender 3.2+
 
 Feature List (click on the links to see how-to/examples):
 - Object Mode
     - **[Clean and Combine](docs/examples/clean_and_combine.md)** - Combine multiple meshes, with modifiers, into one export-ready object. Armatures are preserved.
-    - **[Merge Vertex Groups](docs/examples/merge_vertex_groups.md)** - Combine two vertex groups on selected meshes using a given operation. Also available in Weight Paint mode.
+    - **[Merge/Operate Vertex Groups](docs/examples/merge_vertex_groups.md)** - Run a math operation on one or two vertex groups. Also available in Weight Paint mode.
 - Armature Edit Mode
+    - **[Add Bone Circle](docs/examples/add_bone_circle.md)** - Creates a circle of bones around an active bone, with rolls adjusted to face it
     - **[Add Leaf Bones](docs/examples/add_leaf_bones.md)** - Add leaf bones to an armature for external purposes
     - **[Select End Bones](docs/examples/select_end_bones.md)** - Select bones at the bottom of the hiearchy
     - **[Surface Bone Placer](docs/examples/surface_bone_placer.md)** - Place bones on geometric surfaces with a single click
     - **[Mark Bone Side](docs/examples/mark_bone_side.md)** - Mark bones as left or right in an armature. Alternative to built-in method which relies on specific rules.
 - Armature Pose Mode
     - **[Set Rotation Mode](docs/examples/set_bone_rotation_mode.md)** - Select multiple pose bones and set their rotation mode (Quaternion, XYZ Euler, Axis Angle, etc) with just the click of a button. Alternative to built-in method which can be hit-or-miss (although this will not convert keyframed transforms).
-    - **[Curl Bones](docs/examples/curl_bones.md)** - Offsets euler rotations of all selected pose bones by the given rotation. Only works in Euler rotation mode.
+    - **[Curl Bones](docs/examples/curl_bones.md)** - Offsets euler rotations of all selected pose bones by the given rotation. Currently only works in Euler rotation mode.
 - Rendering
-    - **(Work In Progress) Batch Render NLA Tracks** - Individually render out each animated NLA track inside of all selected objects. Renders from all selected cameras. Great for game animation previews, or spritesheets.
+    - **(Work In Progress) Batch Render NLA Tracks** - Individually render out each animated NLA track inside of all selected objects. Renders from all selected cameras. Great for game animation previews or spritesheets.
 
 # Installation
 Download the zip file from the releases area on GitHub, and then go to `Edit > Preferences > Add-ons` and then click `Install` in the top right, and select the zip file. Make sure the plugin it points to is enabled.

docs/examples/add_bone_circle.md

@@ -0,0 +1,39 @@
+# Add Leaf Bones
+Creates a circle of bones around the active bone, with bone rolls adjusted to face said active bone.
+Useful for radial symmetry.
+
+Additional roll offset can be added with the built-in `Set Roll` command (which takes a roll in radians).
+
+## Accessing
+While editing an Armature, go to `Add > Add Bone Circle`.
+
+## Use
+Make the bone active you want to place a circle around, and run the operator.
+
+## Example - Jetpack Thruster
+Place and make active a bone for the center of your thruster.
+
+![](../images/exmp_bonecircle1.png)
+
+Then run `Add > Add Bone Circle`--this will create a circle around your active bone. Adjust settings as needed.
+
+![](../images/exmp_bonecircle2.png)
+
+You can see that the bone rolls were adjusted so each bone has the same axis facing the center of the circle.
+
+Also, my bones are spaced evenly, but my fins aren't lining up. That's an issue with how my geometry is placed, not the bones themselves.
+
+![](../images/exmp_bonecircle3.png)
+
+If necessary, you can use Blender's built-in `Set Roll` command to adjust the rolls. Note that this takes a value in radians.
+Use pi to offset rolls by 180 degrees.
+
+![](../images/exmp_bonecircle4.png)
+
+Now our Z axis is facing outward instead of inward!
+
+![](../images/exmp_bonecircle5.png)
+
+I also selected the ends of the bones, then scaled them in to create a funneling effect.
+
+![](../images/exmp_bonecircle6.png)

docs/examples/merge_vertex_groups.md

@@ -1,7 +1,9 @@
-# Merge Vertex Groups
+# Merge/Operate Vertex Groups
+Run a math operation on one or two vertex groups. Useful for things like merging two vertex groups.
+
 ## Accessing
 From Object mode, select the objects you want to edit, and go to `Object > Apply > Merge Vertex Groups`.
-The operation should apply to all possible objects it can, which is useful for multi-mesh character rigs.
+The operation should apply to all selected objects it can, which is useful for multi-mesh character rigs.
 
 Or, if you're in Weight Paint Mode, simply go to `Weights > Merge Vertex Groups`.
 This will allow real-time view of the operation if you make changes after applying it.