1 Commits

Author SHA1 Message Date
3ebf0184ee Few more readme details 2025-01-13 17:34:55 -06:00

View File

@ -1,17 +1,19 @@
# Yet Another Pose Library
In Blender 3.x, a new Asset-based Pose system was introduced. That's fine and dandy, but it was not (and still is not as of Jan 2025) ready to replace the old Action-based Pose Library system. The former Pose Library was deprecated and gutted rapidly during Blender 3.x, leaving legacy users high and dry.
For Blender 3.5 - 4.3 (4.1 recommended).
During the Blender 3.x releases, a new Asset-based Pose system was introduced. That's fine and dandy, but it was not (and still is not as of Jan 2025) ready to replace the old Action-based Pose Library system. The former Pose Library was quickly deprecated and removed, leaving legacy users high and dry.
This addon brings the Legacy Pose Library back as best as it can in a modern panel, and tries to stick as close to the old system as possible. Most, if not all existing Pose Libraries should work without any modifications. Little new is introduced outside of UI enhancements and handling for new data.
These other excellent addons also address this removal in their own ways:
These excellent addons also address this removal in their own ways, check them out:
- [Sakura Poselib](https://github.com/kafuji/Sakura_Poselib)
- [gret](https://github.com/greisane/gret?tab=readme-ov-file#animation-actions-panel)
- [Amarillo's Pose Library](https://github.com/AmarilloArts/Amarillos-Pose-Library)
## Old Features
- The Pose Library list layout is ported 1:1 to a Sidebar (N) panel.
- The Pose Library list panel is ported from Armature Data Properties to a Sidebar (N) panel.
- Operators and data property [that were removed in 3.5](https://projects.blender.org/blender/blender/issues/93406) are ported from C to Python:
- `yapl.apply_pose`
@ -27,8 +29,8 @@ These other excellent addons also address this removal in their own ways:
## New Features
- New (optional) panel interface for interacting with pose libraries, inspired by [gret's Actions Panel feature](https://github.com/greisane/gret?tab=readme-ov-file#animation-actions-panel).
- Hotkey/Modifier-centric: Hover over buttons for tooltips
- New panel interface for interacting with pose libraries, inspired by [gret's Actions Panel feature](https://github.com/greisane/gret?tab=readme-ov-file#animation-actions-panel).
- Hover over buttons for tooltips
- Operator to protect potentially-orphaned pose data (read Considerations)
- `yapl.protect_orphan_pose_library`
@ -40,12 +42,13 @@ These other excellent addons also address this removal in their own ways:
## Usage
1. Open Sidebar (`N`), and choose the `Pose` tab.
2. Select existing Pose Library from drop-down, or create a new library.
2. Select an Armature Object, or an Object parented to an Armature.
3. Select existing Pose Library from drop-down, or create a new library.
### Hotkeys:
### 3D View Hotkeys:
- `Shift + L` - Add/Replace Pose
- `Alt + L` - Browse Poses with Arrow Keys
### Menu Controls
### New Panel Controls
- `Single click` - Apply Pose
- `Shift + Click` - Rename Pose
- `Alt + Click` - Remove Pose