Documentation

1. Installation

1. Go to Edit > Preferences > Add-ons.
2. Click Install from disk and navigate to your rigflow_0_1.zip file.
3. Enable the "Rigging: RigFlow" addon by checking the box.
4. The RigFlow panel will appear in the 3D View's sidebar (N key) under the "Rigging" tab.

2. Basic Workflow

1. Select the mesh object you want to rig.
2. In the RigFlow panel, click the "Start" button. Your viewport will now be in drawing mode.
3. To Draw a Path: Hold Ctrl and Left-Click + Drag your mouse across the surface of your mesh.
4. To Adjust: Release Ctrl. Now you can Left-Click and Drag any of the circular joint handles to move them.
5. When you are satisfied with your paths, click the "Generate Bones" button in the panel.
6. RigFlow will create a new Armature named "RigBoneArmature" and, if "Auto-Parent with Weights" is enabled, will parent your mesh to it.

3. Panel UI Explained

• Start / Rigging...: The main button to enter or exit the interactive drawing mode.
• Paths: Shows a live count of the number of separate bone paths you have drawn.

Drawing Mode Settings:

• Draw Mode (Selector): Switch between Draw and Extrude modes.
• Smoothing Strength: (Draw Mode only) Controls how much smoothing is applied to your freehand path. Higher values result in smoother, less noisy curves.
• Envelope Opacity: Adjusts the transparency of the bone volume preview.
• Snap Endpoints: If checked, the start/end of a path will try to snap to nearby paths or vertices.
• Snap Threshold: Controls the search distance for snapping.
• Mirror Bones: Toggle symmetrical drawing on or off.
• Mirror Axis: Choose the axis for mirroring (X, Y, or Z).

Bone Generation Settings:

• Bone Segments: (Draw Mode only) Sets the number of bones a single drawn path will be converted into.
• Auto-Connect: When generating, automatically connects and parents bones head/tail positions that match.
• Auto-Parent with Weights: After generation, automatically parents the active mesh to the new armature using Blender's automatic weighting.