@laplace.live/pixijs-live2d 0.0.1 → 0.2.0

package/dist/index.d.ts

@@ -3024,6 +3024,12 @@ declare abstract class InternalModel extends EventEmitter {
   abstract parallelMotionManager: ParallelMotionManager<CubismMotion>[];
   pose?: unknown;
   physics?: unknown;
+  /**
+   * Retune the idle breath live, where the engine has one — `breathDepth` is a construction
+   * option, and a host that exposes it as a control needs to change it after load. Absent on a
+   * model type with no breath, so callers skip rather than branch.
+   */
+  setBreath?(enabled: boolean, depth?: number): void;
   /**
    * Original canvas width of the model. Note this doesn't represent the model's real size,
    * as the model can overflow from its canvas.
@@ -6949,6 +6955,8 @@ declare class CubismInternalModel extends InternalModel {
   parallelMotionManager: CubismParallelMotionManager[];
   lipSync: boolean;
   breath: CubismBreath;
+  /** Whether the idle breath contributes at all; see {@link setBreath}. */
+  breathEnabled: boolean;
   eyeBlink?: CubismEyeBlink;
   pose?: CubismPose;
   physics?: CubismPhysics;
@@ -6988,6 +6996,16 @@ declare class CubismInternalModel extends InternalModel {
   update(dt: DOMHighResTimeStamp, now: DOMHighResTimeStamp): void;
   updateFocus(): void;
   updateFacialEmotion(mouthForm: number): void;
+  /**
+   * The idle breath set, scaled by `breathDepth`. Amplitudes and periods are the Cubism sample's
+   * own: a head sway across `ParamAngle*`/`ParamBodyAngleX` alongside `ParamBreath` itself.
+   */
+  protected applyBreathParameters(): void;
+  /**
+   * Retune the idle breath live. `enabled: false` stops the contribution outright rather than
+   * scaling it to nothing, so a host can turn it off without losing the depth it returns to.
+   */
+  setBreath(enabled: boolean, depth?: number): void;
   updateNaturalMovements(dt: DOMHighResTimeStamp, _now: DOMHighResTimeStamp): void;
   draw(gl: WebGLRenderingContext): void;
   extendParallelMotionManager(managerCount: number): void;

package/dist/index.js

@@ -15140,6 +15140,8 @@ var CubismInternalModel = class extends InternalModel {
 	parallelMotionManager;
 	lipSync = true;
 	breath = CubismBreath.create();
+	/** Whether the idle breath contributes at all; see {@link setBreath}. */
+	breathEnabled = true;
 	eyeBlink;
 	renderer = new CubismRenderer_WebGL(0, 0);
 	idManager;
@@ -15192,13 +15194,7 @@ var CubismInternalModel = class extends InternalModel {
 			eyeBlink.setParameterIds?.(parameterIds);
 			this.eyeBlink = eyeBlink;
 		}
-		this.breath.setParameters([
-			new BreathParameterData(this.idParamAngleX, 0, 15 * this.options.breathDepth, 6.5345, .5),
-			new BreathParameterData(this.idParamAngleY, 0, 8 * this.options.breathDepth, 3.5345, .5),
-			new BreathParameterData(this.idParamAngleZ, 0, 10 * this.options.breathDepth, 5.5345, .5),
-			new BreathParameterData(this.idParamBodyAngleX, 0, 4 * this.options.breathDepth, 15.5345, .5),
-			new BreathParameterData(this.idParamBreath, 0, .5, 3.2345, .5)
-		]);
+		this.applyBreathParameters();
 		this.renderer.initialize(this.coreModel, getRequiredMaskRenderTextureCount(this.coreModel));
 		this.renderer.useHighPrecisionMask(this.renderer.isUsingHighPrecisionMask() || resolveHighPrecisionMaskOption(this.coreModel, this.options.useHighPrecisionMask));
 		this.renderer.setIsPremultipliedAlpha(true);
@@ -15315,8 +15311,31 @@ var CubismInternalModel = class extends InternalModel {
 	updateFacialEmotion(mouthForm) {
 		this.coreModel.addParameterValueById(this.idParamMouthForm, mouthForm);
 	}
+	/**
+	* The idle breath set, scaled by `breathDepth`. Amplitudes and periods are the Cubism sample's
+	* own: a head sway across `ParamAngle*`/`ParamBodyAngleX` alongside `ParamBreath` itself.
+	*/
+	applyBreathParameters() {
+		const depth = this.options.breathDepth ?? 1;
+		this.breath.setParameters([
+			new BreathParameterData(this.idParamAngleX, 0, 15 * depth, 6.5345, .5),
+			new BreathParameterData(this.idParamAngleY, 0, 8 * depth, 3.5345, .5),
+			new BreathParameterData(this.idParamAngleZ, 0, 10 * depth, 5.5345, .5),
+			new BreathParameterData(this.idParamBodyAngleX, 0, 4 * depth, 15.5345, .5),
+			new BreathParameterData(this.idParamBreath, 0, .5 * depth, 3.2345, .5)
+		]);
+	}
+	/**
+	* Retune the idle breath live. `enabled: false` stops the contribution outright rather than
+	* scaling it to nothing, so a host can turn it off without losing the depth it returns to.
+	*/
+	setBreath(enabled, depth = this.options.breathDepth ?? 1) {
+		this.breathEnabled = enabled;
+		this.options.breathDepth = depth;
+		this.applyBreathParameters();
+	}
 	updateNaturalMovements(dt, _now) {
-		this.breath?.updateParameters(this.coreModel, dt / 1e3);
+		if (this.breathEnabled) this.breath?.updateParameters(this.coreModel, dt / 1e3);
 	}
 	draw(gl) {
 		const matrix = this.drawingMatrix;