endset_three_editor 0.10.34 → 0.10.35

package/dist/three/index.d.ts

@@ -13,15 +13,19 @@ import * as THREE from "three";
  * three 渲染器对透明物体按「groupOrder → renderOrder → 相机距离(z 大者先画)」排序，
  * 默认所有物体 renderOrder = 0：此时半透明模型（例如透明度 0.7 的外墙）与水体的
  * 先后完全取决于二者"物体原点"的相机距离。像墙体这种"几何很大、原点却偏离几何中心"
- * 的对象，距离排序会随相机移动而翻转，于是：
- *   - 墙体先画：水体的 alpha 被墙体的 0.7 覆盖 → 水体发白/像空气一样消失
- *   - 水体先画且墙体写深度：水体被深度剔除 → 水体整块消失
- * 给水体一个更大的 renderOrder，使其始终在其它半透明模型之后绘制，
- * 保证水体稳定可见（不再随视角时隐时现）。
+ * 的对象，距离排序会随相机移动而翻转 → 水体随视角时隐时现。
  *
- * 注意：仅改变绘制顺序，不改变不透明物体的遮挡关系（不透明物体先于透明队列绘制）。
+ * 这里给水体一个更小的 renderOrder，让它**恒定在其它半透明模型之前绘制**：
+ * 半透明模型（0.7 外墙等）便总是以自身 alpha 混合在"已经画好的水体"之上，
+ * 于是墙体与水体重叠的部分、以及不重叠的部分，观感完全一致（都是同一个 0.7）。
+ * 反之若让水体最后绘制，水体的像素会盖在墙上，把墙在水体范围内的像素"洗淡"，
+ * 出现"只有与水体重叠的那块墙变透明，其余部分还是 0.7"的问题。
+ *
+ * 注意：
+ * - 只影响透明队列内部的先后，不改变不透明物体的遮挡关系（不透明物体先绘制）；
+ * - 水体自身 depthWrite = false，不会把任何物体按深度剔除（不会出现整块消失）。
  */
-export declare const WATER_RENDER_ORDER = 1;
+export declare const WATER_RENDER_ORDER = -1;
 /**
  * 初始化编辑器，挂载到指定 DOM 容器
  * @param container - 编辑器挂载的 DOM 元素