three-base 2.0.137 → 2.0.145

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 (273) hide show
  1. package/DirectionalLight.d.ts +2 -2
  2. package/DirectionalLight.js +1 -1
  3. package/DirectionalLight.ts +70 -0
  4. package/EventMap.d.ts +103 -0
  5. package/EventMap.js +17 -0
  6. package/EventMap.ts +139 -0
  7. package/EventMesh.ts +60 -0
  8. package/ExtrudeMesh.js +1 -25
  9. package/ExtrudeMesh.ts +553 -0
  10. package/FPScontrol.d.ts +448 -15
  11. package/FPScontrol.js +1448 -266
  12. package/FPScontrol.ts +1855 -0
  13. package/Fire/Fire.d.ts +4 -4
  14. package/Fire/Fire.js +8 -7
  15. package/Fire/Fire.ts +89 -0
  16. package/Fire/{FireGromtry.d.ts → FireGeometry.d.ts} +2 -2
  17. package/Fire/{FireGromtry.js → FireGeometry.js} +1 -1
  18. package/Fire/FireGeometry.ts +40 -0
  19. package/Fire/FireMaterial.d.ts +3 -3
  20. package/Fire/FireMaterial.js +1 -1
  21. package/Fire/FireMaterial.ts +89 -0
  22. package/Fire/index.d.ts +1 -0
  23. package/Fire/index.js +1 -0
  24. package/Fire/index.ts +2 -0
  25. package/GLTFDracoLoader.d.ts +71 -0
  26. package/GLTFDracoLoader.js +266 -0
  27. package/GLTFDracoLoader.ts +430 -0
  28. package/Grass/Grass.d.ts +2 -2
  29. package/Grass/Grass.ts +38 -0
  30. package/Grass/index.d.ts +1 -0
  31. package/Grass/index.js +1 -0
  32. package/Grass/index.ts +2 -0
  33. package/Ground1/Ground1.d.ts +2 -3
  34. package/Ground1/Ground1.js +64 -60
  35. package/Ground1/Ground1.ts +114 -0
  36. package/Ground1/index.ts +1 -0
  37. package/MeshBase.d.ts +1 -0
  38. package/MeshBase.js +37 -13
  39. package/MeshBase.ts +253 -0
  40. package/Mirror.d.ts +3 -3
  41. package/Mirror.js +7 -3
  42. package/Mirror.ts +203 -0
  43. package/MktMesh/MktMesh.d.ts +301 -0
  44. package/MktMesh/MktMesh.js +1064 -0
  45. package/MktMesh/MktMesh.ts +1096 -0
  46. package/MktMesh/assetUrl.d.ts +59 -0
  47. package/MktMesh/assetUrl.js +154 -0
  48. package/MktMesh/assetUrl.ts +155 -0
  49. package/MktMesh/mktMappingShader.d.ts +12 -0
  50. package/MktMesh/mktMappingShader.js +139 -0
  51. package/MktMesh/mktMappingShader.ts +139 -0
  52. package/MktMesh/mktShader.d.ts +263 -0
  53. package/MktMesh/mktShader.js +1248 -0
  54. package/MktMesh/mktShader.ts +1344 -0
  55. package/MktMesh/panoBitmapTexture.d.ts +25 -0
  56. package/MktMesh/panoBitmapTexture.js +52 -0
  57. package/MktMesh/panoBitmapTexture.ts +54 -0
  58. package/MktMesh/panoSlotBind.d.ts +29 -0
  59. package/MktMesh/panoSlotBind.js +106 -0
  60. package/MktMesh/panoSlotBind.ts +153 -0
  61. package/MktMesh/panoSlotRoster.d.ts +22 -0
  62. package/MktMesh/panoSlotRoster.js +169 -0
  63. package/MktMesh/panoSlotRoster.ts +168 -0
  64. package/MktMesh/panoTileStitcher.d.ts +119 -0
  65. package/MktMesh/panoTileStitcher.js +533 -0
  66. package/MktMesh/panoTileStitcher.ts +616 -0
  67. package/MktMesh/types.d.ts +75 -0
  68. package/MktMesh/types.js +1 -0
  69. package/MktMesh/types.ts +87 -0
  70. package/MktMesh/wallCapTessellate.d.ts +33 -0
  71. package/MktMesh/wallCapTessellate.js +97 -0
  72. package/MktMesh/wallCapTessellate.ts +68 -0
  73. package/PipeMesh/PathGeometry.js +9 -2
  74. package/PipeMesh/PathGeometry.ts +343 -0
  75. package/PipeMesh/PathPoint.ts +36 -0
  76. package/PipeMesh/PathPointList.js +1 -0
  77. package/PipeMesh/PathPointList.ts +227 -0
  78. package/PipeMesh/PathTubeGeometry.ts +146 -0
  79. package/PipeMesh/PipeMesh.d.ts +1 -1
  80. package/PipeMesh/PipeMesh.js +1 -1
  81. package/PipeMesh/PipeMesh.ts +76 -0
  82. package/PipeMesh/index.ts +1 -0
  83. package/PlaneModal1/PlaneModal1.d.ts +16 -13
  84. package/PlaneModal1/PlaneModal1.js +4 -0
  85. package/PlaneModal1/PlaneModal1.ts +138 -0
  86. package/PlaneModal1/index.ts +1 -0
  87. package/PlaneText.d.ts +2 -14
  88. package/PlaneText.js +7 -2
  89. package/PlaneText.ts +55 -0
  90. package/PlaneWithHtml.d.ts +4 -2
  91. package/PlaneWithHtml.js +2 -1
  92. package/PlaneWithHtml.ts +70 -0
  93. package/PointLight/PointLight.d.ts +3 -4
  94. package/PointLight/PointLight.js +1 -7
  95. package/PointLight/PointLight.ts +67 -0
  96. package/PointLight/index.ts +1 -0
  97. package/README.md +110 -79
  98. package/Sky/Sky.ts +22 -0
  99. package/Sky/index.ts +1 -0
  100. package/SpotLight.d.ts +2 -2
  101. package/SpotLight.js +1 -1
  102. package/SpotLight.ts +74 -0
  103. package/SpriteModal1/SpriteModal1.d.ts +16 -13
  104. package/SpriteModal1/SpriteModal1.js +8 -2
  105. package/SpriteModal1/SpriteModal1.ts +146 -0
  106. package/SpriteModal1/index.ts +1 -0
  107. package/SpriteText.d.ts +14 -13
  108. package/SpriteText.js +22 -9
  109. package/SpriteText.ts +205 -0
  110. package/SpriteText2.d.ts +9 -8
  111. package/SpriteText2.js +57 -32
  112. package/SpriteText2.ts +258 -0
  113. package/SpriteText3.d.ts +86 -0
  114. package/SpriteText3.js +519 -0
  115. package/SpriteText3.ts +599 -0
  116. package/SpriteWithHtml.d.ts +4 -2
  117. package/SpriteWithHtml.ts +50 -0
  118. package/Text3D/Text3D.js +17 -21
  119. package/Text3D/Text3D.ts +77 -0
  120. package/Text3D/fontController.d.ts +10 -9
  121. package/Text3D/fontController.js +17 -50
  122. package/Text3D/fontController.ts +209 -0
  123. package/Text3D/index.ts +1 -0
  124. package/ThreeBase.d.ts +168 -31
  125. package/ThreeBase.js +663 -117
  126. package/ThreeBase.ts +1314 -0
  127. package/ThreeMouse.d.ts +20 -7
  128. package/ThreeMouse.js +78 -32
  129. package/ThreeMouse.ts +472 -0
  130. package/Transition.d.ts +12 -7
  131. package/Transition.js +26 -27
  132. package/Transition.ts +242 -0
  133. package/Water/Water.js +21 -3
  134. package/Water/Water.ts +45 -0
  135. package/Water/index.d.ts +2 -0
  136. package/Water/index.js +2 -0
  137. package/Water/index.ts +2 -0
  138. package/WaterFlow/FloatingDuck.d.ts +88 -0
  139. package/WaterFlow/FloatingDuck.js +307 -0
  140. package/WaterFlow/FloatingDuck.ts +445 -0
  141. package/WaterFlow/GPUFluidSimulation.d.ts +56 -0
  142. package/WaterFlow/GPUFluidSimulation.js +785 -0
  143. package/WaterFlow/GPUFluidSimulation.ts +827 -0
  144. package/WaterFlow/ReservoirSystem.d.ts +106 -0
  145. package/WaterFlow/ReservoirSystem.js +621 -0
  146. package/WaterFlow/ReservoirSystem.ts +754 -0
  147. package/WaterFlow/SPHField.d.ts +35 -0
  148. package/WaterFlow/SPHField.js +204 -0
  149. package/WaterFlow/SPHField.ts +228 -0
  150. package/WaterFlow/ScreenSpaceFluidPass.d.ts +69 -0
  151. package/WaterFlow/ScreenSpaceFluidPass.js +736 -0
  152. package/WaterFlow/ScreenSpaceFluidPass.ts +789 -0
  153. package/WaterFlow/ShallowWaterSurface.d.ts +45 -0
  154. package/WaterFlow/ShallowWaterSurface.js +441 -0
  155. package/WaterFlow/ShallowWaterSurface.ts +510 -0
  156. package/WaterFlow/WaterFlow.d.ts +87 -0
  157. package/WaterFlow/WaterFlow.js +171 -0
  158. package/WaterFlow/WaterFlow.ts +219 -0
  159. package/WaterFlow/types.d.ts +161 -0
  160. package/WaterFlow/types.js +1 -0
  161. package/WaterFlow/types.ts +189 -0
  162. package/WaterFlow/waterFlowPass.d.ts +3 -0
  163. package/WaterFlow/waterFlowPass.js +20 -0
  164. package/WaterFlow/waterFlowPass.ts +40 -0
  165. package/collisionOBB.d.ts +42 -0
  166. package/collisionOBB.js +112 -0
  167. package/collisionOBB.ts +108 -0
  168. package/declare.d.ts +25 -167
  169. package/index.js +0 -1
  170. package/index.ts +1 -0
  171. package/instanced/InstancedBatch.d.ts +57 -0
  172. package/instanced/InstancedBatch.js +348 -0
  173. package/instanced/InstancedBatch.ts +406 -0
  174. package/instanced/InstancedChild.d.ts +174 -0
  175. package/instanced/InstancedChild.js +264 -0
  176. package/instanced/InstancedChild.ts +327 -0
  177. package/instanced/InstancedGroup.d.ts +43 -0
  178. package/instanced/InstancedGroup.js +126 -0
  179. package/instanced/InstancedGroup.ts +137 -0
  180. package/{InstancedMeshBase.d.ts → instanced/InstancedMeshBase.d.ts} +6 -7
  181. package/{InstancedMeshBase.js → instanced/InstancedMeshBase.js} +36 -47
  182. package/instanced/InstancedMeshBase.ts +292 -0
  183. package/instanced/InstancedTemplate.d.ts +46 -0
  184. package/instanced/InstancedTemplate.js +125 -0
  185. package/instanced/InstancedTemplate.ts +188 -0
  186. package/keyControls.d.ts +29 -0
  187. package/{keyContorls.js → keyControls.js} +10 -7
  188. package/keyControls.ts +107 -0
  189. package/lensflare/LensFlare.d.ts +39 -0
  190. package/lensflare/LensFlare.js +373 -0
  191. package/lensflare/LensFlare.ts +448 -0
  192. package/lensflare/lensflare0.png +0 -0
  193. package/lensflare/lensflare3.png +0 -0
  194. package/lensflare/lensflare_custom.png +0 -0
  195. package/lensflare/lensflare_hex_ghost.png +0 -0
  196. package/lensflare/lensflare_hex_main.png +0 -0
  197. package/package.json +104 -25
  198. package/pass/bloom_pass.d.ts +1 -1
  199. package/pass/bloom_pass.js +127 -40
  200. package/pass/bloom_pass.ts +243 -0
  201. package/pass/cover_pass.d.ts +1 -1
  202. package/pass/cover_pass.js +55 -32
  203. package/pass/cover_pass.ts +182 -0
  204. package/pass/debugDepthState.d.ts +20 -0
  205. package/pass/debugDepthState.js +9 -0
  206. package/pass/debugDepthState.ts +22 -0
  207. package/pass/depthTestBias.d.ts +12 -0
  208. package/pass/depthTestBias.js +12 -0
  209. package/pass/depthTestBias.ts +12 -0
  210. package/pass/effectUserData.d.ts +27 -0
  211. package/pass/effectUserData.js +1 -0
  212. package/pass/effectUserData.ts +46 -0
  213. package/pass/frosted_glass_pass.d.ts +1 -1
  214. package/pass/frosted_glass_pass.js +45 -64
  215. package/pass/frosted_glass_pass.ts +288 -0
  216. package/pass/fsQuad.d.ts +2 -2
  217. package/pass/fsQuad.ts +34 -0
  218. package/pass/glow_pass.d.ts +1 -1
  219. package/pass/glow_pass.js +288 -72
  220. package/pass/glow_pass.ts +654 -0
  221. package/pass/screen_bloom_pass.d.ts +11 -0
  222. package/pass/screen_bloom_pass.js +235 -0
  223. package/pass/screen_bloom_pass.ts +263 -0
  224. package/pass/ssao_pass.d.ts +78 -3
  225. package/pass/ssao_pass.js +642 -206
  226. package/pass/ssao_pass.ts +918 -0
  227. package/pass/stroke_pass.d.ts +1 -1
  228. package/pass/stroke_pass.js +187 -116
  229. package/pass/stroke_pass.ts +638 -0
  230. package/shaders/FXAAShaderMaterial.js +5 -48
  231. package/shaders/FXAAShaderMaterial.ts +201 -0
  232. package/shaders/baseDepthVisShader.d.ts +11 -0
  233. package/shaders/baseDepthVisShader.js +36 -0
  234. package/shaders/baseDepthVisShader.ts +36 -0
  235. package/shaders/baseTextureToRenderShader.js +46 -51
  236. package/shaders/baseTextureToRenderShader.ts +232 -0
  237. package/shaders/copyShader.js +2 -3
  238. package/shaders/copyShader.ts +32 -0
  239. package/shaders/debugDepthCompareShader.d.ts +14 -0
  240. package/shaders/debugDepthCompareShader.js +49 -0
  241. package/shaders/debugDepthCompareShader.ts +50 -0
  242. package/shaders/debugDepthJudgeShader.d.ts +18 -0
  243. package/shaders/debugDepthJudgeShader.js +52 -0
  244. package/shaders/debugDepthJudgeShader.ts +54 -0
  245. package/shaders/debugExcludedShader.d.ts +13 -0
  246. package/shaders/debugExcludedShader.js +46 -0
  247. package/shaders/debugExcludedShader.ts +48 -0
  248. package/spriteTextBg.d.ts +1 -0
  249. package/spriteTextBg.js +20 -0
  250. package/spriteTextBg.ts +20 -0
  251. package/threeLoader.d.ts +8 -7
  252. package/threeLoader.js +58 -67
  253. package/threeLoader.ts +525 -0
  254. package/threeUtils.d.ts +2 -1
  255. package/threeUtils.js +24 -25
  256. package/threeUtils.ts +373 -0
  257. package/types.d.ts +2 -0
  258. package/types.js +6 -0
  259. package/types.ts +8 -0
  260. package/ApngTexture.d.ts +0 -13
  261. package/ApngTexture.js +0 -61
  262. package/ApngTextureManage.d.ts +0 -18
  263. package/ApngTextureManage.js +0 -87
  264. package/KeyFrameAnimation.d.ts +0 -25
  265. package/KeyFrameAnimation.js +0 -78
  266. package/keyContorls.d.ts +0 -25
  267. package/lib/draco/draco_decoder.js +0 -34
  268. package/lib/draco/draco_decoder.wasm +0 -0
  269. package/lib/draco/draco_wasm_wrapper.js +0 -117
  270. package/pass/emissive_ao_pass.d.ts +0 -13
  271. package/pass/emissive_ao_pass.js +0 -370
  272. package/shaders.d.ts +0 -5
  273. package/shaders.js +0 -93
@@ -0,0 +1,343 @@
1
+ import { DynamicDrawUsage, StaticDrawUsage, Usage } from 'three/src/constants.js';
2
+ import { PathPoint } from './PathPoint.js';
3
+ import type { PathPointList } from './PathPointList.js';
4
+ import { BufferGeometry } from 'three/src/core/BufferGeometry.js';
5
+ import { BufferAttribute } from 'three/src/core/BufferAttribute.js';
6
+ import { Vector3 } from 'three/src/math/Vector3.js';
7
+
8
+ export interface Options {
9
+ radius?: number;
10
+ width?: number;
11
+ progress?: number;
12
+ radialSegments?: number;
13
+ startRad?: number;
14
+ arrow?: boolean;
15
+ side?: 'both' | 'left' | 'right';
16
+ }
17
+
18
+ export interface PathGeometryParam {
19
+ pathPointList: PathPointList;
20
+ options: Options;
21
+ usage: Usage;
22
+ transparent: boolean;
23
+ }
24
+
25
+ interface VertexData {
26
+ position: Array<number>;
27
+ normal: Array<number>;
28
+ uv: Array<number>;
29
+ uv2: Array<number>;
30
+ indices: Array<number>;
31
+ count: number;
32
+ }
33
+
34
+ /**
35
+ * PathGeometry
36
+ */
37
+ class PathGeometry extends BufferGeometry {
38
+ /**
39
+ * @param {Object|Number} initData - If initData is number, geometry init by empty data and set it as the max vertex. If initData is Object, it contains pathPointList and options.
40
+ * @param {Boolean} [generateUv2=false]
41
+ */
42
+ constructor(initData: PathGeometryParam, generateUv2: boolean = false) {
43
+ super();
44
+ this._initByData(initData.pathPointList, initData.options, initData.usage, generateUv2);
45
+ }
46
+
47
+ _initByMaxVertex(maxVertex: number, generateUv2: boolean): void {
48
+ this.setAttribute('position', new BufferAttribute(new Float32Array(maxVertex * 3), 3).setUsage(DynamicDrawUsage));
49
+ this.setAttribute('normal', new BufferAttribute(new Float32Array(maxVertex * 3), 3).setUsage(DynamicDrawUsage));
50
+ this.setAttribute('uv', new BufferAttribute(new Float32Array(maxVertex * 2), 2).setUsage(DynamicDrawUsage));
51
+ if (generateUv2) {
52
+ this.setAttribute('uv2', new BufferAttribute(new Float32Array(maxVertex * 2), 2).setUsage(DynamicDrawUsage));
53
+ }
54
+ this.drawRange.start = 0;
55
+ this.drawRange.count = 0;
56
+ this.setIndex(new Array(maxVertex * 3));
57
+ }
58
+
59
+ _initByData(pathPointList: PathPointList, options: Options, usage: Usage, generateUv2: boolean): void {
60
+ const vertexData = generatePathVertexData(pathPointList, options, generateUv2);
61
+ if (vertexData && vertexData.count !== 0) {
62
+ this.setAttribute('position', new BufferAttribute(new Float32Array(vertexData.position), 3).setUsage(usage || StaticDrawUsage));
63
+ this.setAttribute('normal', new BufferAttribute(new Float32Array(vertexData.normal), 3).setUsage(usage || StaticDrawUsage));
64
+ this.setAttribute('uv', new BufferAttribute(new Float32Array(vertexData.uv), 2).setUsage(usage || StaticDrawUsage));
65
+ if (generateUv2) {
66
+ this.setAttribute('uv2', new BufferAttribute(new Float32Array(vertexData.uv2), 2).setUsage(usage || StaticDrawUsage));
67
+ }
68
+ this.setIndex(vertexData.indices);
69
+ }
70
+ else {
71
+ this._initByMaxVertex(2, generateUv2);
72
+ }
73
+ }
74
+
75
+ /**
76
+ * Update geometry by PathPointList instance
77
+ * @param {PathPointList} pathPointList
78
+ * @param {Object} options
79
+ * @param {Number} [options.width=0.1]
80
+ * @param {Number} [options.progress=1]
81
+ * @param {Boolean} [options.arrow=true]
82
+ * @param {String} [options.side='both'] - "left"/"right"/"both"
83
+ */
84
+ update(pathPointList: PathPointList, options: Options): void {
85
+ const generateUv2 = !!this.getAttribute('uv2');
86
+ const vertexData = generatePathVertexData(pathPointList, options, generateUv2);
87
+ if (vertexData) {
88
+ this._updateAttributes(vertexData.position, vertexData.normal, vertexData.uv, generateUv2 ? vertexData.uv2 : null, vertexData.indices);
89
+ this.drawRange.count = vertexData.count;
90
+ }
91
+ else {
92
+ this.drawRange.count = 0;
93
+ }
94
+ }
95
+
96
+ _resizeAttribute(name: string, len: number): void {
97
+ let attribute = this.getAttribute(name);
98
+ while (attribute.array.length < len) {
99
+ const oldLength = attribute.array.length;
100
+ const newAttribute = new BufferAttribute(new Float32Array(oldLength * 2), attribute.itemSize, attribute.normalized);
101
+ newAttribute.name = attribute.name;
102
+ if (attribute instanceof BufferAttribute) {
103
+ newAttribute.usage = attribute.usage;
104
+ }
105
+ this.setAttribute(name, newAttribute);
106
+ attribute = newAttribute;
107
+ }
108
+ }
109
+
110
+ _resizeIndex(len: number): void {
111
+ let index = this.getIndex();
112
+ if (!index) return;
113
+ while (index.array.length < len) {
114
+ const oldLength = index.array.length;
115
+ const newIndex = new BufferAttribute(oldLength * 2 > 65535 ? new Uint32Array(oldLength * 2) : new Uint16Array(oldLength * 2), 1);
116
+ newIndex.name = index.name;
117
+ if (index instanceof BufferAttribute) {
118
+ newIndex.usage = index.usage;
119
+ }
120
+ this.setIndex(newIndex);
121
+ index = newIndex;
122
+ }
123
+ }
124
+
125
+ _updateAttributes(position: Array<number>, normal: Array<number>, uv: Array<number>, uv2: Array<number> | null, indices: Array<number>): void {
126
+ this._resizeAttribute('position', position.length);
127
+ const positionAttribute = this.getAttribute('position') as BufferAttribute & { updateRange: { count: number } };
128
+ positionAttribute.array.set(position, 0);
129
+ positionAttribute.updateRange.count = position.length;
130
+ positionAttribute.needsUpdate = true;
131
+ this._resizeAttribute('normal', normal.length);
132
+ const normalAttribute = this.getAttribute('normal') as BufferAttribute & { updateRange: { count: number } };
133
+ normalAttribute.array.set(normal, 0);
134
+ normalAttribute.updateRange.count = normal.length;
135
+ normalAttribute.needsUpdate = true;
136
+ this._resizeAttribute('uv', uv.length);
137
+ const uvAttribute = this.getAttribute('uv') as BufferAttribute & { updateRange: { count: number } };
138
+ uvAttribute.array.set(uv, 0);
139
+ uvAttribute.updateRange.count = uv.length;
140
+ uvAttribute.needsUpdate = true;
141
+ if (uv2) {
142
+ this._resizeAttribute('uv2', uv2.length);
143
+ const uv2Attribute = this.getAttribute('uv2') as BufferAttribute & { updateRange: { count: number } };
144
+ uv2Attribute.array.set(uv2, 0);
145
+ uv2Attribute.updateRange.count = uv2.length;
146
+ uv2Attribute.needsUpdate = true;
147
+ }
148
+ this._resizeIndex(indices.length);
149
+ const indexAttribute = this.getIndex() as BufferAttribute & { updateRange: { count: number } };
150
+ indexAttribute.set(indices, 0);
151
+ indexAttribute.updateRange.count = indices.length;
152
+ indexAttribute.needsUpdate = true;
153
+ indexAttribute.needsUpdate = true;
154
+ }
155
+ }
156
+
157
+ export { PathGeometry };
158
+
159
+ // Vertex Data Generate Functions
160
+ function generatePathVertexData(pathPointList: PathPointList, options: Options, generateUv2: boolean = false): VertexData | null {
161
+ const width = options.width || 0.1;
162
+ const progress = options.progress !== undefined ? options.progress : 1;
163
+ const arrow = options.arrow !== undefined ? options.arrow : true;
164
+ const side = options.side !== undefined ? options.side : 'both';
165
+ const halfWidth = width / 2;
166
+ const sideWidth = side !== 'both' ? width / 2 : width;
167
+ const totalDistance = pathPointList.distance();
168
+ const progressDistance = progress * totalDistance;
169
+ if (totalDistance == 0) {
170
+ return null;
171
+ }
172
+ const sharpUvOffset = halfWidth / sideWidth;
173
+ const sharpUvOffset2 = halfWidth / totalDistance;
174
+ let count = 0;
175
+ // modify data
176
+ const position: Array<number> = [];
177
+ const normal: Array<number> = [];
178
+ const uv: Array<number> = [];
179
+ const uv2: Array<number> = [];
180
+ const indices: Array<number> = [];
181
+ let verticesCount = 0;
182
+ const right = new Vector3();
183
+ const left = new Vector3();
184
+ // for sharp corners
185
+ const leftOffset = new Vector3();
186
+ const rightOffset = new Vector3();
187
+ const tempPoint1 = new Vector3();
188
+ const tempPoint2 = new Vector3();
189
+
190
+ function addVertices(pathPoint: PathPoint): void {
191
+ const first = position.length === 0;
192
+ const sharpCorner = pathPoint.sharp && !first;
193
+ const uvDist = pathPoint.dist / sideWidth;
194
+ const uvDist2 = pathPoint.dist / totalDistance;
195
+ const dir = pathPoint.dir;
196
+ const up = pathPoint.up;
197
+ const _right = pathPoint.right;
198
+ if (side !== 'left') {
199
+ right.copy(_right).multiplyScalar(halfWidth * pathPoint.widthScale);
200
+ }
201
+ else {
202
+ right.set(0, 0, 0);
203
+ }
204
+ if (side !== 'right') {
205
+ left.copy(_right).multiplyScalar(-halfWidth * pathPoint.widthScale);
206
+ }
207
+ else {
208
+ left.set(0, 0, 0);
209
+ }
210
+ right.add(pathPoint.pos);
211
+ left.add(pathPoint.pos);
212
+ if (sharpCorner) {
213
+ leftOffset.fromArray(position, position.length - 6).sub(left);
214
+ rightOffset.fromArray(position, position.length - 3).sub(right);
215
+ const leftDist = leftOffset.length();
216
+ const rightDist = rightOffset.length();
217
+ const sideOffset = leftDist - rightDist;
218
+ let longerOffset, longEdge;
219
+ if (sideOffset > 0) {
220
+ longerOffset = leftOffset;
221
+ longEdge = left;
222
+ }
223
+ else {
224
+ longerOffset = rightOffset;
225
+ longEdge = right;
226
+ }
227
+ tempPoint1.copy(longerOffset).setLength(Math.abs(sideOffset)).add(longEdge);
228
+ let _cos = tempPoint2.copy(longEdge).sub(tempPoint1).normalize().dot(dir);
229
+ let _len = tempPoint2.copy(longEdge).sub(tempPoint1).length();
230
+ let _dist = _cos * _len * 2;
231
+ tempPoint2.copy(dir).setLength(_dist).add(tempPoint1);
232
+ if (sideOffset > 0) {
233
+ position.push(tempPoint1.x, tempPoint1.y, tempPoint1.z, // 6
234
+ right.x, right.y, right.z, // 5
235
+ left.x, left.y, left.z, // 4
236
+ right.x, right.y, right.z, // 3
237
+ tempPoint2.x, tempPoint2.y, tempPoint2.z, // 2
238
+ right.x, right.y, right.z // 1
239
+ );
240
+ verticesCount += 6;
241
+ indices.push(verticesCount - 6, verticesCount - 8, verticesCount - 7, verticesCount - 6, verticesCount - 7, verticesCount - 5, verticesCount - 4, verticesCount - 6, verticesCount - 5, verticesCount - 2, verticesCount - 4, verticesCount - 1);
242
+ count += 12;
243
+ }
244
+ else {
245
+ position.push(left.x, left.y, left.z, // 6
246
+ tempPoint1.x, tempPoint1.y, tempPoint1.z, // 5
247
+ left.x, left.y, left.z, // 4
248
+ right.x, right.y, right.z, // 3
249
+ left.x, left.y, left.z, // 2
250
+ tempPoint2.x, tempPoint2.y, tempPoint2.z // 1
251
+ );
252
+ verticesCount += 6;
253
+ indices.push(verticesCount - 6, verticesCount - 8, verticesCount - 7, verticesCount - 6, verticesCount - 7, verticesCount - 5, verticesCount - 6, verticesCount - 5, verticesCount - 3, verticesCount - 2, verticesCount - 3, verticesCount - 1);
254
+ count += 12;
255
+ }
256
+ normal.push(up.x, up.y, up.z, up.x, up.y, up.z, up.x, up.y, up.z, up.x, up.y, up.z, up.x, up.y, up.z, up.x, up.y, up.z);
257
+ uv.push(uvDist - sharpUvOffset, 0, uvDist - sharpUvOffset, 1, uvDist, 0, uvDist, 1, uvDist + sharpUvOffset, 0, uvDist + sharpUvOffset, 1);
258
+ if (generateUv2) {
259
+ uv2.push(uvDist2 - sharpUvOffset2, 0, uvDist2 - sharpUvOffset2, 1, uvDist2, 0, uvDist2, 1, uvDist2 + sharpUvOffset2, 0, uvDist2 + sharpUvOffset2, 1);
260
+ }
261
+ }
262
+ else {
263
+ position.push(left.x, left.y, left.z, right.x, right.y, right.z);
264
+ normal.push(up.x, up.y, up.z, up.x, up.y, up.z);
265
+ uv.push(uvDist, 0, uvDist, 1);
266
+ if (generateUv2) {
267
+ uv2.push(uvDist2, 0, uvDist2, 1);
268
+ }
269
+ verticesCount += 2;
270
+ if (!first) {
271
+ indices.push(verticesCount - 2, verticesCount - 4, verticesCount - 3, verticesCount - 2, verticesCount - 3, verticesCount - 1);
272
+ count += 6;
273
+ }
274
+ }
275
+ }
276
+ const sharp = new Vector3();
277
+ function addStart(pathPoint: PathPoint): void {
278
+ const dir = pathPoint.dir;
279
+ const up = pathPoint.up;
280
+ const _right = pathPoint.right;
281
+ const uvDist = pathPoint.dist / sideWidth;
282
+ const uvDist2 = pathPoint.dist / totalDistance;
283
+ if (side !== 'left') {
284
+ right.copy(_right).multiplyScalar(halfWidth * 2);
285
+ }
286
+ else {
287
+ right.set(0, 0, 0);
288
+ }
289
+ if (side !== 'right') {
290
+ left.copy(_right).multiplyScalar(-halfWidth * 2);
291
+ }
292
+ else {
293
+ left.set(0, 0, 0);
294
+ }
295
+ sharp.copy(dir).setLength(halfWidth * 3);
296
+ right.add(pathPoint.pos);
297
+ left.add(pathPoint.pos);
298
+ sharp.add(pathPoint.pos);
299
+ position.push(left.x, left.y, left.z, right.x, right.y, right.z, sharp.x, sharp.y, sharp.z);
300
+ normal.push(up.x, up.y, up.z, up.x, up.y, up.z, up.x, up.y, up.z);
301
+ uv.push(uvDist, side !== 'both' ? (side !== 'right' ? -2 : 0) : -0.5, uvDist, side !== 'both' ? (side !== 'left' ? 2 : 0) : 1.5, uvDist + 1.5, side !== 'both' ? 0 : 0.5);
302
+ if (generateUv2) {
303
+ uv2.push(uvDist2, side !== 'both' ? (side !== 'right' ? -2 : 0) : -0.5, uvDist2, side !== 'both' ? (side !== 'left' ? 2 : 0) : 1.5, uvDist2 + (1.5 * width) / totalDistance, side !== 'both' ? 0 : 0.5);
304
+ }
305
+ verticesCount += 3;
306
+ indices.push(verticesCount - 1, verticesCount - 3, verticesCount - 2);
307
+ count += 3;
308
+ }
309
+ let lastPoint: PathPoint | undefined;
310
+ if (progressDistance > 0) {
311
+ for (let i = 0; i < pathPointList.count; i++) {
312
+ const pathPoint = pathPointList.array[i];
313
+ if (pathPoint.dist > progressDistance) {
314
+ const prevPoint = pathPointList.array[i - 1];
315
+ lastPoint = new PathPoint();
316
+ // linear lerp for progress
317
+ const alpha = (progressDistance - prevPoint.dist) / (pathPoint.dist - prevPoint.dist);
318
+ lastPoint.lerpPathPoints(prevPoint, pathPoint, alpha);
319
+ addVertices(lastPoint);
320
+ break;
321
+ }
322
+ else {
323
+ addVertices(pathPoint);
324
+ }
325
+ }
326
+ }
327
+ else {
328
+ lastPoint = pathPointList.array[0];
329
+ }
330
+ // build arrow geometry
331
+ if (arrow) {
332
+ lastPoint = lastPoint || pathPointList.array[pathPointList.count - 1];
333
+ addStart(lastPoint);
334
+ }
335
+ return {
336
+ position,
337
+ normal,
338
+ uv,
339
+ uv2,
340
+ indices,
341
+ count,
342
+ };
343
+ }
@@ -0,0 +1,36 @@
1
+ import { Vector3 } from 'three/src/math/Vector3';
2
+
3
+ /**
4
+ * PathPoint
5
+ */
6
+ class PathPoint {
7
+ pos: Vector3 = new Vector3();
8
+ dir: Vector3 = new Vector3();
9
+ right: Vector3 = new Vector3();
10
+ up: Vector3 = new Vector3(); // normal
11
+ dist: number = 0; // distance from start
12
+ widthScale: number = 1; // for corner
13
+ sharp: boolean = false; // marks as sharp corner
14
+
15
+ constructor() { }
16
+
17
+ lerpPathPoints(p1: PathPoint, p2: PathPoint, alpha: number): void {
18
+ this.pos.lerpVectors(p1.pos, p2.pos, alpha);
19
+ this.dir.lerpVectors(p1.dir, p2.dir, alpha);
20
+ this.up.lerpVectors(p1.up, p2.up, alpha);
21
+ this.right.lerpVectors(p1.right, p2.right, alpha);
22
+ this.dist = (p2.dist - p1.dist) * alpha + p1.dist;
23
+ this.widthScale = (p2.widthScale - p1.widthScale) * alpha + p1.widthScale;
24
+ }
25
+
26
+ copy(source: PathPoint): void {
27
+ this.pos.copy(source.pos);
28
+ this.dir.copy(source.dir);
29
+ this.up.copy(source.up);
30
+ this.right.copy(source.right);
31
+ this.dist = source.dist;
32
+ this.widthScale = source.widthScale;
33
+ }
34
+ }
35
+
36
+ export { PathPoint };
@@ -112,6 +112,7 @@ class PathPointList {
112
112
  point.up.set(0, 1, 0);
113
113
  }
114
114
  if (tz < min) {
115
+ min = tz;
115
116
  point.up.set(0, 0, 1);
116
117
  }
117
118
  }
@@ -0,0 +1,227 @@
1
+ import { Vector3 } from 'three/src/math/Vector3.js';
2
+ import { PathPoint } from './PathPoint.js';
3
+ import { Matrix4 } from 'three/src/math/Matrix4.js';
4
+ import { QuadraticBezierCurve3 } from 'three/src/extras/curves/QuadraticBezierCurve3.js';
5
+
6
+ const helpVec3_1: Vector3 = new Vector3();
7
+ const helpVec3_2: Vector3 = new Vector3();
8
+ const helpVec3_3: Vector3 = new Vector3();
9
+ const helpMat4: Matrix4 = new Matrix4();
10
+ const helpCurve: QuadraticBezierCurve3 = new QuadraticBezierCurve3(new Vector3(), new Vector3(), new Vector3());
11
+
12
+ interface CornerBezierCurve {
13
+ v0: Vector3;
14
+ v1: Vector3;
15
+ v2: Vector3;
16
+ }
17
+
18
+ function _getCornerBezierCurve(last: Vector3, current: Vector3, next: Vector3, cornerRadius: number, firstCorner: boolean, out: QuadraticBezierCurve3): QuadraticBezierCurve3 {
19
+ const lastDir = helpVec3_1.subVectors(current, last);
20
+ const nextDir = helpVec3_2.subVectors(next, current);
21
+ const lastDirLength = lastDir.length();
22
+ const nextDirLength = nextDir.length();
23
+ lastDir.normalize();
24
+ nextDir.normalize();
25
+ // cornerRadius can not bigger then lineDistance / 2, auto fix this
26
+ const v0Dist = Math.min((firstCorner ? lastDirLength / 2 : lastDirLength) * 0.999999, cornerRadius);
27
+ out.v0.copy(current).sub(lastDir.multiplyScalar(v0Dist));
28
+ out.v1.copy(current);
29
+ const v2Dist = Math.min((nextDirLength / 2) * 0.999999, cornerRadius);
30
+ out.v2.copy(current).add(nextDir.multiplyScalar(v2Dist));
31
+ return out;
32
+ }
33
+
34
+ /**
35
+ * PathPointList
36
+ * input points to generate a PathPoint list
37
+ */
38
+ class PathPointList {
39
+ array: Array<PathPoint> = []; // path point array
40
+ count: number = 0;
41
+
42
+ constructor() { }
43
+
44
+ /**
45
+ * Set points
46
+ * @param {Vector3[]} points key points array
47
+ * @param {number} cornerRadius? the corner radius. set 0 to disable round corner. default is 0.1
48
+ * @param {number} cornerSplit? the corner split. default is 10.
49
+ * @param {number} up? force up. default is auto up (calculate by tangent).
50
+ * @param {boolean} close? close path. default is false.
51
+ */
52
+ set(points: Array<Vector3>, cornerRadius: number = 0.1, cornerSplit: number = 10, up?: Vector3, close: boolean = false): void {
53
+ points = points.slice(0);
54
+ if (points.length < 2) {
55
+ console.warn('PathPointList: points length less than 2.');
56
+ this.count = 0;
57
+ return;
58
+ }
59
+ // Auto close
60
+ if (close && !points[0].equals(points[points.length - 1])) {
61
+ points.push(new Vector3().copy(points[0]));
62
+ }
63
+ // Generate path point list
64
+ for (let i = 0, l = points.length; i < l; i++) {
65
+ if (i === 0) {
66
+ this._start(points[i], points[i + 1], up);
67
+ }
68
+ else if (i === l - 1) {
69
+ if (close) {
70
+ // Connect end point and start point
71
+ this._corner(points[i], points[1], cornerRadius, cornerSplit, up);
72
+ // Fix start point
73
+ const dist = this.array[0].dist; // should not copy dist
74
+ this.array[0].copy(this.array[this.count - 1]);
75
+ this.array[0].dist = dist;
76
+ }
77
+ else {
78
+ this._end(points[i]);
79
+ }
80
+ }
81
+ else {
82
+ this._corner(points[i], points[i + 1], cornerRadius, cornerSplit, up);
83
+ }
84
+ }
85
+ }
86
+
87
+ /**
88
+ * Get distance of this path
89
+ * @return {number}
90
+ */
91
+ distance(): number {
92
+ if (this.count > 0) {
93
+ return this.array[this.count - 1].dist;
94
+ }
95
+ return 0;
96
+ }
97
+
98
+ _getByIndex(index: number): PathPoint {
99
+ if (!this.array[index]) {
100
+ this.array[index] = new PathPoint();
101
+ }
102
+ return this.array[index];
103
+ }
104
+
105
+ _start(current: Vector3, next: Vector3, up?: Vector3): void {
106
+ this.count = 0;
107
+ const point = this._getByIndex(this.count);
108
+ point.pos.copy(current);
109
+ point.dir.subVectors(next, current);
110
+ // init start up dir
111
+ if (up) {
112
+ point.up.copy(up);
113
+ }
114
+ else {
115
+ // select an initial normal vector perpendicular to the first tangent vector
116
+ let min = Number.MAX_VALUE;
117
+ const tx = Math.abs(point.dir.x);
118
+ const ty = Math.abs(point.dir.y);
119
+ const tz = Math.abs(point.dir.z);
120
+ if (tx < min) {
121
+ min = tx;
122
+ point.up.set(1, 0, 0);
123
+ }
124
+ if (ty < min) {
125
+ min = ty;
126
+ point.up.set(0, 1, 0);
127
+ }
128
+ if (tz < min) {
129
+ min = tz;
130
+ point.up.set(0, 0, 1);
131
+ }
132
+ }
133
+ point.right.crossVectors(point.dir, point.up).normalize();
134
+ point.up.crossVectors(point.right, point.dir).normalize();
135
+ point.dist = 0;
136
+ point.widthScale = 1;
137
+ point.sharp = false;
138
+ point.dir.normalize();
139
+ this.count++;
140
+ }
141
+
142
+ _end(current: Vector3): void {
143
+ const lastPoint = this.array[this.count - 1];
144
+ const point = this._getByIndex(this.count);
145
+ point.pos.copy(current);
146
+ point.dir.subVectors(current, lastPoint.pos);
147
+ const dist = point.dir.length();
148
+ point.dir.normalize();
149
+ point.up.copy(lastPoint.up); // copy last up
150
+ const vec = helpVec3_1.crossVectors(lastPoint.dir, point.dir);
151
+ if (vec.length() > Number.EPSILON) {
152
+ vec.normalize();
153
+ const theta = Math.acos(Math.min(Math.max(lastPoint.dir.dot(point.dir), -1), 1)); // clamp for floating pt errors
154
+ point.up.applyMatrix4(helpMat4.makeRotationAxis(vec, theta));
155
+ }
156
+ point.right.crossVectors(point.dir, point.up).normalize();
157
+ point.dist = lastPoint.dist + dist;
158
+ point.widthScale = 1;
159
+ point.sharp = false;
160
+ this.count++;
161
+ }
162
+
163
+ _corner(current: Vector3, next: Vector3, cornerRadius: number, cornerSplit: number, up?: Vector3): void {
164
+ if (cornerRadius > 0 && cornerSplit > 0) {
165
+ const lastPoint = this.array[this.count - 1];
166
+ const curve = _getCornerBezierCurve(lastPoint.pos, current, next, cornerRadius, this.count - 1 === 0, helpCurve);
167
+ const samplerPoints = curve.getPoints(cornerSplit);
168
+ for (let f = 0; f < cornerSplit; f++) {
169
+ this._sharpCorner(samplerPoints[f], samplerPoints[f + 1], up, f === 0 ? 1 : 0);
170
+ }
171
+ if (!samplerPoints[cornerSplit].equals(next)) {
172
+ this._sharpCorner(samplerPoints[cornerSplit], next, up, 2);
173
+ }
174
+ }
175
+ else {
176
+ this._sharpCorner(current, next, up, 0, true);
177
+ }
178
+ }
179
+
180
+ // dirType: 0 - use middle dir / 1 - use last dir / 2- use next dir
181
+ _sharpCorner(current: Vector3, next: Vector3, up?: Vector3, dirType: 0 | 1 | 2 = 0, sharp: boolean = false): void {
182
+ const lastPoint = this.array[this.count - 1];
183
+ const point = this._getByIndex(this.count);
184
+ const lastDir = helpVec3_1.subVectors(current, lastPoint.pos);
185
+ const nextDir = helpVec3_2.subVectors(next, current);
186
+ const lastDirLength = lastDir.length();
187
+ lastDir.normalize();
188
+ nextDir.normalize();
189
+ point.pos.copy(current);
190
+ if (dirType === 1) {
191
+ point.dir.copy(lastDir);
192
+ }
193
+ else if (dirType === 2) {
194
+ point.dir.copy(nextDir);
195
+ }
196
+ else {
197
+ point.dir.addVectors(lastDir, nextDir);
198
+ point.dir.normalize();
199
+ }
200
+ if (up) {
201
+ if (point.dir.dot(up) === 1) {
202
+ point.right.crossVectors(nextDir, up).normalize();
203
+ }
204
+ else {
205
+ point.right.crossVectors(point.dir, up).normalize();
206
+ }
207
+ point.up.crossVectors(point.right, point.dir).normalize();
208
+ }
209
+ else {
210
+ point.up.copy(lastPoint.up);
211
+ const vec = helpVec3_3.crossVectors(lastPoint.dir, point.dir);
212
+ if (vec.length() > Number.EPSILON) {
213
+ vec.normalize();
214
+ const theta = Math.acos(Math.min(Math.max(lastPoint.dir.dot(point.dir), -1), 1)); // clamp for floating pt errors
215
+ point.up.applyMatrix4(helpMat4.makeRotationAxis(vec, theta));
216
+ }
217
+ point.right.crossVectors(point.dir, point.up).normalize();
218
+ }
219
+ point.dist = lastPoint.dist + lastDirLength;
220
+ const _cos = lastDir.dot(nextDir);
221
+ point.widthScale = Math.min(1 / Math.sqrt((1 + _cos) / 2), 1.415) || 1;
222
+ point.sharp = Math.abs(_cos - 1) > 0.05 && sharp;
223
+ this.count++;
224
+ }
225
+ }
226
+
227
+ export { PathPointList };