ice3 0.2.2 → 0.2.3

package/README.md

@@ -58,6 +58,6 @@ WebGL2 兼容别名。拾取使用 `await engine.pick(point)`。
 [ICE3 Studio](https://github.com/ice-3d/ice3-studio/blob/main/README.md)
 完成 Source Import、Prepare、验证、partition、LOD 和 Tileset 发布。当前生产链见
 [Studio Asset Pipeline](https://github.com/ice-3d/ice3-studio/blob/main/docs/reference/asset-pipeline.md)。
-公开 package 的当前版本为 `0.2.2`。
+公开 package 的当前版本为 `0.2.3`。
 
 本项目采用 MIT License。

package/dist/_types/renderer/WebGL2RendererBackend.d.ts

@@ -13,7 +13,11 @@ export declare class WebGL2RendererBackend implements ICERendererBackend {
     private program;
     private clipPlane;
     private shadowMap;
-    /** 方向光阴影开关：默认关闭，由 `initialize({ shadows })` 或页面地址 `?shadows=` 打开。 */
+    /**
+     * 方向光阴影开关。默认开启：没有影子的厂区看起来像浮在地上，
+     * 而多一次全场景深度 pass 的代价远小于这个观感损失。
+     * 要关掉用 `initialize({ shadows: false })` 或页面地址 `?shadows=0`。
+     */
     private shadowEnabled;
     /** `?shadowdebug=1` 输出遮蔽判定，`=2` 输出深度图；排查阴影问题的唯一可信手段。 */
     private shadowDebug;

package/dist/_types/renderer/types.d.ts

@@ -51,7 +51,7 @@ export interface ICERendererBackend {
         readonly onError?: (error: ICEEngineError) => void;
         /** A deferred GPU upload (for example a base-colour texture) just landed. */
         readonly onUploadReady?: () => void;
-        /** Directional-light shadows. Off by default: it costs a full extra scene pass. */
+        /** Directional-light shadows. On by default; pass false to skip the extra scene pass. */
         readonly shadows?: boolean;
     }): void;
     resize(viewport: ICEViewport, dpr: number): void;

package/dist/index.js

@@ -3073,7 +3073,11 @@ var WebGL2RendererBackend = class {
   program = null;
   clipPlane = [0, 0, 0, 0];
   shadowMap = null;
-  /** 方向光阴影开关：默认关闭，由 `initialize({ shadows })` 或页面地址 `?shadows=` 打开。 */
+  /**
+   * 方向光阴影开关。默认开启：没有影子的厂区看起来像浮在地上，
+   * 而多一次全场景深度 pass 的代价远小于这个观感损失。
+   * 要关掉用 `initialize({ shadows: false })` 或页面地址 `?shadows=0`。
+   */
   shadowEnabled = false;
   /** `?shadowdebug=1` 输出遮蔽判定，`=2` 输出深度图；排查阴影问题的唯一可信手段。 */
   shadowDebug = 0;
@@ -3251,7 +3255,7 @@ var WebGL2RendererBackend = class {
     this.ensureTextureCache();
     this.sceneDepth = new WebGL2SceneDepth(gl);
     this.readOcclusionOverride();
-    this.shadowEnabled = options.shadows ?? false;
+    this.shadowEnabled = options.shadows ?? true;
     this.readShadowOverride();
     this.canvas.addEventListener("webglcontextlost", this.handleContextLost);
     this.canvas.addEventListener("webglcontextrestored", this.handleContextRestored);