ldr 0.33.0 → 0.33.2

package/dist/node/library.d.ts

@@ -43,6 +43,8 @@ export declare class Library {
     /** Texture PNG bytes for a !TEXMAP name: an MPD `!DATA` block in `doc` first, then the LDraw search path with a
      *  `textures/` prefix (parts/, p/, models/, official then unofficial), then without it. Case-insensitive. */
     texture(name: string, doc?: Doc): Uint8Array | null;
+    /** Every point of file `fname` of `doc` (type 2-5 lines, through its subfiles) has y = 0 (see `singularFix`). */
+    private flatY;
     private emit;
     /** Flatten a model into part instances (see `flatten` in the browser entry for the rules; `models/` library files are walked
      *  as submodels). 24 handled at render (edge color). Alias parts resolve to canonical names. MPD files and synthetic parts

package/dist/spec.d.ts

@@ -223,6 +223,19 @@ export declare function looseSource(f: LFile, step: number): string;
 export declare function hash32(s: string): string;
 /** Inverse of an affine LDraw matrix, or null when singular. */
 export declare function invert(m: M): M | null;
+/**
+ * BFC "Degenerate Matrices" (ldraw.org article 415): a subfile placed with a singular (determinant 0) matrix can't be culled.
+ * Returns null for a regular matrix. For a singular one: when the subfile lies in its own XZ plane (`flatY`: every point has y = 0),
+ * the Y column doesn't move any point, so the matrix is repaired the way LDView / L3P / LDGLite do (L3Input heritage, LDView
+ * `LDLModelLine::tryToFixPlanarMatrix`): an all-zero row gets 1 in its Y column (one row at a time), else an all-zero Y column gets 1s
+ * one row at a time; the repaired matrix (same points, determinant != 0) decides the winding and culling stays on. Otherwise culling
+ * is off for the subfile (`cull: false`). "Singular" = |det| at most 1e-9 of the product of the row lengths (the library's own
+ * near-singular references, e.g. 55297's discs at ~1e-6, keep their determinant's sign as before).
+ */
+export declare function singularFix(m: M, flatY: () => boolean): {
+    m: M;
+    cull: boolean;
+} | null;
 /**
  * Synthetic part for a part reference wrapped by a model-level `!TEXMAP` (the map is defined in the model, not in the part file).
  * `map` must already be in the part's own coordinates. The wrapper is a certified file that applies the map to the part, so

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ldr",
-  "version": "0.33.0",
+  "version": "0.33.2",
   "description": "High-performance LEGO (LDraw) rendering for three.js: instanced parts packs, hidden stud/tube culling, low-detail studs, indexed edges, build steps.",
   "license": "MIT",
   "author": "Evan Bacon",