auto_walk/README.md

# Unfold animation cycle

Unfold static Walk/run cycle along defined path.


<!-- /!\ Alpha, work in progress -->

<!-- **[Download latest]()** -->

<!-- ### [Demo Youtube]() -->

---  

## Description

sequencial set of tools:

- Fix character on curve
- Fit the curve on a ground object
- Animate the path (use key marked as 'EXTREME' type on selected foot pose bone)
- Define speed and adjust
- Expand anim cycle and step curve animation
- Pin feet on ground (use contact keys marked as 'EXTREME' for each feets)

### Where ?

Sidebar > Anim > unfold anim cycle

### TODO

- pin feets:
  - iterate in reverse in keys when pinning so last foot position is correct
  - create intermediate keys (at each frame when necessary) to prevent lateral sliding on curved path
      (maybe expose as an option... not needed if path is straight for example... or auto detect if path is full straight at the moment of pin ops)

- Expose methods to go back in action history


*things to consider*:

  - Expose foot ?
  - Store path animation on a separate action (but that mean NLA hadto be used every time)

Bonus:
  - Use position A-B method to generate curve (with retimed animation to prioritize speed over fidelity)
  - auto-determine foot bone to use for distance reference
  - create nurb path instead of curve
  - Smoothing keys after last freezed to avoid too much gap "pose click".

<!--
### DONE
- align curve to root
- Put curve forward motion on bones modifier's offset value as negative time offset (instead of using curve )
 -->
---

## Changelog:

0.7.0

- auto-detect foot to use for path animation
- button to go back and forth between curve edit and armature pose mode
- UI revamp showing better separation of tool categories

0.6.0

- World paste and `Jump next frame`
- more compact and improved ui for world paste
- fix errors in some operators

0.5.0

- pin feet working

0.4.2

- context manager for `expand cycle step` store / restore

0.4.1

- update fcurve after bake

0.4.0

- better curve creation

0.3.5

- partly working

0.3.3

- total wip

0.3.0

- Rework interface
- Add manual bone pinning: simple world space copy/paste + pose and jump prev/next
- Faster pin feets
- bool prop to disable end/curve stepping (interpolation as linear if needed)
- Switch action back to new curve when re-snapping to ground
- fix shrinkwrap
- fix rebake with linear
- error message when no fcurve has anim cycle

0.2.0:

- first working version

0.1.0:

- initial commit, halfway there