Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xiaowuc2/pose-animator-
https://github.com/xiaowuc2/pose-animator-
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/xiaowuc2/pose-animator-
- Owner: xiaowuc2
- License: apache-2.0
- Created: 2020-05-11T11:51:27.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-12-11T05:28:23.000Z (about 2 years ago)
- Last Synced: 2023-03-05T14:09:07.967Z (almost 2 years ago)
- Language: JavaScript
- Size: 60.5 MB
- Stars: 13
- Watchers: 5
- Forks: 9
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Pose Animaton
Pose Animator takes a 2D vector illustration and animates its containing curves in real-time based on the recognition result from PoseNet and FaceMesh. It borrows the idea of skeleton-based animation from computer graphics and applies it to vector characters.
In skeletal animation a character is represented in two parts:
1. a surface used to draw the character, and
1. a hierarchical set of interconnected bones used to animate the surface.
In Pose Animator, the surface is defined by the 2D vector paths in the input SVG files. For the bone structure, Pose Animator provides a predefined rig (bone hierarchy) representation, designed based on the keypoints from PoseNet and FaceMesh. This bone structure’s initial pose is specified in the input SVG file, along with the character illustration, while the real time bone positions are updated by the recognition result from ML models.
// TODO: Add blog post link.
For more details on its technical design please check out this blog post.
### Demo 1: [Camera feed](https://pose-animator-demo.firebaseapp.com/camera.html)
The camera demo animates a 2D avatar in real-time from a webcam video stream.
### Demo 2: [Static image](https://pose-animator-demo.firebaseapp.com/static_image.html)
The static image demo shows the avatar positioned from a single image.
## Build And Run
Install dependencies and prepare the build directory:
```sh
yarn
```
To watch files for changes, and launch a dev server:
```sh
yarn watch
```
## Platform support
Demos are supported on Desktop Chrome and iOS Safari.
It should also run on Chrome on Android and potentially more Android mobile browsers though support has not been tested yet.
# Animate your own design
1. Download the [sample skeleton SVG here](/resources/samples/skeleton.svg).
1. Create a new file in your vector graphics editor of choice. Copy the group named ‘skeleton’ from the above file into your working file. Note:
* Do not add, remove or rename the joints (circles) in this group. Pose Animator relies on these named paths to read the skeleton’s initial position. Missing joints will cause errors.
* However you can move the joints around to embed them into your illustration. See step 4.
1. Create a new group and name it ‘illustration’, next to the ‘skeleton’ group. This is the group where you can put all the paths for your illustration.
* Flatten all subgroups so that ‘illustration’ only contains path elements.
* Composite paths are not supported at the moment.
* The working file structure should look like this:
```
[Layer 1]
|---- skeleton
|---- illustration
|---- path 1
|---- path 2
|---- path 3
```
1. Embed the sample skeleton in ‘skeleton’ group into your illustration by moving the joints around.
1. Export the file as an SVG file.
1. Open [Pose Animator camera demo](https://pose-animator-demo.firebaseapp.com/camera.html). Once everything loads, drop your SVG file into the browser tab. You should be able to see it come to life
I've improve a bit that the real project bt @yemount
If you really like my project please give me a star and improve the project by fork :D