https://github.com/toxe/blender-scripts

Blender Scripts
https://github.com/toxe/blender-scripts

blender blender-python blender-scripts python

Last synced: 3 months ago
JSON representation

Blender Scripts

• Host: GitHub
• URL: https://github.com/toxe/blender-scripts
• Owner: Toxe
• License: mit
• Created: 2022-04-07T14:19:07.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2024-04-12T12:37:06.000Z (about 1 year ago)
• Last Synced: 2024-11-29T06:15:03.316Z (5 months ago)
• Topics: blender, blender-python, blender-scripts, python
• Language: Python
• Homepage:
• Size: 689 KB
• Stars: 4
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Blender Scripts

Open `Python.blend` for an example Blender file that contains all scripts.

Supported versions: Blender 3+ and 4+

## Operators

### Align Bone to Transform Orientation

Align bone to a *Custom Transform Orientation* and recalculate roll so that the bone Z axis points along the custom orientation X axis.

> Run the `op_align_bone_to_transform_orientation.py` script once to register the new "Align Bone to Transform Orientation" operation.

[op_align_bone_to_transform_orientation.py](op_align_bone_to_transform_orientation.py)

1. Go into *Edit Mode* (`Tab` when in *Object Mode*).

2. Switch to *Face Select* mode (`3`).

3. Select an object face.  

   ![align_bone_to_transform_orientation_03.png](images/align_bone_to_transform_orientation_03.png)

4. Create a *Custom Transform Orientation*.

   Two options:

   - Option 1: Open the command palette (`F3` or Edit --> Menu Search), type "transform create orientation" and execute the

     "Create Orientation" command. This will create a new *Custom Transform Orientation* called "Face" (by default).

     (Note: Older Blender versions will *not* automatically select the transform it. See: step 5.)

     ![align_bone_to_transform_orientation_04a.png](images/align_bone_to_transform_orientation_04a.png)

   - Option 2: Open the "Transform Orientations" menu in the header of your 3D Viewport editor and click on the `+` button.

     This will create a new *Custom Transform Orientation* called "Face" (by default) and automatically select it.

     ![align_bone_to_transform_orientation_04b.png](images/align_bone_to_transform_orientation_04b.png)

5. If your new *Custom Transform Orientation* isn't already selected: Open the "Transform Orientations" menu

   in the header of your 3D Viewport editor and select "Face" at the bottom. ("Face" is the default name if

   this was the first manually created custom orientation.)

   ![align_bone_to_transform_orientation_05.png](images/align_bone_to_transform_orientation_05.png)

6. Snap (`Shift+S`) --> Cursor to Selected

   ![align_bone_to_transform_orientation_06.png](images/align_bone_to_transform_orientation_06.png)

7. Select an existing armature and enter *Edit Mode*.

8. Either add a new bone or select an existing bone.

   ![align_bone_to_transform_orientation_08.png](images/align_bone_to_transform_orientation_08.png)

9. Open the command palette (`F3`) and type "Align Bone to Transform Orientation".  

   Or: Right click the bone in *Edit Mode* and select the same operation.

   ![align_bone_to_transform_orientation_09a.png](images/align_bone_to_transform_orientation_09a.png)

   ![align_bone_to_transform_orientation_09b.png](images/align_bone_to_transform_orientation_09b.png)

10. Now the bone sits orthogonal on the selected face and is rolled in a way that its Z axis points along the X axis of the

    *Custom Transform Orientation*.

    ![align_bone_to_transform_orientation_10a.png](images/align_bone_to_transform_orientation_10a.png)

    ![align_bone_to_transform_orientation_10b.png](images/align_bone_to_transform_orientation_10b.png)

11. The newly created "Face" orientation can now be deleted.

## Test Scripts

Just a couple of test scripts.

### [test_move_cursor.py](test_move_cursor.py)

Get location of a vertex and move cursor to Z +1 in local space.

### [test_object_info.py](test_object_info.py)

Show object info and convert vertex coordinates between local and global space.