three-vat 4.1.0 → 4.2.0

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-import { AnimationClip, AnimationAction, Object3D, DataTexture, FloatType, HalfFloatType } from 'three';
-import { D as DeltaVAT, R as RigVAT, V as VAT } from './carrier-VLSJLgjX.js';
-export { E as EndMode, I as INFINITE_REPETITIONS, L as LoopMode, a as VATBase, b as VATCarrier, c as VATClip, d as VATClipDefaults, e as VATClock, f as VATCrowd, g as VATFrame, h as VATInstance, i as VATOutgoingFrame, j as VATPlaybackState, k as VATPlaybackTexture, l as VATPlaybackTextureOptions, m as createVATPlaybackTexture, n as endsAt, r as resolveVATFrame, s as setVATInstance } from './carrier-VLSJLgjX.js';
+import { AnimationClip, AnimationAction, Object3D, Material, DataTexture, FloatType, HalfFloatType } from 'three';
+import { D as DeltaVAT, R as RigVAT, b as VAT } from './types-CDPXKe0_.js';
+export { E as EndMode, I as INFINITE_REPETITIONS, L as LoopMode, e as VATBase, f as VATClip, g as VATClipDefaults, V as VATClock, d as VATCrowd, h as VATFrame, c as VATInstance, i as VATOutgoingFrame, j as VATPlaybackState, a as VATPlaybackTexture, k as VATPlaybackTextureOptions, l as createVATPlaybackTexture, m as endsAt, r as resolveVATFrame, s as setVATInstance, t as turnVATInstance } from './types-CDPXKe0_.js';
+import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
+export { V as VATCarrier } from './carrier-DmKhB4QL.js';
 
 /**
  * What {@link bakeVAT} takes for each animation: the clip itself, or an
@@ -107,7 +109,8 @@ interface BakeOptions {
  * a plain clip carries no configuration, so the simple case still needs no
  * mixer at all and takes the library defaults ({@link VATClipDefaults}).
  *
- * `loop`, `repetitions` and `timeScale` are read. **`clampWhenFinished` is
+ * `loop`, `repetitions` and `timeScale` are read, a negative `timeScale` as a
+ * clip that plays backwards by default (ADR-0033). **`clampWhenFinished` is
  * not**: it is `false` on every untouched action, so a crowd reads it as the
  * silence it usually is and clamps either way — an instance names
  * `endMode: EndMode.Rewind` to get three's behaviour back.
@@ -154,6 +157,35 @@ declare function bakeVAT(root: Object3D, animations: BakeInput[], options: BakeO
 }): RigVAT;
 declare function bakeVAT(root: Object3D, animations: BakeInput[], options?: BakeOptions): VAT;
 
+interface LoadVATOptions {
+    /**
+     * The loader to read the file with: yours, configured as your page already
+     * configures it. A plain `GLTFLoader` when none is passed. The plugin that
+     * reads the baked file is registered on it once, and leaves every other
+     * file it loads alone.
+     */
+    loader?: GLTFLoader;
+    /**
+     * Your own materials, to use in place of the file's: one for each
+     * `materialIndex`, in that order, as `vat.materials` holds them. Replaces
+     * them wholesale, so a crowd is restyled without a re-bake. An array of
+     * another length is refused.
+     */
+    materials?: Material[];
+}
+/**
+ * Load a baked file, written by `npx three-vat bake <input> --out <file>`, as
+ * the VAT `bakeVAT` returned when the command baked it: every texel, the clip
+ * table with its defaults, the bounds and `fallback`. Hand it to
+ * `createVATMesh` exactly as a fresh one.
+ *
+ * Refuses, by name, a file of another format version, which is to be baked
+ * again, and a file whose geometry no longer matches the one its texels are
+ * addressed by, which an optimizer that reorders, welds or simplifies vertices
+ * is the likely cause of.
+ */
+declare function loadVAT(url: string, { loader, materials }?: LoadVATOptions): Promise<VAT>;
+
 /**
  * The WebGL2 *spec floor for high-end desktop*, which two things lean on.
  *
@@ -318,4 +350,4 @@ declare function bakeVATInWorker(worker: VATBakeWorker, root: Object3D, animatio
  */
 declare function serveVATBakes(scope?: VATBakeScope): () => void;
 
-export { type BakeInput, type BakeOptions, DeltaVAT, MAX_TEXTURE_SIZE, RigVAT, VAT, type VATBakeScope, type VATBakeWorker, type Vec3Out, bakeVAT, bakeVATInWorker, decodeOctahedral, encodeOctahedral, makeVATNormalTexture, makeVATTexture, serveVATBakes };
+export { type BakeInput, type BakeOptions, DeltaVAT, type LoadVATOptions, MAX_TEXTURE_SIZE, RigVAT, VAT, type VATBakeScope, type VATBakeWorker, type Vec3Out, bakeVAT, bakeVATInWorker, decodeOctahedral, encodeOctahedral, loadVAT, makeVATNormalTexture, makeVATTexture, serveVATBakes };