@algorisys/tinyfly 0.78.0 → 0.81.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -5
- package/lib/addons/characters.js +2479 -1009
- package/lib/browser/tinyfly.iife.js +4 -4
- package/lib/browser/tinyfly.js +4768 -3221
- package/lib/browser/tinyfly.umd.js +4 -4
- package/lib/engine/tinyfly-engine.js +874 -797
- package/lib/engine/tinyfly-engine.umd.cjs +2 -2
- package/lib/types/characters/acrobatics.d.ts +398 -0
- package/lib/types/characters/character.d.ts +26 -0
- package/lib/types/characters/dance.d.ts +196 -0
- package/lib/types/characters/hand.d.ts +57 -4
- package/lib/types/characters/hands/draw-cartoon-hand.d.ts +39 -0
- package/lib/types/characters/hands/hand-rig.d.ts +116 -0
- package/lib/types/characters/hands/index.d.ts +3 -0
- package/lib/types/characters/index.d.ts +4 -0
- package/lib/types/characters/species/human.d.ts +4 -1
- package/lib/types/characters/stick-figure.d.ts +86 -4
- package/lib/types/characters/stick-to-human.d.ts +27 -0
- package/lib/types/engine/authoring/beats.d.ts +64 -0
- package/lib/types/engine/authoring/index.d.ts +1 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -50,10 +50,13 @@ A lightweight, API-driven animation engine and visual editor for creating high-p
|
|
|
50
50
|
- **Immediate mode too** - A scene's `background` and `draw(ctx, { time })` functions paint each frame directly, Cairo/Processing-style, and mix freely with timeline targets
|
|
51
51
|
- **Timing from narration** - `planNarration()` lays spoken lines out from their clip lengths (lead, gap, tail) into cues, scene spans and markers; `voiceNarration()` measures recorded clips with ffmpeg and writes the sample-aligned narration WAV
|
|
52
52
|
- **Characters** - A poseable stick figure (`@algorisys/tinyfly/characters`): named poses, facial expressions (brows, eyes that widen, close and look around, mouth shapes), squash and stretch, rubber-hose limbs, blending, walk cycles and talking, all driven by timeline tracks. **Characters v2**: one skeleton in 3D drawn flat, turning front to side to back, resting on whatever touches the ground, reaching for points, in clean, pencil or silhouette looks, and a 🧍 Character element in the editor you pose and keyframe
|
|
53
|
+
- **Dance and flips** - The stick figure dances disco, hip hop, breaking toprock, jazz, K-pop, Bollywood, Bhangra, Bharatanatyam (with mudras), the Charleston and tap (foot strikes as data, for tap sounds), and does front, back, layout, scissor and side flips, cartwheels, back handsprings, split leaps, toe touches and full splits. Wrists, ankles, foot turn-out, whole-body `spin` and `rise` are pose fields; moves are keyed in beats, so any tempo plays them; styles, grooves and routines are plain JSON (`danceFrame()`, `danceTracks()`, `flipPose()`, `flipTracks()`). In the editor a 🧍 Character dances from the playhead, in time with the music: an Audio element's tempo is detected (`detectTempo()`) or tapped, the timeline shows its beats and bars, and keyframes snap to them. See [docs/dance.md](docs/dance.md)
|
|
53
54
|
- **Maps** - Animated maps on OpenStreetMap tiles or an offline world outline (also in pencil): the camera flies in, pins drop, routes draw themselves while a marker travels them; a 🗺 Map element in the editor with a one-click trip
|
|
54
55
|
- **Pencil sketch style** - Hand-drawn strokes with line boil (`sketch` style, `sketchPen`) for a pencil-test, Pencilmation-like look, on the stick figure and on canvas rect / circle / line / path shapes (also from the editor's Properties panel); a `drawOn` track draws any of those shapes on; the wobble is seeded by time, so renders stay deterministic
|
|
55
|
-
- **The drawing hand** - `drawnPathTarget()` draws a sketched stroke on from a `draw` track while a cartoon hand holds the pencil at its end; the same hand can hold the eraser
|
|
56
|
+
- **The drawing hand** - `drawnPathTarget()` draws a sketched stroke on from a `draw` track while a cartoon hand holds the pencil at its end in a writing grip; the same hand can hold the eraser. `handAt()` gives one hand for a whole scene: it follows each stroke, lifts and glides to the next, and enters and leaves the page
|
|
56
57
|
- **Erasing** - An eraser rubs out part of a target (`erasable()`, animated by an `erase` track) or of anything drawn in code (`withErased()`); clip-based, so it works in the browser and headless alike
|
|
58
|
+
- **Cartoon hands** - A hand rig in 3D, drawn flat: thumb and fingers posed by numbers (`index.curl`, `thumb.across`, `spread`, `turn`), ready-made shapes (fist, point, thumbs-up, peace, OK, pinch, wave, pencil grip…), left and right, four or five fingers, in every look; the animator's hand and (opt-in) character gloves are built on it. See [docs/cartoon-hands.md](docs/cartoon-hands.md)
|
|
59
|
+
- **Pencil story example** - `examples/pencil-story-hindi/index.html` tells a short Hindi story (प्यासा राहगीर, the thirsty traveller) Pencilmation-style with the browser bundle alone: the hand draws the scene and writes the narration, then rubs out the pot
|
|
57
60
|
- **Captions** - `toSRT()` / `toWebVTT()` from narration cues or from a timeline's markers
|
|
58
61
|
|
|
59
62
|
### Render Adapters
|
|
@@ -222,7 +225,7 @@ GSAP-shaped functions at the top level. Teaching embeds are included: add
|
|
|
222
225
|
itself.
|
|
223
226
|
|
|
224
227
|
```html
|
|
225
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
228
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.81.0/cdn/tinyfly.iife.js"></script>
|
|
226
229
|
<script>
|
|
227
230
|
tinyfly.to('.box', { x: 200, rotate: 90, duration: 1, ease: 'power2.out' })
|
|
228
231
|
|
|
@@ -258,7 +261,7 @@ A teaching figure needs no code at all:
|
|
|
258
261
|
<script type="application/json" data-tinyfly-timeline>{ …timeline JSON with markers… }</script>
|
|
259
262
|
<figcaption>Appending to a full slice</figcaption>
|
|
260
263
|
</figure>
|
|
261
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
264
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.81.0/cdn/tinyfly.iife.js" data-tinyfly-auto></script>
|
|
262
265
|
```
|
|
263
266
|
|
|
264
267
|
See [Teaching Animations](docs/teaching.md).
|
|
@@ -357,7 +360,7 @@ Without a build step, the player bundle puts the same functions on a `tinyfly` g
|
|
|
357
360
|
<div data-tinyfly="box" style="width: 60px; height: 60px; background: #4a9eff;"></div>
|
|
358
361
|
</div>
|
|
359
362
|
|
|
360
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
363
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.81.0/cdn/tinyfly-player.iife.js"></script>
|
|
361
364
|
<script>
|
|
362
365
|
tinyfly.play('#animation', './animation.json', { loop: -1 })
|
|
363
366
|
</script>
|
|
@@ -466,7 +469,7 @@ Or skip the code entirely with declarative embeds (see [Teaching Animations](doc
|
|
|
466
469
|
<svg viewBox="0 0 720 200">…</svg>
|
|
467
470
|
<script type="application/json" data-tinyfly-timeline>{ …timeline JSON… }</script>
|
|
468
471
|
</figure>
|
|
469
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
472
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.81.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
|
|
470
473
|
```
|
|
471
474
|
|
|
472
475
|
### Audio / Video Sync
|