Live2D Cubism Web Framework

The framework is organized into several functional components:

• effect: Provides functions to add motion-based effects to models, such as automatic blinking and lip-sync.
• id: Manages parameter names, part names, and Drawable names set on the model using unique types.
• math: Provides arithmetic operations required for model manipulation and rendering, including matrix and vector calculations.
• model: Provides core functions for handling models, including creation, updating, and destruction.
• motion: Provides functions for applying motion data to models, such as motion playback and parameter blending.
• physics: Provides functions to apply deformation operations to models via physics calculations.
• rendering: Provides a renderer that implements graphics commands for drawing the model.
• type: Provides type definitions used throughout the framework.
• utils: Provides utility functions such as JSON parsers and log output.

The CubismMath class provides a collection of static utility methods for common mathematical operations required for Live2D model calculations, including trigonometry, vector math, and equation solving. It also defines a constant Epsilon for floating-point comparisons.

Key capabilities include:

• Clamping and Range: Restricting values within a specific range.
• Trigonometry: Sine, cosine, and conversions between degrees and radians.
• Vector Math: Calculating directions and angles between CubismVector2 objects.
• Equation Solving: Solving quadratic and cubic equations (specifically using Cardano's algorithm for Bezier curves).
• Easing: Sine-based easing for fade-in/out effects.

import { CubismMath } from './math/cubismmath';

// Example: Clamping a value
const clamped = CubismMath.clamp(15, 0, 10); // returns 10

// Example: Converting degrees to radians
const rad = CubismMath.degreesToRadian(180);

// Example: Sine easing
const eased = CubismMath.getEasingSine(0.5);

The CubismUpdateScheduler is responsible for managing and executing a list of ICubismUpdater instances. It ensures that updaters are executed in the correct order by automatically sorting them based on their internal execution order before the next update cycle occurs. This is typically used during the late update phase of a model's lifecycle.

Key behaviors:

• Automatic Sorting: When an updater is added or its execution order changes (via onUpdaterChanged), the scheduler marks the list as needing a sort. The list is sorted using ICubismUpdater.sortFunction during the next call to onLateUpdate.
• Lifecycle Management: Use release() or clearUpdatableList() to remove all updaters and clean up listeners to prevent memory leaks.
• Duplicate Prevention: addUpdatableList will not add the same ICubismUpdater instance multiple times.

import { CubismUpdateScheduler } from './cubismupdatescheduler';

const scheduler = new CubismUpdateScheduler();

// Add updaters (must implement ICubismUpdater)
// scheduler.addUpdatableList(myUpdater);

// In your animation/render loop:
// scheduler.onLateUpdate(model, deltaTimeSeconds);

// Cleanup
// scheduler.release();