@playcanvas/web-components 0.7.1 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcanvas/web-components",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "author": "PlayCanvas <support@playcanvas.com>",
   "homepage": "https://playcanvas.com",
   "description": "Web Components for the PlayCanvas Engine",
@@ -45,7 +45,7 @@
     "watch": "rollup -c -w"
   },
   "peerDependencies": {
-    "playcanvas": "^2.19.0"
+    "playcanvas": "^2.20.1"
   },
   "devDependencies": {
     "@mediapipe/tasks-vision": "0.10.35",
@@ -58,13 +58,13 @@
     "@typescript-eslint/eslint-plugin": "8.62.0",
     "@typescript-eslint/parser": "8.62.0",
     "concurrently": "10.0.3",
-    "earcut": "3.0.2",
+    "earcut": "3.1.0",
     "eslint": "9.39.4",
     "eslint-import-resolver-typescript": "4.4.5",
     "globals": "17.7.0",
     "mediabunny": "1.49.0",
     "opentype.js": "2.0.0",
-    "playcanvas": "2.20.0",
+    "playcanvas": "2.20.1",
     "publint": "0.3.21",
     "rollup": "4.62.2",
     "serve": "14.2.6",

package/src/components/gsplat-component.ts

@@ -20,6 +20,10 @@ class GSplatComponentElement extends ComponentElement {
 
     private _lodMultiplier = 3;
 
+    private _lodRangeMin = 0;
+
+    private _lodRangeMax = 99;
+
     /** @ignore */
     constructor() {
         super('gsplat');
@@ -30,7 +34,9 @@ class GSplatComponentElement extends ComponentElement {
             asset: AssetElement.get(this._asset),
             castShadows: this._castShadows,
             lodBaseDistance: this._lodBaseDistance,
-            lodMultiplier: this._lodMultiplier
+            lodMultiplier: this._lodMultiplier,
+            lodRangeMin: this._lodRangeMin,
+            lodRangeMax: this._lodRangeMax
         };
     }
 
@@ -126,13 +132,58 @@ class GSplatComponentElement extends ComponentElement {
         return this._lodMultiplier;
     }
 
+    /**
+     * Sets the minimum allowed LOD index (inclusive). The LOD selected by distance is clamped so it
+     * never goes finer (lower index) than this value. Raising it avoids downloading the highest
+     * quality (largest) LOD files. Defaults to 0. Only affects assets that contain LOD levels (e.g.
+     * `.lod-meta.json`).
+     * @param value - The minimum LOD index.
+     */
+    set lodRangeMin(value: number) {
+        this._lodRangeMin = value;
+        if (this.component) {
+            this.component.lodRangeMin = value;
+        }
+    }
+
+    /**
+     * Gets the minimum allowed LOD index.
+     * @returns The minimum LOD index.
+     */
+    get lodRangeMin() {
+        return this._lodRangeMin;
+    }
+
+    /**
+     * Sets the maximum allowed LOD index (inclusive). The LOD selected by distance is clamped so it
+     * never goes coarser (higher index) than this value. The default of 99 effectively means "no
+     * cap". Defaults to 99. Only affects assets that contain LOD levels (e.g. `.lod-meta.json`).
+     * @param value - The maximum LOD index.
+     */
+    set lodRangeMax(value: number) {
+        this._lodRangeMax = value;
+        if (this.component) {
+            this.component.lodRangeMax = value;
+        }
+    }
+
+    /**
+     * Gets the maximum allowed LOD index.
+     * @returns The maximum LOD index.
+     */
+    get lodRangeMax() {
+        return this._lodRangeMax;
+    }
+
     static get observedAttributes() {
         return [
             ...super.observedAttributes,
             'asset',
             'cast-shadows',
             'lod-base-distance',
-            'lod-multiplier'
+            'lod-multiplier',
+            'lod-range-min',
+            'lod-range-max'
         ];
     }
 
@@ -152,6 +203,12 @@ class GSplatComponentElement extends ComponentElement {
             case 'lod-multiplier':
                 this.lodMultiplier = Number(newValue);
                 break;
+            case 'lod-range-min':
+                this.lodRangeMin = Number(newValue);
+                break;
+            case 'lod-range-max':
+                this.lodRangeMax = Number(newValue);
+                break;
         }
     }
 }