three-base 2.0.169 → 2.0.175

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.
Files changed (124) hide show
  1. package/FPScontrol.d.ts +55 -30
  2. package/FPScontrol.js +278 -225
  3. package/FPScontrol.ts +177 -127
  4. package/Ground1/Ground1.d.ts +4 -2
  5. package/Ground1/Ground1.js +77 -57
  6. package/Ground1/Ground1.ts +77 -57
  7. package/Mirror.js +0 -4
  8. package/Mirror.ts +0 -4
  9. package/MktMesh/MktMesh.d.ts +8 -3
  10. package/MktMesh/MktMesh.js +43 -14
  11. package/MktMesh/MktMesh.ts +40 -14
  12. package/MktMesh/mktMappingShader.d.ts +6 -5
  13. package/MktMesh/mktMappingShader.js +26 -19
  14. package/MktMesh/mktMappingShader.ts +28 -19
  15. package/MktMesh/mktShader.d.ts +127 -58
  16. package/MktMesh/mktShader.js +192 -117
  17. package/MktMesh/mktShader.ts +251 -127
  18. package/MktMesh/panoSlotRoster.d.ts +2 -2
  19. package/MktMesh/panoSlotRoster.js +9 -7
  20. package/MktMesh/panoSlotRoster.ts +9 -7
  21. package/MktMesh/panoTileStitcher.d.ts +20 -13
  22. package/MktMesh/panoTileStitcher.js +97 -76
  23. package/MktMesh/panoTileStitcher.ts +119 -90
  24. package/MktMesh/types.d.ts +5 -1
  25. package/MktMesh/types.ts +5 -1
  26. package/PipeMesh/PipeJoint.d.ts +22 -0
  27. package/PipeMesh/PipeJoint.js +33 -0
  28. package/PipeMesh/PipeJoint.ts +38 -0
  29. package/PipeMesh/PipeMesh.d.ts +94 -22
  30. package/PipeMesh/PipeMesh.js +192 -53
  31. package/PipeMesh/PipeMesh.ts +223 -76
  32. package/PipeMesh/PipeStraight.d.ts +19 -0
  33. package/PipeMesh/PipeStraight.js +34 -0
  34. package/PipeMesh/PipeStraight.ts +45 -0
  35. package/PipeMesh/axisSnap.d.ts +52 -0
  36. package/PipeMesh/axisSnap.js +52 -0
  37. package/PipeMesh/axisSnap.ts +93 -0
  38. package/PipeMesh/directRoute.d.ts +85 -0
  39. package/PipeMesh/directRoute.js +126 -0
  40. package/PipeMesh/directRoute.ts +190 -0
  41. package/PipeMesh/index.d.ts +6 -0
  42. package/PipeMesh/index.js +6 -0
  43. package/PipeMesh/index.ts +7 -1
  44. package/PipeMesh/pipeMaterial.d.ts +16 -0
  45. package/PipeMesh/pipeMaterial.js +23 -0
  46. package/PipeMesh/pipeMaterial.ts +26 -0
  47. package/ThreeBase.d.ts +2 -49
  48. package/ThreeBase.js +43 -164
  49. package/ThreeBase.ts +1176 -1314
  50. package/instanced/InstancedBatch.d.ts +14 -1
  51. package/instanced/InstancedBatch.js +53 -3
  52. package/instanced/InstancedBatch.ts +62 -3
  53. package/instanced/InstancedChild.d.ts +24 -0
  54. package/instanced/InstancedChild.js +40 -0
  55. package/instanced/InstancedChild.ts +41 -0
  56. package/instanced/InstancedGroup.d.ts +48 -0
  57. package/instanced/InstancedGroup.js +45 -1
  58. package/instanced/InstancedGroup.ts +85 -0
  59. package/package.json +2 -7
  60. package/pass/bloom_pass.js +7 -14
  61. package/pass/bloom_pass.ts +7 -16
  62. package/pass/cover_pass.js +7 -15
  63. package/pass/cover_pass.ts +7 -17
  64. package/pass/debugDepthState.d.ts +16 -8
  65. package/pass/debugDepthState.js +4 -0
  66. package/pass/debugDepthState.ts +27 -9
  67. package/pass/glow_pass.js +19 -110
  68. package/pass/glow_pass.ts +19 -115
  69. package/pass/ssao_pass.d.ts +14 -59
  70. package/pass/ssao_pass.js +66 -171
  71. package/pass/ssao_pass.ts +63 -207
  72. package/pass/stroke_pass.js +13 -16
  73. package/pass/stroke_pass.ts +14 -18
  74. package/shaders/baseDepthVisShader.d.ts +1 -1
  75. package/shaders/baseDepthVisShader.js +1 -1
  76. package/shaders/baseDepthVisShader.ts +1 -1
  77. package/shaders/debugDepthCompareShader.d.ts +2 -2
  78. package/shaders/debugDepthCompareShader.js +2 -2
  79. package/shaders/debugDepthCompareShader.ts +2 -2
  80. package/shaders/debugDepthJudgeShader.d.ts +1 -1
  81. package/shaders/debugDepthJudgeShader.js +1 -1
  82. package/shaders/debugDepthJudgeShader.ts +1 -1
  83. package/PipeMesh/PathGeometry.d.ts +0 -44
  84. package/PipeMesh/PathGeometry.js +0 -307
  85. package/PipeMesh/PathGeometry.ts +0 -343
  86. package/PipeMesh/PathPoint.d.ts +0 -17
  87. package/PipeMesh/PathPoint.js +0 -31
  88. package/PipeMesh/PathPoint.ts +0 -36
  89. package/PipeMesh/PathPointList.d.ts +0 -31
  90. package/PipeMesh/PathPointList.js +0 -209
  91. package/PipeMesh/PathPointList.ts +0 -227
  92. package/PipeMesh/PathTubeGeometry.d.ts +0 -25
  93. package/PipeMesh/PathTubeGeometry.js +0 -130
  94. package/PipeMesh/PathTubeGeometry.ts +0 -146
  95. package/WaterFlow/FloatingDuck.d.ts +0 -88
  96. package/WaterFlow/FloatingDuck.js +0 -307
  97. package/WaterFlow/FloatingDuck.ts +0 -445
  98. package/WaterFlow/GPUFluidSimulation.d.ts +0 -56
  99. package/WaterFlow/GPUFluidSimulation.js +0 -785
  100. package/WaterFlow/GPUFluidSimulation.ts +0 -827
  101. package/WaterFlow/ReservoirSystem.d.ts +0 -106
  102. package/WaterFlow/ReservoirSystem.js +0 -621
  103. package/WaterFlow/ReservoirSystem.ts +0 -754
  104. package/WaterFlow/SPHField.d.ts +0 -35
  105. package/WaterFlow/SPHField.js +0 -204
  106. package/WaterFlow/SPHField.ts +0 -228
  107. package/WaterFlow/ScreenSpaceFluidPass.d.ts +0 -69
  108. package/WaterFlow/ScreenSpaceFluidPass.js +0 -736
  109. package/WaterFlow/ScreenSpaceFluidPass.ts +0 -789
  110. package/WaterFlow/ShallowWaterSurface.d.ts +0 -45
  111. package/WaterFlow/ShallowWaterSurface.js +0 -441
  112. package/WaterFlow/ShallowWaterSurface.ts +0 -510
  113. package/WaterFlow/WaterFlow.d.ts +0 -87
  114. package/WaterFlow/WaterFlow.js +0 -171
  115. package/WaterFlow/WaterFlow.ts +0 -219
  116. package/WaterFlow/types.d.ts +0 -161
  117. package/WaterFlow/types.js +0 -1
  118. package/WaterFlow/types.ts +0 -189
  119. package/WaterFlow/waterFlowPass.d.ts +0 -3
  120. package/WaterFlow/waterFlowPass.js +0 -20
  121. package/WaterFlow/waterFlowPass.ts +0 -40
  122. package/shaders/debugExcludedShader.d.ts +0 -13
  123. package/shaders/debugExcludedShader.js +0 -46
  124. package/shaders/debugExcludedShader.ts +0 -48
@@ -1,307 +0,0 @@
1
- import * as THREE from 'three';
2
- function addScaledSphere(group, geometry, material, position, scale, rotation = null) {
3
- const mesh = new THREE.Mesh(geometry, material);
4
- mesh.position.set(...position);
5
- mesh.scale.set(...scale);
6
- if (rotation)
7
- mesh.rotation.set(...rotation);
8
- mesh.castShadow = true;
9
- mesh.receiveShadow = true;
10
- group.add(mesh);
11
- return mesh;
12
- }
13
- /** 漂浮的橡皮鸭:跟随水面高度/坡度做浮沉与倾斜,可被鼠标拖拽。 */
14
- export class FloatingDuck {
15
- bounds;
16
- /** 静水面高度;setEnvironment 会随容器变化更新(故非 readonly)。 */
17
- waterY;
18
- start;
19
- velocity;
20
- surfaceSample;
21
- yaw;
22
- yawVelocity;
23
- pitch;
24
- roll;
25
- radiusX;
26
- radiusZ;
27
- active;
28
- dragging;
29
- dragOffset;
30
- dragVelocity;
31
- lastDragPosition;
32
- group;
33
- model;
34
- pickGeometry;
35
- pickMaterial;
36
- pickMesh;
37
- yellowMaterial;
38
- wingMaterial;
39
- beakMaterial;
40
- eyeMaterial;
41
- highlightMaterial;
42
- sphereGeometry;
43
- body;
44
- head;
45
- beak;
46
- tailGeometry;
47
- tail;
48
- constructor({ basinMinX, basinMaxX, basinHalfZ, waterY, startX = 1.2, startZ = 0.24, }) {
49
- this.bounds = { basinMinX, basinMaxX, basinHalfZ, centerZ: 0 };
50
- this.waterY = waterY;
51
- this.start = new THREE.Vector3(startX, waterY - 0.016, startZ);
52
- this.velocity = new THREE.Vector3();
53
- this.surfaceSample = {};
54
- this.yaw = Math.PI;
55
- this.yawVelocity = 0;
56
- this.pitch = 0;
57
- this.roll = 0;
58
- this.radiusX = 0.19;
59
- this.radiusZ = 0.145;
60
- this.active = true;
61
- this.dragging = false;
62
- this.dragOffset = new THREE.Vector2();
63
- this.dragVelocity = new THREE.Vector2();
64
- this.lastDragPosition = new THREE.Vector2();
65
- this.group = new THREE.Group();
66
- this.group.name = 'floating-rubber-duck';
67
- this.model = new THREE.Group();
68
- this.group.add(this.model);
69
- this.pickGeometry = new THREE.SphereGeometry(0.29, 12, 8);
70
- this.pickMaterial = new THREE.MeshBasicMaterial({
71
- transparent: true,
72
- opacity: 0,
73
- depthWrite: false,
74
- colorWrite: false,
75
- });
76
- this.pickMesh = new THREE.Mesh(this.pickGeometry, this.pickMaterial);
77
- this.pickMesh.name = 'rubber-duck-pick-volume';
78
- this.pickMesh.position.y = 0.13;
79
- this.pickMesh.layers.set(2);
80
- this.group.add(this.pickMesh);
81
- this.yellowMaterial = new THREE.MeshPhysicalMaterial({
82
- color: 0xf2b705,
83
- roughness: 0.46,
84
- metalness: 0,
85
- clearcoat: 0.32,
86
- clearcoatRoughness: 0.28,
87
- });
88
- this.wingMaterial = new THREE.MeshPhysicalMaterial({
89
- color: 0xd99b03,
90
- roughness: 0.48,
91
- metalness: 0,
92
- clearcoat: 0.24,
93
- });
94
- this.beakMaterial = new THREE.MeshPhysicalMaterial({
95
- color: 0xe85e06,
96
- roughness: 0.42,
97
- metalness: 0,
98
- clearcoat: 0.25,
99
- });
100
- this.eyeMaterial = new THREE.MeshStandardMaterial({ color: 0x101518, roughness: 0.2 });
101
- this.highlightMaterial = new THREE.MeshBasicMaterial({ color: 0xffffff });
102
- this.sphereGeometry = new THREE.SphereGeometry(1, 32, 20);
103
- this.body = addScaledSphere(this.model, this.sphereGeometry, this.yellowMaterial, [0, 0.072, 0], [0.19, 0.12, 0.132]);
104
- this.head = addScaledSphere(this.model, this.sphereGeometry, this.yellowMaterial, [0.115, 0.205, 0], [0.098, 0.102, 0.096]);
105
- this.beak = addScaledSphere(this.model, this.sphereGeometry, this.beakMaterial, [0.203, 0.191, 0], [0.071, 0.026, 0.047]);
106
- for (const side of [-1, 1]) {
107
- addScaledSphere(this.model, this.sphereGeometry, this.wingMaterial, [-0.02, 0.092, side * 0.115], [0.105, 0.048, 0.052], [side * 0.18, 0, side * 0.08]);
108
- addScaledSphere(this.model, this.sphereGeometry, this.eyeMaterial, [0.176, 0.237, side * 0.069], [0.014, 0.017, 0.011]);
109
- addScaledSphere(this.model, this.sphereGeometry, this.highlightMaterial, [0.184, 0.244, side * 0.077], [0.0045, 0.005, 0.0035]);
110
- }
111
- this.tailGeometry = new THREE.ConeGeometry(0.052, 0.105, 20);
112
- this.tail = new THREE.Mesh(this.tailGeometry, this.yellowMaterial);
113
- this.tail.position.set(-0.177, 0.132, 0);
114
- this.tail.rotation.z = -Math.PI * 0.5;
115
- this.tail.castShadow = true;
116
- this.model.add(this.tail);
117
- this.reset();
118
- }
119
- setActive(active) {
120
- this.active = active;
121
- this.group.visible = active;
122
- }
123
- setEnvironment({ minX, maxX, halfZ, centerZ = 0, waterY }, reposition = false) {
124
- this.bounds.basinMinX = minX;
125
- this.bounds.basinMaxX = maxX;
126
- this.bounds.basinHalfZ = halfZ;
127
- this.bounds.centerZ = centerZ;
128
- this.waterY = waterY;
129
- if (reposition) {
130
- const receiverWidth = maxX - minX;
131
- this.place(minX + Math.min(0.75, receiverWidth * 0.35), centerZ + Math.min(0.2, halfZ * 0.3));
132
- }
133
- else {
134
- this.clampToBounds();
135
- }
136
- }
137
- place(x, z) {
138
- this.group.position.set(x, this.waterY - 0.016, z);
139
- this.velocity.set(0, 0, 0);
140
- this.clampToBounds();
141
- }
142
- translateContainer(deltaX, deltaZ) {
143
- this.group.position.x += deltaX;
144
- this.group.position.z += deltaZ;
145
- this.clampToBounds();
146
- }
147
- beginDrag(worldX, worldZ) {
148
- this.dragging = true;
149
- this.dragOffset.set(this.group.position.x - worldX, this.group.position.z - worldZ);
150
- this.lastDragPosition.set(this.group.position.x, this.group.position.z);
151
- this.dragVelocity.set(0, 0);
152
- this.velocity.x = 0;
153
- this.velocity.z = 0;
154
- }
155
- dragTo(worldX, worldZ, deltaSeconds) {
156
- if (!this.dragging)
157
- return;
158
- const previousX = this.group.position.x;
159
- const previousZ = this.group.position.z;
160
- this.group.position.x = worldX + this.dragOffset.x;
161
- this.group.position.z = worldZ + this.dragOffset.y;
162
- this.clampToBounds();
163
- const inverseDelta = 1 / Math.max(deltaSeconds, 1 / 120);
164
- const measuredX = (this.group.position.x - previousX) * inverseDelta;
165
- const measuredZ = (this.group.position.z - previousZ) * inverseDelta;
166
- this.dragVelocity.x = THREE.MathUtils.lerp(this.dragVelocity.x, measuredX, 0.42);
167
- this.dragVelocity.y = THREE.MathUtils.lerp(this.dragVelocity.y, measuredZ, 0.42);
168
- this.velocity.x = this.dragVelocity.x;
169
- this.velocity.z = this.dragVelocity.y;
170
- this.lastDragPosition.set(this.group.position.x, this.group.position.z);
171
- }
172
- endDrag() {
173
- if (!this.dragging)
174
- return;
175
- this.dragging = false;
176
- const releaseSpeed = Math.hypot(this.dragVelocity.x, this.dragVelocity.y);
177
- const releaseScale = releaseSpeed > 1.5 ? 1.5 / releaseSpeed : 1;
178
- this.velocity.x = this.dragVelocity.x * releaseScale;
179
- this.velocity.z = this.dragVelocity.y * releaseScale;
180
- this.yawVelocity += THREE.MathUtils.clamp(this.velocity.z * 0.34, -0.7, 0.7);
181
- }
182
- clampToBounds() {
183
- const minX = this.bounds.basinMinX + this.radiusX;
184
- const maxX = this.bounds.basinMaxX - this.radiusX;
185
- const minZ = this.bounds.centerZ - this.bounds.basinHalfZ + this.radiusZ;
186
- const maxZ = this.bounds.centerZ + this.bounds.basinHalfZ - this.radiusZ;
187
- this.group.position.x = THREE.MathUtils.clamp(this.group.position.x, minX, maxX);
188
- this.group.position.z = THREE.MathUtils.clamp(this.group.position.z, minZ, maxZ);
189
- }
190
- reset() {
191
- this.group.position.copy(this.start);
192
- this.velocity.set(0, 0, 0);
193
- this.yaw = Math.PI;
194
- this.yawVelocity = 0;
195
- this.pitch = 0;
196
- this.roll = 0;
197
- this.dragging = false;
198
- this.dragVelocity.set(0, 0);
199
- this.group.rotation.set(0, this.yaw, 0);
200
- this.model.rotation.set(0, 0, 0);
201
- }
202
- update(delta, elapsed, { surface = null, impactX = 0, impactZ = 0, impactEnergy = 0, emitting = false, } = {}) {
203
- if (!this.active)
204
- return;
205
- const dt = Math.min(delta, 1 / 30);
206
- const position = this.group.position;
207
- const sample = surface?.sampleSurface(position.x, position.z, this.surfaceSample) || this.surfaceSample;
208
- if (!surface) {
209
- sample.height = 0;
210
- sample.velocityY = 0;
211
- sample.slopeX = 0;
212
- sample.slopeZ = 0;
213
- sample.flowX = 0;
214
- sample.flowZ = 0;
215
- const dx = position.x - impactX;
216
- const dz = position.z - impactZ;
217
- const distanceSq = dx * dx + dz * dz;
218
- const strength = emitting ? Math.min(impactEnergy * 0.065, 0.9) * Math.exp(-distanceSq / 0.48) : 0;
219
- const inverseDistance = 1 / Math.max(Math.sqrt(distanceSq), 0.06);
220
- sample.flowX = strength * (0.42 + dx * inverseDistance * 0.68);
221
- sample.flowZ = strength * dz * inverseDistance * 0.92;
222
- sample.impact = strength * Math.exp(-distanceSq / 0.095);
223
- }
224
- const equilibriumY = this.waterY + sample.height - 0.016;
225
- const buoyancyAcceleration = (equilibriumY - position.y) * 34;
226
- const verticalDamping = (sample.velocityY - this.velocity.y) * 5.8;
227
- this.velocity.y += (buoyancyAcceleration + verticalDamping - sample.impact * 4.4) * dt;
228
- if (!this.dragging) {
229
- const flowResponse = 2.65;
230
- this.velocity.x += ((sample.flowX - this.velocity.x) * flowResponse - sample.slopeX * 1.75) * dt;
231
- this.velocity.z += ((sample.flowZ - this.velocity.z) * flowResponse - sample.slopeZ * 1.75) * dt;
232
- const horizontalDrag = Math.exp(-0.72 * dt);
233
- this.velocity.x *= horizontalDrag;
234
- this.velocity.z *= horizontalDrag;
235
- const horizontalSpeed = Math.hypot(this.velocity.x, this.velocity.z);
236
- if (horizontalSpeed > 1.35) {
237
- const scale = 1.35 / horizontalSpeed;
238
- this.velocity.x *= scale;
239
- this.velocity.z *= scale;
240
- }
241
- position.x += this.velocity.x * dt;
242
- position.z += this.velocity.z * dt;
243
- }
244
- position.y += this.velocity.y * dt;
245
- const minX = this.bounds.basinMinX + this.radiusX;
246
- const maxX = this.bounds.basinMaxX - this.radiusX;
247
- const minZ = this.bounds.centerZ - this.bounds.basinHalfZ + this.radiusZ;
248
- const maxZ = this.bounds.centerZ + this.bounds.basinHalfZ - this.radiusZ;
249
- let collisionTorque = 0;
250
- if (position.x < minX) {
251
- position.x = minX;
252
- this.velocity.x = Math.abs(this.velocity.x) * 0.42;
253
- collisionTorque += 1.8;
254
- }
255
- else if (position.x > maxX) {
256
- position.x = maxX;
257
- this.velocity.x = -Math.abs(this.velocity.x) * 0.42;
258
- collisionTorque -= 1.8;
259
- }
260
- if (position.z < minZ) {
261
- position.z = minZ;
262
- this.velocity.z = Math.abs(this.velocity.z) * 0.42;
263
- collisionTorque -= 1.35;
264
- }
265
- else if (position.z > maxZ) {
266
- position.z = maxZ;
267
- this.velocity.z = -Math.abs(this.velocity.z) * 0.42;
268
- collisionTorque += 1.35;
269
- }
270
- const speedSq = this.velocity.x * this.velocity.x + this.velocity.z * this.velocity.z;
271
- if (speedSq > 0.0012) {
272
- const desiredYaw = Math.atan2(-this.velocity.z, this.velocity.x);
273
- const yawDifference = Math.atan2(Math.sin(desiredYaw - this.yaw), Math.cos(desiredYaw - this.yaw));
274
- this.yawVelocity += yawDifference * 2.7 * dt;
275
- }
276
- const impactSide = THREE.MathUtils.clamp((position.z - impactZ) * 2.2, -1, 1);
277
- this.yawVelocity += (collisionTorque + sample.impact * impactSide * 2.2) * dt;
278
- this.yawVelocity *= Math.exp(-2.25 * dt);
279
- this.yaw += this.yawVelocity * dt;
280
- const forwardX = Math.cos(this.yaw);
281
- const forwardZ = -Math.sin(this.yaw);
282
- const rightX = Math.sin(this.yaw);
283
- const rightZ = Math.cos(this.yaw);
284
- const forwardSlope = sample.slopeX * forwardX + sample.slopeZ * forwardZ;
285
- const rightSlope = sample.slopeX * rightX + sample.slopeZ * rightZ;
286
- const desiredPitch = THREE.MathUtils.clamp(Math.atan(forwardSlope) - sample.impact * 0.12, -0.25, 0.25);
287
- const desiredRoll = THREE.MathUtils.clamp(-Math.atan(rightSlope) - this.yawVelocity * 0.055, -0.24, 0.24);
288
- const tiltBlend = 1 - Math.exp(-5.2 * dt);
289
- this.pitch = THREE.MathUtils.lerp(this.pitch, desiredPitch, tiltBlend);
290
- this.roll = THREE.MathUtils.lerp(this.roll, desiredRoll, tiltBlend);
291
- this.group.rotation.y = this.yaw;
292
- this.model.rotation.x = this.roll;
293
- this.model.rotation.z = this.pitch;
294
- this.model.position.y = Math.sin(elapsed * 3.1 + position.x * 1.7) * 0.0025;
295
- }
296
- dispose() {
297
- this.pickGeometry.dispose();
298
- this.pickMaterial.dispose();
299
- this.sphereGeometry.dispose();
300
- this.tailGeometry.dispose();
301
- this.yellowMaterial.dispose();
302
- this.wingMaterial.dispose();
303
- this.beakMaterial.dispose();
304
- this.eyeMaterial.dispose();
305
- this.highlightMaterial.dispose();
306
- }
307
- }