Rename project to Yet Another Pose Library (for now)

This commit is contained in:
2025-01-13 16:03:46 -06:00
parent 21f2278990
commit 23ffed939a
6 changed files with 107 additions and 107 deletions

View File

@ -1,4 +1,4 @@
# Damn Simple Pose Library
# 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.
@ -10,19 +10,19 @@ The former Pose Library was deprecated and gutted rapidly during Blender 3.x, le
- 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:
- `dspl.apply_pose`
- `dspl.browse_poses`
- `dspl.create_pose_library`
- `dspl.convert_pose_library`
- `dspl.add_pose`
- `dspl.move_pose`
- `dspl.remove_pose`
- `dspl.rename_pose`
- `dspl.unlink_pose_library`
- `yapl.apply_pose`
- `yapl.browse_poses`
- `yapl.create_pose_library`
- `yapl.convert_pose_library`
- `yapl.add_pose`
- `yapl.move_pose`
- `yapl.remove_pose`
- `yapl.rename_pose`
- `yapl.unlink_pose_library`
- `Object.pose_library`
## Installation
1. [Download the repository as a zip](https://git.bkspl.me/breakingspell/DamnSimplePoseLibrary/archive/develop.zip), or otherwise clone the repository.
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.
3. Optionally configure the suffix strings to fit your workflow, and whether the orhpan checker should run at startup.
@ -43,6 +43,6 @@ The former Pose Library was deprecated and gutted rapidly during Blender 3.x, le
## Considerations
- Opening older scenes will cause existing Pose Libraries to unlink from their former targets and fall into orphan state. They can be re-linked and will retain their link when saved afterwards, but would otherwise disappear if saved without linking or protecting the datablock.
- This is due to the core DNA type `poselib` having been removed, so objects will drop the data. [There is no way to prevent this](https://developer.blender.org/docs/features/core/rna/#internals) as Python ID properties cannot be present at program runtime, only once the add-on is initialized.
- To mitgate, an operator is provided to protect orphaned pose libraries: `dspl.protect_orphan_pose_library`.
- To mitgate, an operator is provided to protect orphaned pose libraries: `yapl.protect_orphan_pose_library`.
- This add-on was made much easier by the `pose_markers` property being retained for converting old pose libraries to the new asset system. If they decide to remove that property as well, there will be a need to improvise an index-based lookup.