@algorisys/tinyfly 0.108.0 → 0.109.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 +9 -4
- package/docs/cricket.md +127 -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 +23 -0
- package/docs/maps.md +2 -2
- package/docs/teaching.md +1 -1
- package/lib/addons/characters.js +4821 -8840
- package/lib/addons/cricket-camera-BWByoNgz.js +4205 -0
- package/lib/addons/scene-3d.js +436 -540
- package/lib/addons/shots-DR_ViiAC.js +125 -0
- package/lib/addons/sports.js +390 -0
- package/lib/browser/tinyfly.iife.js +12 -12
- package/lib/browser/tinyfly.js +7945 -7470
- package/lib/browser/tinyfly.umd.js +12 -12
- package/lib/types/browser/index.d.ts +1 -0
- package/lib/types/characters/capabilities.d.ts +12 -0
- package/lib/types/sports/ball-flight.d.ts +22 -0
- package/lib/types/sports/cricket/cricket-action.d.ts +7 -0
- package/lib/types/sports/cricket/cricket-camera.d.ts +13 -0
- package/lib/types/sports/cricket/cricket-field.d.ts +13 -0
- package/lib/types/sports/cricket/cricket-motion.d.ts +36 -0
- package/lib/types/sports/cricket/cricket-types.d.ts +84 -0
- package/lib/types/sports/cricket/index.d.ts +5 -0
- package/lib/types/sports/index.d.ts +3 -0
- package/llms-full.txt +186 -8
- package/llms.txt +30 -29
- package/package.json +5 -1
- package/skills/tinyfly/SKILL.md +19 -0
|
@@ -46,6 +46,7 @@ export * from '../player';
|
|
|
46
46
|
export * from '../drivers';
|
|
47
47
|
export * from '../interaction';
|
|
48
48
|
export * from '../characters';
|
|
49
|
+
export * from '../sports';
|
|
49
50
|
export { tf, live, createLive, Stage, LiveTimeline, CompatTimeline, quickPlay, mapEase, CustomEase, CustomBounce, CustomWiggle, } from '../compat/gsap';
|
|
50
51
|
export { applyBloom } from '../adapters/canvas/bloom';
|
|
51
52
|
export type { BloomOptions } from '../adapters/canvas/bloom';
|
|
@@ -1,7 +1,19 @@
|
|
|
1
1
|
import { type PropertyInfo } from '../adapters/canvas/target-properties';
|
|
2
2
|
import type { SurfaceAbout } from './surface/surface';
|
|
3
3
|
import type { Cast } from './acting/custom';
|
|
4
|
+
import { CRICKET_FORMATS } from '../sports/cricket/cricket-types';
|
|
5
|
+
import { CRICKET_VIEWS } from '../sports/cricket/cricket-camera';
|
|
4
6
|
export interface Capabilities {
|
|
7
|
+
sports: {
|
|
8
|
+
cricket: {
|
|
9
|
+
actions: Record<string, {
|
|
10
|
+
name: string;
|
|
11
|
+
summary: string;
|
|
12
|
+
}>;
|
|
13
|
+
formats: typeof CRICKET_FORMATS;
|
|
14
|
+
cameras: typeof CRICKET_VIEWS;
|
|
15
|
+
};
|
|
16
|
+
};
|
|
5
17
|
version?: string;
|
|
6
18
|
timing: string;
|
|
7
19
|
easings: {
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { Track } from '../engine/types';
|
|
2
|
+
import type { Vec3 } from '../engine/math';
|
|
3
|
+
export interface BallFlightOptions {
|
|
4
|
+
target: string;
|
|
5
|
+
id?: string;
|
|
6
|
+
start: number;
|
|
7
|
+
end: number;
|
|
8
|
+
from: Vec3;
|
|
9
|
+
to: Vec3;
|
|
10
|
+
/** Height above the straight chord at halfway, in scene units. */
|
|
11
|
+
arc?: number;
|
|
12
|
+
/** Sideways displacement at halfway, in scene units. */
|
|
13
|
+
curve?: number;
|
|
14
|
+
/** Key spacing in ms, default 40. Contact endpoints are always included. */
|
|
15
|
+
every?: number;
|
|
16
|
+
}
|
|
17
|
+
export declare function finiteVector(value: Vec3, name: string): void;
|
|
18
|
+
export declare function sampleTimes(start: number, end: number, every?: number, contacts?: number[]): number[];
|
|
19
|
+
/** A pedagogical arc, not a physics simulation. Pure and suitable for any sport. */
|
|
20
|
+
export declare function ballFlightPoint(options: BallFlightOptions, time: number): Vec3;
|
|
21
|
+
/** Ordinary numeric tracks. Use several flights with shared endpoints for bounces/throws. */
|
|
22
|
+
export declare function ballFlightTracks(options: BallFlightOptions): Track[];
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { type CricketActionOptions, type CricketActionResult, type CricketClip, type CricketEvent, type CricketField, type CricketFieldOptions } from './cricket-types';
|
|
2
|
+
/** Compile an authored play on a cricketField into JSON tracks and narration events. No renderer or clock. */
|
|
3
|
+
export declare function cricketAction(field: CricketField, options?: CricketActionOptions): CricketActionResult;
|
|
4
|
+
/** An owned scene and timeline ready for browser/Worker/Node consumers. */
|
|
5
|
+
export declare function cricketClip(options?: CricketFieldOptions & CricketActionOptions): CricketClip;
|
|
6
|
+
/** Event/caption selection is time based, so seeking and reverse playback work too. */
|
|
7
|
+
export declare function cricketEventAt(events: readonly CricketEvent[], time: number): CricketEvent | undefined;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { Track } from '../../engine/types';
|
|
2
|
+
import { type CricketClip } from './cricket-types';
|
|
3
|
+
export type CricketView = 'pitch' | 'batter' | 'bowler' | 'keeper' | 'field' | 'overhead' | 'orbit' | 'follow-ball';
|
|
4
|
+
export declare const CRICKET_VIEWS: Readonly<Record<CricketView, string>>;
|
|
5
|
+
export declare const CRICKET_CAMERA_ANGLES: Readonly<Record<CricketView, number>>;
|
|
6
|
+
export interface CricketCameraOptions {
|
|
7
|
+
view?: CricketView;
|
|
8
|
+
/** Any azimuth, degrees; orbit adds one complete revolution to this angle. */
|
|
9
|
+
yaw?: number;
|
|
10
|
+
every?: number;
|
|
11
|
+
}
|
|
12
|
+
/** Public scene camera tracks; UI controls merely select these builder inputs. */
|
|
13
|
+
export declare function cricketCameraTracks(clip: CricketClip, options?: CricketCameraOptions): Track[];
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { type CricketField, type CricketFieldOptions, type CricketPlayer, type CricketPlayerOptions } from './cricket-types';
|
|
2
|
+
export declare const CRICKET_PITCH: Readonly<{
|
|
3
|
+
length: 20.12;
|
|
4
|
+
width: 3.05;
|
|
5
|
+
poppingCrease: 1.22;
|
|
6
|
+
returnCrease: 1.32;
|
|
7
|
+
stumpHeight: 0.711;
|
|
8
|
+
wicketWidth: 0.2286;
|
|
9
|
+
}>;
|
|
10
|
+
/** An owned JSON character object, on the existing organic rig. */
|
|
11
|
+
export declare function cricketPlayer(options: CricketPlayerOptions): CricketPlayer;
|
|
12
|
+
/** Standard pitch/creases; illustrative field positions and circular boundary. All units are metres. */
|
|
13
|
+
export declare function cricketField(options?: CricketFieldOptions): CricketField;
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { type Character } from '../../characters/character';
|
|
2
|
+
import { HAND_SHAPES } from '../../characters/hands/hand-rig';
|
|
3
|
+
import type { Pose } from '../../characters/rig/body-plan';
|
|
4
|
+
import { type Quat, type Vec3 } from '../../engine/math';
|
|
5
|
+
import type { CharacterObject3D, Scene3D } from '../../scene-3d/scene-types';
|
|
6
|
+
export interface CricketActor {
|
|
7
|
+
object: CharacterObject3D;
|
|
8
|
+
who: Character;
|
|
9
|
+
}
|
|
10
|
+
export interface BatFrame {
|
|
11
|
+
grip: Vec3;
|
|
12
|
+
axis: Vec3;
|
|
13
|
+
scale: number;
|
|
14
|
+
}
|
|
15
|
+
export interface CricketSample {
|
|
16
|
+
position: Vec3;
|
|
17
|
+
pose: Pose;
|
|
18
|
+
bat?: BatFrame;
|
|
19
|
+
}
|
|
20
|
+
export declare const progress: (time: number, start: number, end: number) => number;
|
|
21
|
+
export declare const smooth: (t: number) => number;
|
|
22
|
+
export declare const add: (a: Vec3, b: Vec3) => Vec3;
|
|
23
|
+
export declare const scale: (a: Vec3, b: number) => Vec3;
|
|
24
|
+
export declare function cricketActor(scene: Scene3D, id: string): CricketActor;
|
|
25
|
+
export declare function restSample(actor: CricketActor): CricketSample;
|
|
26
|
+
/** Actual native wrist/elbow/leg points in world space, including grounding and body yaw. */
|
|
27
|
+
export declare function cricketJoint(actor: CricketActor, sample: CricketSample, chain: string, index: number): Vec3;
|
|
28
|
+
export declare function cricketPalm(actor: CricketActor, sample: CricketSample, side: 'left' | 'right'): Vec3;
|
|
29
|
+
/** Solve to the rendered palm rather than snapping an unattached prop to a desired hand point. */
|
|
30
|
+
export declare function cricketReach(actor: CricketActor, sample: CricketSample, side: 'left' | 'right', target: Vec3, shape?: keyof typeof HAND_SHAPES): CricketSample;
|
|
31
|
+
export declare function gripBat(actor: CricketActor, sample: CricketSample, target: Vec3, axis: Vec3): CricketSample;
|
|
32
|
+
export declare function batSweetSpot(bat: BatFrame): Vec3;
|
|
33
|
+
/** Rotation from a mesh's +y axis to a world direction. Written as slerp keyframe data. */
|
|
34
|
+
export declare function alignCricketEquipment(direction: Vec3): Quat;
|
|
35
|
+
export declare function blendPose(a: Pose, b: Pose, t: number): Pose;
|
|
36
|
+
export declare function poseSequence(time: number, keys: Array<[number, Pose]>): Pose;
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import type { TimelineDefinition } from '../../engine/types';
|
|
2
|
+
import type { Vec3 } from '../../engine/math';
|
|
3
|
+
import type { CharacterObject3D, Scene3D } from '../../scene-3d/scene-types';
|
|
4
|
+
import type { CharacterOptions } from '../../characters/character';
|
|
5
|
+
import type { SoftCartoonName } from '../../characters/soft-cartoon-cast';
|
|
6
|
+
export type CricketFormat = 'test' | 'odi' | 't20';
|
|
7
|
+
export type CricketRole = 'batter' | 'bowler' | 'keeper' | 'fielder' | 'umpire';
|
|
8
|
+
export type CricketCast = 'adults' | 'children' | 'mixed';
|
|
9
|
+
export type CricketAction = 'bowling' | 'spin' | 'batting' | 'defend' | 'running' | 'four' | 'six' | 'catch' | 'fielding' | 'throw' | 'bowled' | 'lbw' | 'stumping' | 'run-out' | 'no-ball' | 'wide';
|
|
10
|
+
export interface CricketFormatInfo {
|
|
11
|
+
name: string;
|
|
12
|
+
inningsPerSide: number;
|
|
13
|
+
oversPerInnings: number | null;
|
|
14
|
+
ballsPerOver: number;
|
|
15
|
+
freeHitAfterNoBall: boolean;
|
|
16
|
+
summary: string;
|
|
17
|
+
}
|
|
18
|
+
/** Basic international format facts, not a full set of competition playing conditions. */
|
|
19
|
+
export declare const CRICKET_FORMATS: Readonly<Record<CricketFormat, Readonly<CricketFormatInfo>>>;
|
|
20
|
+
export interface CricketPlayerOptions {
|
|
21
|
+
id: string;
|
|
22
|
+
role: CricketRole;
|
|
23
|
+
preset?: SoftCartoonName;
|
|
24
|
+
format?: CricketFormat;
|
|
25
|
+
height?: number;
|
|
26
|
+
position?: Vec3;
|
|
27
|
+
color?: string;
|
|
28
|
+
/** Optional headwear; bare heads keep expressive faces clear in tutorial close-ups. */
|
|
29
|
+
headwear?: 'none' | 'cap' | 'sun-hat';
|
|
30
|
+
/** JSON appearance settings; canvas hooks and custom rig callbacks are deliberately excluded. */
|
|
31
|
+
appearance?: Pick<CharacterOptions, 'skin' | 'ink' | 'hair' | 'face' | 'body' | 'headSize' | 'shoulderWidth' | 'hipWidth' | 'armLength' | 'legLength' | 'handSize'>;
|
|
32
|
+
}
|
|
33
|
+
export interface CricketFieldOptions {
|
|
34
|
+
id?: string;
|
|
35
|
+
format?: CricketFormat;
|
|
36
|
+
cast?: CricketCast;
|
|
37
|
+
/** Circular illustrative boundary in metres, default 64; venues choose their own boundaries. */
|
|
38
|
+
boundaryRadius?: number;
|
|
39
|
+
battingColor?: string;
|
|
40
|
+
fieldingColor?: string;
|
|
41
|
+
}
|
|
42
|
+
export interface CricketField {
|
|
43
|
+
scene: Scene3D;
|
|
44
|
+
format: CricketFormat;
|
|
45
|
+
boundaryRadius: number;
|
|
46
|
+
landmarks: Record<string, Vec3>;
|
|
47
|
+
}
|
|
48
|
+
export interface CricketEvent {
|
|
49
|
+
id: string;
|
|
50
|
+
time: number;
|
|
51
|
+
kind: 'setup' | 'release' | 'bounce' | 'contact' | 'collect' | 'throw' | 'wicket' | 'boundary' | 'signal' | 'result';
|
|
52
|
+
label: string;
|
|
53
|
+
caption: string;
|
|
54
|
+
}
|
|
55
|
+
export interface CricketResult {
|
|
56
|
+
runs: number;
|
|
57
|
+
extras: number;
|
|
58
|
+
wickets: number;
|
|
59
|
+
legalBall: boolean;
|
|
60
|
+
freeHitNext: boolean;
|
|
61
|
+
dismissal?: 'caught' | 'bowled' | 'lbw' | 'stumped' | 'run-out';
|
|
62
|
+
}
|
|
63
|
+
export interface CricketActionOptions {
|
|
64
|
+
action?: CricketAction;
|
|
65
|
+
/** Complete clip length, default 6000 ms, 4000..60000. */
|
|
66
|
+
duration?: number;
|
|
67
|
+
every?: number;
|
|
68
|
+
}
|
|
69
|
+
export interface CricketActionResult {
|
|
70
|
+
action: CricketAction;
|
|
71
|
+
duration: number;
|
|
72
|
+
timeline: TimelineDefinition;
|
|
73
|
+
events: CricketEvent[];
|
|
74
|
+
/** Authored example outcome; no automatic scoring or umpiring is inferred from geometry. */
|
|
75
|
+
result: CricketResult;
|
|
76
|
+
}
|
|
77
|
+
export interface CricketClip extends CricketField, CricketActionResult {
|
|
78
|
+
}
|
|
79
|
+
export type CricketPlayer = CharacterObject3D;
|
|
80
|
+
export declare const CRICKET_ACTIONS: Readonly<Record<CricketAction, Readonly<{
|
|
81
|
+
name: string;
|
|
82
|
+
summary: string;
|
|
83
|
+
}>>>;
|
|
84
|
+
export declare function cricketChoice<T extends string>(choices: Readonly<Record<T, unknown>>, value: T, name: string): T;
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export { cricketPlayer, cricketField, CRICKET_PITCH } from './cricket-field';
|
|
2
|
+
export { cricketAction, cricketClip, cricketEventAt } from './cricket-action';
|
|
3
|
+
export { cricketCameraTracks, CRICKET_VIEWS, CRICKET_CAMERA_ANGLES, type CricketView, type CricketCameraOptions } from './cricket-camera';
|
|
4
|
+
export { CRICKET_FORMATS, CRICKET_ACTIONS } from './cricket-types';
|
|
5
|
+
export type { CricketFormat, CricketRole, CricketCast, CricketAction, CricketFormatInfo, CricketPlayerOptions, CricketFieldOptions, CricketField, CricketEvent, CricketResult, CricketActionOptions, CricketActionResult, CricketClip, CricketPlayer } from './cricket-types';
|
package/llms-full.txt
CHANGED
|
@@ -15,6 +15,138 @@ Key facts:
|
|
|
15
15
|
|
|
16
16
|
---
|
|
17
17
|
|
|
18
|
+
<!-- docs/cricket.md -->
|
|
19
|
+
|
|
20
|
+
# Cricket stories
|
|
21
|
+
|
|
22
|
+
Build a cricket scene and a play as JSON with `@algorisys/tinyfly/sports`.
|
|
23
|
+
The same data runs in a browser, Worker or Node. Players use tinyfly's
|
|
24
|
+
existing organic adult and child rig. Try the [interactive cricket example](https://tinyfly.app/examples/live-cricket-story)
|
|
25
|
+
or its [full-page view](https://tinyfly.app/examples/live-cricket-story/full).
|
|
26
|
+
|
|
27
|
+
```ts
|
|
28
|
+
import { Timeline } from '@algorisys/tinyfly'
|
|
29
|
+
import { cricketClip, cricketCameraTracks, cricketEventAt } from '@algorisys/tinyfly/sports'
|
|
30
|
+
import { characterObjects } from '@algorisys/tinyfly/characters'
|
|
31
|
+
import { loadScene3D, drawScene3D } from '@algorisys/tinyfly/scene-3d'
|
|
32
|
+
|
|
33
|
+
const clip = cricketClip({ format: 't20', action: 'stumping', cast: 'mixed' })
|
|
34
|
+
const tracks = [...clip.timeline.tracks, ...cricketCameraTracks(clip, { view: 'keeper' })]
|
|
35
|
+
const timeline = new Timeline({ ...clip.timeline, tracks })
|
|
36
|
+
const scene = loadScene3D(clip.scene, { kinds: [characterObjects] })
|
|
37
|
+
// Your explicit clock supplies time in milliseconds.
|
|
38
|
+
function draw(ctx, time) {
|
|
39
|
+
drawScene3D(ctx, scene, timeline.getStateAtTime(time).values,
|
|
40
|
+
{ width: 1280, height: 720, time })
|
|
41
|
+
const caption = cricketEventAt(clip.events, time)?.caption
|
|
42
|
+
return caption
|
|
43
|
+
}
|
|
44
|
+
const json = JSON.stringify({ ...clip, timeline: { ...clip.timeline, tracks } })
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
With script tags, load `tinyfly.iife.js` and the scene-3d add-on. Sports builders
|
|
48
|
+
and characters are available on `tinyfly`; scene rendering uses the add-on.
|
|
49
|
+
See [getting started](getting-started.md) for the versioned CDN URLs.
|
|
50
|
+
|
|
51
|
+
## Builders
|
|
52
|
+
|
|
53
|
+
| API | Result |
|
|
54
|
+
| --- | --- |
|
|
55
|
+
| `cricketPlayer({ id, role, preset?, format?, height?, position?, color?, headwear?, appearance? })` | An owned JSON `character` scene object. Roles: batter, bowler, keeper, fielder, umpire. Presets include youngMan, youngWoman, childBoy, childGirl. |
|
|
56
|
+
| `cricketField({ id?, format?, cast?, boundaryRadius?, battingColor?, fieldingColor? })` | `scene`, `format`, `boundaryRadius`, `landmarks`. A 20.12 × 3.05 metre pitch, standard creases, wickets/bails, two bats, ball, boundary, eleven fielding players, two batters and two umpires. |
|
|
57
|
+
| `cricketAction(field, { action?, duration?, every? })` | A JSON timeline, timed events/captions and declared example result. Does not modify the field. |
|
|
58
|
+
| `cricketClip(options)` | Combines field and action; default T20, adult cast, pace bowling, 6000 ms. |
|
|
59
|
+
| `cricketCameraTracks(clip, { view?, yaw?, every? })` | Ordinary scene camera tracks. Merge these with the action tracks. |
|
|
60
|
+
| `cricketEventAt(events, time)` | Most recent event at that time, including when seeking backward. |
|
|
61
|
+
| `ballFlightPoint(options, time)`, `ballFlightTracks(options)` | Shared sampled arcs for other sports too. `from`, `to`, `arc`, `curve`, `start`, `end`, `target`; exact endpoints. |
|
|
62
|
+
|
|
63
|
+
Units are metres, milliseconds and degrees. `cast` is `adults`, `children` or
|
|
64
|
+
`mixed`; `format` is `test`, `odi` or `t20`. `boundaryRadius` defaults to 64 m
|
|
65
|
+
and accepts 24–250 m. A boundary is venue dependent. Sampling defaults to 40 ms,
|
|
66
|
+
accepts 16–1000 ms and always includes play contact events. Durations accept
|
|
67
|
+
4000–60000 ms; changing duration scales the whole play. Player height accepts
|
|
68
|
+
0.5–3 m. Bare heads are the default; optional `headwear` is `none`, `cap` or
|
|
69
|
+
`sun-hat`. Appearance is JSON data, without canvas hooks or rig callbacks.
|
|
70
|
+
|
|
71
|
+
The standard action builder expects the named actors/equipment from
|
|
72
|
+
`cricketField`; required actors must be unparented with no object rotation or
|
|
73
|
+
scale. It owns poses and paths for that layout. Customize appearance and
|
|
74
|
+
uniforms before compiling; author your own scene tracks for a different layout.
|
|
75
|
+
|
|
76
|
+
## Plays and cameras
|
|
77
|
+
|
|
78
|
+
`CRICKET_ACTIONS` contains sixteen plays:
|
|
79
|
+
|
|
80
|
+
- `bowling`, `spin`: run-up, delivery, bounce and keeper collection.
|
|
81
|
+
- `batting`, `defend`: drive or block with two hands gripping the bat.
|
|
82
|
+
- `running`: batters change ends for one illustrated run.
|
|
83
|
+
- `four`, `six`: grounded boundary or boundary crossed in the air, with signals.
|
|
84
|
+
- `catch`, `fielding`, `throw`: aerial catch, ground collection or return throw.
|
|
85
|
+
- `bowled`, `lbw`, `stumping`, `run-out`: distinct authored dismissal examples.
|
|
86
|
+
- `no-ball`, `wide`: extra, umpire signal and an uncounted delivery.
|
|
87
|
+
|
|
88
|
+
The ball releases from a rendered palm, meets the blade at contact, and follows
|
|
89
|
+
the collecting hand. Bails move after the relevant wicket break. Bats scale
|
|
90
|
+
with child proportions. Events carry `id`, `time`, `kind`, `label`, `caption`;
|
|
91
|
+
the timeline also contains matching markers and English captions.
|
|
92
|
+
Drive and ground-fielding plays use distinct collection positions, with the
|
|
93
|
+
ball and fielder keyed to the same palm contact.
|
|
94
|
+
Defensive blocks retain their downward two-hand bat pose and emit the `contact`
|
|
95
|
+
event with the “Bat contact” label. Pace, spin, no-ball and stumping deliveries
|
|
96
|
+
pass outside the off stump on the side away from the batter, allowing for the
|
|
97
|
+
displayed ball and stump radii before collection. Bowled keeps its intentional
|
|
98
|
+
wicket collision; stumping keeps the later hand-held wicket break.
|
|
99
|
+
|
|
100
|
+
`CRICKET_VIEWS` offers `pitch`, `batter`, `bowler`, `keeper`, `field`, `overhead`,
|
|
101
|
+
`orbit` and `follow-ball`. `yaw` chooses any azimuth; `orbit` adds a complete
|
|
102
|
+
360° revolution over the play. `CRICKET_CAMERA_ANGLES` provides suggested
|
|
103
|
+
starting angles. Equivalent azimuths such as 0° and 360° use identical geometry.
|
|
104
|
+
The field camera's clipping range scales with the boundary radius so wide views
|
|
105
|
+
include the full supported ground. Following the ball samples only its three
|
|
106
|
+
position channels with forward keyframe cursors, using the requested camera
|
|
107
|
+
spacing without evaluating actor tracks.
|
|
108
|
+
|
|
109
|
+
Development full-page previews load the local browser API and scene add-ons;
|
|
110
|
+
production previews and copied HTML retain the versioned CDN bundles.
|
|
111
|
+
|
|
112
|
+
## Teaching scope
|
|
113
|
+
|
|
114
|
+
These are authored visual demonstrations. Arcs, the enlarged ball, timings,
|
|
115
|
+
field placements and results are illustrative. The API does not infer a
|
|
116
|
+
cricket decision from collisions, enforce every law, simulate ball physics,
|
|
117
|
+
manage an innings or supply lesson navigation/quizzes. `result` declares
|
|
118
|
+
`runs`, `extras`, `wickets`, `legalBall`, `freeHitNext` and optional `dismissal`.
|
|
119
|
+
Use it with your own tutorial, narration, scoring or lesson system.
|
|
120
|
+
|
|
121
|
+
`CRICKET_FORMATS` records basic Test, ODI and T20 differences. Test has two
|
|
122
|
+
innings per side and no innings over limit; ODI/T20 have one innings per side
|
|
123
|
+
and maximum 50/20 overs respectively. See the [ICC format overview](https://www.icc-cricket.com/about/cricket/game-formats/the-three-formats).
|
|
124
|
+
No-balls and wides each add one extra and do not count as legal over balls.
|
|
125
|
+
The stumping example uses a legal delivery and a batter outside their ground,
|
|
126
|
+
without an attempted run. The LBW caption explicitly leaves a full decision's
|
|
127
|
+
pitching, impact and bat-contact checks to the author. Consult the
|
|
128
|
+
[MCC Laws, 2026 edition](https://www.lords.org/getmedia/a4ef9f77-2a25-4f5b-a286-4601f08e6334/Laws-of-Cricket-2017-Code-4th-Edition-(2026)_5.pdf).
|
|
129
|
+
ODI/T20 no-balls lead to a free hit on the next legitimate delivery; Test
|
|
130
|
+
does not add this automatically. Competition rules and effective dates matter:
|
|
131
|
+
see [ICC playing conditions](https://www.icc-cricket.com/about/cricket/rules-and-regulations/playing-conditions)
|
|
132
|
+
and the [October 2026 changes](https://www.icc-cricket.com/news/key-changes-across-formats-with-new-icc-playing-conditions).
|
|
133
|
+
|
|
134
|
+
## Headless video
|
|
135
|
+
|
|
136
|
+
After `npm run build:libs`:
|
|
137
|
+
|
|
138
|
+
```sh
|
|
139
|
+
node bin/tinyfly.mjs video examples/headless-video/cricket-story.mjs --stills /tmp/cricket-story
|
|
140
|
+
node bin/tinyfly.mjs video examples/headless-video/cricket-story.mjs -o /tmp/cricket-story.mp4
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
The example consumes the same public clip, camera and scene APIs. JSON download
|
|
144
|
+
in the interactive example includes the selected camera tracks, ready to sample
|
|
145
|
+
again after parsing. Other sports can reuse `ballFlightTracks`, character rigs
|
|
146
|
+
and scene cameras; cricket-specific motion remains in the sports add-on.
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
18
150
|
<!-- docs/getting-started.md -->
|
|
19
151
|
|
|
20
152
|
# Getting Started with tinyfly
|
|
@@ -204,7 +336,7 @@ with a GSAP-style call (durations are in seconds here):
|
|
|
204
336
|
```html
|
|
205
337
|
<div class="box" style="width:60px;height:60px;background:#4a9eff"></div>
|
|
206
338
|
|
|
207
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
339
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.109.0/cdn/tinyfly.iife.js"></script>
|
|
208
340
|
<script>
|
|
209
341
|
tinyfly.to('.box', { x: 200, duration: 1 })
|
|
210
342
|
</script>
|
|
@@ -412,7 +544,7 @@ Without a build step, the all-in-one bundle exposes the same functions on a
|
|
|
412
544
|
global — `tinyfly.to()`, `tinyfly.timeline()` and so on:
|
|
413
545
|
|
|
414
546
|
```html
|
|
415
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
547
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.109.0/cdn/tinyfly.iife.js"></script>
|
|
416
548
|
<script>
|
|
417
549
|
tinyfly.to('.box', { x: 200, duration: 1 })
|
|
418
550
|
</script>
|
|
@@ -2327,7 +2459,7 @@ For simple website embedding without a build system.
|
|
|
2327
2459
|
</html>
|
|
2328
2460
|
```
|
|
2329
2461
|
|
|
2330
|
-
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.
|
|
2462
|
+
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.109.0/cdn/tinyfly-player.iife.js`.
|
|
2331
2463
|
|
|
2332
2464
|
---
|
|
2333
2465
|
|
|
@@ -6680,7 +6812,7 @@ The dialog shows the generated HTML/JavaScript code with a **Copy Code** button.
|
|
|
6680
6812
|
**Steps to embed:**
|
|
6681
6813
|
1. Build the player: `npm run build:player`
|
|
6682
6814
|
2. Copy `lib/player/tinyfly-player.iife.js` to your project (or load
|
|
6683
|
-
`https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
6815
|
+
`https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.109.0/cdn/tinyfly-player.iife.js`
|
|
6684
6816
|
instead; see [Deployment](DEPLOYMENT.md))
|
|
6685
6817
|
3. Copy the generated code into your HTML
|
|
6686
6818
|
4. Adjust the script `src` path if needed
|
|
@@ -7921,6 +8053,26 @@ bakes. See `docs/dance.md`.
|
|
|
7921
8053
|
|
|
7922
8054
|
## Characters with a look
|
|
7923
8055
|
|
|
8056
|
+
For cricket tutorials, import `cricketClip`, `cricketCameraTracks` and
|
|
8057
|
+
`cricketEventAt` from `@algorisys/tinyfly/sports`. The clip is an owned scene,
|
|
8058
|
+
JSON timeline, timed captions and declared result. Choose `test | odi | t20`,
|
|
8059
|
+
`adults | children | mixed`, and a play from `CRICKET_ACTIONS`. Merge camera
|
|
8060
|
+
tracks with action tracks; render with scene-3d plus `[characterObjects]`.
|
|
8061
|
+
The UI is a consumer of these APIs. `orbit` covers the full ground in 360°;
|
|
8062
|
+
`follow-ball` keys against the same ball tracks. Contacts are sampled exactly,
|
|
8063
|
+
including two-hand bat grip, release, catch and wicket break. These are authored
|
|
8064
|
+
demonstrations, not collision-based umpiring or an innings simulator. Do not
|
|
8065
|
+
infer new outcomes from the illustrative arcs. See `docs/cricket.md` and
|
|
8066
|
+
`examples/headless-video/cricket-story.mjs`; `/examples/live-cricket-story`
|
|
8067
|
+
has event seeking and downloadable scene/action/camera JSON.
|
|
8068
|
+
Wide cameras support the full 24–250 m boundary range; equivalent yaw angles
|
|
8069
|
+
use identical geometry. Ball-follow cameras sample only ball position channels.
|
|
8070
|
+
Render the headless example with `tinyfly video <scene.mjs> -o <output.mp4>`.
|
|
8071
|
+
Preserve the defensive block's two-hand blade contact and `contact` event.
|
|
8072
|
+
Keeper-bound pace/spin/no-ball/stumping paths clear the off stump with the
|
|
8073
|
+
displayed ball radius included, before palm collection. Keep bowled contact
|
|
8074
|
+
and the later stumping wicket break intentional when editing these paths.
|
|
8075
|
+
|
|
7924
8076
|
For original soft cartoon story characters, opt into `figure: 'organic'`.
|
|
7925
8077
|
Its default `face.projection: 'volume'` moves eyes/mouth around the head and
|
|
7926
8078
|
lets hair occlude them, with a flatter profile facial plane and a nose above
|
|
@@ -8162,6 +8314,9 @@ new-tab player using the same standalone HTML as Copy code. Live demos,
|
|
|
8162
8314
|
timeline examples and editable sample scenes play with their own controls
|
|
8163
8315
|
and scrolling, without the gallery panels. Use these URLs when sharing an
|
|
8164
8316
|
example for visual review.
|
|
8317
|
+
Development live previews load the local browser API and required add-ons, so
|
|
8318
|
+
unpublished APIs work before release. Production previews and copied pages
|
|
8319
|
+
keep the versioned CDN URLs.
|
|
8165
8320
|
|
|
8166
8321
|
---
|
|
8167
8322
|
|
|
@@ -8194,7 +8349,7 @@ path for all of that:
|
|
|
8194
8349
|
</figure>
|
|
8195
8350
|
|
|
8196
8351
|
<!-- once, anywhere on the page (a site-wide footer is fine) -->
|
|
8197
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
8352
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.109.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
|
|
8198
8353
|
```
|
|
8199
8354
|
|
|
8200
8355
|
Every `[data-tinyfly-embed]` mounts when the page is ready, with no per-post
|
|
@@ -9466,8 +9621,8 @@ On a page with no build step, load the maps add-on after the browser bundle; it
|
|
|
9466
9621
|
adds to the same `tinyfly` global:
|
|
9467
9622
|
|
|
9468
9623
|
```html
|
|
9469
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
9470
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
9624
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.109.0/cdn/tinyfly.iife.js"></script>
|
|
9625
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.109.0/cdn/tinyfly-maps.iife.js"></script>
|
|
9471
9626
|
```
|
|
9472
9627
|
|
|
9473
9628
|
It is a separate script because the offline world map it carries adds about
|
|
@@ -14642,7 +14797,7 @@ magnet.addEventListener('pointerleave', () => {
|
|
|
14642
14797
|
|
|
14643
14798
|
<!-- capabilities: generated from the library -->
|
|
14644
14799
|
|
|
14645
|
-
# tinyfly capabilities (v0.
|
|
14800
|
+
# tinyfly capabilities (v0.109.0)
|
|
14646
14801
|
|
|
14647
14802
|
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).
|
|
14648
14803
|
|
|
@@ -15057,6 +15212,29 @@ Edits:
|
|
|
15057
15212
|
- `move`: a part; { at, to: an anchor name or { x, y }, duration? }: carry the part there, loose
|
|
15058
15213
|
- `fling`: a part; { at, velocity?, spin?, gravity?, duration? }: knock the part off on a spinning arc
|
|
15059
15214
|
|
|
15215
|
+
## Cricket stories (`@algorisys/tinyfly/sports`)
|
|
15216
|
+
|
|
15217
|
+
`cricketClip({ format, action, cast })` returns an organic-player scene, JSON tracks, timed events/captions and a declared result. `cricketField`, `cricketPlayer` and `cricketAction` compose separately; `cricketCameraTracks` adds camera tracks. These are authored tutorial plays, not physics or automatic umpiring. See docs/cricket.md.
|
|
15218
|
+
|
|
15219
|
+
- `bowling`: Run up, deliver with a straight arm, bounce and follow through.
|
|
15220
|
+
- `spin`: A shorter approach and a curved illustrative flight before the bounce.
|
|
15221
|
+
- `batting`: Two hands on the bat, a backlift, contact and a follow-through.
|
|
15222
|
+
- `defend`: Meet the ball with a controlled bat and keep it close.
|
|
15223
|
+
- `running`: Both batters make the opposite ground to complete one run.
|
|
15224
|
+
- `four`: A struck ball reaches the boundary after touching the ground.
|
|
15225
|
+
- `six`: A struck ball clears the boundary before touching the ground.
|
|
15226
|
+
- `catch`: A fielder controls the struck ball before it touches the ground.
|
|
15227
|
+
- `fielding`: A fielder moves to the ball, bends and gathers it.
|
|
15228
|
+
- `throw`: Gather, wind up, release and return the ball to the keeper.
|
|
15229
|
+
- `bowled`: A legal delivery hits the wicket and removes a bail.
|
|
15230
|
+
- `lbw`: Pad contact and a projected path to the stumps illustrate an authored LBW decision.
|
|
15231
|
+
- `stumping`: The keeper holds the ball and breaks the wicket while the striker is out of ground, not attempting a run.
|
|
15232
|
+
- `run-out`: A direct throw breaks the wicket before the running batter makes that ground.
|
|
15233
|
+
- `no-ball`: The landing front foot oversteps the popping crease at release; one extra, no legal ball.
|
|
15234
|
+
- `wide`: An untouched delivery passes beyond reach for a normal stroke; one extra, no legal ball.
|
|
15235
|
+
|
|
15236
|
+
Formats: `test`, `odi`, `t20`. Casts: adults, children, mixed. Cameras: `pitch`, `batter`, `bowler`, `keeper`, `field`, `overhead`, `orbit`, `follow-ball`. Orbit turns 360° around the whole ground.
|
|
15237
|
+
|
|
15060
15238
|
## Camera shots (`cameraTracks(shots, { stage })`)
|
|
15061
15239
|
|
|
15062
15240
|
- **frame**: `{ at, duration?, easing?, frame: { focus?: { x, y }, scale?, rotate? } }: push in, pull out, or cut (duration 0)`
|
package/llms.txt
CHANGED
|
@@ -13,47 +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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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
|
-
- [
|
|
43
|
-
- [
|
|
44
|
-
- [
|
|
45
|
-
- [
|
|
46
|
-
- [
|
|
47
|
-
- [
|
|
48
|
-
- [
|
|
49
|
-
- [
|
|
50
|
-
- [
|
|
51
|
-
- [
|
|
52
|
-
- [3D
|
|
53
|
-
- [
|
|
54
|
-
- [
|
|
42
|
+
- [Cricket Stories](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.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.109.0/docs/DEPLOYMENT.md): Building and hosting the editor, and serving the player bundles.
|
|
55
56
|
|
|
56
57
|
## Optional
|
|
57
58
|
|
|
58
|
-
- [README](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
59
|
-
- [Release notes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.
|
|
59
|
+
- [README](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.109.0/README.md): Feature overview, project layout and development setup.
|
|
60
|
+
- [Release notes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.109.0/release-notes/README.md): What changed in each version.
|