@adatechnology/game-items-three 0.3.1 → 0.4.0

package/dist/index.d.ts

@@ -151,9 +151,14 @@ interface ItemDestruction {
     readonly materials?: Readonly<Record<string, string>>;
     /** Segments the cylinder and box meshes of the model are rebuilt with, so a bullet dent (a few millimetres wide) finds vertices to push in. */
     readonly tessellate?: {
+        /**
+         * With `capRings` (and `three` given to `tagForDestruction`) a cylinder becomes one lathe with that many rings on each end, so the lid and the bottom dent
+         * too; its rows then are about as tall as its columns are wide, never more than `heightSegments`.
+         */
         readonly cylinder?: {
             readonly heightSegments: number;
             readonly radialSegments: number;
+            readonly capRings?: number;
         };
         readonly box?: {
             readonly widthSegments: number;
@@ -161,6 +166,11 @@ interface ItemDestruction {
             readonly depthSegments: number;
         };
     };
+    /** Real wall thickness in metres of the shell (`body`, the largest mesh) and of its other parts (`ends`: lid, bottom, neck), for the destruction world. */
+    readonly wall?: {
+        readonly body: number;
+        readonly ends: number;
+    };
 }
 /** A family of models that behave alike: one rule for all of them, so adding a model is one id and changing the rule changes them all. */
 interface ItemFamily {
@@ -205,11 +215,13 @@ interface DestructionTagOptions {
     readonly weight?: number;
     /** Size in metres, for the contents of the shell. */
     readonly size?: readonly [number, number, number];
+    /** three.js, for the shapes three only makes from scratch (a cylinder with rings on its ends: `tessellate.cylinder.capRings`). */
+    readonly three?: typeof THREE_NS;
 }
 /**
  * Writes the `userData` that `specFromObject3D` reads onto the meshes of a drawn item: the destruction material of each mesh from its kit material tag,
  * the item's real weight in kg (`destructionMass`, so the world weighs what the thing weighs) and what the model's family in `data/destruction.json` asks for (hollow shells, welded parts, skins),
- * with the liquid the model holds on its shell (`destructionContains`).
+ * with the liquid the model holds on its shell (`destructionContains`) and the real thickness of each wall (`destructionThickness`).
  */
 declare function tagForDestruction(root: THREE_NS.Object3D, options?: DestructionTagOptions): void;