@algorisys/tinyfly 0.88.0 → 0.89.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.
@@ -0,0 +1,9 @@
1
+ import type { ActingRig } from './acting';
2
+ /**
3
+ * Acting rigs: which pose fields lead, which drag, which wind up and how far.
4
+ * Limits are in each field's own units (degrees for joints).
5
+ */
6
+ /** The v1 stick figure (`StickPose`). */
7
+ export declare const STICK_ACTING_RIG: ActingRig;
8
+ /** The v2 human body plan (`HUMAN_REST` fields). */
9
+ export declare const HUMAN_ACTING_RIG: ActingRig;
@@ -200,7 +200,14 @@ export interface CharacterPoseKey {
200
200
  pose?: HumanPoseName | Pose;
201
201
  /** Easing into this key */
202
202
  easing?: EasingType;
203
+ /** `false`: the acting pass (`actCharacterTracks`) takes the move into this key as written */
204
+ act?: boolean;
203
205
  }
206
+ /**
207
+ * The pose at each key: a named pose, or the previous key's pose with the
208
+ * key's changes (the first builds on `rest`).
209
+ */
210
+ export declare function resolveCharacterPoseKeys(keys: CharacterPoseKey[], rest?: Pose): Pose[];
204
211
  /**
205
212
  * Keyframe tracks that move a character target through a sequence of poses.
206
213
  * Each key is a named pose or changes from the previous key (the first builds
@@ -20,3 +20,4 @@ export type { BodyPlan, ChainSpec, BoneSpec, BoneAngles, ContactSpec, HeadSpec,
20
20
  export { createPen, ellipsePoints, type Pen, type Look, type PencilOptions, type PenOptions } from './look/pen';
21
21
  export { basicOutfit, type BasicOutfitOptions } from './wardrobe/basic-outfit';
22
22
  export * from './hands';
23
+ export * from './acting';
@@ -447,7 +447,14 @@ export interface PoseKey {
447
447
  expression?: ExpressionName | Partial<Expression>;
448
448
  /** Easing into this key */
449
449
  easing?: EasingType;
450
+ /** `false`: the acting pass (`actTracks`) takes the move into this key as written */
451
+ act?: boolean;
450
452
  }
453
+ /**
454
+ * The full pose at each key: a named pose, or the previous key's pose with
455
+ * the key's changes (the first builds on rest), with the key's face applied.
456
+ */
457
+ export declare function resolvePoseKeys(keys: PoseKey[]): StickPose[];
451
458
  /**
452
459
  * Keyframe tracks that move `target` through a sequence of poses. Each key is
453
460
  * a named pose or changes from the previous key (the first builds on rest),
@@ -42,3 +42,10 @@ export declare class Clock {
42
42
  private _scheduleFrame;
43
43
  private _onFrame;
44
44
  }
45
+ /**
46
+ * Time held to the last drawing: animating "on twos" (12 drawings a second
47
+ * against a 24 fps film) means each pose shows for two frames. Given a
48
+ * time in ms and the drawings per second, the time of the drawing on screen.
49
+ * A rate of 0 (or less) leaves time continuous.
50
+ */
51
+ export declare function heldTime(time: number, drawingsPerSecond: number): number;
@@ -20,6 +20,13 @@ export interface VideoScene {
20
20
  height: number;
21
21
  /** Frames per second (default 30) */
22
22
  fps?: number;
23
+ /**
24
+ * Drawings per second for the timeline's animation: 12 holds every pose for
25
+ * two frames of 24 fps ("on twos"), 8 for three ("on threes"), as hand-drawn
26
+ * animation is timed. The frame rate (and `draw`, `background`) stays as set,
27
+ * so camera moves drawn there can stay smooth. Default: every frame.
28
+ */
29
+ drawingRate?: number;
23
30
  /** Length in ms (default: the timeline's duration) */
24
31
  duration?: number;
25
32
  /** Animation data; its markers drive stills and captions */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@algorisys/tinyfly",
3
- "version": "0.88.0",
3
+ "version": "0.89.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",