@algorisys/tinyfly 0.113.0 → 0.114.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 +5 -4
- package/docs/character-appearance.md +26 -0
- package/docs/editor-guide.md +1 -1
- package/docs/examples.md +1 -1
- package/docs/getting-started.md +1 -1
- package/docs/gsap-compat.md +1 -1
- package/docs/llm-guide.md +6 -1
- package/docs/maps.md +2 -2
- package/docs/teaching.md +1 -1
- package/lib/addons/characters.js +878 -872
- package/lib/addons/{cricket-play-DQqoiwTG.js → cricket-play-BZNhfgOK.js} +1764 -1663
- package/lib/addons/sports.js +1 -1
- package/lib/browser/tinyfly.iife.js +12 -12
- package/lib/browser/tinyfly.js +7326 -7223
- package/lib/browser/tinyfly.umd.js +12 -12
- package/lib/types/characters/body/body-shape.d.ts +86 -0
- package/lib/types/characters/body/organic-body.d.ts +16 -0
- package/lib/types/characters/index.d.ts +1 -0
- package/lib/types/characters/soft-cartoon-cast.d.ts +7 -0
- package/llms-full.txt +42 -9
- package/llms.txt +30 -30
- package/package.json +1 -1
- package/skills/tinyfly/SKILL.md +5 -1
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import type { BodyProfilePoint } from './organic-body';
|
|
2
|
+
/**
|
|
3
|
+
* A body described by tape-measure girths, as a tailor or a size chart gives
|
|
4
|
+
* them. Any unit works (cm, inches) as long as `height` uses the same one:
|
|
5
|
+
* only the ratios matter. The organic figure turns these into the torso's
|
|
6
|
+
* front width and its front and back depth, so the shape reads correctly from
|
|
7
|
+
* the front, the side and everywhere between.
|
|
8
|
+
*/
|
|
9
|
+
export interface BodyMeasurements {
|
|
10
|
+
/** Standing height, in the same unit as the girths */
|
|
11
|
+
height: number;
|
|
12
|
+
/** Bust (or chest) girth at its fullest */
|
|
13
|
+
bust: number;
|
|
14
|
+
/** Ribcage girth just under the bust (default 0.86 × bust); the difference is how far the bust projects */
|
|
15
|
+
underbust?: number;
|
|
16
|
+
/** Natural waist girth, at its narrowest */
|
|
17
|
+
waist: number;
|
|
18
|
+
/** Hip girth at the fullest part of the seat */
|
|
19
|
+
hip: number;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* The common body-shape families from size charts, as measurements of a
|
|
23
|
+
* 165 cm figure. Every shape suits any character; they are starting points,
|
|
24
|
+
* changed field by field like any other option.
|
|
25
|
+
*/
|
|
26
|
+
export declare const BODY_SHAPES: {
|
|
27
|
+
hourglass: {
|
|
28
|
+
height: number;
|
|
29
|
+
bust: number;
|
|
30
|
+
underbust: number;
|
|
31
|
+
waist: number;
|
|
32
|
+
hip: number;
|
|
33
|
+
};
|
|
34
|
+
pear: {
|
|
35
|
+
height: number;
|
|
36
|
+
bust: number;
|
|
37
|
+
underbust: number;
|
|
38
|
+
waist: number;
|
|
39
|
+
hip: number;
|
|
40
|
+
};
|
|
41
|
+
rectangle: {
|
|
42
|
+
height: number;
|
|
43
|
+
bust: number;
|
|
44
|
+
underbust: number;
|
|
45
|
+
waist: number;
|
|
46
|
+
hip: number;
|
|
47
|
+
};
|
|
48
|
+
invertedTriangle: {
|
|
49
|
+
height: number;
|
|
50
|
+
bust: number;
|
|
51
|
+
underbust: number;
|
|
52
|
+
waist: number;
|
|
53
|
+
hip: number;
|
|
54
|
+
};
|
|
55
|
+
round: {
|
|
56
|
+
height: number;
|
|
57
|
+
bust: number;
|
|
58
|
+
underbust: number;
|
|
59
|
+
waist: number;
|
|
60
|
+
hip: number;
|
|
61
|
+
};
|
|
62
|
+
};
|
|
63
|
+
export type BodyShapeName = keyof typeof BODY_SHAPES;
|
|
64
|
+
/** Torso profiles along the spine (hip 0 to neck 1), each a fraction of the height. */
|
|
65
|
+
export interface BodyShapeProfiles {
|
|
66
|
+
/** Half-width seen from the front */
|
|
67
|
+
torso: BodyProfilePoint[];
|
|
68
|
+
/** Depth from the spine line toward the chest and belly, seen from the side */
|
|
69
|
+
torsoFront: BodyProfilePoint[];
|
|
70
|
+
/** Depth from the spine line toward the back and seat, seen from the side */
|
|
71
|
+
torsoBack: BodyProfilePoint[];
|
|
72
|
+
/** Half-width of the hips at their fullest, for placing the legs */
|
|
73
|
+
hipHalfWidth: number;
|
|
74
|
+
}
|
|
75
|
+
/** The named shape's measurements, or the measurements as given; validated. */
|
|
76
|
+
export declare function resolveMeasurements(measurements: BodyMeasurements | BodyShapeName): Required<BodyMeasurements>;
|
|
77
|
+
/**
|
|
78
|
+
* Turn measurements into torso profiles. A pure function: the same
|
|
79
|
+
* measurements always give the same shape. `shoulder` is the half-width at
|
|
80
|
+
* the shoulders that the rest of the figure already uses.
|
|
81
|
+
*/
|
|
82
|
+
export declare function bodyShapeProfiles(measurements: BodyMeasurements | BodyShapeName, shoulder: number): BodyShapeProfiles;
|
|
83
|
+
/** Thighs fill out with the hips: their half-width at the top. */
|
|
84
|
+
export declare function measuredThighWidth(hipHalfWidth: number): number;
|
|
85
|
+
/** Half the spacing of the hip joints for these measurements: each thigh's outside meets the hip line. */
|
|
86
|
+
export declare function measuredHipWidth(measurements: BodyMeasurements | BodyShapeName): number;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type BodyMeasurements, type BodyShapeName } from './body-shape';
|
|
1
2
|
/** A contour's half-width as a share of character height, at 0..1 along it. */
|
|
2
3
|
export interface BodyProfilePoint {
|
|
3
4
|
at: number;
|
|
@@ -14,6 +15,19 @@ export interface SkinShading {
|
|
|
14
15
|
export interface OrganicBodyOptions {
|
|
15
16
|
/** Hip to neck: hips, waist, chest and shoulders. */
|
|
16
17
|
torso?: BodyProfilePoint[];
|
|
18
|
+
/**
|
|
19
|
+
* Seen from the side, the torso's depth from the spine line toward the
|
|
20
|
+
* chest and belly (front) and toward the back and seat (back). Default:
|
|
21
|
+
* `torso` × `depth` each way.
|
|
22
|
+
*/
|
|
23
|
+
torsoFront?: BodyProfilePoint[];
|
|
24
|
+
torsoBack?: BodyProfilePoint[];
|
|
25
|
+
/**
|
|
26
|
+
* The torso from tape-measure girths, or a named shape (`hourglass`, `pear`,
|
|
27
|
+
* `rectangle`, `invertedTriangle`, `round`; see BODY_SHAPES). Sets each of
|
|
28
|
+
* `torso`, `torsoFront`, `torsoBack` and the thighs that is not given too.
|
|
29
|
+
*/
|
|
30
|
+
measurements?: BodyMeasurements | BodyShapeName;
|
|
17
31
|
/** Shoulder to wrist: upper arm, elbow, forearm and wrist. */
|
|
18
32
|
arm?: BodyProfilePoint[];
|
|
19
33
|
/** Hip to ankle: thigh, knee, calf and ankle. */
|
|
@@ -33,6 +47,8 @@ export interface OrganicBodyOptions {
|
|
|
33
47
|
/** Resolved, owned JSON data. Profiles are copied once when making a character. */
|
|
34
48
|
export interface OrganicBody {
|
|
35
49
|
torso: BodyProfilePoint[];
|
|
50
|
+
torsoFront: BodyProfilePoint[];
|
|
51
|
+
torsoBack: BodyProfilePoint[];
|
|
36
52
|
arm: BodyProfilePoint[];
|
|
37
53
|
leg: BodyProfilePoint[];
|
|
38
54
|
neck: BodyProfilePoint[];
|
|
@@ -31,6 +31,7 @@ export { leafOutfit, leafOutfitContours, type LeafOutfitOptions, type LeafOutfit
|
|
|
31
31
|
export { softCartoonCharacter, SOFT_CARTOON_CAST, type SoftCartoonName } from './soft-cartoon-cast';
|
|
32
32
|
export { resolveOrganicBody, bodyProfileWidth, type OrganicBody, type OrganicBodyOptions, type BodyProfilePoint, type SkinShading } from './body/organic-body';
|
|
33
33
|
export { organicBodyContours, organicCenterLine, type OrganicBodyContours, type OrganicContour, type OrganicSample } from './body/organic-geometry';
|
|
34
|
+
export { BODY_SHAPES, bodyShapeProfiles, measuredHipWidth, resolveMeasurements, type BodyMeasurements, type BodyShapeName, type BodyShapeProfiles } from './body/body-shape';
|
|
34
35
|
export { humanPlan, humanPose, mirrorHumanPose, humanFieldLabel, HUMAN_REST, HUMAN_POSES, HUMAN_EXPRESSIONS, HUMAN_BUILDS, FOOT_SHAPES, type FootShape, type HumanBuild, type HumanBuildName, type HumanPoseName, type HumanExpressionName } from './species/human';
|
|
35
36
|
export { CHARACTER_CAST, ANIME_CAST, MANGA_CAST, castMember, type CastMember, type CastName, type AnimeCastName, type MangaCastName } from './cast';
|
|
36
37
|
export type { FaceOptions, PupilCircle } from './head/face';
|
package/llms-full.txt
CHANGED
|
@@ -591,7 +591,7 @@ with a GSAP-style call (durations are in seconds here):
|
|
|
591
591
|
```html
|
|
592
592
|
<div class="box" style="width:60px;height:60px;background:#4a9eff"></div>
|
|
593
593
|
|
|
594
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
594
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.114.0/cdn/tinyfly.iife.js"></script>
|
|
595
595
|
<script>
|
|
596
596
|
tinyfly.to('.box', { x: 200, duration: 1 })
|
|
597
597
|
</script>
|
|
@@ -799,7 +799,7 @@ Without a build step, the all-in-one bundle exposes the same functions on a
|
|
|
799
799
|
global — `tinyfly.to()`, `tinyfly.timeline()` and so on:
|
|
800
800
|
|
|
801
801
|
```html
|
|
802
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
802
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.114.0/cdn/tinyfly.iife.js"></script>
|
|
803
803
|
<script>
|
|
804
804
|
tinyfly.to('.box', { x: 200, duration: 1 })
|
|
805
805
|
</script>
|
|
@@ -2714,7 +2714,7 @@ For simple website embedding without a build system.
|
|
|
2714
2714
|
</html>
|
|
2715
2715
|
```
|
|
2716
2716
|
|
|
2717
|
-
Build the player with `npm run build:player` to generate `lib/player/tinyfly-player.iife.js`, or load it from the CDN: `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
2717
|
+
Build the player with `npm run build:player` to generate `lib/player/tinyfly-player.iife.js`, or load it from the CDN: `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.114.0/cdn/tinyfly-player.iife.js`.
|
|
2718
2718
|
|
|
2719
2719
|
---
|
|
2720
2720
|
|
|
@@ -7067,7 +7067,7 @@ The dialog shows the generated HTML/JavaScript code with a **Copy Code** button.
|
|
|
7067
7067
|
**Steps to embed:**
|
|
7068
7068
|
1. Build the player: `npm run build:player`
|
|
7069
7069
|
2. Copy `lib/player/tinyfly-player.iife.js` to your project (or load
|
|
7070
|
-
`https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
7070
|
+
`https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.114.0/cdn/tinyfly-player.iife.js`
|
|
7071
7071
|
instead; see [Deployment](DEPLOYMENT.md))
|
|
7072
7072
|
3. Copy the generated code into your HTML
|
|
7073
7073
|
4. Adjust the script `src` path if needed
|
|
@@ -8386,7 +8386,12 @@ lets hair occlude them, with a flatter profile facial plane and a nose above
|
|
|
8386
8386
|
the mouth; classic `cartoon` projection remains available. Foreground organic
|
|
8387
8387
|
arms/hands draw together over lower garments, preserving the wrist at the waist.
|
|
8388
8388
|
`body` owns JSON half-width profiles (`torso`, `arm`, `leg`, `neck`): increasing
|
|
8389
|
-
arrays of `{ at: 0..1, width: fractionOfHeight }` spanning 0 to 1.
|
|
8389
|
+
arrays of `{ at: 0..1, width: fractionOfHeight }` spanning 0 to 1. For a body
|
|
8390
|
+
in proportion, prefer `body.measurements`: a shape name (`hourglass`, `pear`,
|
|
8391
|
+
`rectangle`, `invertedTriangle`, `round`) or girths `{ height, bust, underbust?,
|
|
8392
|
+
waist, hip }` in one unit. It sets the front width, the side depth (bust forward,
|
|
8393
|
+
seat back) and the leg spacing, so the figure reads correctly at every `turn`.
|
|
8394
|
+
Don't hand-tune `torso` to fake a side view; `torsoFront`/`torsoBack` set depth. Set `skin`
|
|
8390
8395
|
once for exposed body, head and hands; `body.fill` overrides it.
|
|
8391
8396
|
Use `body.fill: 'none'` for outline-only exposed skin, including both hand
|
|
8392
8397
|
variants in every look. In 3D, only foreground arms use garment depths for
|
|
@@ -8656,7 +8661,7 @@ path for all of that:
|
|
|
8656
8661
|
</figure>
|
|
8657
8662
|
|
|
8658
8663
|
<!-- once, anywhere on the page (a site-wide footer is fine) -->
|
|
8659
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
8664
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.114.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
|
|
8660
8665
|
```
|
|
8661
8666
|
|
|
8662
8667
|
Every `[data-tinyfly-embed]` mounts when the page is ready, with no per-post
|
|
@@ -9928,8 +9933,8 @@ On a page with no build step, load the maps add-on after the browser bundle; it
|
|
|
9928
9933
|
adds to the same `tinyfly` global:
|
|
9929
9934
|
|
|
9930
9935
|
```html
|
|
9931
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
9932
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
9936
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.114.0/cdn/tinyfly.iife.js"></script>
|
|
9937
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.114.0/cdn/tinyfly-maps.iife.js"></script>
|
|
9933
9938
|
```
|
|
9934
9939
|
|
|
9935
9940
|
It is a separate script because the offline world map it carries adds about
|
|
@@ -10211,6 +10216,32 @@ height. Torso positions run hip to neck, arms shoulder to wrist, and legs
|
|
|
10211
10216
|
hip to ankle. Cubic centerlines pass through native elbow/knee joints with
|
|
10212
10217
|
interpolated width profiles. Options are copied at construction and can
|
|
10213
10218
|
travel as JSON. `body.depth` (0.2–1, default 0.55) sets torso side thickness.
|
|
10219
|
+
`body.torsoFront` and `body.torsoBack` (same format) set the torso's side
|
|
10220
|
+
view directly: its depth from the spine line toward the chest and belly, and
|
|
10221
|
+
toward the back and seat. They default to `torso × depth` each way.
|
|
10222
|
+
|
|
10223
|
+
### Body shape and measurements
|
|
10224
|
+
|
|
10225
|
+
`body.measurements` describes the torso the way a size chart does, so women,
|
|
10226
|
+
men and children of every build can be drawn in proportion:
|
|
10227
|
+
|
|
10228
|
+
```ts
|
|
10229
|
+
character({ figure: 'organic', body: { measurements: 'hourglass' } })
|
|
10230
|
+
character({ figure: 'organic', body: { measurements: { height: 165, bust: 94, underbust: 76, waist: 70, hip: 98 } } })
|
|
10231
|
+
```
|
|
10232
|
+
|
|
10233
|
+
The girths can be in any unit, as long as `height` uses the same one. `underbust`
|
|
10234
|
+
defaults to 0.86 × `bust`, and the difference between the two is how far the bust
|
|
10235
|
+
projects. Named shapes (`BODY_SHAPES`) are `hourglass`, `pear`, `rectangle`,
|
|
10236
|
+
`invertedTriangle` and `round`. Measurements set the front width, the side depth
|
|
10237
|
+
(the bust forward, the seat back, and a belly when the waist is close to the hips)
|
|
10238
|
+
and the hip and thigh spacing. Because each torso section is projected from both
|
|
10239
|
+
its width and its depth, the shape reads correctly at every `turn`, not only from
|
|
10240
|
+
the front. Clothing follows the same contour. Any explicit `torso`, `torsoFront`,
|
|
10241
|
+
`torsoBack` or `hipWidth` still wins. `softCartoonCharacter` drops its preset torso
|
|
10242
|
+
when you pass new measurements. The shapes are kept as stylised silhouettes, in
|
|
10243
|
+
proportion with the rest of the cast. In the editor, organic characters have a
|
|
10244
|
+
**Body shape** picker.
|
|
10214
10245
|
`body.fill` overrides `skin` for all exposed body, face and palms; omit it
|
|
10215
10246
|
to keep one `skin` colour control. The editor's Skin and Line controls show
|
|
10216
10247
|
the resolved fill and outline colour; editing them also updates any existing
|
|
@@ -15107,7 +15138,7 @@ magnet.addEventListener('pointerleave', () => {
|
|
|
15107
15138
|
|
|
15108
15139
|
<!-- capabilities: generated from the library -->
|
|
15109
15140
|
|
|
15110
|
-
# tinyfly capabilities (v0.
|
|
15141
|
+
# tinyfly capabilities (v0.114.0)
|
|
15111
15142
|
|
|
15112
15143
|
Generated from the library itself: every name below is accepted, and names not listed are rejected (beat scripts, code panels and `checkTracks` say which name was probably meant).
|
|
15113
15144
|
|
|
@@ -15393,6 +15424,8 @@ Appearance options of `character({ … })`, all plain data that turns with the h
|
|
|
15393
15424
|
- `build`: `standard`, `slim`, `tall`, `short`, `broad`, `curvy`, `stocky`, `kid`, `child`, `toddler`
|
|
15394
15425
|
- `figure`: `fluid`, `stick`, `organic`
|
|
15395
15426
|
- `body.torso · body.arm · body.leg · body.neck`: Organic half-width profiles: [{ at: 0..1, width: fractionOfHeight }], increasing from 0 to 1; independent of ink width.
|
|
15427
|
+
- `body.measurements`: Organic torso from tape-measure girths { height, bust, underbust?, waist, hip } in any one unit, or a named shape (hourglass | pear | rectangle | invertedTriangle | round). Sets the front width, the side depth (bust forward, seat back, belly) and the hip and thigh spacing; reads correctly at every turn. An explicit torso / torsoFront / torsoBack / hipWidth still wins.
|
|
15428
|
+
- `body.torsoFront · body.torsoBack`: Organic side-view depth from the spine line toward the chest/belly and toward the back/seat, same profile format; default torso × depth.
|
|
15396
15429
|
- `body.fill · body.outline · body.shading`: Shared skin fill, outline { color, width }, cel material { mode: cel | none, light: [x,y], shadow, opacity, highlight }.
|
|
15397
15430
|
- `softCartoonCharacter(name, options?)`: Original youngMan / youngWoman / childBoy / childGirl story presets. Children have larger head proportions, shorter limbs and rounded torsos; every face, hair, build, hand, clothing and material option can be overridden.
|
|
15398
15431
|
- `face.projection`: Organic default volume follows the head axes, keeps both eyes in three-quarter views and projects a small nose above the mouth; opaque hair covers features. cartoon keeps the classic face slide.
|
package/llms.txt
CHANGED
|
@@ -13,48 +13,48 @@ Key facts:
|
|
|
13
13
|
- For language models: read the capability catalog first (`npx @algorisys/tinyfly capabilities`, or the end of llms-full.txt). It is generated from the library, so every name in it (poses, expressions, gags, gaits, beat actions, canvas properties, code-panel edits) is accepted, and names not in it are rejected with the name probably meant. Check beat scripts with `npx @algorisys/tinyfly check beats.json`, tracks with `checkTracks(tracks, targets)`, and ask any target what it animates with `describeTarget(target)`. The npm package ships `docs/`, `llms.txt`, `llms-full.txt` and an agent skill (`skills/tinyfly/SKILL.md`); `docs/llm-guide.md` describes the workflow.
|
|
14
14
|
- Source: https://github.com/algorisys-oss/tinyfly. License: MIT.
|
|
15
15
|
|
|
16
|
-
All documentation and the interactive course in a single file: [llms-full.txt](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
16
|
+
All documentation and the interactive course in a single file: [llms-full.txt](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/llms-full.txt)
|
|
17
17
|
|
|
18
18
|
## Start here
|
|
19
19
|
|
|
20
|
-
- [Getting Started](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
21
|
-
- [GSAP Compatibility](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
22
|
-
- [Code Examples](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
23
|
-
- [Building Animations with an LLM](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
20
|
+
- [Getting Started](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/getting-started.md): What tinyfly is, making a first animation in the editor, and using it from code, a script tag or the CDN.
|
|
21
|
+
- [GSAP Compatibility](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/gsap-compat.md): The GSAP-style API (`live.to`, `tf.timeline`): supported vars, motion paths, morphSVG, text, inertia, Draggable, Flip, and where it differs from GSAP.
|
|
22
|
+
- [Code Examples](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/examples.md): Recipes with the engine API: fades, loops, colour and bezier easing, loading JSON, canvas and SVG rendering, multi-scene sequences, motion paths and script-tag embeds; a festive garba/dandiya scene with partner contacts, circle travel and spins, also rendered to video.
|
|
23
|
+
- [Building Animations with an LLM](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/llm-guide.md): For assistants and the people setting them up: read the capability catalog (`tinyfly capabilities`), ask targets what they animate (`describeTarget`), check beats and tracks with did-you-mean errors (`tinyfly check`, `checkTracks`), render stills to look at, and the agent skill shipped in the package.
|
|
24
24
|
|
|
25
25
|
## Reference
|
|
26
26
|
|
|
27
|
-
- [API Reference](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
28
|
-
- [File Format](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
27
|
+
- [API Reference](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/api-reference.md): Every public engine, player and adapter API: Timeline, tracks, keyframes, easing, drivers, serialization and exports.
|
|
28
|
+
- [File Format](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/file-format.md): The JSON animation format: timelines, every track kind, keyframes, easing and the project file — for generating or consuming animations.
|
|
29
29
|
|
|
30
30
|
## Editor features
|
|
31
31
|
|
|
32
|
-
- [Editor Guide](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
33
|
-
- [Shape Morphing](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
34
|
-
- [Pen Tool](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
35
|
-
- [Polygons & Stars](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
36
|
-
- [Grid & Snapping](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
37
|
-
- [Onion Skinning](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
38
|
-
- [Sprite-sheet Export](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
32
|
+
- [Editor Guide](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/editor-guide.md): Every panel and feature of the visual editor, from elements and keyframes to text and inertia tracks, preview and export.
|
|
33
|
+
- [Shape Morphing](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/shape-morph.md): Tweening one path into another, including shapes with different point counts and several subpaths.
|
|
34
|
+
- [Pen Tool](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/pen-tool.md): Drawing custom paths point by point with straight segments and bezier curves.
|
|
35
|
+
- [Polygons & Stars](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/polygon-star.md): Parametric polygon and star shapes that stay editable while animating like any path.
|
|
36
|
+
- [Grid & Snapping](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/grid-and-snapping.md): The grid overlay, snapping to grid, elements and artboard centre, and alignment guides.
|
|
37
|
+
- [Onion Skinning](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/onion-skinning.md): Ghost frames before and after the playhead for judging arcs and easing.
|
|
38
|
+
- [Sprite-sheet Export](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/sprite-sheet-export.md): Exporting frames as a PNG grid plus JSON metadata for game engines and canvas players.
|
|
39
39
|
|
|
40
40
|
## Guides
|
|
41
41
|
|
|
42
|
-
- [Cricket Stories](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
43
|
-
- [Scroll Animation](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
44
|
-
- [Props: Everyday Objects with Behaviours](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
45
|
-
- [Teaching Animations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
46
|
-
- [Rendering Video from Code](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
47
|
-
- [Animated Maps](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
48
|
-
- [Cartoon Hands](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
49
|
-
- [Character Appearance](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
50
|
-
- [Cartoon Acting](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
51
|
-
- [Dance and Flips](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
52
|
-
- [3D Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
53
|
-
- [3D Transforms and Rotations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
54
|
-
- [Extending tinyfly](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
55
|
-
- [Deployment](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
42
|
+
- [Cricket Stories](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/cricket.md): Reusable sports APIs, organic adult/child players, sixteen cricket plays, Test/ODI/T20 facts, contact-keyed JSON, captions, headless video and a 360° ground camera.
|
|
43
|
+
- [Scroll Animation](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/scroll-animation.md): Scroll-driven and play-when-visible animation with ScrollDriver and VisibilityDriver.
|
|
44
|
+
- [Props: Everyday Objects with Behaviours](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/props.md): Cars, trucks, buses, tractors, carts, train carriages, bikes, motorbikes, trees, houses, a helicopter and a plane: 3D rigs drawn with the characters’ pens (clean, pencil) that turn toward the camera, with beats acted through the 12 principles (anticipation, squash and stretch, follow-through, an exaggeration dial), wheels that roll exactly, effects, and figures riding them.
|
|
45
|
+
- [Teaching Animations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/teaching.md): Step-through explanatory figures: markers, captions in several languages, the teaching player, step controls, one-script declarative embeds, tinyfly/teach diagram primitives, and validate / render for build pipelines.
|
|
46
|
+
- [Rendering Video from Code](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/video-rendering.md): Rendering a scene to MP4 without a browser: `tinyfly video`, custom canvas targets drawn by code, timing from narration and recorded voice-over, the stick-figure character, SRT/WebVTT captions, stills, porting Cairo scripts, and a benchmark against pycairo.
|
|
47
|
+
- [Animated Maps](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/maps.md): Maps that animate: a camera that flies in to a city, pins that drop in, routes that draw themselves while a marker travels them, on OpenStreetMap tiles or an offline world outline (also in pencil), in the browser and in headless video.
|
|
48
|
+
- [Cartoon Hands](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/cartoon-hands.md): A hand you can pose: a palm and five fingers in 3D, posed by numbers (curls, thumb, spread, wrist turn), ready-made shapes from a fist to a pencil grip, left and right, four or five fingers, in clean, pencil and silhouette looks; the animator's hand and character gloves are built on it.
|
|
49
|
+
- [Character Appearance](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/character-appearance.md): Hair (34 styles), facial hair (20), glasses, hats and ears for the v2 character as plain data on the head, so they turn with it through all eight views; builds (child, tall, short…), a recurring cast (castMember), expressions with blush, tears and sweat, everyday poses, held items (mug, phone, bags, umbrella, parcel) and two characters’ hands meeting (meetHands: handshake, high five, hand-over).
|
|
50
|
+
- [Cartoon Acting](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/acting.md): actTracks(): the same key poses, acted: anticipation, overshoot and settle, overlapping joints, eyes that lead and blink, moving holds and jump squash, in full, snappy or limited styles; gags as data (take, double take, wind-up); a line of action (bend); gaits with personality; lip-sync from text (Latin and Devanagari); beat scripts compiled to acted tracks; your own actions (defineAction), gaits (defineGait) and personas (persona()); acting on code (codePanel lines and words as anchors: leap onto a line, point at it, swipe it away wiped, knocked off or blurred; grab, throw, kick, carry and drop words, push them along their line, write new text in by hand; ride a line as gaps close); camera shots (push in, cut, shake, follow); the cartoon zip; speed lines, dust puffs and impact stars; drawing on twos (a timeline setting); acting, gags, walks and lines in the editor.
|
|
51
|
+
- [Dance and Flips](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/dance.md): The stick figure dances disco, hip hop, breaking, jazz, K-pop, Bollywood, Bhangra, Bharatanatyam (with mudras), the Charleston, tap and popping, and does flips, leaps and splits; native v2 garba (two/three clap) and dandiya add body-local routines, circle formations, world foot plants, paired stick-tip contacts and signed spins; JSON bakes, timing, contact limits and editor menus.
|
|
52
|
+
- [3D Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/scene-3d.md): @algorisys/tinyfly/scene-3d: cameras, lights and meshes as JSON, in metres, animated by tracks at <scene>/<object> (cuts with activeCamera), drawn on a 2D canvas with flat, smooth or toon shading, ink outlines and fog, in browsers, Workers and Node (MP4 with tinyfly video); v2 characters in pen or solid looks, scripted native dances, timed signed spins and circle formations with foot contacts.
|
|
53
|
+
- [3D Transforms and Rotations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/3d-rotations.md): CSS-style 3D for flat elements in every renderer (rotateX, rotateY, z, perspective, backface visibility; true perspective on Canvas and WebGL, matching CSS within a pixel), one documented transform order, the editor's 3D fields; smooth quaternion rotations with interpolation: "slerp"; the vec3, quat and mat4 helpers; format version 2.
|
|
54
|
+
- [Extending tinyfly](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/extending.md): Writing a render adapter, animating any object with live and the ticker, custom and parametric eases, stagger offsets, adding a track kind, and contributing gallery examples.
|
|
55
|
+
- [Deployment](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/docs/DEPLOYMENT.md): Building and hosting the editor, and serving the player bundles.
|
|
56
56
|
|
|
57
57
|
## Optional
|
|
58
58
|
|
|
59
|
-
- [README](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
60
|
-
- [Release notes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
59
|
+
- [README](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/README.md): Feature overview, project layout and development setup.
|
|
60
|
+
- [Release notes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.114.0/release-notes/README.md): What changed in each version.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@algorisys/tinyfly",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.114.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Lightweight, API-driven animation engine and editor. The engine is framework-agnostic and runs in browsers, Web Workers, and Node.",
|
|
6
6
|
"license": "MIT",
|
package/skills/tinyfly/SKILL.md
CHANGED
|
@@ -134,7 +134,11 @@ names.
|
|
|
134
134
|
profile face and a nose projecting from above the mouth;
|
|
135
135
|
`face.projection: 'cartoon'` keeps the classic face slide. Optional JSON
|
|
136
136
|
`body` profiles (`torso`, `arm`, `leg`, `neck`) use increasing `{ at, width }`
|
|
137
|
-
from 0 to 1, with half-width fractions of height.
|
|
137
|
+
from 0 to 1, with half-width fractions of height. For realistic proportions
|
|
138
|
+
use `body.measurements`: `'hourglass' | 'pear' | 'rectangle' |
|
|
139
|
+
'invertedTriangle' | 'round'` or `{ height, bust, underbust?, waist, hip }`
|
|
140
|
+
in any one unit. It shapes width and side depth (bust/seat/belly) at every turn,
|
|
141
|
+
and `torsoFront`/`torsoBack` override the depth. Use `skin` for the whole exposed character;
|
|
138
142
|
`body.fill` overrides it; `'none'` makes exposed body/head/hands outline-only
|
|
139
143
|
in every look. Organic 3D painter ordering promotes only foreground arms to
|
|
140
144
|
torso/leg garment depths, leaving other parts at physical depths.
|