sfml.js 0.0.1 → 1.0.0-rc.2

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 (741) hide show
  1. package/LICENSE +1 -1
  2. package/README.ja.md +173 -0
  3. package/README.ko.md +173 -0
  4. package/README.md +129 -20
  5. package/README.zh-CN.md +173 -0
  6. package/assets/branding/sfml-js-symbol-pentagon.svg +24 -0
  7. package/assets/branding/sfml-js-wordmark-dark.svg +20 -0
  8. package/assets/branding/sfml-js-wordmark.svg +19 -0
  9. package/assets/breakout.png +0 -0
  10. package/binding.gyp +95 -183
  11. package/dist/audio/effect-processor.d.ts +67 -0
  12. package/dist/audio/effect-processor.js +58 -0
  13. package/dist/audio/input-sound-file.d.ts +138 -0
  14. package/dist/audio/input-sound-file.js +253 -0
  15. package/dist/audio/listener.d.ts +90 -0
  16. package/dist/audio/listener.js +148 -0
  17. package/dist/audio/music.d.ts +210 -0
  18. package/dist/audio/music.js +353 -0
  19. package/dist/audio/output-sound-file.d.ts +47 -0
  20. package/dist/audio/output-sound-file.js +102 -0
  21. package/dist/audio/playback-device.d.ts +121 -0
  22. package/dist/audio/playback-device.js +152 -0
  23. package/dist/audio/sound-buffer-recorder.d.ts +114 -0
  24. package/dist/audio/sound-buffer-recorder.js +142 -0
  25. package/dist/audio/sound-buffer.d.ts +150 -0
  26. package/dist/audio/sound-buffer.js +237 -0
  27. package/dist/audio/sound-file-factory.d.ts +100 -0
  28. package/dist/audio/sound-file-factory.js +225 -0
  29. package/dist/audio/sound-file-reader.d.ts +191 -0
  30. package/dist/audio/sound-file-reader.js +132 -0
  31. package/dist/audio/sound-file-writer.d.ts +59 -0
  32. package/dist/audio/sound-file-writer.js +20 -0
  33. package/dist/audio/sound-recorder.d.ts +184 -0
  34. package/dist/audio/sound-recorder.js +286 -0
  35. package/dist/audio/sound-source.d.ts +336 -0
  36. package/dist/audio/sound-source.js +389 -0
  37. package/dist/audio/sound-stream.d.ts +76 -0
  38. package/dist/audio/sound-stream.js +83 -0
  39. package/dist/audio/sound.d.ts +41 -0
  40. package/dist/audio/sound.js +66 -0
  41. package/dist/audio/value.d.ts +359 -0
  42. package/dist/audio/value.js +353 -0
  43. package/dist/audio/worker.d.ts +306 -0
  44. package/dist/audio/worker.js +2 -0
  45. package/dist/graphics/blend-mode.d.ts +248 -0
  46. package/dist/graphics/blend-mode.js +234 -0
  47. package/dist/graphics/boolean-vector.d.ts +134 -0
  48. package/dist/graphics/boolean-vector.js +202 -0
  49. package/dist/graphics/circle-shape.d.ts +84 -0
  50. package/dist/graphics/circle-shape.js +72 -0
  51. package/dist/graphics/color.d.ts +278 -0
  52. package/dist/graphics/color.js +291 -0
  53. package/dist/graphics/convex-shape.d.ts +56 -0
  54. package/dist/graphics/convex-shape.js +59 -0
  55. package/dist/graphics/drawable.d.ts +22 -0
  56. package/dist/graphics/drawable.js +20 -0
  57. package/dist/graphics/font.d.ts +199 -0
  58. package/dist/graphics/font.js +319 -0
  59. package/dist/graphics/glsl-matrix.d.ts +62 -0
  60. package/dist/graphics/glsl-matrix.js +106 -0
  61. package/dist/graphics/glsl.d.ts +165 -0
  62. package/dist/graphics/glsl.js +215 -0
  63. package/dist/graphics/glyph.d.ts +133 -0
  64. package/dist/graphics/glyph.js +138 -0
  65. package/dist/graphics/image.d.ts +192 -0
  66. package/dist/graphics/image.js +285 -0
  67. package/dist/graphics/primitive-type.d.ts +51 -0
  68. package/dist/graphics/primitive-type.js +60 -0
  69. package/dist/graphics/rect.d.ts +203 -0
  70. package/dist/graphics/rect.js +249 -0
  71. package/dist/graphics/rectangle-shape.d.ts +55 -0
  72. package/dist/graphics/rectangle-shape.js +60 -0
  73. package/dist/graphics/render-states.d.ts +188 -0
  74. package/dist/graphics/render-states.js +115 -0
  75. package/dist/graphics/render-target.d.ts +222 -0
  76. package/dist/graphics/render-target.js +434 -0
  77. package/dist/graphics/render-texture.d.ts +130 -0
  78. package/dist/graphics/render-texture.js +187 -0
  79. package/dist/graphics/render-window.d.ts +138 -0
  80. package/dist/graphics/render-window.js +154 -0
  81. package/dist/graphics/shader.d.ts +192 -0
  82. package/dist/graphics/shader.js +321 -0
  83. package/dist/graphics/shape.d.ts +189 -0
  84. package/dist/graphics/shape.js +277 -0
  85. package/dist/graphics/sprite.d.ts +104 -0
  86. package/dist/graphics/sprite.js +164 -0
  87. package/dist/graphics/stencil-mode.d.ts +230 -0
  88. package/dist/graphics/stencil-mode.js +173 -0
  89. package/dist/graphics/swap.d.ts +17 -0
  90. package/dist/graphics/swap.js +16 -0
  91. package/dist/graphics/text.d.ts +759 -0
  92. package/dist/graphics/text.js +724 -0
  93. package/dist/graphics/texture.d.ts +255 -0
  94. package/dist/graphics/texture.js +390 -0
  95. package/dist/graphics/transform.d.ts +129 -0
  96. package/dist/graphics/transform.js +274 -0
  97. package/dist/graphics/transformable.d.ts +24 -0
  98. package/dist/graphics/transformable.js +38 -0
  99. package/dist/graphics/vertex-array.d.ts +123 -0
  100. package/dist/graphics/vertex-array.js +234 -0
  101. package/dist/graphics/vertex-buffer.d.ts +205 -0
  102. package/dist/graphics/vertex-buffer.js +256 -0
  103. package/dist/graphics/vertex.d.ts +111 -0
  104. package/dist/graphics/vertex.js +134 -0
  105. package/dist/graphics/view.d.ts +172 -0
  106. package/dist/graphics/view.js +296 -0
  107. package/dist/index.d.ts +116 -0
  108. package/dist/index.js +251 -0
  109. package/dist/internal/audio-codec-registry.d.ts +13 -0
  110. package/dist/internal/audio-codec-registry.js +64 -0
  111. package/dist/internal/audio-input-stream.d.ts +13 -0
  112. package/dist/internal/audio-input-stream.js +44 -0
  113. package/dist/internal/audio-music-pump.d.ts +63 -0
  114. package/dist/internal/audio-music-pump.js +193 -0
  115. package/dist/internal/audio-native.d.ts +145 -0
  116. package/dist/internal/audio-native.js +24 -0
  117. package/dist/internal/audio-recorder-session.d.ts +77 -0
  118. package/dist/internal/audio-recorder-session.js +182 -0
  119. package/dist/internal/audio-worker-session.d.ts +18 -0
  120. package/dist/internal/audio-worker-session.js +82 -0
  121. package/dist/internal/audio-worker.d.ts +1 -0
  122. package/dist/internal/audio-worker.js +134 -0
  123. package/dist/internal/glsl-value.d.ts +51 -0
  124. package/dist/internal/glsl-value.js +69 -0
  125. package/dist/internal/graphics-state.d.ts +45 -0
  126. package/dist/internal/graphics-state.js +123 -0
  127. package/dist/internal/input-stream.d.ts +4 -0
  128. package/dist/internal/input-stream.js +25 -0
  129. package/dist/internal/lazy-value.d.ts +17 -0
  130. package/dist/internal/lazy-value.js +43 -0
  131. package/dist/internal/native.d.ts +317 -0
  132. package/dist/internal/native.js +8 -0
  133. package/dist/internal/numeric-properties.d.ts +2 -0
  134. package/dist/internal/numeric-properties.js +39 -0
  135. package/dist/internal/render-states.d.ts +4 -0
  136. package/dist/internal/render-states.js +44 -0
  137. package/dist/internal/scalar.d.ts +52 -0
  138. package/dist/internal/scalar.js +95 -0
  139. package/dist/internal/shaped-glyph.d.ts +32 -0
  140. package/dist/internal/shaped-glyph.js +51 -0
  141. package/dist/internal/struct-view.d.ts +11 -0
  142. package/dist/internal/struct-view.js +39 -0
  143. package/dist/internal/text-indices.d.ts +7 -0
  144. package/dist/internal/text-indices.js +22 -0
  145. package/dist/internal/transformable.d.ts +124 -0
  146. package/dist/internal/transformable.js +121 -0
  147. package/dist/internal/value-storage.d.ts +33 -0
  148. package/dist/internal/value-storage.js +21 -0
  149. package/dist/network/common.d.ts +23 -0
  150. package/dist/network/common.js +78 -0
  151. package/dist/network/dns.d.ts +124 -0
  152. package/dist/network/dns.js +142 -0
  153. package/dist/network/ftp.d.ts +265 -0
  154. package/dist/network/ftp.js +417 -0
  155. package/dist/network/gen/constants.d.ts +878 -0
  156. package/dist/network/gen/constants.js +886 -0
  157. package/dist/network/http.d.ts +458 -0
  158. package/dist/network/http.js +732 -0
  159. package/dist/network/ip-address.d.ts +210 -0
  160. package/dist/network/ip-address.js +301 -0
  161. package/dist/network/packet.d.ts +249 -0
  162. package/dist/network/packet.js +326 -0
  163. package/dist/network/sftp.d.ts +661 -0
  164. package/dist/network/sftp.js +826 -0
  165. package/dist/network/socket-selector.d.ts +132 -0
  166. package/dist/network/socket-selector.js +214 -0
  167. package/dist/network/socket.d.ts +301 -0
  168. package/dist/network/socket.js +402 -0
  169. package/dist/network/tcp-listener.d.ts +114 -0
  170. package/dist/network/tcp-listener.js +199 -0
  171. package/dist/network/tcp-socket.d.ts +307 -0
  172. package/dist/network/tcp-socket.js +493 -0
  173. package/dist/network/tls-material.d.ts +22 -0
  174. package/dist/network/tls-material.js +52 -0
  175. package/dist/network/udp-socket.d.ts +178 -0
  176. package/dist/network/udp-socket.js +285 -0
  177. package/dist/system/angle.d.ts +77 -0
  178. package/dist/system/angle.js +122 -0
  179. package/dist/system/clock.d.ts +65 -0
  180. package/dist/system/clock.js +99 -0
  181. package/dist/system/err.d.ts +18 -0
  182. package/dist/system/err.js +61 -0
  183. package/dist/system/error.d.ts +15 -0
  184. package/dist/system/error.js +22 -0
  185. package/dist/system/file-input-stream.d.ts +68 -0
  186. package/dist/system/file-input-stream.js +148 -0
  187. package/dist/system/input-stream.d.ts +114 -0
  188. package/dist/system/input-stream.js +106 -0
  189. package/dist/system/operators.d.ts +291 -0
  190. package/dist/system/operators.js +505 -0
  191. package/dist/system/sleep.d.ts +9 -0
  192. package/dist/system/sleep.js +28 -0
  193. package/dist/system/suspend-aware-clock.d.ts +22 -0
  194. package/dist/system/suspend-aware-clock.js +29 -0
  195. package/dist/system/time.d.ts +100 -0
  196. package/dist/system/time.js +188 -0
  197. package/dist/system/timeout-with-predicate.d.ts +60 -0
  198. package/dist/system/timeout-with-predicate.js +52 -0
  199. package/dist/system/unicode.d.ts +54 -0
  200. package/dist/system/unicode.js +67 -0
  201. package/dist/system/vector2.d.ts +302 -0
  202. package/dist/system/vector2.js +314 -0
  203. package/dist/system/vector3.d.ts +249 -0
  204. package/dist/system/vector3.js +266 -0
  205. package/dist/system/version.d.ts +51 -0
  206. package/dist/system/version.js +24 -0
  207. package/dist/window/clipboard.d.ts +14 -0
  208. package/dist/window/clipboard.js +26 -0
  209. package/dist/window/context-settings.d.ts +94 -0
  210. package/dist/window/context-settings.js +84 -0
  211. package/dist/window/context.d.ts +87 -0
  212. package/dist/window/context.js +122 -0
  213. package/dist/window/cursor.d.ts +58 -0
  214. package/dist/window/cursor.js +80 -0
  215. package/dist/window/event.d.ts +529 -0
  216. package/dist/window/event.js +87 -0
  217. package/dist/window/gen/constants.d.ts +2213 -0
  218. package/dist/window/gen/constants.js +2227 -0
  219. package/dist/window/joystick.d.ts +81 -0
  220. package/dist/window/joystick.js +80 -0
  221. package/dist/window/keyboard.d.ts +50 -0
  222. package/dist/window/keyboard.js +59 -0
  223. package/dist/window/mouse.d.ts +31 -0
  224. package/dist/window/mouse.js +57 -0
  225. package/dist/window/sensor.d.ts +26 -0
  226. package/dist/window/sensor.js +40 -0
  227. package/dist/window/touch.d.ts +27 -0
  228. package/dist/window/touch.js +44 -0
  229. package/dist/window/video-mode.d.ts +77 -0
  230. package/dist/window/video-mode.js +99 -0
  231. package/dist/window/vulkan.d.ts +32 -0
  232. package/dist/window/vulkan.js +45 -0
  233. package/dist/window/window.d.ts +355 -0
  234. package/dist/window/window.js +434 -0
  235. package/docs/README.ja.md +30 -0
  236. package/docs/README.ko.md +30 -0
  237. package/docs/README.md +30 -0
  238. package/docs/README.zh-CN.md +30 -0
  239. package/docs/api.ja.md +84 -0
  240. package/docs/api.ko.md +84 -0
  241. package/docs/api.md +81 -0
  242. package/docs/api.zh-CN.md +81 -0
  243. package/docs/audio.ja.md +249 -0
  244. package/docs/audio.ko.md +251 -0
  245. package/docs/audio.md +252 -0
  246. package/docs/audio.zh-CN.md +252 -0
  247. package/docs/concepts.ja.md +130 -0
  248. package/docs/concepts.ko.md +130 -0
  249. package/docs/concepts.md +131 -0
  250. package/docs/concepts.zh-CN.md +131 -0
  251. package/docs/development.ja.md +148 -0
  252. package/docs/development.ko.md +148 -0
  253. package/docs/development.md +150 -0
  254. package/docs/development.zh-CN.md +150 -0
  255. package/docs/getting-started.ja.md +154 -0
  256. package/docs/getting-started.ko.md +154 -0
  257. package/docs/getting-started.md +156 -0
  258. package/docs/getting-started.zh-CN.md +156 -0
  259. package/docs/graphics.ja.md +256 -0
  260. package/docs/graphics.ko.md +254 -0
  261. package/docs/graphics.md +255 -0
  262. package/docs/graphics.zh-CN.md +257 -0
  263. package/docs/network.ja.md +214 -0
  264. package/docs/network.ko.md +216 -0
  265. package/docs/network.md +218 -0
  266. package/docs/network.zh-CN.md +218 -0
  267. package/docs/system.ja.md +169 -0
  268. package/docs/system.ko.md +171 -0
  269. package/docs/system.md +173 -0
  270. package/docs/system.zh-CN.md +173 -0
  271. package/docs/window.ja.md +138 -0
  272. package/docs/window.ko.md +140 -0
  273. package/docs/window.md +141 -0
  274. package/docs/window.zh-CN.md +141 -0
  275. package/native/addon.cc +129 -0
  276. package/native/audio-binding.cc +543 -0
  277. package/native/audio-codec-binding.cc +246 -0
  278. package/native/audio-device-binding.cc +160 -0
  279. package/native/audio-file-binding.cc +192 -0
  280. package/native/audio-recorder-binding.cc +237 -0
  281. package/native/audio-recorder.h +39 -0
  282. package/native/audio-state.h +220 -0
  283. package/native/audio-stream-binding.cc +284 -0
  284. package/native/audio-stream.h +28 -0
  285. package/native/audio-worker-binding.cc +447 -0
  286. package/native/audio-worker.h +121 -0
  287. package/native/batch-drawable.cc +189 -0
  288. package/native/batch-drawable.h +57 -0
  289. package/native/context-binding.cc +180 -0
  290. package/native/context-settings.h +74 -0
  291. package/native/deferred-delete.cc +49 -0
  292. package/native/deferred-delete.h +84 -0
  293. package/native/error-stream-binding.cc +270 -0
  294. package/native/exception-boundary.h +97 -0
  295. package/native/font-binding.cc +210 -0
  296. package/native/font-state.h +27 -0
  297. package/native/graphics-binding.cc +338 -0
  298. package/native/graphics-state.h +253 -0
  299. package/native/image-binding.cc +258 -0
  300. package/native/image-state.h +93 -0
  301. package/native/input-binding.cc +246 -0
  302. package/native/numeric-fields.h +96 -0
  303. package/native/render-window-binding.cc +103 -0
  304. package/native/render-window-state.h +22 -0
  305. package/native/shader-binding.cc +292 -0
  306. package/native/shape-binding.cc +283 -0
  307. package/native/shape-state.h +68 -0
  308. package/native/shaped-glyph-storage.h +45 -0
  309. package/native/shared-handle.h +69 -0
  310. package/native/stream-binding.cc +286 -0
  311. package/native/system-binding.cc +91 -0
  312. package/native/text-binding.cc +205 -0
  313. package/native/text-state.h +101 -0
  314. package/native/texture-binding.cc +330 -0
  315. package/native/texture-resource.h +52 -0
  316. package/native/time-value.h +28 -0
  317. package/native/transformable-binding.cc +23 -0
  318. package/native/transformable-state.h +44 -0
  319. package/native/value-binding.h +200 -0
  320. package/native/value-layout.h +116 -0
  321. package/native/values-binding.cc +27 -0
  322. package/native/vertex-binding.cc +50 -0
  323. package/native/vertex-buffer-binding.cc +232 -0
  324. package/native/vertex-storage.h +20 -0
  325. package/native/view-data.h +24 -0
  326. package/native/window-binding.cc +388 -0
  327. package/native/window-event.h +92 -0
  328. package/native/window-owner.h +81 -0
  329. package/package.json +87 -35
  330. package/src/audio/effect-processor.ts +86 -0
  331. package/src/audio/input-sound-file.ts +259 -0
  332. package/src/audio/listener.ts +136 -0
  333. package/src/audio/music.ts +357 -0
  334. package/src/audio/output-sound-file.ts +96 -0
  335. package/src/audio/playback-device.ts +145 -0
  336. package/src/audio/sound-buffer-recorder.ts +141 -0
  337. package/src/audio/sound-buffer.ts +275 -0
  338. package/src/audio/sound-file-factory.ts +235 -0
  339. package/src/audio/sound-file-reader.ts +224 -0
  340. package/src/audio/sound-file-writer.ts +61 -0
  341. package/src/audio/sound-recorder.ts +315 -0
  342. package/src/audio/sound-source.ts +396 -0
  343. package/src/audio/sound-stream.ts +108 -0
  344. package/src/audio/sound.ts +63 -0
  345. package/src/audio/value.ts +408 -0
  346. package/src/audio/worker.ts +308 -0
  347. package/src/graphics/blend-mode.ts +291 -0
  348. package/src/graphics/boolean-vector.ts +225 -0
  349. package/src/graphics/circle-shape.ts +113 -0
  350. package/src/graphics/color.ts +374 -0
  351. package/src/graphics/convex-shape.ts +76 -0
  352. package/src/graphics/drawable.ts +32 -0
  353. package/src/graphics/font.ts +377 -0
  354. package/src/graphics/glsl-matrix.ts +110 -0
  355. package/src/graphics/glsl.ts +229 -0
  356. package/src/graphics/glyph.ts +186 -0
  357. package/src/graphics/image.ts +366 -0
  358. package/src/graphics/primitive-type.ts +56 -0
  359. package/src/graphics/rect.ts +350 -0
  360. package/src/graphics/rectangle-shape.ts +76 -0
  361. package/src/graphics/render-states.ts +238 -0
  362. package/src/graphics/render-target.ts +554 -0
  363. package/src/graphics/render-texture.ts +234 -0
  364. package/src/graphics/render-window.ts +250 -0
  365. package/src/graphics/shader.ts +353 -0
  366. package/src/graphics/shape.ts +343 -0
  367. package/src/graphics/sprite.ts +203 -0
  368. package/src/graphics/stencil-mode.ts +258 -0
  369. package/src/graphics/swap.ts +28 -0
  370. package/src/graphics/text.ts +944 -0
  371. package/src/graphics/texture.ts +529 -0
  372. package/src/graphics/transform.ts +321 -0
  373. package/src/graphics/transformable.ts +37 -0
  374. package/src/graphics/vertex-array.ts +270 -0
  375. package/src/graphics/vertex-buffer.ts +345 -0
  376. package/src/graphics/vertex.ts +211 -0
  377. package/src/graphics/view.ts +355 -0
  378. package/src/index.ts +147 -0
  379. package/src/internal/audio-codec-registry.ts +68 -0
  380. package/src/internal/audio-input-stream.ts +42 -0
  381. package/src/internal/audio-music-pump.ts +199 -0
  382. package/src/internal/audio-native.ts +176 -0
  383. package/src/internal/audio-recorder-session.ts +234 -0
  384. package/src/internal/audio-worker-session.ts +89 -0
  385. package/src/internal/audio-worker.ts +146 -0
  386. package/src/internal/glsl-value.ts +79 -0
  387. package/src/internal/graphics-state.ts +131 -0
  388. package/src/internal/input-stream.ts +30 -0
  389. package/src/internal/lazy-value.ts +62 -0
  390. package/src/internal/native.ts +581 -0
  391. package/src/internal/numeric-properties.ts +37 -0
  392. package/src/internal/render-states.ts +42 -0
  393. package/src/internal/scalar.ts +117 -0
  394. package/src/internal/shaped-glyph.ts +68 -0
  395. package/src/internal/struct-view.ts +49 -0
  396. package/src/internal/text-indices.ts +19 -0
  397. package/src/internal/transformable.ts +260 -0
  398. package/src/internal/value-storage.ts +40 -0
  399. package/src/network/common.ts +58 -0
  400. package/src/network/dns.ts +191 -0
  401. package/src/network/ftp.ts +386 -0
  402. package/src/network/gen/constants.ts +879 -0
  403. package/src/network/http.ts +680 -0
  404. package/src/network/ip-address.ts +311 -0
  405. package/src/network/packet.ts +388 -0
  406. package/src/network/sftp.ts +1015 -0
  407. package/src/network/socket-selector.ts +206 -0
  408. package/src/network/socket.ts +415 -0
  409. package/src/network/tcp-listener.ts +193 -0
  410. package/src/network/tcp-socket.ts +569 -0
  411. package/src/network/tls-material.ts +46 -0
  412. package/src/network/udp-socket.ts +294 -0
  413. package/src/system/angle.ts +132 -0
  414. package/src/system/clock.ts +104 -0
  415. package/src/system/err.ts +58 -0
  416. package/src/system/error.ts +18 -0
  417. package/src/system/file-input-stream.ts +147 -0
  418. package/src/system/input-stream.ts +150 -0
  419. package/src/system/operators.ts +681 -0
  420. package/src/system/sleep.ts +25 -0
  421. package/src/system/suspend-aware-clock.ts +27 -0
  422. package/src/system/time.ts +218 -0
  423. package/src/system/timeout-with-predicate.ts +94 -0
  424. package/src/system/unicode.ts +64 -0
  425. package/src/system/vector2.ts +549 -0
  426. package/src/system/vector3.ts +433 -0
  427. package/src/system/version.ts +66 -0
  428. package/src/window/clipboard.ts +22 -0
  429. package/src/window/context-settings.ts +143 -0
  430. package/src/window/context.ts +152 -0
  431. package/src/window/cursor.ts +116 -0
  432. package/src/window/event.ts +580 -0
  433. package/src/window/gen/constants.ts +2231 -0
  434. package/src/window/joystick.ts +108 -0
  435. package/src/window/keyboard.ts +78 -0
  436. package/src/window/mouse.ts +58 -0
  437. package/src/window/sensor.ts +37 -0
  438. package/src/window/touch.ts +42 -0
  439. package/src/window/video-mode.ts +136 -0
  440. package/src/window/vulkan.ts +42 -0
  441. package/src/window/window.ts +579 -0
  442. package/test/native/audio-probes.cc +181 -0
  443. package/test/native/deferred-delete-probes.cc +62 -0
  444. package/test/native/drawable-probes.cc +168 -0
  445. package/test/native/exception-probes.cc +83 -0
  446. package/test/native/image-probes.cc +105 -0
  447. package/test/native/matrix-probes.cc +67 -0
  448. package/test/native/network-oracle.cc +32 -0
  449. package/test/native/render-texture-probes.cc +193 -0
  450. package/test/native/shader-probes.cc +69 -0
  451. package/test/native/shape-probes.cc +160 -0
  452. package/test/native/sprite-probes.cc +146 -0
  453. package/test/native/system-probes.cc +109 -0
  454. package/test/native/text-probes.cc +211 -0
  455. package/test/native/texture-probes.cc +200 -0
  456. package/test/native/time-probes.cc +143 -0
  457. package/test/native/transform-probes.cc +92 -0
  458. package/test/native/transformable-probes.cc +152 -0
  459. package/test/native/value-oracle.h +88 -0
  460. package/test/native/value-probes.cc +379 -0
  461. package/test/native/vertex-array-probes.cc +82 -0
  462. package/test/native/vertex-buffer-probes.cc +87 -0
  463. package/test/native/view-probes.cc +150 -0
  464. package/test/native/window-probes.cc +172 -0
  465. package/test/tsconfig.json +8 -0
  466. package/tools/configure-lsp.cjs +23 -0
  467. package/tools/constant-docs.cjs +109 -0
  468. package/tools/constant-docs.json +1318 -0
  469. package/tools/generate-network-constants.cjs +59 -0
  470. package/tools/generate-window-constants.cjs +178 -0
  471. package/tools/lib_downloader.cjs +92 -0
  472. package/tools/lib_downloader_urls.cjs +23 -0
  473. package/tsconfig.json +11 -4
  474. package/index.d.ts +0 -1
  475. package/lib/clock.d.ts +0 -8
  476. package/lib/clock.js +0 -5
  477. package/lib/color.d.ts +0 -11
  478. package/lib/color.js +0 -98
  479. package/lib/common.js +0 -47
  480. package/lib/drawable/circle_shape.d.ts +0 -5
  481. package/lib/drawable/circle_shape.js +0 -26
  482. package/lib/drawable/convex_shape.d.ts +0 -5
  483. package/lib/drawable/convex_shape.js +0 -35
  484. package/lib/drawable/drawable.d.ts +0 -6
  485. package/lib/drawable/drawable.js +0 -18
  486. package/lib/drawable/plugin_package.d.ts +0 -31
  487. package/lib/drawable/plugin_package.js +0 -102
  488. package/lib/drawable/rectangle_shape.d.ts +0 -9
  489. package/lib/drawable/rectangle_shape.js +0 -28
  490. package/lib/drawable/shape.d.ts +0 -14
  491. package/lib/drawable/shape.js +0 -30
  492. package/lib/drawable/sprite.d.ts +0 -17
  493. package/lib/drawable/sprite.js +0 -53
  494. package/lib/drawable/text.d.ts +0 -26
  495. package/lib/drawable/text.js +0 -88
  496. package/lib/drawable/transformable.d.ts +0 -28
  497. package/lib/drawable/transformable.js +0 -113
  498. package/lib/drawable/vertex_array.d.ts +0 -40
  499. package/lib/drawable/vertex_array.js +0 -128
  500. package/lib/font.d.ts +0 -24
  501. package/lib/font.js +0 -137
  502. package/lib/image.d.ts +0 -26
  503. package/lib/image.js +0 -147
  504. package/lib/joystick.d.ts +0 -21
  505. package/lib/joystick.js +0 -72
  506. package/lib/keyboard.d.ts +0 -113
  507. package/lib/keyboard.js +0 -17
  508. package/lib/mouse.d.ts +0 -6
  509. package/lib/mouse.js +0 -39
  510. package/lib/poll_event.d.ts +0 -138
  511. package/lib/rect.d.ts +0 -18
  512. package/lib/rect.js +0 -119
  513. package/lib/render_window.d.ts +0 -67
  514. package/lib/render_window.js +0 -197
  515. package/lib/sensor.d.ts +0 -12
  516. package/lib/sensor.js +0 -34
  517. package/lib/sfml.d.ts +0 -32
  518. package/lib/sfml.js +0 -36
  519. package/lib/sound/base.d.ts +0 -33
  520. package/lib/sound/base.js +0 -109
  521. package/lib/sound/music.d.ts +0 -15
  522. package/lib/sound/music.js +0 -65
  523. package/lib/sound/sound.d.ts +0 -16
  524. package/lib/sound/sound.js +0 -55
  525. package/lib/sound/sound_buffer.d.ts +0 -14
  526. package/lib/sound/sound_buffer.js +0 -78
  527. package/lib/texture.d.ts +0 -21
  528. package/lib/texture.js +0 -127
  529. package/lib/time.d.ts +0 -13
  530. package/lib/time.js +0 -41
  531. package/lib/touch.d.ts +0 -7
  532. package/lib/touch.js +0 -34
  533. package/lib/vector2.d.ts +0 -49
  534. package/lib/vector2.js +0 -141
  535. package/lib/vector3.d.ts +0 -47
  536. package/lib/vector3.js +0 -154
  537. package/lib/vertex.d.ts +0 -14
  538. package/lib/vertex.js +0 -177
  539. package/lib/video_mode.d.ts +0 -12
  540. package/lib/video_mode.js +0 -99
  541. package/src/base_class_with_loading.h +0 -21
  542. package/src/clock.cc +0 -71
  543. package/src/clock.h +0 -30
  544. package/src/color.cc +0 -189
  545. package/src/color.h +0 -49
  546. package/src/drawable/circle_shape.cc +0 -78
  547. package/src/drawable/circle_shape.h +0 -28
  548. package/src/drawable/convex_shape.cc +0 -57
  549. package/src/drawable/convex_shape.h +0 -29
  550. package/src/drawable/drawable-inl.h +0 -29
  551. package/src/drawable/drawable.cc +0 -41
  552. package/src/drawable/drawable.h +0 -49
  553. package/src/drawable/package_plugin-inl.h +0 -191
  554. package/src/drawable/package_plugin.h +0 -60
  555. package/src/drawable/rectangle_shape.cc +0 -69
  556. package/src/drawable/rectangle_shape.h +0 -29
  557. package/src/drawable/shape.cc +0 -67
  558. package/src/drawable/shape.h +0 -39
  559. package/src/drawable/sprite.cc +0 -122
  560. package/src/drawable/sprite.h +0 -45
  561. package/src/drawable/text.cc +0 -133
  562. package/src/drawable/text.h +0 -54
  563. package/src/drawable/vertex_array.cc +0 -248
  564. package/src/drawable/vertex_array.h +0 -46
  565. package/src/font.cc +0 -214
  566. package/src/font.h +0 -44
  567. package/src/gen/.gitkeep +0 -0
  568. package/src/gen/joystick_axis.cc +0 -30
  569. package/src/gen/keycode.cc +0 -226
  570. package/src/gen/mouse_button.cc +0 -30
  571. package/src/gen/sensor_type.cc +0 -26
  572. package/src/image.cc +0 -379
  573. package/src/image.h +0 -72
  574. package/src/joystick.cc +0 -132
  575. package/src/joystick.h +0 -32
  576. package/src/keyboard.cc +0 -65
  577. package/src/keyboard.h +0 -27
  578. package/src/mouse.cc +0 -95
  579. package/src/mouse.h +0 -30
  580. package/src/plugins/transformable_plugin-inl.h +0 -121
  581. package/src/plugins/transformable_plugin.h +0 -42
  582. package/src/poll_event.cc +0 -326
  583. package/src/poll_event.h +0 -18
  584. package/src/rect-inl.h +0 -154
  585. package/src/rect.cc +0 -28
  586. package/src/rect.h +0 -105
  587. package/src/render_window.cc +0 -413
  588. package/src/render_window.h +0 -111
  589. package/src/render_window_async_display.cc +0 -49
  590. package/src/render_window_async_draw.cc +0 -56
  591. package/src/resizable_buffer.h +0 -104
  592. package/src/sensor.cc +0 -82
  593. package/src/sensor.h +0 -28
  594. package/src/sfml.cc +0 -85
  595. package/src/sound/music.cc +0 -113
  596. package/src/sound/music.h +0 -35
  597. package/src/sound/sound.cc +0 -116
  598. package/src/sound/sound.h +0 -41
  599. package/src/sound/sound_buffer.cc +0 -226
  600. package/src/sound/sound_buffer.h +0 -46
  601. package/src/sound/sound_source.cc +0 -124
  602. package/src/sound/sound_source.h +0 -80
  603. package/src/texture.cc +0 -246
  604. package/src/texture.h +0 -47
  605. package/src/time.cc +0 -177
  606. package/src/time.h +0 -42
  607. package/src/touch.cc +0 -54
  608. package/src/touch.h +0 -23
  609. package/src/utils-inl.h +0 -48
  610. package/src/utils.h +0 -21
  611. package/src/vector2-inl.h +0 -198
  612. package/src/vector2.cc +0 -36
  613. package/src/vector2.h +0 -133
  614. package/src/vector3-inl.h +0 -200
  615. package/src/vector3.cc +0 -36
  616. package/src/vector3.h +0 -134
  617. package/src/vertex.cc +0 -238
  618. package/src/vertex.h +0 -114
  619. package/src/video_mode.cc +0 -184
  620. package/src/video_mode.h +0 -38
  621. package/src/workers/load_from_file_worker.h +0 -79
  622. package/src/workers/save_to_file_worker.h +0 -79
  623. package/third_party/sfml/include/SFML/Audio/AlResource.hpp +0 -70
  624. package/third_party/sfml/include/SFML/Audio/Export.hpp +0 -48
  625. package/third_party/sfml/include/SFML/Audio/InputSoundFile.hpp +0 -268
  626. package/third_party/sfml/include/SFML/Audio/Listener.hpp +0 -234
  627. package/third_party/sfml/include/SFML/Audio/Music.hpp +0 -337
  628. package/third_party/sfml/include/SFML/Audio/OutputSoundFile.hpp +0 -133
  629. package/third_party/sfml/include/SFML/Audio/Sound.hpp +0 -264
  630. package/third_party/sfml/include/SFML/Audio/SoundBuffer.hpp +0 -352
  631. package/third_party/sfml/include/SFML/Audio/SoundBufferRecorder.hpp +0 -144
  632. package/third_party/sfml/include/SFML/Audio/SoundFileFactory.hpp +0 -197
  633. package/third_party/sfml/include/SFML/Audio/SoundFileFactory.inl +0 -100
  634. package/third_party/sfml/include/SFML/Audio/SoundFileReader.hpp +0 -165
  635. package/third_party/sfml/include/SFML/Audio/SoundFileWriter.hpp +0 -125
  636. package/third_party/sfml/include/SFML/Audio/SoundRecorder.hpp +0 -410
  637. package/third_party/sfml/include/SFML/Audio/SoundSource.hpp +0 -332
  638. package/third_party/sfml/include/SFML/Audio/SoundStream.hpp +0 -420
  639. package/third_party/sfml/include/SFML/Audio.hpp +0 -56
  640. package/third_party/sfml/include/SFML/Config.hpp +0 -248
  641. package/third_party/sfml/include/SFML/GpuPreference.hpp +0 -74
  642. package/third_party/sfml/include/SFML/Graphics/BlendMode.hpp +0 -219
  643. package/third_party/sfml/include/SFML/Graphics/CircleShape.hpp +0 -154
  644. package/third_party/sfml/include/SFML/Graphics/Color.hpp +0 -275
  645. package/third_party/sfml/include/SFML/Graphics/ConvexShape.hpp +0 -153
  646. package/third_party/sfml/include/SFML/Graphics/Drawable.hpp +0 -126
  647. package/third_party/sfml/include/SFML/Graphics/Export.hpp +0 -48
  648. package/third_party/sfml/include/SFML/Graphics/Font.hpp +0 -496
  649. package/third_party/sfml/include/SFML/Graphics/Glsl.hpp +0 -227
  650. package/third_party/sfml/include/SFML/Graphics/Glsl.inl +0 -155
  651. package/third_party/sfml/include/SFML/Graphics/Glyph.hpp +0 -81
  652. package/third_party/sfml/include/SFML/Graphics/Image.hpp +0 -346
  653. package/third_party/sfml/include/SFML/Graphics/PrimitiveType.hpp +0 -58
  654. package/third_party/sfml/include/SFML/Graphics/Rect.hpp +0 -274
  655. package/third_party/sfml/include/SFML/Graphics/Rect.inl +0 -171
  656. package/third_party/sfml/include/SFML/Graphics/RectangleShape.hpp +0 -132
  657. package/third_party/sfml/include/SFML/Graphics/RenderStates.hpp +0 -174
  658. package/third_party/sfml/include/SFML/Graphics/RenderTarget.hpp +0 -518
  659. package/third_party/sfml/include/SFML/Graphics/RenderTexture.hpp +0 -334
  660. package/third_party/sfml/include/SFML/Graphics/RenderWindow.hpp +0 -302
  661. package/third_party/sfml/include/SFML/Graphics/Shader.hpp +0 -875
  662. package/third_party/sfml/include/SFML/Graphics/Shape.hpp +0 -355
  663. package/third_party/sfml/include/SFML/Graphics/Sprite.hpp +0 -279
  664. package/third_party/sfml/include/SFML/Graphics/Text.hpp +0 -513
  665. package/third_party/sfml/include/SFML/Graphics/Texture.hpp +0 -733
  666. package/third_party/sfml/include/SFML/Graphics/Transform.hpp +0 -497
  667. package/third_party/sfml/include/SFML/Graphics/Transformable.hpp +0 -429
  668. package/third_party/sfml/include/SFML/Graphics/Vertex.hpp +0 -148
  669. package/third_party/sfml/include/SFML/Graphics/VertexArray.hpp +0 -223
  670. package/third_party/sfml/include/SFML/Graphics/VertexBuffer.hpp +0 -408
  671. package/third_party/sfml/include/SFML/Graphics/View.hpp +0 -343
  672. package/third_party/sfml/include/SFML/Graphics.hpp +0 -68
  673. package/third_party/sfml/include/SFML/Main.hpp +0 -43
  674. package/third_party/sfml/include/SFML/Network/Export.hpp +0 -48
  675. package/third_party/sfml/include/SFML/Network/Ftp.hpp +0 -616
  676. package/third_party/sfml/include/SFML/Network/Http.hpp +0 -482
  677. package/third_party/sfml/include/SFML/Network/IpAddress.hpp +0 -328
  678. package/third_party/sfml/include/SFML/Network/Packet.hpp +0 -545
  679. package/third_party/sfml/include/SFML/Network/Socket.hpp +0 -219
  680. package/third_party/sfml/include/SFML/Network/SocketHandle.hpp +0 -57
  681. package/third_party/sfml/include/SFML/Network/SocketSelector.hpp +0 -263
  682. package/third_party/sfml/include/SFML/Network/TcpListener.hpp +0 -170
  683. package/third_party/sfml/include/SFML/Network/TcpSocket.hpp +0 -316
  684. package/third_party/sfml/include/SFML/Network/UdpSocket.hpp +0 -292
  685. package/third_party/sfml/include/SFML/Network.hpp +0 -53
  686. package/third_party/sfml/include/SFML/OpenGL.hpp +0 -78
  687. package/third_party/sfml/include/SFML/System/Clock.hpp +0 -117
  688. package/third_party/sfml/include/SFML/System/Err.hpp +0 -80
  689. package/third_party/sfml/include/SFML/System/Export.hpp +0 -48
  690. package/third_party/sfml/include/SFML/System/FileInputStream.hpp +0 -169
  691. package/third_party/sfml/include/SFML/System/InputStream.hpp +0 -152
  692. package/third_party/sfml/include/SFML/System/Lock.hpp +0 -139
  693. package/third_party/sfml/include/SFML/System/MemoryInputStream.hpp +0 -148
  694. package/third_party/sfml/include/SFML/System/Mutex.hpp +0 -148
  695. package/third_party/sfml/include/SFML/System/NativeActivity.hpp +0 -62
  696. package/third_party/sfml/include/SFML/System/NonCopyable.hpp +0 -129
  697. package/third_party/sfml/include/SFML/System/Sleep.hpp +0 -52
  698. package/third_party/sfml/include/SFML/System/String.hpp +0 -669
  699. package/third_party/sfml/include/SFML/System/String.inl +0 -53
  700. package/third_party/sfml/include/SFML/System/Thread.hpp +0 -282
  701. package/third_party/sfml/include/SFML/System/Thread.inl +0 -90
  702. package/third_party/sfml/include/SFML/System/ThreadLocal.hpp +0 -103
  703. package/third_party/sfml/include/SFML/System/ThreadLocalPtr.hpp +0 -158
  704. package/third_party/sfml/include/SFML/System/ThreadLocalPtr.inl +0 -77
  705. package/third_party/sfml/include/SFML/System/Time.hpp +0 -488
  706. package/third_party/sfml/include/SFML/System/Utf.hpp +0 -763
  707. package/third_party/sfml/include/SFML/System/Utf.inl +0 -752
  708. package/third_party/sfml/include/SFML/System/Vector2.hpp +0 -301
  709. package/third_party/sfml/include/SFML/System/Vector2.inl +0 -161
  710. package/third_party/sfml/include/SFML/System/Vector3.hpp +0 -302
  711. package/third_party/sfml/include/SFML/System/Vector3.inl +0 -168
  712. package/third_party/sfml/include/SFML/System.hpp +0 -60
  713. package/third_party/sfml/include/SFML/Window/Clipboard.hpp +0 -119
  714. package/third_party/sfml/include/SFML/Window/Context.hpp +0 -195
  715. package/third_party/sfml/include/SFML/Window/ContextSettings.hpp +0 -149
  716. package/third_party/sfml/include/SFML/Window/Cursor.hpp +0 -241
  717. package/third_party/sfml/include/SFML/Window/Event.hpp +0 -285
  718. package/third_party/sfml/include/SFML/Window/Export.hpp +0 -48
  719. package/third_party/sfml/include/SFML/Window/GlResource.hpp +0 -109
  720. package/third_party/sfml/include/SFML/Window/Joystick.hpp +0 -227
  721. package/third_party/sfml/include/SFML/Window/Keyboard.hpp +0 -491
  722. package/third_party/sfml/include/SFML/Window/Mouse.hpp +0 -180
  723. package/third_party/sfml/include/SFML/Window/Sensor.hpp +0 -150
  724. package/third_party/sfml/include/SFML/Window/Touch.hpp +0 -137
  725. package/third_party/sfml/include/SFML/Window/VideoMode.hpp +0 -228
  726. package/third_party/sfml/include/SFML/Window/Vulkan.hpp +0 -115
  727. package/third_party/sfml/include/SFML/Window/Window.hpp +0 -354
  728. package/third_party/sfml/include/SFML/Window/WindowBase.hpp +0 -518
  729. package/third_party/sfml/include/SFML/Window/WindowHandle.hpp +0 -101
  730. package/third_party/sfml/include/SFML/Window/WindowStyle.hpp +0 -53
  731. package/third_party/sfml/include/SFML/Window.hpp +0 -58
  732. package/tools/clang_format.js +0 -9
  733. package/tools/copier/linux.js +0 -21
  734. package/tools/copier/macos.js +0 -34
  735. package/tools/copier/windows.js +0 -33
  736. package/tools/joystick_axis.js +0 -63
  737. package/tools/keycode.js +0 -92
  738. package/tools/lib_downloader.js +0 -107
  739. package/tools/lib_downloader_urls.js +0 -59
  740. package/tools/mouse_button.js +0 -92
  741. package/tools/sensor_type.js +0 -63
@@ -0,0 +1,178 @@
1
+ /// <reference types="node" />
2
+ import { Socket as UdpHandle } from 'node:dgram';
3
+ import { Socket, SocketStatus as Status, type SocketHandle } from './socket';
4
+ import { IpAddress } from './ip-address';
5
+ import { Packet } from './packet';
6
+ /**
7
+ * Result of receiving a single UDP datagram.
8
+ * @zh 单个 UDP 数据报的接收结果。
9
+ * @ja 単一の UDP データグラムの受信結果。
10
+ * @ko 단일 UDP 데이터그램 수신 결과.
11
+ */
12
+ export interface DatagramResult {
13
+ /**
14
+ * Operation result status.
15
+ * @zh 操作结果状态。
16
+ * @ja 操作結果の状態。
17
+ * @ko 작업 결과 상태.
18
+ */
19
+ status: Status;
20
+ /**
21
+ * Bytes written to the destination, or 0 on failure.
22
+ * @zh 写入目标的字节数,失败时为 0。
23
+ * @ja 出力先に書き込んだバイト数。失敗時は 0 です。
24
+ * @ko 대상에 쓴 바이트 수이며 실패 시 0입니다.
25
+ */
26
+ received: number;
27
+ /**
28
+ * Sender address on successful receipt.
29
+ * @zh 成功接收时的发送方地址。
30
+ * @ja 受信成功時の送信元アドレス。
31
+ * @ko 수신 성공 시 송신자 주소.
32
+ */
33
+ remoteAddress?: IpAddress;
34
+ /**
35
+ * Sender port, or 0 on failure.
36
+ * @zh 发送方端口,失败时为 0。
37
+ * @ja 送信元ポート。失敗時は 0 です。
38
+ * @ko 송신자 포트이며 실패 시 0입니다.
39
+ */
40
+ remotePort: number;
41
+ }
42
+ /**
43
+ * UDP socket preserving datagram boundaries; Packet data has no TCP
44
+ * length header.
45
+ * @zh 保留数据报边界的 UDP 套接字,Packet 不附加 TCP 长度头。
46
+ * @ja データグラム境界を保持する UDP ソケット。
47
+ * Packet に TCP の長さヘッダーは付加しません。
48
+ * @ko 데이터그램 경계를 유지하는 UDP 소켓.
49
+ * Packet에 TCP 길이 헤더를 붙이지 않습니다.
50
+ */
51
+ export declare class UdpSocket extends Socket {
52
+ /**
53
+ * Maximum UDP datagram payload size in bytes allowed by this implementation.
54
+ * @zh 本实现允许的最大 UDP 数据报载荷字节数。
55
+ * @ja この実装で許容する UDP データグラムの最大ペイロードバイト数。
56
+ * @ko 이 구현에서 허용하는 최대 UDP 데이터그램 페이로드 바이트 수.
57
+ */
58
+ static readonly MaxDatagramSize = 65507;
59
+ /**
60
+ * Underlying UDP socket handle.
61
+ * @zh 底层 UDP 套接字句柄。
62
+ * @ja 下位の UDP ソケットハンドル。
63
+ * @ko 기반 UDP 소켓 핸들.
64
+ */
65
+ protected transport?: UdpHandle;
66
+ /** 是否已绑定端口。 */
67
+ private bound;
68
+ /** 绑定地址族,4 或 6。 */
69
+ private family;
70
+ /** 待交付的缓冲数据报队列。 */
71
+ private pending;
72
+ /** 待交付缓冲区的总字节数,上限 8 MiB。 */
73
+ private pendingBytes;
74
+ /** 接收操作串行队列。 */
75
+ private readonly reads;
76
+ /** 发送操作串行队列。 */
77
+ private readonly writes;
78
+ /**
79
+ * Create an unbound UDP socket with asynchronous blocking semantics
80
+ * by default.
81
+ * @zh 创建尚未绑定的 UDP 套接字,默认使用异步阻塞语义。
82
+ * @ja 未バインドの UDP ソケットを作成します。
83
+ * 既定では非同期ブロッキング動作を使います。
84
+ * @ko 바인딩되지 않은 UDP 소켓을 생성하며 기본적으로 비동기 블로킹 동작을
85
+ * 사용합니다.
86
+ */
87
+ constructor();
88
+ /**
89
+ * Return the bound local port, or 0 when unbound.
90
+ * @zh 返回已绑定的本地端口,未绑定时为 0。
91
+ * @ja バインド済みのローカルポートを返し、未バインドなら 0 を返します。
92
+ * @ko 바인딩된 로컬 포트를 반환하며 바인딩되지 않았으면 0입니다.
93
+ */
94
+ getLocalPort(): number;
95
+ /**
96
+ * Bind a local port and address asynchronously; port 0 lets the system assign
97
+ * a port. Use IPv4 by default.
98
+ * @zh 异步绑定本地端口和地址;port 为 0 时由系统分配,默认使用 IPv4。
99
+ * @ja ローカルポートとアドレスを非同期にバインドします。
100
+ * port が 0 ならシステムが割り当てます。既定では IPv4 を使用します。
101
+ * @ko 로컬 포트와 주소를 비동기로 바인딩합니다. port가 0이면 시스템이
102
+ * 할당하며 기본적으로 IPv4를 사용합니다.
103
+ */
104
+ bind(port: number, address?: IpAddress): Promise<Status>;
105
+ /**
106
+ * Reject non-UDP Node transports before adoption.
107
+ * @zh 接管前拒绝非 UDP 的 Node 传输。
108
+ * @ja 引き継ぐ前に UDP 以外の Node トランスポートを拒否します。
109
+ * @ko 인수 전에 UDP가 아닌 Node 전송 객체를 거부합니다.
110
+ */
111
+ protected validateHandle(handle: SocketHandle): void;
112
+ /**
113
+ * Integrate an allocated or adopted UDP handle into the same datagram queue
114
+ * and binding state.
115
+ * @zh 将分配或接管的 UDP 句柄接入同一数据报队列及绑定状态。
116
+ * @ja 割り当てまたは引き継いだ UDP ハンドルを同じデータグラムキューと
117
+ * バインド状態に組み込みます。
118
+ * @ko 할당하거나 인수한 UDP 핸들을 같은 데이터그램 큐와 바인딩 상태에
119
+ * 연결합니다.
120
+ */
121
+ protected onCreate(): void;
122
+ /**
123
+ * Close the UDP transport and clear datagrams pending receipt.
124
+ * @zh 关闭 UDP 传输并清空待接收的数据报。
125
+ * @ja UDP トランスポートを閉じ、受信待ちのデータグラムを消去します。
126
+ * @ko UDP 전송 객체를 닫고 수신 대기 중인 데이터그램을 비웁니다.
127
+ */
128
+ unbind(): void;
129
+ /**
130
+ * Clear the old transport's binding state and datagrams;
131
+ * the generation change cancels old reads.
132
+ * @zh 清空旧传输的绑定状态和数据报,旧读取通过代际变化取消。
133
+ * @ja 古いトランスポートのバインド状態とデータグラムを消去します。
134
+ * 世代の変更により古い読み取りをキャンセルします。
135
+ * @ko 기존 전송 객체의 바인딩 상태와 데이터그램을 비우며,
136
+ * 세대 변경으로 이전 읽기를 취소합니다.
137
+ */
138
+ protected onClose(): void;
139
+ /**
140
+ * Send a call-time data snapshot as one datagram; if unbound, automatically
141
+ * bind an ephemeral port for the destination address family.
142
+ * @zh 发送调用时的数据快照为一个数据报;未绑定时按目标地址族自动绑定临时端口。
143
+ * @ja 呼び出し時のデータスナップショットを 1 つのデータグラムとして送信します。
144
+ * 未バインドなら宛先アドレスファミリーに応じて一時ポートに自動バインドします。
145
+ * @ko 호출 시점의 데이터 스냅샷을 하나의 데이터그램으로 송신합니다.
146
+ * 바인딩되지 않았으면 대상 주소 계열에 맞는 임시 포트에 자동 바인딩합니다.
147
+ */
148
+ send(data: Uint8Array | Packet, address: IpAddress, port: number): Promise<Status>;
149
+ /** 发送字节数据报,未绑定时自动绑定。 */
150
+ private sendBytes;
151
+ /**
152
+ * Receive one complete datagram; discard it and return Error if the
153
+ * destination byte buffer is too small. With no data, nonblocking mode
154
+ * returns NotReady.
155
+ * @zh 接收一个完整数据报;目标字节区过小时丢弃并返回 Error,
156
+ * 非阻塞无数据为 NotReady。
157
+ * @ja 完全なデータグラムを 1 つ受信します。出力先バイト領域が小さすぎる場合は
158
+ * 破棄して Error を返し、非ブロッキングでデータがなければ NotReady を返します。
159
+ * @ko 완전한 데이터그램 하나를 수신합니다. 대상 바이트 버퍼가 너무 작으면
160
+ * 폐기하고 Error를 반환합니다. 논블로킹 모드에서 데이터가 없으면 NotReady입니다.
161
+ */
162
+ receive(destination: Uint8Array | Packet): Promise<DatagramResult>;
163
+ /**
164
+ * Return the binding state; derived classes may extend this.
165
+ * @zh 返回绑定状态,允许派生类扩展。
166
+ * @ja バインド状態を返します。派生クラスで拡張できます。
167
+ * @ko 바인딩 상태를 반환하며 파생 클래스에서 확장할 수 있습니다.
168
+ */
169
+ protected isAlive(): boolean;
170
+ /**
171
+ * Return readiness bits for pending datagrams and the current binding.
172
+ * @zh 返回待接收数据报和当前绑定对应的就绪位。
173
+ * @ja 受信待ちデータグラムと現在のバインドに対応する準備状態ビットを返します。
174
+ * @ko 수신 대기 데이터그램과 현재 바인딩에 해당하는 준비 상태 비트를 반환합니다.
175
+ */
176
+ protected getReadiness(mask: number): number;
177
+ protected getNativeHandle(): UdpHandle | undefined;
178
+ }
@@ -0,0 +1,285 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.UdpSocket = void 0;
4
+ const node_dgram_1 = require("node:dgram");
5
+ const socket_1 = require("./socket");
6
+ const ip_address_1 = require("./ip-address");
7
+ const packet_1 = require("./packet");
8
+ const common_1 = require("./common");
9
+ /**
10
+ * UDP socket preserving datagram boundaries; Packet data has no TCP
11
+ * length header.
12
+ * @zh 保留数据报边界的 UDP 套接字,Packet 不附加 TCP 长度头。
13
+ * @ja データグラム境界を保持する UDP ソケット。
14
+ * Packet に TCP の長さヘッダーは付加しません。
15
+ * @ko 데이터그램 경계를 유지하는 UDP 소켓.
16
+ * Packet에 TCP 길이 헤더를 붙이지 않습니다.
17
+ */
18
+ class UdpSocket extends socket_1.Socket {
19
+ /**
20
+ * Create an unbound UDP socket with asynchronous blocking semantics
21
+ * by default.
22
+ * @zh 创建尚未绑定的 UDP 套接字,默认使用异步阻塞语义。
23
+ * @ja 未バインドの UDP ソケットを作成します。
24
+ * 既定では非同期ブロッキング動作を使います。
25
+ * @ko 바인딩되지 않은 UDP 소켓을 생성하며 기본적으로 비동기 블로킹 동작을
26
+ * 사용합니다.
27
+ */
28
+ constructor() {
29
+ super(socket_1.SocketType.Udp);
30
+ /** 是否已绑定端口。 */
31
+ this.bound = false;
32
+ /** 绑定地址族,4 或 6。 */
33
+ this.family = 4;
34
+ /** 待交付的缓冲数据报队列。 */
35
+ this.pending = [];
36
+ /** 待交付缓冲区的总字节数,上限 8 MiB。 */
37
+ this.pendingBytes = 0;
38
+ /** 接收操作串行队列。 */
39
+ this.reads = new common_1.SerialQueue();
40
+ /** 发送操作串行队列。 */
41
+ this.writes = new common_1.SerialQueue();
42
+ }
43
+ /**
44
+ * Return the bound local port, or 0 when unbound.
45
+ * @zh 返回已绑定的本地端口,未绑定时为 0。
46
+ * @ja バインド済みのローカルポートを返し、未バインドなら 0 を返します。
47
+ * @ko 바인딩된 로컬 포트를 반환하며 바인딩되지 않았으면 0입니다.
48
+ */
49
+ getLocalPort() {
50
+ return this.bound ? this.transport.address().port : 0;
51
+ }
52
+ /**
53
+ * Bind a local port and address asynchronously; port 0 lets the system assign
54
+ * a port. Use IPv4 by default.
55
+ * @zh 异步绑定本地端口和地址;port 为 0 时由系统分配,默认使用 IPv4。
56
+ * @ja ローカルポートとアドレスを非同期にバインドします。
57
+ * port が 0 ならシステムが割り当てます。既定では IPv4 を使用します。
58
+ * @ko 로컬 포트와 주소를 비동기로 바인딩합니다. port가 0이면 시스템이
59
+ * 할당하며 기본적으로 IPv4를 사용합니다.
60
+ */
61
+ async bind(port, address = ip_address_1.IpAddress.Any) {
62
+ (0, common_1.uint)(port, 65535);
63
+ if (!(address instanceof ip_address_1.IpAddress))
64
+ throw new TypeError('Expected IpAddress');
65
+ this.create(address.getType());
66
+ const socket = this.transport;
67
+ const generation = this.epoch;
68
+ const ready = (0, common_1.waitFor)(this[socket_1.socketEvents], () => this.bound ||
69
+ !!this.failure || this.epoch !== generation);
70
+ socket.bind(port, address.toString());
71
+ await ready;
72
+ return this.epoch !== generation ? socket_1.SocketStatus.Disconnected
73
+ : this.bound ? socket_1.SocketStatus.Done : socket_1.SocketStatus.Error;
74
+ }
75
+ /**
76
+ * Reject non-UDP Node transports before adoption.
77
+ * @zh 接管前拒绝非 UDP 的 Node 传输。
78
+ * @ja 引き継ぐ前に UDP 以外の Node トランスポートを拒否します。
79
+ * @ko 인수 전에 UDP가 아닌 Node 전송 객체를 거부합니다.
80
+ */
81
+ validateHandle(handle) {
82
+ if (!(handle instanceof node_dgram_1.Socket))
83
+ throw new TypeError('Expected Node UDP');
84
+ }
85
+ /**
86
+ * Integrate an allocated or adopted UDP handle into the same datagram queue
87
+ * and binding state.
88
+ * @zh 将分配或接管的 UDP 句柄接入同一数据报队列及绑定状态。
89
+ * @ja 割り当てまたは引き継いだ UDP ハンドルを同じデータグラムキューと
90
+ * バインド状態に組み込みます。
91
+ * @ko 할당하거나 인수한 UDP 핸들을 같은 데이터그램 큐와 바인딩 상태에
92
+ * 연결합니다.
93
+ */
94
+ onCreate() {
95
+ const socket = this.transport;
96
+ const generation = this.epoch;
97
+ // Node 运行时保存创建地址族,但当前 @types/node 未声明此字段。
98
+ const { type } = socket;
99
+ this.family = type === 'udp4' ? 4 : 6;
100
+ const current = () => this.transport === socket && this.epoch === generation;
101
+ const error = (error) => {
102
+ if (!current())
103
+ return;
104
+ this.failure = error;
105
+ this.changed();
106
+ };
107
+ const message = (data, peer) => {
108
+ if (!current())
109
+ return;
110
+ if (this.pendingBytes + data.length <= 8 * 1024 * 1024 &&
111
+ this.pending.length < 4096) {
112
+ this.pending.push({ data, peer });
113
+ this.pendingBytes += data.length;
114
+ this.changed();
115
+ }
116
+ };
117
+ const listening = () => {
118
+ if (!current())
119
+ return;
120
+ this.bound = true;
121
+ if (this.family === 4)
122
+ socket.setBroadcast(true);
123
+ this.changed();
124
+ };
125
+ const closed = () => {
126
+ if (!current())
127
+ return;
128
+ this.bound = false;
129
+ this.changed();
130
+ };
131
+ socket.on('error', error)
132
+ .on('message', message)
133
+ .on('listening', listening)
134
+ .on('close', closed);
135
+ this.detach = () => {
136
+ socket.off('error', error)
137
+ .off('message', message)
138
+ .off('listening', listening)
139
+ .off('close', closed);
140
+ };
141
+ try {
142
+ socket.address();
143
+ listening();
144
+ }
145
+ catch {
146
+ this.bound = false;
147
+ }
148
+ }
149
+ /**
150
+ * Close the UDP transport and clear datagrams pending receipt.
151
+ * @zh 关闭 UDP 传输并清空待接收的数据报。
152
+ * @ja UDP トランスポートを閉じ、受信待ちのデータグラムを消去します。
153
+ * @ko UDP 전송 객체를 닫고 수신 대기 중인 데이터그램을 비웁니다.
154
+ */
155
+ unbind() { this.close(); }
156
+ /**
157
+ * Clear the old transport's binding state and datagrams;
158
+ * the generation change cancels old reads.
159
+ * @zh 清空旧传输的绑定状态和数据报,旧读取通过代际变化取消。
160
+ * @ja 古いトランスポートのバインド状態とデータグラムを消去します。
161
+ * 世代の変更により古い読み取りをキャンセルします。
162
+ * @ko 기존 전송 객체의 바인딩 상태와 데이터그램을 비우며,
163
+ * 세대 변경으로 이전 읽기를 취소합니다.
164
+ */
165
+ onClose() {
166
+ this.bound = false;
167
+ this.pending = [];
168
+ this.pendingBytes = 0;
169
+ }
170
+ /**
171
+ * Send a call-time data snapshot as one datagram; if unbound, automatically
172
+ * bind an ephemeral port for the destination address family.
173
+ * @zh 发送调用时的数据快照为一个数据报;未绑定时按目标地址族自动绑定临时端口。
174
+ * @ja 呼び出し時のデータスナップショットを 1 つのデータグラムとして送信します。
175
+ * 未バインドなら宛先アドレスファミリーに応じて一時ポートに自動バインドします。
176
+ * @ko 호출 시점의 데이터 스냅샷을 하나의 데이터그램으로 송신합니다.
177
+ * 바인딩되지 않았으면 대상 주소 계열에 맞는 임시 포트에 자동 바인딩합니다.
178
+ */
179
+ send(data, address, port) {
180
+ (0, common_1.uint)(port, 65535);
181
+ if (!(address instanceof ip_address_1.IpAddress))
182
+ throw new TypeError('Expected IpAddress');
183
+ const input = Buffer.from(data instanceof packet_1.Packet ? data[packet_1.packetSend]() : (0, common_1.bytes)(data));
184
+ if (input.length > UdpSocket.MaxDatagramSize)
185
+ return Promise.resolve(socket_1.SocketStatus.Error);
186
+ if (!this.transport)
187
+ this.create(address.getType());
188
+ const generation = this.epoch;
189
+ return this.writes.run(() => this.sendBytes(input, address, port, generation));
190
+ }
191
+ /** 发送字节数据报,未绑定时自动绑定。 */
192
+ async sendBytes(input, address, port, generation) {
193
+ if (generation !== this.epoch)
194
+ return socket_1.SocketStatus.Disconnected;
195
+ if (this.family !== (address.isV4() ? 4 : 6))
196
+ return socket_1.SocketStatus.Error;
197
+ const socket = this.transport;
198
+ let onError;
199
+ const completion = new Promise(resolve => {
200
+ const done = (error) => {
201
+ if (generation !== this.epoch)
202
+ return resolve(socket_1.SocketStatus.Disconnected);
203
+ if (error)
204
+ this.failure = error;
205
+ resolve(error ? socket_1.SocketStatus.Error : socket_1.SocketStatus.Done);
206
+ };
207
+ // Node 在 bind 失败时丢弃排队的 send 回调,必须监听 error 完成它。
208
+ onError = done;
209
+ socket.once('error', onError);
210
+ try {
211
+ socket.send(input, port, address.toString(), done);
212
+ }
213
+ catch (error) {
214
+ done(error instanceof Error ? error : new Error(String(error)));
215
+ }
216
+ });
217
+ try {
218
+ return await this.awaitWrite(completion, generation);
219
+ }
220
+ finally {
221
+ socket.off('error', onError);
222
+ }
223
+ }
224
+ /**
225
+ * Receive one complete datagram; discard it and return Error if the
226
+ * destination byte buffer is too small. With no data, nonblocking mode
227
+ * returns NotReady.
228
+ * @zh 接收一个完整数据报;目标字节区过小时丢弃并返回 Error,
229
+ * 非阻塞无数据为 NotReady。
230
+ * @ja 完全なデータグラムを 1 つ受信します。出力先バイト領域が小さすぎる場合は
231
+ * 破棄して Error を返し、非ブロッキングでデータがなければ NotReady を返します。
232
+ * @ko 완전한 데이터그램 하나를 수신합니다. 대상 바이트 버퍼가 너무 작으면
233
+ * 폐기하고 Error를 반환합니다. 논블로킹 모드에서 데이터가 없으면 NotReady입니다.
234
+ */
235
+ receive(destination) {
236
+ const output = destination instanceof packet_1.Packet ? undefined : (0, common_1.bytes)(destination);
237
+ const generation = this.epoch;
238
+ return this.reads.run(async () => {
239
+ const result = (status) => ({ status, received: 0, remotePort: 0 });
240
+ await this.awaitReady(() => this.pending.length > 0 || !this.bound ||
241
+ !!this.failure, generation);
242
+ if (generation !== this.epoch || !this.bound)
243
+ return result(socket_1.SocketStatus.Error);
244
+ const item = this.pending.shift();
245
+ if (!item)
246
+ return result(this.failure ? socket_1.SocketStatus.Error : socket_1.SocketStatus.NotReady);
247
+ this.pendingBytes -= item.data.length;
248
+ if (output && output.length < item.data.length)
249
+ return result(socket_1.SocketStatus.Error);
250
+ if (destination instanceof packet_1.Packet)
251
+ destination[packet_1.packetReceive](item.data);
252
+ else
253
+ item.data.copy(output);
254
+ return { status: socket_1.SocketStatus.Done, received: item.data.length,
255
+ remoteAddress: ip_address_1.IpAddress.fromString(item.peer.address),
256
+ remotePort: item.peer.port };
257
+ });
258
+ }
259
+ /**
260
+ * Return the binding state; derived classes may extend this.
261
+ * @zh 返回绑定状态,允许派生类扩展。
262
+ * @ja バインド状態を返します。派生クラスで拡張できます。
263
+ * @ko 바인딩 상태를 반환하며 파생 클래스에서 확장할 수 있습니다.
264
+ */
265
+ isAlive() { return this.bound; }
266
+ /**
267
+ * Return readiness bits for pending datagrams and the current binding.
268
+ * @zh 返回待接收数据报和当前绑定对应的就绪位。
269
+ * @ja 受信待ちデータグラムと現在のバインドに対応する準備状態ビットを返します。
270
+ * @ko 수신 대기 데이터그램과 현재 바인딩에 해당하는 준비 상태 비트를 반환합니다.
271
+ */
272
+ getReadiness(mask) {
273
+ // eslint-disable-next-line no-bitwise
274
+ return ((this.pending.length ? 1 : 0) | (this.bound ? 2 : 0)) & mask;
275
+ }
276
+ getNativeHandle() { return this.transport; }
277
+ }
278
+ /**
279
+ * Maximum UDP datagram payload size in bytes allowed by this implementation.
280
+ * @zh 本实现允许的最大 UDP 数据报载荷字节数。
281
+ * @ja この実装で許容する UDP データグラムの最大ペイロードバイト数。
282
+ * @ko 이 구현에서 허용하는 최대 UDP 데이터그램 페이로드 바이트 수.
283
+ */
284
+ UdpSocket.MaxDatagramSize = 65507;
285
+ exports.UdpSocket = UdpSocket;
@@ -0,0 +1,77 @@
1
+ import { type NativeValueHandle } from '../internal/native';
2
+ import { angleStorage, angleNative, mutableValue, type ReadonlyValue } from '../internal/value-storage';
3
+ /**
4
+ * SFML's float32 remainder, whose truncated quotient must fit in int32.
5
+ * @zh SFML 的 float32 余数,截断后的商必须在 int32 范围内。
6
+ * @ja SFML の float32 剰余。切り捨てた商は int32 の範囲内でなければならない。
7
+ * @ko SFML의 float32 나머지. 소수부를 버린 몫은 int32 범위 내여야 한다.
8
+ */
9
+ export declare function positiveRemainder(a: number, b: number): number;
10
+ /**
11
+ * sf::Angle's float32 value, with native ownership created on demand.
12
+ * @zh sf::Angle 的 float32 值,按需创建原生所有权。
13
+ * @ja sf::Angle の float32 値。ネイティブ所有権は必要に応じて作成される。
14
+ * @ko sf::Angle의 float32 값. 네이티브 소유권은 필요할 때 생성된다.
15
+ */
16
+ export declare class Angle {
17
+ readonly [mutableValue] = true;
18
+ private readonly state;
19
+ /**
20
+ * Create a zero angle, or copy the angle value of source.
21
+ * @zh 创建零角度,或复制 source 的角度值。
22
+ * @ja ゼロ角度を作成するか、source の角度値をコピーする。
23
+ * @ko 영각을 생성하거나 source의 각도 값을 복사한다.
24
+ */
25
+ constructor(source?: ReadonlyValue<Angle>);
26
+ get [angleStorage](): Float32Array;
27
+ get [angleNative](): NativeValueHandle<'angle'>;
28
+ /**
29
+ * Return the value in degrees, with 360 degrees per revolution.
30
+ * @zh 返回角度制数值,一周为 360 度。
31
+ * @ja 度数法の値を返す。1 回転は 360 度。
32
+ * @ko 도 단위 값을 반환한다. 한 바퀴는 360도이다.
33
+ */
34
+ asDegrees(): number;
35
+ /**
36
+ * Return the value in radians, with 2π radians per revolution.
37
+ * @zh 返回弧度制数值,一周为 2π 弧度。
38
+ * @ja ラジアン値を返す。1 回転は 2π ラジアン。
39
+ * @ko 라디안 단위 값을 반환한다. 한 바퀴는 2π 라디안이다.
40
+ */
41
+ asRadians(): number;
42
+ /**
43
+ * Return a new angle normalized to [-180°, 180°).
44
+ * @zh 返回归一化到 [-180°, 180°) 的新角度。
45
+ * @ja [-180°, 180°) に正規化した新しい角度を返す。
46
+ * @ko [-180°, 180°)로 정규화한 새 각도를 반환한다.
47
+ */
48
+ wrapSigned(): Angle;
49
+ /**
50
+ * Return a new angle normalized to [0°, 360°).
51
+ * @zh 返回归一化到 [0°, 360°) 的新角度。
52
+ * @ja [0°, 360°) に正規化した新しい角度を返す。
53
+ * @ko [0°, 360°)로 정규화한 새 각도를 반환한다.
54
+ */
55
+ wrapUnsigned(): Angle;
56
+ /**
57
+ * The read-only zero angle.
58
+ * @zh 只读的零角度。
59
+ * @ja 読み取り専用のゼロ角度。
60
+ * @ko 읽기 전용 영각.
61
+ */
62
+ static readonly Zero: ReadonlyValue<Angle>;
63
+ }
64
+ /**
65
+ * Create an angle from radians, stored with float32 precision.
66
+ * @zh 从弧度值创建角度,按 float32 精度存储。
67
+ * @ja ラジアン値から角度を作成し、float32 精度で格納する。
68
+ * @ko 라디안 값으로 각도를 생성하고 float32 정밀도로 저장한다.
69
+ */
70
+ export declare function radians(angle: number): Angle;
71
+ /**
72
+ * Create an angle from degrees, stored with float32 precision.
73
+ * @zh 从度数创建角度,按 float32 精度存储。
74
+ * @ja 度数から角度を作成し、float32 精度で格納する。
75
+ * @ko 도 단위 값으로 각도를 생성하고 float32 정밀도로 저장한다.
76
+ */
77
+ export declare function degrees(angle: number): Angle;
@@ -0,0 +1,122 @@
1
+ "use strict";
2
+ var _a;
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.degrees = exports.radians = exports.Angle = exports.positiveRemainder = void 0;
5
+ const native_1 = require("../internal/native");
6
+ const lazy_value_1 = require("../internal/lazy-value");
7
+ const value_storage_1 = require("../internal/value-storage");
8
+ const pi = Math.fround(3.141592654);
9
+ const tau = Math.fround(pi * 2);
10
+ /**
11
+ * SFML's float32 remainder, whose truncated quotient must fit in int32.
12
+ * @zh SFML 的 float32 余数,截断后的商必须在 int32 范围内。
13
+ * @ja SFML の float32 剰余。切り捨てた商は int32 の範囲内でなければならない。
14
+ * @ko SFML의 float32 나머지. 소수부를 버린 몫은 int32 범위 내여야 한다.
15
+ */
16
+ function positiveRemainder(a, b) {
17
+ if (!(b > 0))
18
+ throw new RangeError('Angle modulus must be positive');
19
+ // C++ int has no negative zero, unlike Math.trunc().
20
+ const truncated = Math.trunc(Math.fround(a / b));
21
+ const quotient = truncated === 0 ? 0 : truncated;
22
+ if (!Number.isFinite(quotient) ||
23
+ quotient < -2147483648 || quotient > 2147483647) {
24
+ throw new RangeError('Angle remainder quotient is outside int32 range');
25
+ }
26
+ const result = Math.fround(a - Math.fround(Math.fround(quotient) * b));
27
+ return result >= 0 ? result : Math.fround(result + b);
28
+ }
29
+ exports.positiveRemainder = positiveRemainder;
30
+ /**
31
+ * sf::Angle's float32 value, with native ownership created on demand.
32
+ * @zh sf::Angle 的 float32 值,按需创建原生所有权。
33
+ * @ja sf::Angle の float32 値。ネイティブ所有権は必要に応じて作成される。
34
+ * @ko sf::Angle의 float32 값. 네이티브 소유권은 필요할 때 생성된다.
35
+ */
36
+ class Angle {
37
+ /**
38
+ * Create a zero angle, or copy the angle value of source.
39
+ * @zh 创建零角度,或复制 source 的角度值。
40
+ * @ja ゼロ角度を作成するか、source の角度値をコピーする。
41
+ * @ko 영각을 생성하거나 source의 각도 값을 복사한다.
42
+ */
43
+ constructor(source) {
44
+ this[_a] = true;
45
+ this.state = new lazy_value_1.LazyValue(new Float32Array(1), buffer => native_1.native.wrapAngle(buffer));
46
+ if (source !== undefined) {
47
+ this[value_storage_1.angleStorage][0] = source.asRadians();
48
+ }
49
+ }
50
+ get [(_a = value_storage_1.mutableValue, value_storage_1.angleStorage)]() {
51
+ return this.state.values;
52
+ }
53
+ get [value_storage_1.angleNative]() {
54
+ return (0, lazy_value_1.nativeValue)(this, value_storage_1.angleNative, this.state);
55
+ }
56
+ /**
57
+ * Return the value in degrees, with 360 degrees per revolution.
58
+ * @zh 返回角度制数值,一周为 360 度。
59
+ * @ja 度数法の値を返す。1 回転は 360 度。
60
+ * @ko 도 단위 값을 반환한다. 한 바퀴는 360도이다.
61
+ */
62
+ asDegrees() {
63
+ return Math.fround(this.asRadians() * Math.fround(180 / pi));
64
+ }
65
+ /**
66
+ * Return the value in radians, with 2π radians per revolution.
67
+ * @zh 返回弧度制数值,一周为 2π 弧度。
68
+ * @ja ラジアン値を返す。1 回転は 2π ラジアン。
69
+ * @ko 라디안 단위 값을 반환한다. 한 바퀴는 2π 라디안이다.
70
+ */
71
+ asRadians() {
72
+ return this[value_storage_1.angleStorage][0];
73
+ }
74
+ /**
75
+ * Return a new angle normalized to [-180°, 180°).
76
+ * @zh 返回归一化到 [-180°, 180°) 的新角度。
77
+ * @ja [-180°, 180°) に正規化した新しい角度を返す。
78
+ * @ko [-180°, 180°)로 정규화한 새 각도를 반환한다.
79
+ */
80
+ wrapSigned() {
81
+ return radians(Math.fround(positiveRemainder(Math.fround(this.asRadians() + pi), tau) - pi));
82
+ }
83
+ /**
84
+ * Return a new angle normalized to [0°, 360°).
85
+ * @zh 返回归一化到 [0°, 360°) 的新角度。
86
+ * @ja [0°, 360°) に正規化した新しい角度を返す。
87
+ * @ko [0°, 360°)로 정규화한 새 각도를 반환한다.
88
+ */
89
+ wrapUnsigned() {
90
+ return radians(positiveRemainder(this.asRadians(), tau));
91
+ }
92
+ }
93
+ /**
94
+ * The read-only zero angle.
95
+ * @zh 只读的零角度。
96
+ * @ja 読み取り専用のゼロ角度。
97
+ * @ko 읽기 전용 영각.
98
+ */
99
+ Angle.Zero = Object.freeze(new Angle());
100
+ exports.Angle = Angle;
101
+ /**
102
+ * Create an angle from radians, stored with float32 precision.
103
+ * @zh 从弧度值创建角度,按 float32 精度存储。
104
+ * @ja ラジアン値から角度を作成し、float32 精度で格納する。
105
+ * @ko 라디안 값으로 각도를 생성하고 float32 정밀도로 저장한다.
106
+ */
107
+ function radians(angle) {
108
+ const result = new Angle();
109
+ result[value_storage_1.angleStorage][0] = angle;
110
+ return result;
111
+ }
112
+ exports.radians = radians;
113
+ /**
114
+ * Create an angle from degrees, stored with float32 precision.
115
+ * @zh 从度数创建角度,按 float32 精度存储。
116
+ * @ja 度数から角度を作成し、float32 精度で格納する。
117
+ * @ko 도 단위 값으로 각도를 생성하고 float32 정밀도로 저장한다.
118
+ */
119
+ function degrees(angle) {
120
+ return radians(Math.fround(angle) * Math.fround(pi / 180));
121
+ }
122
+ exports.degrees = degrees;