Few more readme details
This commit is contained in:
33
README.md
33
README.md
@ -1,14 +1,20 @@
|
||||
# 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.
|
||||
For Blender 3.5 - 4.3 (4.1 recommended).
|
||||
|
||||
The former Pose Library was deprecated and gutted rapidly during Blender 3.x, leaving legacy users high and dry. This addon brings the feature back as best as it can in a modern panel. Most, if not all existing Pose Libraries should work without any modifications, little new is introduced outside of string suffixes and mitigations (read further).
|
||||
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.
|
||||
|
||||
## Features
|
||||
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 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 panel is ported from Armature Data Properties to a Sidebar (N) panel.
|
||||
|
||||
- Supports Blender 3.3 - 4.3 (4.1 recommended).
|
||||
- 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).
|
||||
- The older Pose Library list layout is provided as option.
|
||||
- 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`
|
||||
- `yapl.browse_poses`
|
||||
@ -21,6 +27,14 @@ The former Pose Library was deprecated and gutted rapidly during Blender 3.x, le
|
||||
- `yapl.unlink_pose_library`
|
||||
- `Object.pose_library`
|
||||
|
||||
## New Features
|
||||
|
||||
- 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`
|
||||
|
||||
## Installation
|
||||
1. [Download the repository as a zip](https://git.bkspl.me/breakingspell/YetAnotherPoseLibrary/archive/develop.zip), or otherwise clone the repository.
|
||||
2. Install as an Add-on in Blender via Install -> Zip, and enable.
|
||||
@ -28,12 +42,13 @@ The former Pose Library was deprecated and gutted rapidly during Blender 3.x, le
|
||||
|
||||
## 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
|
||||
|
Reference in New Issue
Block a user