Picker Toolkit

Here’s a user‐focused guide to every control in the “Picker Toolkit” panel (in the 3D View’s UI region under Nascore_Tools). It’s organized into the three sub-sections you can toggle on or off with the top toolbar icons.

1. Top Toolbar Toggles

These three buttons show or hide the corresponding sections of the panel:

• Images 📷 (show_picker_images)
  Show/hide the Picker Images section.

• Shapes ☟ (show_picker_tools)
  Show/hide the Picker Bones & Shapes section.

• Share 🔗 (show_share_picker)
  Show/hide the Share Picker sub-panel (Import/Cleanup/Retarget).

2. Picker Images

(Visible when Images 📷 is enabled)

1. Load Linked Picker Data
   Scans the blend file for any existing picker-image planes or bone-groups (including linked/appended armatures) and populates the list.

2. Add ➕ (Create Picker Image)
   Captures the current 3D View as a transparent plane (“picker image”) parented to your armature, and adds it to the list.

3. Remove ❌ (Delete Picker Image)
   Deletes the selected picker-image plane, all its associated bones/shapes, and—if it was the last one—cleans up the root bone, empty, shapes and collections.

4. Attach 🔌 (Attach Picker Image)
   Re-prefixes existing picker bones to the currently selected image key, based on which original bones you have selected.

5. Image List
   A scrollable list of all picker images. For each entry you get:

   • Visible ☑️ toggle: Show/hide that image plane in the viewport.

   • Name button: Make that image the “active” one (changes which bones get created/attached).

6. Transforms for “”
   When an image is active, a sub-box appears with:

   • Location / Scale fields: numerically move or resize the plane.

   • Array Count & Offset: add an array modifier to duplicate the plane.

   • Attach/Detach to Camera (Constrain Root Bone to Camera): pin the picker root bone (and thus the plane) to follow your active camera.

   • Show Bones In Front: toggle armature’s “in front” display mode so picker shapes stay unobstructed.

3. Picker Bones & Shapes

(Visible when Shapes ☟ is enabled)

1. Add Shape Icons
   A grid of shape-type buttons — pick one then click in the viewport to place picker bones for the selected original bones:

   • Circle, Box, Triangle, Rectangle, Star, Arrow, Moon, Up/Down Arrow, Side Arrow, All Arrows, Plus
     (Create Picker Bones (Click to Place) with the chosen shape_type)

2. Draw Picker Shape ✏️
   Free-draw curve shapes instead of the predefined shapes.

3. Bone Color Themes
   16 small color swatches. Click to recolor selected picker bones (or group bone if that’s active) to one of the theme palettes.

4. Shape Size & Curve Resolution
   Numeric sliders to control global picker-shape scale and spline resolution.

5. Delete Picker Bones 🗑️
   Removes any selected picker bones (and their shapes) from your armature.

6. Select Bones
   Toggles between selecting originals and their corresponding picker bones. Handy for switching back and forth.

7. Edit Shapes ✂️ / Apply Edit
   First click: enter curve-edit on all selected picker-shapes so you can tweak points. Second click: exit and re-hide everything.

8. Left / Right Suffix
   Text fields defining what denotes “left” and “right” in your bone names (e.g. .L and .R) for mirroring.

9. Mirror Picker Bones
   Creates mirrored picker bones on the opposite side of your rig, based on those suffixes.

10. Transfer Picker Shape 🔄
    Copies the custom-shape curve from the active picker bone to any other selected bones’ pickers.

4. Share Picker

(Visible when Share 🔗 is enabled)

1. Import Picker Rig
   Append just the Picker_*_WGT collections and their armatures from another blend, then clean out everything except Picker data, and merge into your current rig.

2. Cleanup Picker Import
   Delete all bones except those starting with “Picker_”, strip drivers/actions/NLA, and purge orphans—handy for packaging just the picker rig.

3. Analyze main bones
   Scans your selected picker bones and attempts to build a mapping to their original bones (fuzzy–match, suffix, or explicit associated_bone).

4. Rename Picker bones
   Applies the mapping built by Analyze: renames picker bones (and their shapes/collections) to match your originals.

5. Mapping List
   A scrollable list of each picker → original entry. You can manually override any mapping via the eyedropper operator.

That’s every button and control you’ll find in the “Picker Toolkit” panel. Let me know if you need expansion on any one operator or screenshots for workflow!