three-base 2.0.187 → 2.0.188

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/ThreeBase.js CHANGED
@@ -76,16 +76,17 @@ export default class ThreeBase extends EventDispatcher {
76
76
  // effectiveRatio × resolution 内部超采样渲染,终处理 FXAA 降采样输出到屏幕。
77
77
  // 全链路同倍率 → 各 RT 严格 1:1 对齐:几何锯齿、效果边缘锯齿、辉光漏光(深度 vs mask 错位)、
78
78
  // mask 合成 UV 缩放错位、SSAO 深度错位变黑 一并消除。
79
- // ⭐ 默认 1(原生分辨率):2026-10-21 皇上旨「有点卡,分辨率改成 1」。原默认 2 = 每维 2×、
80
- // 总像素 4×,全链路填充 ×4 且 35 张 RT 显存约 1.1 GB(1920×1080 画布)。降到 1 后填充与显存
81
- // 均降约 75%,几何硬边锯齿由终处理 FXAA 兜底。需要纹理摩尔纹治本时,面板上再调回 2。
79
+ // ⭐ 现行 4(2026-10-27 用户点名「只把超采样倍率改成 4」,setter 的夹上限也是 4):4 = 每维 4×、总像素 16×,
80
+ // 全链路填充与全部 RT 显存同比涨,卡顿风险由用户自测裁决。
81
+ // 上一档 1 出自 2026-10-21「有点卡,分辨率改成 1」;再早的默认 2 = 每维 2×、总像素 4×,
82
+ // 当时量过:35 张 RT 显存约 1.1 GB(1920×1080 画布)。1 那档几何硬边锯齿只由终处理 FXAA 兜底。
82
83
  // 历史坑:baseRenderScale/auxRenderScale/effectRenderScale 三参各自为政,倍率不同步必错位,
83
84
  // 故统一为单参数 resolution 管全局。
84
85
  // ⚠️ 必须用 getter/setter,不能是普通字段:所有 RT 尺寸只在 updateRenderTargetSizes()
85
86
  // 里按 effectiveRatio × resolution 计算,而该方法过去只被 setSize()(容器尺寸变化)调用
86
87
  // → 运行时改 resolution 不会重建任何 RT,画面毫无变化(表现为"调分辨率没感觉")。
87
88
  // 故 setter 里改动倍率后立刻重建全部 RT。
88
- _resolution = 1;
89
+ _resolution = 4;
89
90
  get resolution() {
90
91
  return this._resolution;
91
92
  }
package/ThreeBase.ts CHANGED
@@ -117,9 +117,10 @@ export default class ThreeBase extends EventDispatcher<ThreeBaseEventTypeMap> {
117
117
  // effectiveRatio × resolution 内部超采样渲染,终处理 FXAA 降采样输出到屏幕。
118
118
  // 全链路同倍率 → 各 RT 严格 1:1 对齐:几何锯齿、效果边缘锯齿、辉光漏光(深度 vs mask 错位)、
119
119
  // mask 合成 UV 缩放错位、SSAO 深度错位变黑 一并消除。
120
- // ⭐ 默认 1(原生分辨率):2026-10-21 皇上旨「有点卡,分辨率改成 1」。原默认 2 = 每维 2×、
121
- // 总像素 4×,全链路填充 ×4 且 35 张 RT 显存约 1.1 GB(1920×1080 画布)。降到 1 后填充与显存
122
- // 均降约 75%,几何硬边锯齿由终处理 FXAA 兜底。需要纹理摩尔纹治本时,面板上再调回 2。
120
+ // ⭐ 现行 4(2026-10-27 用户点名「只把超采样倍率改成 4」,setter 的夹上限也是 4):4 = 每维 4×、总像素 16×,
121
+ // 全链路填充与全部 RT 显存同比涨,卡顿风险由用户自测裁决。
122
+ // 上一档 1 出自 2026-10-21「有点卡,分辨率改成 1」;再早的默认 2 = 每维 2×、总像素 4×,
123
+ // 当时量过:35 张 RT 显存约 1.1 GB(1920×1080 画布)。1 那档几何硬边锯齿只由终处理 FXAA 兜底。
123
124
  // 历史坑:baseRenderScale/auxRenderScale/effectRenderScale 三参各自为政,倍率不同步必错位,
124
125
  // 故统一为单参数 resolution 管全局。
125
126
 
@@ -127,7 +128,7 @@ export default class ThreeBase extends EventDispatcher<ThreeBaseEventTypeMap> {
127
128
  // 里按 effectiveRatio × resolution 计算,而该方法过去只被 setSize()(容器尺寸变化)调用
128
129
  // → 运行时改 resolution 不会重建任何 RT,画面毫无变化(表现为"调分辨率没感觉")。
129
130
  // 故 setter 里改动倍率后立刻重建全部 RT。
130
- private _resolution: number = 1;
131
+ private _resolution: number = 4;
131
132
 
132
133
  get resolution(): number {
133
134
  return this._resolution;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "three-base",
3
- "version": "2.0.187",
3
+ "version": "2.0.188",
4
4
  "description": "A Three.js extension library providing common 3D components, animations, materials, and utilities",
5
5
  "author": "xiaosihan",
6
6
  "publishConfig": {