three-vat 2.1.0 → 4.0.0

package/dist/chunk-3PWAY6MD.js

@@ -1,211 +0,0 @@
-import { FloatType, DataTexture, RGBAFormat, NearestFilter } from 'three';
-
-// src/vat-texture.ts
-var MAX_TEXTURE_SIZE = 16384;
-function makeVATTexture(data, width, height, type = FloatType) {
-  const tex = new DataTexture(data, width, height, RGBAFormat, type);
-  tex.minFilter = NearestFilter;
-  tex.magFilter = NearestFilter;
-  tex.generateMipmaps = false;
-  tex.needsUpdate = true;
-  return tex;
-}
-
-// src/instance-playback.ts
-var PACK_TEXELS = {
-  clip: 0,
-  playback: 1,
-  fade: 2
-};
-var PACK_WIDTH = 3;
-var PACK_STRIDE = PACK_WIDTH * 4;
-var LoopMode = {
-  /** Play the clip end to end, forever (or `repetitions` times). */
-  Repeat: 0,
-  /** Play the clip through once. */
-  Once: 1,
-  /** Play forward, then backward, without baking the reversed frames. */
-  PingPong: 2
-};
-var EndMode = {
-  /** Hold the last frame. */
-  Clamp: 0,
-  /** Return to the first frame. */
-  Rewind: 1
-};
-var INFINITE_REPETITIONS = -1;
-var MAX_FADE_DURATION = 0.25;
-function defaultRepetitions(loopMode) {
-  return loopMode === LoopMode.Repeat ? INFINITE_REPETITIONS : 1;
-}
-var LIBRARY_PLAYBACK_DEFAULTS = {
-  loopMode: LoopMode.Repeat,
-  repetitions: defaultRepetitions(LoopMode.Repeat),
-  endMode: EndMode.Clamp,
-  speed: 1
-};
-function resolvedPlaybackOf(instance) {
-  const { clip } = instance;
-  const clipLoopMode = clip.loopMode ?? LIBRARY_PLAYBACK_DEFAULTS.loopMode;
-  const loopMode = instance.loopMode ?? clipLoopMode;
-  const clipRepetitions = loopMode === clipLoopMode ? clip.repetitions : void 0;
-  return {
-    loopMode,
-    repetitions: instance.repetitions ?? clipRepetitions ?? defaultRepetitions(loopMode),
-    endMode: instance.endMode ?? clip.endMode ?? LIBRARY_PLAYBACK_DEFAULTS.endMode,
-    speed: instance.speed ?? clip.speed ?? LIBRARY_PLAYBACK_DEFAULTS.speed
-  };
-}
-function fadeOf(instance) {
-  const duration = Math.min(instance.fadeDuration ?? 0, MAX_FADE_DURATION);
-  const from = instance.from;
-  if (!from || duration <= 0 || from.frames <= 0) return null;
-  return { from, duration };
-}
-function fadeRowOf(from) {
-  return from.startFrame + Math.max(Math.min(Math.floor(from.phase * from.frames), from.frames - 1), 0);
-}
-function resolveVATFrame(instance, time) {
-  const { clip } = instance;
-  const frames = clip.frames;
-  const last = frames - 1;
-  const duration = frames / clip.fps;
-  const { loopMode, repetitions, endMode, speed } = resolvedPlaybackOf(instance);
-  const local = (time - instance.startTime) * speed;
-  const loops = local / duration;
-  const started = local >= 0;
-  const finished = started && repetitions !== INFINITE_REPETITIONS && loops >= repetitions;
-  let phase;
-  let wraps;
-  if (!started) {
-    phase = 0;
-    wraps = false;
-  } else if (finished) {
-    phase = endMode === EndMode.Clamp ? 1 : 0;
-    wraps = false;
-  } else if (loopMode === LoopMode.PingPong) {
-    const m = loops % 2;
-    phase = m < 1 ? m : 2 - m;
-    wraps = false;
-  } else {
-    phase = loops % 1;
-    wraps = true;
-  }
-  const f = phase * (wraps ? frames : last);
-  const f0 = Math.min(Math.floor(f), last);
-  const f1 = wraps ? (f0 + 1) % frames : Math.min(f0 + 1, last);
-  const row = clip.startFrame + f0;
-  const fading = fadeOf(instance);
-  const elapsed = fading ? (time - instance.startTime) / fading.duration : 0;
-  return {
-    row,
-    rowNext: clip.startFrame + f1,
-    mix: f - f0,
-    wraps,
-    finished,
-    phase,
-    fadeRow: fading ? fadeRowOf(fading.from) : row,
-    fadeWeight: fading ? 1 - Math.min(Math.max(elapsed, 0), 1) : 0
-  };
-}
-function createVATPlaybackTexture(instances) {
-  const count = instances.length;
-  if (count < 1) {
-    throw new Error(
-      "three-vat: a crowd needs at least one instance \u2014 a playback texture is one row per instance, and there is no zero-row texture to carry none"
-    );
-  }
-  if (count > MAX_TEXTURE_SIZE) {
-    throw new Error(
-      `three-vat: a crowd of ${count} instances needs ${count} rows of playback texture, past the ${MAX_TEXTURE_SIZE}-row ceiling \u2014 the playback texture holds one row per instance, so MAX_TEXTURE_SIZE is the instance ceiling.`
-    );
-  }
-  const data = new Float32Array(count * PACK_STRIDE);
-  for (let i = 0; i < count; i++) writePack(data, i, instances[i]);
-  return { texture: makeVATTexture(data, PACK_WIDTH, count), count };
-}
-var FORWARD_ONLY_REASON = "a baked band plays forward from its own first row, so a negative speed would freeze it on that row rather than run it backwards \u2014 bake a reversed clip instead. A speed of 0 is a held first row, and is fine";
-var rowStart = (index) => index * PACK_STRIDE;
-var texelStart = (index, field) => rowStart(index) + field * 4;
-function writePack(data, index, instance) {
-  const clip = texelStart(index, PACK_TEXELS.clip);
-  const playback = texelStart(index, PACK_TEXELS.playback);
-  const fade = texelStart(index, PACK_TEXELS.fade);
-  const policy = resolvedPlaybackOf(instance);
-  if (policy.speed < 0) {
-    throw new Error(`three-vat: instance ${index} has speed ${policy.speed}; ${FORWARD_ONLY_REASON}.`);
-  }
-  data[clip] = instance.clip.startFrame;
-  data[clip + 1] = instance.clip.frames;
-  data[clip + 2] = instance.clip.fps;
-  data[clip + 3] = policy.speed;
-  data[playback] = instance.startTime;
-  data[playback + 1] = policy.loopMode;
-  data[playback + 2] = policy.repetitions;
-  data[playback + 3] = policy.endMode;
-  const fading = fadeOf(instance);
-  data[fade] = fading ? fading.from.startFrame : 0;
-  data[fade + 1] = fading ? fading.from.frames : 0;
-  data[fade + 2] = fading ? fading.from.phase : 0;
-  data[fade + 3] = fading ? fading.duration : 0;
-}
-function readPack(data, index) {
-  const clip = texelStart(index, PACK_TEXELS.clip);
-  const playback = texelStart(index, PACK_TEXELS.playback);
-  return {
-    clip: { startFrame: data[clip], frames: data[clip + 1], fps: data[clip + 2] },
-    startTime: data[playback],
-    speed: data[clip + 3],
-    loopMode: data[playback + 1],
-    repetitions: data[playback + 2],
-    endMode: data[playback + 3]
-  };
-}
-function assertInstance(playback, index) {
-  if (!Number.isInteger(index) || index < 0 || index >= playback.count) {
-    throw new Error(`three-vat: instance ${index} is outside this crowd of ${playback.count}`);
-  }
-}
-function setVATInstance(playback, index, instance) {
-  assertInstance(playback, index);
-  const data = playback.texture.image.data;
-  const fading = instance.from === void 0 && (instance.fadeDuration ?? 0) > 0 ? { ...instance, from: freezeOf(data, index, instance.startTime) } : instance;
-  writePack(data, index, fading);
-  playback.texture.addUpdateRange(rowStart(index), PACK_STRIDE);
-  playback.texture.needsUpdate = true;
-}
-function freezeOf(data, index, time) {
-  const outgoing = readPack(data, index);
-  const { row } = resolveVATFrame(outgoing, time);
-  return {
-    startFrame: outgoing.clip.startFrame,
-    frames: outgoing.clip.frames,
-    // The row the instance is actually displaying at that moment — so a fade
-    // out of a finished one-shot freezes the end pose it was holding, not the
-    // first row of a clip it stopped playing seconds ago.
-    //
-    // Named as the phase at the *centre* of that row rather than the playback
-    // phase itself, because {@link fadeRowOf} is what reads it back and the two
-    // do not spread a phase the same way: a bouncing ping-pong is up to a row
-    // apart between them, and rounding in a shader could cost another. Half a
-    // row of slack costs nothing and lands all three decodes on this row.
-    phase: (row - outgoing.clip.startFrame + 0.5) / outgoing.clip.frames
-  };
-}
-function endsAt(instance) {
-  const { repetitions, speed } = resolvedPlaybackOf(instance);
-  if (repetitions === INFINITE_REPETITIONS || speed <= 0) return null;
-  const duration = instance.clip.frames / instance.clip.fps;
-  return instance.startTime + duration * repetitions / speed;
-}
-
-// src/rig-texture.ts
-var RIG_TEXELS = {
-  /** `(qx, qy, qz, qw)` — the slot's rotation, on one hemisphere with its neighbouring rows. */
-  rotation: 0,
-  /** `(tx, ty, tz, s)` — where the slot puts the origin, and its uniform scale in the spare component. */
-  placement: 1
-};
-var RIG_TEXELS_PER_SLOT = 2;
-
-export { EndMode, FORWARD_ONLY_REASON, INFINITE_REPETITIONS, LIBRARY_PLAYBACK_DEFAULTS, LoopMode, MAX_FADE_DURATION, MAX_TEXTURE_SIZE, PACK_TEXELS, RIG_TEXELS, RIG_TEXELS_PER_SLOT, createVATPlaybackTexture, endsAt, makeVATTexture, resolveVATFrame, setVATInstance };