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,218 @@
1
+ # Network
2
+
3
+ [English](network.md) ยท **็ฎ€ไฝ“ไธญๆ–‡** ยท [ๆ—ฅๆœฌ่ชž](network.ja.md) ยท [ํ•œ๊ตญ์–ด](network.ko.md)
4
+
5
+ > ไฝฟ็”จ Packet ๅฎšไน‰ๆŠฅๆ–‡๏ผŒ้€š่ฟ‡ TCP๏ผUDP ไผ ่พ“๏ผŒๆˆ–ไฝฟ็”จ HTTPใ€FTPใ€SFTP ๅฎŒๆˆๅ่ฎฎๆ“ไฝœใ€‚็ฝ‘็ปœ I/O ่ฟ”ๅ›ž Promise๏ผŒ่ฐƒ็”จๆ–นๅŒๆ—ถๆฃ€ๆŸฅๆ“ไฝœ็Šถๆ€ใ€‚
6
+
7
+ [API ๅฏผ่ˆช](api.zh-CN.md) ยท [ๆ ธๅฟƒๆฆ‚ๅฟต](concepts.zh-CN.md) ยท [ๅ›ž็Žฏ็คบไพ‹](../examples/network.cjs)
8
+
9
+ ็”Ÿไบง Network ไฝฟ็”จ Node.js ไผ ่พ“ๅฎž็Žฐ SFML ้ฃŽๆ ผๆŽฅๅฃ๏ผŒFTP ไฝฟ็”จ basic-ftp๏ผŒSFTP ไฝฟ็”จ ssh2๏ผŒIPv6 ่งฃๆžไฝฟ็”จ ipaddr.jsใ€‚ๅฎƒไธ่ฐƒ็”จ SFML C++ ็ฝ‘็ปœๆจกๅ—๏ผ›Packet ๆ ผๅผๅŠ้ƒจๅˆ†ๅ€ผ่ฏญไน‰้€š่ฟ‡็‹ฌ็ซ‹ C++ ็จ‹ๅบๅฏน็…งใ€‚
10
+
11
+ ## ๆŽฅๅฃไธŽ่ฐƒ็”จๆ–นๅผ
12
+
13
+ | ๆŽฅๅฃ | ๅฎž็ŽฐไธŽ้€‚้… |
14
+ |------|------------|
15
+ | IpAddress | IPv4 ๆ•ดๆ•ฐ๏ผๅ››ๅญ—่Š‚ๆž„้€ ๏ผŒIPv6 16 ๅญ—่Š‚ๆž„้€ ๏ผŒๅคๅˆถใ€fromStringใ€toStringใ€toIntegerใ€toBytesใ€getTypeใ€isV4/isV6๏ผ›้™ๆ€ resolveใ€getLocalAddressใ€getPublicAddress ่ฟ”ๅ›ž Promise |
16
+ | Dns | resolveใ€queryNsใ€queryMxใ€querySrvใ€queryTxtใ€getPublicAddress๏ผ›ๆ”ฏๆŒ็‹ฌ็ซ‹ Resolver ๅ’ŒๆŒ‡ๅฎšๆœๅŠกๅ™จ |
17
+ | Socket | setBlockingใ€isBlockingใ€AnyPortใ€Status๏ผ›getLastError ่ฟ”ๅ›žๆœ€่ฟ‘ไธ€ๆฌกๅบ•ๅฑ‚้”™่ฏฏ |
18
+ | TcpSocket | connectใ€disconnectใ€sendใ€receiveใ€็ซฏๅฃ๏ผ่ฟœ็ซฏๅœฐๅ€ๆŸฅ่ฏข๏ผ›setupTlsClientใ€setupTlsServerใ€getCurrentCiphersuiteName |
19
+ | TcpListener | listenใ€closeใ€acceptใ€getLocalPort |
20
+ | UdpSocket | bindใ€unbindใ€sendใ€receiveใ€getLocalPortใ€MaxDatagramSize |
21
+ | SocketSelector | addใ€removeใ€clearใ€waitใ€isReadyใ€dispatchReadyCallbacksใ€ๅคๅˆถๆž„้€ ไธŽ assign๏ผ›Receive๏ผSend ไฝๆ ‡ๅฟ— |
22
+ | Packet | appendใ€clearใ€getDataใ€getDataSizeใ€getReadPositionใ€endOfPacketใ€isValidใ€ๅคๅˆถๆž„้€ ๏ผ›็ฑปๅž‹ๆ˜Ž็กฎ็š„ write/read๏ผ›ๅฏ้‡ๅ†™ onSend/onReceive |
23
+ | Http | setHostใ€sendRequestใ€Request ไธŽ Response๏ผ›ๆ˜พๅผ HTTP ่ฏทๆฑ‚็‰ˆๆœฌ |
24
+ | Ftp | connectใ€disconnectใ€loginใ€keepAliveใ€ๅทฅไฝœ็›ฎๅฝ•ใ€็›ฎๅฝ•ๅˆ—่กจใ€ๅˆ‡ๆข๏ผๅˆ›ๅปบ๏ผๅˆ ้™ค็›ฎๅฝ•ใ€้‡ๅ‘ฝๅ๏ผๅˆ ้™คๆ–‡ไปถใ€ไธŠไผ ๏ผ่ฟฝๅŠ ๏ผไธ‹่ฝฝใ€sendCommand |
25
+ | Sftp | connect ไธŽ login ๅˆ†็ฆปใ€ๅฏ†็ ๏ผๅฏ†้’ฅ่ฎค่ฏใ€getSessionInfoใ€่ทฏๅพ„่งฃๆžใ€็›ฎๅฝ•ๅ’Œๅฑžๆ€งใ€้‡ๅ‘ฝๅ๏ผๅˆ ้™คใ€ๆตๅผไธŠไผ ไธ‹่ฝฝใ€TimeoutWithPredicate |
26
+
27
+ ๆœ‰ I/O ๆˆ–็ญ‰ๅพ…็š„ๆ–นๆณ•่ฟ”ๅ›ž Promise๏ผŒ็บฏ็Šถๆ€ๆŸฅ่ฏขๅ’Œ้…็ฝฎไปๅŒๆญฅใ€‚`disconnect()` ็š„ TcpSocket ็‰ˆๆœฌใ€listener.closeใ€udp.unbind ๅŒๆญฅ็ป“ๆŸๆœฌๅœฐไผ ่พ“ใ€‚FTP๏ผSFTP ็š„ disconnect ่ฟ”ๅ›ž Promise๏ผŒๅฆๆไพ›ๅŒๆญฅ close ไธญๆ–ญๆœชๅฎŒๆˆๆ“ไฝœใ€‚
28
+
29
+ C++ ่พ“ๅ‡บๅผ•็”จ็”จ่ฟ”ๅ›žๅฏน่ฑก่กจ็คบ๏ผš
30
+
31
+ | ๆ“ไฝœ | ่ฟ”ๅ›žๅ€ผ |
32
+ |------|--------|
33
+ | TCP send(Uint8Array) | `{ status, sent }` |
34
+ | TCP receive(Uint8Array) | `{ status, received }` |
35
+ | TCP send/receive(Packet) | `SocketStatus` |
36
+ | UDP send(Uint8Array ๆˆ– Packet, address, port) | `SocketStatus` |
37
+ | UDP receive(Uint8Array ๆˆ– Packet) | `{ status, received, remoteAddress?, remotePort }` |
38
+
39
+ SocketHandle ๆ˜ฏ Node transport ๅฏน่ฑก็š„็ฑปๅž‹ๅˆซๅ๏ผŒไป…็”จไบŽๅ—ไฟๆŠค็š„ getNativeHandle๏ผ›ๅฎƒไธๆ˜ฏๅฏ่ทจๅนณๅฐไผ ้€’็š„ๆ“ไฝœ็ณป็ปŸ fd๏ผSOCKET ๆ•ฐๅญ—ใ€‚
40
+
41
+ ## TCPใ€UDP ไธŽ Selector
42
+
43
+ ```js
44
+ const sf = require('sfml.js');
45
+
46
+ function check(status) {
47
+ if (status !== sf.SocketStatus.Done) {
48
+ throw new Error(`Socket operation failed: ${status}`);
49
+ }
50
+ }
51
+
52
+ async function exchange() {
53
+ const listener = new sf.TcpListener();
54
+ const client = new sf.TcpSocket();
55
+ const peer = new sf.TcpSocket();
56
+ try {
57
+ check(await listener.listen(0, sf.IpAddress.LocalHost));
58
+ const accepting = listener.accept(peer);
59
+ check(await client.connect(sf.IpAddress.LocalHost,
60
+ listener.getLocalPort(), sf.seconds(1)));
61
+ check(await accepting);
62
+
63
+ const received = new sf.Packet();
64
+ const waiting = peer.receive(received);
65
+ check(await client.send(
66
+ new sf.Packet().write('string', 'ไฝ ๅฅฝ').write('u64', 42n)));
67
+ check(await waiting);
68
+ console.log(received.read('string'), received.read('u64'));
69
+ } finally {
70
+ listener.close();
71
+ client.disconnect();
72
+ peer.disconnect();
73
+ }
74
+ }
75
+ exchange().catch(error => {
76
+ console.error(error);
77
+ process.exitCode = 1;
78
+ });
79
+ ```
80
+
81
+ `setBlocking(true)` ่กจ็คบ Promise ็ญ‰ๅพ…ๆ‰€้œ€ๆ•ฐๆฎ๏ผๅ†™ๅ…ฅๅฎŒๆˆ๏ผŒไธ้˜ปๅกžไบ‹ไปถๅพช็Žฏใ€‚`setBlocking(false)` ่กจ็คบๆ นๆฎๅฝ“ๅ‰ๅฐ่ฃ…ๅฑ‚็Šถๆ€่ฟ”ๅ›ž๏ผ›TCP connect ๅฏๅŠจ่ฟžๆŽฅๅนถ่ฟ”ๅ›ž NotReady๏ผŒๅฏ็”จ Selector.Send ็ญ‰ๅพ…่ฟžๆŽฅๅฐฑ็ปชใ€‚TLS ๅˆๅง‹ๅŒ–่ฟ”ๅ›ž HandshakeStarted ๅŽ๏ผŒๅฏ้‡ๅค่ฐƒ็”จๅŒไธ€ setup ๆ–นๆณ•ๅ–ๅพ—ๆกๆ‰‹็Šถๆ€ใ€‚UDP bind/send ๅ’Œ TCP listen ไป็ญ‰ๅพ… Node ็š„ๅฎŒๆˆ้€š็Ÿฅ๏ผŒไปฅๆไพ›ๅฎž้™…็ซฏๅฃๅ’Œๆ“ไฝœ็ป“ๆžœใ€‚
82
+
83
+ TCP ๅŽŸๅง‹ๅญ—่Š‚ๅ‘้€็š„ sent ๆ˜ฏๆœฌๆฌก่ขซๅฐ่ฃ…ๅฑ‚ๆŽฅๆ”ถ็š„ๅญ—่Š‚ๆ•ฐใ€‚้ž้˜ปๅกžๆจกๅผๆœ€ๅคšๆไบคๅฝ“ๅ‰ Node writable highWaterMark ็š„ๅ‰ฉไฝ™ๅฎน้‡๏ผŒ้ƒจๅˆ†ๆŽฅๆ”ถ่ฟ”ๅ›ž Partial๏ผŒๆฒกๆœ‰็ฉบ้—ด่ฟ”ๅ›ž NotReady๏ผ›็ปง็ปญๅ‘้€ๆ—ถไผ ๅ…ฅๆœชๅ‘้€็š„ๅŽ็ผ€ใ€‚Node write ่ฟ”ๅ›ž false ๅช่กจ็คบ่ƒŒๅŽ‹๏ผŒๆœฌๆฌกๅทฒๅ…ฅ้˜Ÿ็š„ๅญ—่Š‚ไธไผšๅ†ๆฌก่ฆๆฑ‚่ฐƒ็”จ่€…้‡ๅ‘ใ€‚Done ไธไปฃ่กจๅฏน็ซฏๅบ”็”จๅทฒ็ปๆถˆ่ดนๆˆ–ๆŒไน…ๅŒ–ๆ•ฐๆฎใ€‚
84
+
85
+ TCP Packet ไฝฟ็”จๅคง็ซฏ uint32 ้•ฟๅบฆๅ‰็ผ€ใ€‚Partial ๅŽ็ปง็ปญไผ ๅ…ฅๅŒไธ€ไธช Packet๏ผŒๅฐ่ฃ…ๅฑ‚ไฟ็•™็ฌฌไธ€ๆฌกๅ‘้€็š„ๅฟซ็…งไธŽๅ็งป๏ผ›ๅœจๅฎƒๅฎŒๆˆๅ‰๏ผŒๅ…ถไป–ๅ‘้€่ฟ”ๅ›ž NotReady๏ผŒ้˜ฒๆญขๅŒ…ๅ†…ๅฎนไบค้”™ใ€‚ๆŽฅๆ”ถๆ”ฏๆŒไปปๆ„ๅˆ†ๆฎต็š„ๅŒ…ๅคดๅ’ŒๅŒ…ไฝ“๏ผ›้ž้˜ปๅกž NotReady ไฟ็•™ๅทฒๆ”ถ้ƒจๅˆ†ใ€‚ๆŽฅๆ”ถไธญ็š„ Packet ๆœชๅฎŒๆˆๅ‰ไธ่ƒฝๅˆ‡ๆขไธบๅŽŸๅง‹ๅญ—่Š‚ๆŽฅๆ”ถใ€‚
86
+
87
+ TCP ๆŽฅๆ”ถไฝฟ็”จ Node readable ้˜Ÿๅˆ—ๅ’Œ่ƒŒๅŽ‹๏ผŒไธๅฆๅปบๆ— ้™ๅขž้•ฟ็š„ๆ•ฐๆฎๅ‰ฏๆœฌใ€‚UDP ไฟ็•™ๆŠฅๆ–‡่พน็•Œ๏ผ›็›ฎ็š„ๆ•ฐ็ป„ๅฐไบŽๆŠฅๆ–‡ๆ—ถไธขๅผƒๆœฌๆŠฅๆ–‡ๅนถ่ฟ”ๅ›ž Errorใ€‚UDP ๆŽฅๆ”ถ้˜Ÿๅˆ—ๆœ€ๅคšๅฎน็บณ 4096 ไธชๆŠฅๆ–‡ๆˆ– 8 MiB๏ผŒ่ถ…่ฟ‡ๅŽไธขๅผƒๆ–ฐๆŠฅๆ–‡ใ€‚ๅ•ๆŠฅๆ–‡ๆœ€ๅคง 65507 ๅญ—่Š‚ใ€‚TCP Packet ๆŽฅๆ”ถ้™ๅˆถไธบ 64 MiB๏ผ›่ถ…้™ๅ…ณ้—ญ่ฟžๆŽฅๅนถ่ฟ”ๅ›ž Errorใ€‚
88
+
89
+ Selector ่ง‚ๅฏŸๅฐ่ฃ…ๅฑ‚ๅฏ่ฏป๏ผๅฏๅ†™็Šถๆ€๏ผŒไธๅฃฐ็งฐ็ญ‰ๅŒไบŽๅŽŸๅง‹็ณป็ปŸ selectใ€‚ไธ€ๆฌก wait ไฟๅญ˜ๅฐฑ็ปชๅฟซ็…ง๏ผŒisReady ๆŸฅ่ฏข่ฏฅๅฟซ็…ง๏ผŒdispatchReadyCallbacks ๆ˜พๅผๆดพๅ‘๏ผ›wait ่ถ…ๆ—ถ่ฟ”ๅ›ž falseใ€‚ไฟฎๆ”นๆˆๅ‘˜้›†ๅˆๆˆ–ๅ…ณ้—ญๅ…จ้ƒจๆˆๅ‘˜ไผšๅ”ค้†’็ญ‰ๅพ…ใ€‚ไธ€ไธช selector ๅŒๆ—ถๅชๅ…่ฎธไธ€ไธช wait๏ผ›ไฟฎๆ”นๅŽๅฏๅ†ๆฌก waitใ€‚ๅคๅˆถ selector ๅคๅˆถๆˆๅ‘˜ๅผ•็”จๅ’Œๅฐฑ็ปชๅฟซ็…ง๏ผŒไธๅคๅˆถ socketใ€‚
90
+
91
+ ๅ…ณ้—ญ่ฟžๆŽฅไผšๅ”ค้†’ๆŒ‚่ตท็š„่ฏปๅ–ใ€accept ๅ’Œ Selector ็ญ‰ๅพ…๏ผ›ๆ–ฐ่ฟžๆŽฅไฝฟ็”จๆ–ฐ็š„ไปฃๆ•ฐ๏ผŒๆ—งๆ“ไฝœไธ่ƒฝ่ฏปๅ–ๆ–ฐ่ฟžๆŽฅ็š„ๆ•ฐๆฎใ€‚ไฝฟ็”จ็ป“ๆŸๆ—ถๆ˜พๅผๅ…ณ้—ญ็ฝ‘็ปœๅฏน่ฑก๏ผŒๆดปๅŠจ Node ่ฟžๆŽฅไผš็ปดๆŒ่ฟ›็จ‹่ฟ่กŒใ€‚
92
+
93
+ ## Packet
94
+
95
+ ๅŽ็ปญ็‰‡ๆฎตไธญ็š„ `sf` ๅ‡ๆŒ‡ `require('sfml.js')`ใ€‚ๅ†™ๅ…ฅๅ’Œ่ฏปๅ–ๆ—ถๅฟ…้กปไฝฟ็”จ็›ธๅŒ็š„ๅญ—ๆฎต้กบๅบไธŽ็ฑปๅž‹๏ผš
96
+
97
+ ```js
98
+ const packet = new sf.Packet()
99
+ .write('bool', true)
100
+ .write('i32', -100)
101
+ .write('u64', 18446744073709551615n)
102
+ .write('f32', 1.5)
103
+ .write('string', '้Ÿณ้ข‘๐ŸŒŸ')
104
+ .write('bytes', new Uint8Array([ 255, 0, 254 ]));
105
+ ```
106
+
107
+ | ็ฑปๅž‹ๅ‚ๆ•ฐ | JS ็ฑปๅž‹ | SFML ๅญ—่Š‚ๆ ผๅผ |
108
+ |----------|---------|---------------|
109
+ | bool | boolean | ไธ€ไธชๅญ—่Š‚ |
110
+ | i8/u8ใ€i16/u16ใ€i32/u32 | number | ๅฏนๅบ”ไฝๅฎฝ็š„ๆ•ดๆ•ฐ๏ผŒๅคง็ซฏๅบ |
111
+ | i64/u64 | bigint | 64 ไฝๆ•ดๆ•ฐ๏ผŒๅคง็ซฏๅบ |
112
+ | f32/f64 | number | IEEE ๆตฎ็‚น๏ผŒไฝฟ็”จ่ฟ่กŒไธปๆœบๅญ—่Š‚ๅบ๏ผŒไธŽ SFML memcpy ไธ€่‡ด |
113
+ | string | string | ๅฏนๅบ” sf::String๏ผšuint32 ๅญ—็ฌฆๆ•ฐ + UTF-32 ๅคง็ซฏ็ ็‚น |
114
+ | utf8 | string | UTF-8 ็ผ–็ ๆˆ std::string๏ผšuint32 ๅญ—่Š‚ๆ•ฐ + ๅญ—่Š‚ |
115
+ | bytes | Uint8Array | ไบŒ่ฟ›ๅˆถ std::string๏ผšuint32 ๅญ—่Š‚ๆ•ฐ + ๅŽŸๅญ—่Š‚ |
116
+
117
+ `read(type)` ่ฟ”ๅ›ž็›ธๅบ”็ฑปๅž‹๏ผŒๆ•ฐๆฎไธ่ถณๆ—ถ่ฟ”ๅ›ž undefined๏ผŒๅนถไฝฟ isValid ไธบ false๏ผŒ็›ดๅˆฐ clearใ€‚ๅคฑ่ดฅไธไผš่ทณ่ฟ‡็ผบๅคฑๅญ—ๆฎต๏ผ›ๅญ—็ฌฆไธฒ้•ฟๅบฆๅทฒๆˆๅŠŸ่ฏปๅ–ๆ—ถ๏ผŒๆธธๆ ‡ๅœๅœจๅญ—็ฌฆไธฒๆญฃๆ–‡ๅผ€ๅคดใ€‚ๆ•ดๆ•ฐๅ†™ๅ…ฅๆŒ‰ไฝๅฎฝ่ฝฌๆข๏ผŒ64 ไฝๅ€ผไธ็ป่ฟ‡ numberใ€‚่ทจๅคงๅฐ็ซฏๅนณๅฐ็š„ๆตฎ็‚น Packet ไธŽๅŽŸ SFML ไธ€ๆ ท้œ€่ฆๅŒๆ–น่‡ช่กŒ็บฆๅฎš่ฝฌๆขใ€‚
118
+
119
+ ๅบ•ๅฑ‚ไฝฟ็”จๅฏๅขž้•ฟ Buffer๏ผŒ่ฏปๅ–ๆ•ดๆ•ฐๅ’Œๆตฎ็‚น็›ดๆŽฅ่ฎฟ้—ฎๅŒไธ€ๅ†…ๅญ˜ใ€‚getData ่ฟ”ๅ›žๆœ‰ๆ•ˆๅŒบๅŸŸ่ง†ๅ›พ๏ผŒ็ฉบๅŒ…่ฟ”ๅ›ž undefined๏ผ›่ฏฅ่ง†ๅ›พๅบ”ๅช่ฏปไฝฟ็”จใ€‚ๆ‰ฉๅฎนๆˆ– clear ๅŽๆ—ง่ง†ๅ›พไปไฟๆดปๆ—งๅˆ†้…ใ€‚append ๅคๅˆถ่พ“ๅ…ฅ๏ผŒๅ‘้€ๅœจๆŽฅๅ—่พ“ๅ…ฅๆ—ถๅปบ็ซ‹ๅฟซ็…ง๏ผŒ่ฐƒ็”จ่€…้šๅŽไฟฎๆ”น่พ“ๅ…ฅไธไผšๆ”นๅ˜ๅทฒๆไบคๅญ—่Š‚ใ€‚่ฟ™้‡Œๆฒกๆœ‰้ขๅค– NAN ๆ˜ ๅฐ„๏ผŒไนŸๆฒกๆœ‰้€ๅญ—่Š‚่ทจ่ฏญ่จ€่ฐƒ็”จใ€‚
120
+
121
+ onSend ่ฟ”ๅ›žๅพ…ๅ‘้€ๅญ—่Š‚๏ผŒonReceive ๆŽฅๆ”ถๅฎŒๆ•ดๆŠฅๆ–‡๏ผ›ๅญ็ฑปๅฏไปฅๅฎž็ŽฐๅŽ‹็ผฉๆˆ–่‡ชๅฎšไน‰็ผ–็ ใ€‚็ฝ‘็ปœๆŽฅๆ”ถๅœจ่ฐƒ็”จ onReceive ๅ‰ clear ๅŽŸๅŒ…ใ€‚ไธคไธช้’ฉๅญๅŒๆญฅๆ‰ง่กŒ๏ผŒๅผ‚ๆญฅๅทฅไฝœๅบ”ๅœจ send/receive ๅค–ๅฎŒๆˆใ€‚
122
+
123
+ ## ๅœฐๅ€ใ€DNS ไธŽ TLS
124
+
125
+ IpAddress ๆ˜ฏไธๅฏๅ˜ๅ€ผ๏ผŒtoBytes ่ฟ”ๅ›ž็‹ฌ็ซ‹ IPv6 ๅญ—่Š‚ๅ‰ฏๆœฌ๏ผ›toInteger ไป…้€‚็”จไบŽ IPv4ใ€‚fromString ไธๅš DNS๏ผŒไธๆŽฅๅ—็ผฉๅ†™ IPv4ใ€ๅ…ซ่ฟ›ๅˆถๅฝขๅผๆˆ–ๅธฆ zone ID ็š„ IPv6ใ€‚equalใ€notEqualใ€lessใ€lessEqualใ€greaterใ€greaterEqual ๆ”ฏๆŒๅœฐๅ€๏ผ›ๆŽ’ๅบๅ…ˆๆŒ‰ IPv4๏ผIPv6๏ผŒๅ†ๆŒ‰ๅญ—่Š‚ใ€‚
126
+
127
+ Dns.resolve ๅœจไธๆŒ‡ๅฎšๆœๅŠกๅ™จๆ—ถไฝฟ็”จ็ณป็ปŸ lookup๏ผŒๅŒ…ๆ‹ฌ hosts ๆ–‡ไปถ๏ผ›่ฟ™ๆก่ทฏๅพ„็š„ๅฎŒๆˆๆ—ถ้—ด็”ฑ็ณป็ปŸ่งฃๆžๅ™จๆŽงๅˆถใ€‚ๆŒ‡ๅฎšๆœๅŠกๅ™จๆ—ถๅนถ่กŒๆŸฅ A๏ผAAAA๏ผŒqueryNs/Mx/Srv/Txt ไฝฟ็”จ็‹ฌ็ซ‹ Resolver๏ผŒ่ถ…ๆ—ถๅ–ๆถˆ่ฏฅๆฌกๆŸฅ่ฏข๏ผŒไธๅฝฑๅ“ๅ…ถไป–ๆŸฅ่ฏขใ€‚MX ็š„ priority ๆ˜ ๅฐ„ไธบ preference๏ผŒSRV ็š„ name ๆ˜ ๅฐ„ไธบ targetใ€‚้ป˜่ฎคๆœๅŠกๅ™จๆŸฅ่ฏขๅคฑ่ดฅ่ฟ”ๅ›ž undefined ๆˆ–็ฉบๆ•ฐ็ป„ใ€‚
128
+
129
+ getLocalAddress ้€š่ฟ‡ UDP ่ทฏ็”ฑ้€‰ๆ‹ฉๅ–ๅพ—ๆœฌๅœฐๅœฐๅ€๏ผŒไธๅ‘้€ๅบ”็”จๆ•ฐๆฎใ€‚ๅ…ฌ็ฝ‘ๅœฐๅ€ๆŸฅ่ฏข้œ€่ฆๅค–้ƒจ DNS๏ผHTTP ๆœๅŠก๏ผŒไธๅœจ็ฆป็บฟๆต‹่ฏ•ไธญๅ‘่ตท็œŸๅฎžๅ…ฌ็ฝ‘ๆŸฅ่ฏขใ€‚Time.Zero ่กจ็คบไธ่ฎพ่ถ…ๆ—ถใ€‚
130
+
131
+ TLS ๆ”ฏๆŒๅทฒ่ฟžๆŽฅ TCP ็š„ๅฎขๆˆท็ซฏๅ’ŒๆœๅŠก็ซฏๅ‡็บงใ€‚ๅฎขๆˆท็ซฏ้ป˜่ฎค้ชŒ่ฏ็ณป็ปŸ CA ๅ’Œ hostname๏ผŒๅฏไผ ๅ…ฅ่ฏไนฆๅญ—็ฌฆไธฒ๏ผๅญ—่Š‚ไฝœไธบ CA๏ผŒๆˆ–ๆ˜พๅผไผ  false ๅ…ณ้—ญ้ชŒ่ฏ๏ผ›ๆœๅŠก็ซฏๆŽฅๅ—่ฏไนฆใ€็ง้’ฅใ€ๅฏ้€‰ๅฃไปคใ€‚ๅ‡็บงๅ‰ๅฟ…้กปๆŽ’็ฉบ plaintext ่ฏปๅ†™้˜Ÿๅˆ—ใ€‚่ฏไนฆไธŽๅฏ†็ ๅฅ—ไปถ็”ฑ Node/OpenSSL ๆไพ›๏ผŒ้›†ๅˆไธไฟ่ฏไธŽ SFML ็š„ Mbed TLS ไธ€่‡ดใ€‚
132
+
133
+ ## HTTP
134
+
135
+ ```javascript
136
+ const sf = require('sfml.js');
137
+
138
+ async function fetchText(host, uri) {
139
+ const http = new sf.Http(host);
140
+ const request = new sf.Http.Request(uri);
141
+ const response = await http.sendRequest(request, sf.seconds(5));
142
+ if (response.getStatus() !== sf.HttpStatus.Ok) {
143
+ throw new Error(`HTTP status: ${response.getStatus()}`);
144
+ }
145
+ return response.getBody();
146
+ }
147
+ ```
148
+
149
+ Request ๆ”ฏๆŒ setFieldใ€setMethodใ€setUriใ€setHttpVersionใ€setBody๏ผ›Response ๆ”ฏๆŒ็Šถๆ€ใ€HTTP ็‰ˆๆœฌใ€ๅญ—ๆฎตๅ’Œๆญฃๆ–‡ๆŸฅ่ฏขใ€‚getBody ๆŒ‰ UTF-8 ่งฃ็ ๏ผŒgetBodyBytes ๅ–ๅพ—็‹ฌ็ซ‹ๅŽŸๅง‹ๅญ—่Š‚ใ€‚setBody ๅฏไปฅ็›ดๆŽฅๆŽฅๅ— Uint8Arrayใ€‚
150
+
151
+ ไธบๆ”ฏๆŒ SFML ๆ˜พๅผๆŒ‡ๅฎš HTTP/1.0๏ผ1.1 ่ฏทๆฑ‚่กŒ๏ผŒไฝฟ็”จ Node TCP๏ผTLS ๅ‘้€่ฏทๆฑ‚ๅนถๅขž้‡่งฃๆžๅ“ๅบ”๏ผ›่งฃๆžๆ”ฏๆŒ Content-Lengthใ€chunkedใ€trailerใ€ไธญ้—ด 1xxใ€HEAD๏ผๆ— ๆญฃๆ–‡็Šถๆ€ๅ’Œ่ฟžๆŽฅๅ…ณ้—ญๅฎš็•Œใ€‚่ฏทๆฑ‚ๆญฃๆ–‡ไฝฟ็”จ Content-Length๏ผŒ็ฆๆญขๅ†ฒ็ช็š„้•ฟๅบฆๅ’Œ Transfer-Encodingใ€‚ไธไผš่‡ชๅŠจ่ทŸ้š้‡ๅฎšๅ‘ใ€่งฃๅŽ‹ๆญฃๆ–‡ๆˆ–ๅ‡็บง HTTP/2ใ€‚
152
+
153
+ sendRequest ็š„ Time ้™ๅˆถๆ•ดๆฌก่ฏทๆฑ‚๏ผŒๅฏไผ ็ฌฌๅ››ไธช AbortSignal ๅ‚ๆ•ฐๅ–ๆถˆใ€‚ๆ— ๆ•ˆๆˆ–ๆˆชๆ–ญๅ“ๅบ”ๆ˜ ๅฐ„ไธบ InvalidResponse๏ผŒ่ฟžๆŽฅ๏ผTLS ๅคฑ่ดฅไธŽๅ–ๆถˆๆ˜ ๅฐ„ไธบ ConnectionFailedใ€‚ๅ“ๅบ”ๆญฃๆ–‡ไธŠ้™ 64 MiB๏ผŒๆœชๅฎŒๆˆ็š„ๅคด้ƒจๆˆ– chunk framing ไธŠ้™ 64 KiBใ€‚setHost ๅŒๆญฅ่งฃๆžๅœฐๅ€๏ผŒๅฎž้™… DNS ๅ’Œ่ฟžๆŽฅๅœจ sendRequest ไธญๅฎŒๆˆใ€‚
154
+
155
+ ## FTP
156
+
157
+ FTP ไฝฟ็”จ basic-ftp ็š„ๆŽงๅˆถ่ฟžๆŽฅใ€่ขซๅŠจๆ•ฐๆฎ้€š้“ๅ’Œๆตๅผๆ–‡ไปถไผ ่พ“ใ€‚connect ไธ็™ปๅฝ•๏ผ›login ้ป˜่ฎค anonymousใ€‚ๆžšไธพๅ’Œๅ“ๅบ”็ฑปๅž‹ๆŒ‰้šๅŒ… SFML ๅคดๆ–‡ไปถ็”Ÿๆˆ๏ผŒๅŽŸๅง‹ FTP ็Šถๆ€็ ไฟๆŒๅŽŸๅ€ผใ€‚็›ฎๅฝ•ๅˆ—่กจๅ‘้€ NLSTใ€‚
158
+
159
+ download(remoteFile, localDirectory, mode) ๅ†™ๅ…ฅๆœฌๅœฐ็›ฎๅฝ•ไธ‹็š„่ฟœ็ซฏๆ–‡ไปถๅ๏ผ›upload(localFile, remoteDirectory, mode, append) ๅ†™ๅ…ฅ่ฟœ็ซฏ็›ฎๅฝ•ไธ‹็š„ๆœฌๅœฐๆ–‡ไปถๅใ€‚Binary๏ผAscii๏ผEbcdic ๅˆ†ๅˆซๅ‘้€ TYPE I๏ผA๏ผE๏ผŒๆจกๅผๆ˜ฏๅฆๆ”ฏๆŒ็”ฑๆœๅŠกๅ™จๅ“ๅบ”ๅ†ณๅฎšใ€‚renameFileใ€deleteDirectory ็ญ‰ไป…ๆ‰ง่กŒๅฏนๅบ”ๆ“ไฝœ๏ผŒไธ้šๅผ้€’ๅฝ’ๅˆ ้™คใ€‚sendCommand ๅฏๅ‘้€ๅ…ถไป– FTP ๅ‘ฝไปค๏ผŒๅ‚ๆ•ฐไธญ็š„ๆข่กŒๅ’Œ NUL ่ขซๆ‹’็ปใ€‚
160
+
161
+ ๅŒไธ€ Ftp ๅฏน่ฑกไธŠ็š„ๆ“ไฝœไธฒ่กŒใ€‚connect ็š„ Time ๅช็บฆๆŸ่ฟžๆŽฅๅปบ็ซ‹๏ผŒๅ…ถไป–ๅ‘ฝไปคๅฏ็”จ close ไธปๅŠจไธญๆ–ญใ€‚close ๅ…ณ้—ญๆŽงๅˆถไธŽๆ•ฐๆฎ่ฟžๆŽฅใ€‚่ฟžๆŽฅๅคฑ่ดฅใ€่ฟžๆŽฅๅ…ณ้—ญใ€ๆœฌๅœฐๆ–‡ไปถ้”™่ฏฏๆ˜ ๅฐ„ไธบๅฏนๅบ” SFML ๅ“ๅบ”๏ผ›ๆœๅŠกๅ™จ้”™่ฏฏไฟ็•™็Šถๆ€็ ใ€‚
162
+
163
+ <a id="sftp"></a>
164
+
165
+ ## SFTP
166
+
167
+ SFTP ไฝฟ็”จ ssh2ใ€‚connect ๅฎŒๆˆ SSH ๅๅ•†ๅนถๅœๅœจ่ฎค่ฏๅ‰๏ผŒgetSessionInfo ๅฏ่ฏปๅ–ไธปๆœบๅ…ฌ้’ฅใ€SHA-1๏ผSHA-256 ๆŒ‡็บนไปฅๅŠๅๅ•†็ฎ—ๆณ•๏ผ›login ๆ”ฏๆŒๅฏ†็ ๆˆ–ๅŒน้…็š„ๅ…ฌ็ง้’ฅๅ’Œๅฃไปค๏ผŒ่ฎค่ฏๅคฑ่ดฅๅฏ้‡่ฏ•ใ€‚
168
+
169
+ ไธปๆœบๅฏ†้’ฅไธ่‡ชๅŠจๅŒน้… known_hosts๏ผŒๆฒฟ็”จ SFML ๆšด้œฒ SessionInfo ไพ›่ฐƒ็”จๆ–นๅˆคๆ–ญ็š„ๆ–นๅผใ€‚้œ€่ฆๆ ก้ชŒๆœๅŠกๅ™จ่บซไปฝๆ—ถ๏ผŒๅœจ login ๅ‰ๅฐ† hostKey.sha256 ไธŽๅฏไฟกๆŒ‡็บนๆฏ”่พƒใ€‚
170
+
171
+ ไธ‹้ข็š„ๅ‡ฝๆ•ฐ็”ฑๅบ”็”จไผ ๅ…ฅ IpAddressใ€่ฎค่ฏไฟกๆฏใ€ๅทฒ็ŸฅๅฏไฟกๆŒ‡็บนๅ’Œๆถˆ่ดนๅ›ž่ฐƒ๏ผš
172
+
173
+ ```javascript
174
+ async function download(address, username, password, trustedFingerprint, consume) {
175
+ const client = new sf.Sftp();
176
+ try {
177
+ const connection = await client.connect(address, 22, sf.seconds(5));
178
+ if (!connection.isOk()) throw new Error(connection.getMessage());
179
+ const info = client.getSessionInfo();
180
+ if (!info || info.hostKey.sha256 !== trustedFingerprint) {
181
+ throw new Error('Unexpected SFTP host key');
182
+ }
183
+ const authentication = await client.login(username, password, sf.seconds(5));
184
+ if (!authentication.isOk()) throw new Error(authentication.getMessage());
185
+ const result = await client.download('/file', async bytes => {
186
+ await consume(bytes);
187
+ return true;
188
+ });
189
+ if (!result.isOk()) throw new Error(result.getMessage());
190
+ } finally {
191
+ client.close();
192
+ }
193
+ }
194
+ ```
195
+
196
+ download ๅ›ž่ฐƒๆŽฅๆ”ถๆœ€ๅคš 65536 ๅญ—่Š‚็š„ Buffer ่ง†ๅ›พ๏ผ›่ฟ”ๅ›ž false ๅœๆญข๏ผŒEOF ไผšไปฅ้›ถๅญ—่Š‚ๅ›ž่ฐƒ็ป“ๆŸใ€‚upload ๅ›ž่ฐƒๆŽฅๆ”ถ `{ data, size }`๏ผŒๅกซๅ†™ Buffer๏ผŒๅฐ† size ่ฎพไธบๆœ‰ๆ•ˆๅญ—่Š‚ๆ•ฐ๏ผŒ่ฟ”ๅ›ž false ๆ—ถไปๅ†™ๅ‡บๆœฌๆฌกๆœ‰ๆ•ˆๆ•ฐๆฎๅŽๅœๆญขใ€‚ๅ›ž่ฐƒๅฏไปฅ่ฟ”ๅ›ž Promiseใ€‚ๆฏๆฌกๅˆ†้…็‹ฌ็ซ‹ Buffer๏ผŒๅ›ž่ฐƒไฟ็•™ๆ—ง่ง†ๅ›พไธไผš็œ‹ๅˆฐๅŽ็ปญๅ—่ฆ†็›–๏ผ›ไธŠไผ ๅ›ž่ฐƒๅฎŒๆˆๅŽ๏ผŒ่ฐƒ็”จๆ–นไธๅพ—็ปง็ปญไฟฎๆ”นๅทฒๆไบคๅ—ใ€‚
197
+
198
+ ๅฑžๆ€งๅŒ…ๅซ่ทฏๅพ„ใ€FileTypeใ€ๆƒ้™ใ€bigint ๅคงๅฐ๏ผUID๏ผGID๏ผŒไปฅๅŠ Date ๆ—ถ้—ดใ€‚ssh2 ็š„ๅ็งปๅ’Œๅฑžๆ€งๆ•ฐๅ€ผๆŽฅๅฃไฝฟ็”จ number๏ผŒๅ› ๆญคๆœฌ็ป‘ๅฎšๅชๆŽฅๅ— 0๏ฝž2โตยณโˆ’1 ็š„็ฒพ็กฎๅ็งป๏ผŒ่ถ…่ฟ‡่Œƒๅ›ดๆ‹’็ป๏ผŒ้ฟๅ…้™้ป˜ไธขๅคฑ็ฒพๅบฆ๏ผ›ๆ—ถ้—ด็ฒพๅบฆไธบๅ่ฎฎๆไพ›็š„็ง’ใ€‚rename(overwrite=true) ไฝฟ็”จ OpenSSH POSIX rename ๆ‰ฉๅฑ•๏ผŒไธๆ”ฏๆŒ่ฏฅๆ‰ฉๅฑ•็š„ๆœๅŠกๅ™จ่ฟ”ๅ›ž้”™่ฏฏใ€‚
199
+
200
+ Time ่ฝฌไธบๅ•ๆฌกๆ— ่ฟ›ๅฑ•็ญ‰ๅพ…็š„ๅ‘จๆœŸ๏ผ›TimeoutWithPredicate ๅœจ่ฟžๆŽฅๆฒกๆœ‰ๅ…ฅ็ซ™ๆ•ฐๆฎๆˆ–ๆ“ไฝœๅฎŒๆˆ้€š็Ÿฅ่พพๅˆฐไธ€ไธชๅ‘จๆœŸๆ—ถ่ฐƒ็”จ่ฐ“่ฏ๏ผŒtrue ็ปง็ปญ็ญ‰ๅพ…๏ผŒfalse ่ฟ”ๅ›ž Timeout ๅนถๅ…ณ้—ญไผš่ฏใ€‚Time.Zero ไธ่ฎพ็ฝฎ่ฎกๆ—ถๅ™จใ€‚่ฏฅๆœบๅˆถๆ˜ฏ Node ไบ‹ไปถๅฑ‚้ข็š„็ญ‰ๅพ…๏ผŒไธ่ƒฝ็ญ‰ๅŒไบŽ libssh2 ็š„ EAGAIN๏ผๅ†…ๆ ธๅฐฑ็ปช็ป†่Š‚ใ€‚
201
+
202
+ close ไผšไธญๆ–ญ่ฟ›่กŒไธญ็š„็ญ‰ๅพ…๏ผ›็”จๆˆทๅ›ž่ฐƒ Promise ๆ— ๆณ•่ขซๅผบ่กŒ็ปˆๆญข๏ผŒไฝ†ๅฎƒ้šๅŽๅฎŒๆˆๆ—ถไธไผšๅฏน้‡ๆ–ฐๅปบ็ซ‹็š„ไผš่ฏ็ปง็ปญ่ฏปๅ†™ใ€‚SFTP ๅ่ฎฎ็Šถๆ€ๆ˜ ๅฐ„ไธบๅฏนๅบ” Result.Value๏ผ›ๅบ•ๅฑ‚้”™่ฏฏๆ— ๆณ•ไธŽ libssh2 ไธ“ๅฑžๅ€ผ้€ไธ€ๅฏนๅบ”ๆ—ถ่ฟ”ๅ›ž Error ๅ’ŒๅŽŸๆถˆๆฏ๏ผŒไธไผช้€ ไธ“ๅฑž้”™่ฏฏใ€‚
203
+
204
+ ## ้ชŒ่ฏไธŽๆผ”็คบ
205
+
206
+ `npm run demo:network` ๅœจๆœฌๆœบๅ›ž็Žฏๅœฐๅ€่ฟ่กŒ TCPใ€Packetใ€UDPใ€Selector ็คบไพ‹๏ผŒ็ป“ๆŸๆ—ถๅ…ณ้—ญๆ‰€ๆœ‰่ฟžๆŽฅใ€‚
207
+
208
+ `npm run test:runtime` ๅŒ…ๅซ็ฝ‘็ปœๆต‹่ฏ•๏ผŒๅฏๅŠจๆœฌๅœฐ TCP๏ผUDP๏ผDNS๏ผFTP๏ผSSH ๆœๅŠก๏ผŒๆต‹่ฏ•็œŸๅฎžๅฅ—ๆŽฅๅญ—ใ€ๅˆ†ๆฎตๆŠฅๆ–‡ใ€ๅ‘้€่ƒŒๅŽ‹ใ€TLS ไฟกไปปไธŽ hostname ๅคฑ่ดฅใ€ๅฏ†็ ๅ’Œๅ…ฌ้’ฅ่ฎค่ฏใ€็›ฎๅฝ•ไธŽๆตๅผๆ–‡ไปถๆ“ไฝœใ€่ถ…ๆ—ถๅ’Œๅ–ๆถˆใ€‚`network-oracle.test.cjs` ๅœจไธดๆ—ถ็›ฎๅฝ•็ผ–่ฏ‘ SFML C++ ็จ‹ๅบ๏ผŒๅฏน็…ง Packet ๆฏไธชๅญ—ๆฎต็š„ๅญ—่Š‚ไธŽ IPv4๏ผIPv6 ๅญ—็ฌฆไธฒ๏ผ›Windows ไธ‹่ทณ่ฟ‡่ฏฅ Unix ็ผ–่ฏ‘ๅ‘ฝไปคใ€‚
209
+
210
+ ไพ่ต–็‰ˆๆœฌไปฅ [package.json](../package.json) ๅ’Œ้”ๆ–‡ไปถไธบๅ‡†ใ€‚ๆœฌๅœฐๅ›ž็Žฏๆต‹่ฏ•ไธ้ชŒ่ฏๅ…ฌ็ฝ‘ๆœๅŠกๅฏ็”จๆ€ง๏ผ›ๅนณๅฐ้…็ฝฎไธŽๆ‰ง่กŒๆ–นๆณ•่ง [ๅผ€ๅ‘ๆŒ‡ๅ—](development.zh-CN.md#testing)ใ€‚
211
+
212
+ <a id="sfml-cpp-reference"></a>
213
+
214
+ ## SFML C++ ๅ‚่€ƒ
215
+
216
+ ๆŠฅๆ–‡ไธŽๅฅ—ๆŽฅๅญ—ๅ‚่€ƒ [sf::Packet](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Packet.html)ใ€[sf::TcpSocket](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1TcpSocket.html)ใ€[sf::UdpSocket](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1UdpSocket.html)๏ผ›ๅบ”็”จๅ่ฎฎๅ‚่€ƒ [sf::Http](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Http.html)ใ€[sf::Ftp](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Ftp.html)ใ€[sf::Sftp](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Sftp.html)ใ€‚
217
+
218
+ ไธŠๆธธๆ–‡ๆกฃๅฏ็”จไบŽ็†่งฃ Packet ๆ ผๅผไธŽๅ่ฎฎๆฆ‚ๅฟตใ€‚ๅฎž้™…ไผ ่พ“็”ฑ Node.js ๅฎž็Žฐ๏ผŒPromise I/Oใ€็Šถๆ€่ฟ”ๅ›žใ€่ƒŒๅŽ‹ใ€่ถ…ๆ—ถๅ’Œๅฎน้‡้™ๅˆถไปฅๆœฌๆ–‡ไธบๅ‡†๏ผ›ไธ่ฆๅ‡่ฎพไธŽ C++ ็š„้˜ปๅกž่ฐƒ็”จๆˆ–็ณป็ปŸๅฅๆŸ„ๅฎŒๅ…จ็›ธๅŒใ€‚
@@ -0,0 +1,169 @@
1
+ # System
2
+
3
+ [English](system.md) / [็ฎ€ไฝ“ไธญๆ–‡](system.zh-CN.md) / **ๆ—ฅๆœฌ่ชž** / [ํ•œ๊ตญ์–ด](system.ko.md)
4
+
5
+ > System ใฏๅ€คๅž‹ใ€ๆ™‚้–“ใ€ๅ…ฅๅŠ›ใ‚นใƒˆใƒชใƒผใƒ ใ€Unicode ใฎๅขƒ็•Œๅˆคๅฎšใ€ใ‚จใƒฉใƒผๅ‡ฆ็†ใ‚’ๆไพ›ใ—ใพใ™ใ€‚้€šๅธธใฎๆ•ฐๅ€ค่จˆ็ฎ—ใฏ JS ใง่กŒใ„ใ€ใƒชใ‚ฝใƒผใ‚นใซ้–ขใ‚ใ‚‹ๆ“ไฝœใฏใ‚คใƒณใ‚ฟใƒผใƒ•ใ‚งใƒผใ‚นใซๅฟœใ˜ใฆใƒใ‚คใƒ†ใ‚ฃใƒ–ๅดใงๅฎŸ่กŒใ—ใพใ™ใ€‚
6
+
7
+ [API ใƒŠใƒ“ใ‚ฒใƒผใ‚ทใƒงใƒณ](api.ja.md) ยท [ๅŸบๆœฌๆฆ‚ๅฟต](concepts.ja.md)
8
+
9
+ ## ใƒ™ใ‚ฏใƒˆใƒซใจๆผ”็ฎ—
10
+
11
+ ```typescript
12
+ import { Vector2f, Vector2i, add, multiply, addAssign } from 'sfml.js';
13
+
14
+ const position = new Vector2f(10, 20);
15
+ const velocity = new Vector2f(2, 3);
16
+ const next = add(position, velocity);
17
+ const doubled = multiply(velocity, 2);
18
+ addAssign(position, velocity);
19
+ const pixels = new Vector2i(position);
20
+ ```
21
+
22
+ ้€šๅธธใฎๆผ”็ฎ—ใฏ็‹ฌ็ซ‹ใ—ใŸๅ€คใ‚’่ฟ”ใ—ใ€`*Assign` ใฏๅทฆใ‚ชใƒšใƒฉใƒณใƒ‰ใ‚’ๅค‰ๆ›ดใ—ใฆใใ‚Œใ‚’่ฟ”ใ—ใพใ™ใ€‚ไปฃๅ…ฅใงใƒ™ใ‚ฏใƒˆใƒซใฎใ‚นใ‚ซใƒฉใƒผๅž‹ใŒ่‡ชๅ‹•ๅค‰ๆ›ใ•ใ‚Œใ‚‹ใ“ใจใฏใ‚ใ‚Šใพใ›ใ‚“ใ€‚ๅค‰ๆ›ใŒๅฟ…่ฆใชๅ ดๅˆใฏๅฏพๅฟœใ™ใ‚‹ใ‚ณใƒณใ‚นใƒˆใƒฉใ‚ฏใ‚ฟใƒผใ‚’ไฝฟใ„ใพใ™ใ€‚
23
+
24
+ | ใ‚นใ‚ซใƒฉใƒผใ‚ฟใ‚ฐ | JS ใฎๆˆๅˆ†ๅž‹ | ใ‚นใƒˆใƒฌใƒผใ‚ธ |
25
+ | --- | --- | --- |
26
+ | `i8`๏ผ`u8` | number | Int8Array๏ผUint8Array |
27
+ | `i16`๏ผ`u16` | number | Int16Array๏ผUint16Array |
28
+ | `i32`๏ผ`u32` | number | Int32Array๏ผUint32Array |
29
+ | `i64`๏ผ`u64` | bigint | BigInt64Array๏ผBigUint64Array |
30
+ | `f32`๏ผ`f64` | number | Float32Array๏ผFloat64Array |
31
+
32
+ `Vector2i/u/f` ใจ `Vector3i/u/f` ใฏใใ‚Œใžใ‚Œ i32๏ผu32๏ผf32 ใซๅฏพๅฟœใ—ใพใ™ใ€‚ไป–ใฎใ‚นใ‚ซใƒฉใƒผๅž‹ใซใฏ `new Vector2('f64', x, y)` ใชใฉใฎๅฝขๅผใ‚’ไฝฟใ„ใพใ™ใ€‚
33
+
34
+ ไธกๆ–นใฎใƒ™ใ‚ฏใƒˆใƒซๅž‹ใฏ `lengthSquared()`ใ€`dot()`ใ€`cross()`ใ€ๆˆๅˆ†ใ”ใจใฎไน—้™ค็ฎ—ใ‚’ๆไพ›ใ—ใ€2 ๆฌกๅ…ƒใƒ™ใ‚ฏใƒˆใƒซใฏใ•ใ‚‰ใซ `perpendicular()` ใ‚’ๆไพ›ใ—ใพใ™ใ€‚ๆตฎๅ‹•ๅฐๆ•ฐ็‚นใƒ™ใ‚ฏใƒˆใƒซใฏ `length()` ใจ `normalized()` ใ‚’ๆไพ›ใ—ใ€ๆตฎๅ‹•ๅฐๆ•ฐ็‚นใฎ 2 ๆฌกๅ…ƒใƒ™ใ‚ฏใƒˆใƒซใฏ่ง’ๅบฆใ€ๅ›ž่ปขใ€ๅฐ„ๅฝฑใฎๆ“ไฝœใ‚‚ๆไพ›ใ—ใพใ™ใ€‚ๆ•ดๆ•ฐใƒ™ใ‚ฏใƒˆใƒซใงใฏใ€ๆตฎๅ‹•ๅฐๆ•ฐ็‚นๅž‹ๅฐ‚็”จใฎใƒกใ‚ฝใƒƒใƒ‰ใฏไฝฟใˆใพใ›ใ‚“ใ€‚
35
+
36
+ ใƒ™ใ‚ฏใƒˆใƒซใฎ `multiply()`๏ผ`divide()` ใฏใ‚นใ‚ซใƒฉใƒผใ‚’ไฝฟใ„ใพใ™ใ€‚ๆˆๅˆ†ใ”ใจใฎๆ“ไฝœใซใฏ `componentWiseMul()`๏ผ`componentWiseDiv()` ใ‚’ไฝฟใ„ใพใ™ใ€‚ใ‚ผใƒญ้™ค็ฎ—ใ€ใ‚ผใƒญใƒ™ใ‚ฏใƒˆใƒซใฎๆญฃ่ฆๅŒ–ใ€ใ‚ผใƒญ่ปธใธใฎๅฐ„ๅฝฑใฏไพ‹ๅค–ใ‚’ๆŠ•ใ’ใพใ™ใ€‚64 ใƒ“ใƒƒใƒˆๆ•ดๆ•ฐใฎ่จˆ็ฎ—ใงใฏ bigint ใ‚’็ถญๆŒใ—ใ€f32 ใฎ่จˆ็ฎ—ใฏ SFML ใฎ็ฒพๅบฆ่ฆๅ‰‡ใซๅพ“ใฃใฆไธธใ‚ใพใ™ใ€‚ไธ‰่ง’้–ขๆ•ฐใฎ่จˆ็ฎ—ใงใฏใ€ใƒ—ใƒฉใƒƒใƒˆใƒ•ใ‚ฉใƒผใƒ ใฎๆ•ฐๅญฆใƒฉใ‚คใƒ–ใƒฉใƒชใซใ‚ˆใ‚‹้™ๅฎš็š„ใชๅทฎ็•ฐใ‚’่จฑๅฎนใ—ใพใ™ใ€‚
37
+
38
+ ## ่ง’ๅบฆ
39
+
40
+ ```typescript
41
+ import { Angle, degrees, radians, divide } from 'sfml.js';
42
+
43
+ const heading = degrees(90);
44
+ const turn = radians(Math.PI);
45
+ const copy = new Angle(heading);
46
+ const ratio = divide(turn, heading);
47
+ console.log(copy.asDegrees(), ratio);
48
+ ```
49
+
50
+ ๅ›ž่ปขใฎใ‚คใƒณใ‚ฟใƒผใƒ•ใ‚งใƒผใ‚นใฏ Angle ใ‚’ๅ—ใ‘ๅ–ใ‚Šใพใ™ใ€‚`wrapSigned()`ใ€`wrapUnsigned()` ใฏใใ‚Œใžใ‚Œใฎ็ฏ„ๅ›ฒใซๆŠ˜ใ‚Š่ฟ”ใ—ใŸ่ง’ๅบฆใ‚’่ฟ”ใ—ใพใ™ใŒใ€ๆฏ”่ผƒๆ™‚ใซใฏ่‡ชๅ‹•็š„ใซๆŠ˜ใ‚Š่ฟ”ใ—ใพใ›ใ‚“ใ€‚`Angle.Zero` ใฏ่ชญใฟๅ–ใ‚Šๅฐ‚็”จใฎๅฎšๆ•ฐใงใ€ใ‚ณใƒ”ใƒผใ™ใ‚Œใฐๅค‰ๆ›ดใงใใพใ™ใ€‚Angle ใฏ float32 ใ‚’ไฝฟใ„ใ€ๅ‰ฐไฝ™ๆผ”็ฎ—ใงใฏๆญฃใฎ้™คๆ•ฐใŒๅฟ…่ฆใงใ™ใ€‚
51
+
52
+ ## ๆ™‚้–“ใจใ‚ฏใƒญใƒƒใ‚ฏ
53
+
54
+ ```typescript
55
+ import { Clock, milliseconds, microseconds, sleep } from 'sfml.js';
56
+
57
+ const clock = new Clock();
58
+ await sleep(milliseconds(16));
59
+ const elapsed = clock.restart();
60
+ console.log(elapsed.asSeconds(), elapsed.asMicroseconds());
61
+ console.log(microseconds(1000n).asMilliseconds());
62
+ ```
63
+
64
+ | ใ‚คใƒณใ‚ฟใƒผใƒ•ใ‚งใƒผใ‚น | ใ‚ปใƒžใƒณใƒ†ใ‚ฃใ‚ฏใ‚น |
65
+ | --- | --- |
66
+ | `new Time()`๏ผ`new Time(source)`๏ผ`new Time(bigint)` | ้•ทใ•ใ‚ผใƒญใ€ใ‚ณใƒ”ใƒผใ€ใƒžใ‚คใ‚ฏใƒญ็ง’ๆŒ‡ๅฎšใงๆง‹็ฏ‰ |
67
+ | `seconds(number)` | ็ง’ใ‚’ Time ใซๅค‰ๆ› |
68
+ | `milliseconds(number)` | int32 ใฎใƒŸใƒช็ง’ๅ…ฅๅŠ›ใ€‚ๅฐๆ•ฐ้ƒจใฏใ‚ผใƒญๆ–นๅ‘ใซๅˆ‡ใ‚Šๆจใฆ |
69
+ | `microseconds(bigint)` | ใƒžใ‚คใ‚ฏใƒญ็ง’ๅ…ฅๅŠ› |
70
+ | `asMicroseconds()`๏ผ`toDuration()` | ใƒžใ‚คใ‚ฏใƒญ็ง’ใฎ bigint |
71
+ | `asSeconds()`๏ผ`asMilliseconds()` | float32 ใฎ็ง’๏ผint32 ใฎใƒŸใƒช็ง’ |
72
+ | `Clock.start()`๏ผ`stop()` | ่จˆๆธฌใฎๅ†้–‹๏ผไธ€ๆ™‚ๅœๆญข |
73
+ | `Clock.restart()`๏ผ`reset()` | ใใ‚Œใพใงใฎ็ตŒ้Žๆ™‚้–“ใ‚’่ฟ”ใ—ใ€ใ‚ผใƒญใซๆˆปใ—ใฆๅฎŸ่กŒ๏ผๅœๆญข |
74
+
75
+ Time ใฏ็ฌฆๅทไป˜ใ int64 ใฎใƒžใ‚คใ‚ฏใƒญ็ง’ใ‚’ไฟๆŒใ—ใ€ๆ•ดๆ•ฐๅ€ใฎๆผ”็ฎ—ใซใฏ bigintใ€ๆตฎๅ‹•ๅฐๆ•ฐ็‚นใฎๅ€็އใซใฏ number ใ‚’ไฝฟใ„ใพใ™ใ€‚`Time.Zero` ใฏ่ชญใฟๅ–ใ‚Šๅฐ‚็”จใฎๅฎšๆ•ฐใงใ™ใ€‚็ฏ„ๅ›ฒๅค–ใฎๅ€คใ‚„ไธๆญฃใช้™ค็ฎ—ใฏ RangeError ใ‚’ๆŠ•ใ’ใ€ใ‚คใƒณใƒ—ใƒฌใƒผใ‚นๆผ”็ฎ—ใŒๅคฑๆ•—ใ—ใŸๅ ดๅˆใฏๅ…ƒใฎๅ€คใ‚’ไฟๆŒใ—ใพใ™ใ€‚
76
+
77
+ Clock ใฏ `process.hrtime.bigint()` ใ‚’ไฝฟใ„ใ€็‹ฌ็ซ‹ใ—ใŸ Time ใฎใ‚นใƒŠใƒƒใƒ—ใ‚ทใƒงใƒƒใƒˆใ‚’่ฟ”ใ—ใพใ™ใ€‚็‹ฌ่‡ชใฎใ‚ฟใ‚คใƒžใƒผใฏๆŒใŸใšใ€ใ‚ฏใƒญใƒƒใ‚ฏใฎๅˆ†่งฃ่ƒฝใจใ‚ทใ‚นใƒ†ใƒ ใฎใ‚นใƒชใƒผใƒ—ๆ™‚ใฎๆŒ™ๅ‹•ใฏ Node.js ใจใƒ—ใƒฉใƒƒใƒˆใƒ•ใ‚ฉใƒผใƒ ใซใ‚ˆใฃใฆๆฑบใพใ‚Šใพใ™ใ€‚
78
+
79
+ `sleep(time)` ใฏ Promise ใ‚’่ฟ”ใ—ใ€Node ใฎใ‚ฟใ‚คใƒžใƒผใงๅพ…ๆฉŸใ™ใ‚‹ใŸใ‚ใ€ใ‚คใƒ™ใƒณใƒˆใƒซใƒผใƒ—ใ‚’ใƒ–ใƒญใƒƒใ‚ฏใ—ใพใ›ใ‚“ใ€‚ๆญฃใฎๆ™‚้–“ใฏใƒŸใƒช็ง’ๅ˜ไฝใซๅˆ‡ใ‚ŠไธŠใ’ใ€ใ‚ผใƒญใจ่ฒ ใฎๆ™‚้–“ใฏ็›ดใกใซๅฎŒไบ†ใ—ใพใ™ใ€‚ๅฎŸ้š›ใฎๅ†้–‹ๆ™‚ๅˆปใฏใ‚นใ‚ฑใ‚ธใƒฅใƒผใƒชใƒณใ‚ฐใฎๅฝฑ้Ÿฟใ‚’ๅ—ใ‘ใพใ™ใ€‚
80
+
81
+ ### ใ‚ฟใ‚คใƒ ใ‚ขใ‚ฆใƒˆใฎ่จญๅฎš
82
+
83
+ `TimeoutWithPredicate` ใฏ็ขบ่ช้–“้š”ใจ่ฟฐ่ชžใ‚’ไฟๆŒใ™ใ‚‹ใ ใ‘ใงใ€่‡ช่บซใงใฏใ‚ฟใ‚คใƒžใƒผใ‚’้–‹ๅง‹ใ—ใพใ›ใ‚“ใ€‚
84
+
85
+ - `new TimeoutWithPredicate(time)`๏ผšๅ›บๅฎš้–“้š”ใงใ€่ฟฐ่ชžใฏๅธธใซ false ใ‚’่ฟ”ใ—ใพใ™ใ€‚
86
+ - `new TimeoutWithPredicate(predicate, period?)`๏ผšๆ—ขๅฎšใฎ้–“้š”ใฏ 1 ms ใงใ€true ใฏๅพ…ๆฉŸใ‚’็ถšใ‘ใ‚‹ใ“ใจใ‚’ๆ„ๅ‘ณใ—ใพใ™ใ€‚
87
+ - `getPeriod()` ใฏ่ชญใฟๅ–ใ‚Šๅฐ‚็”จใฎ Time ใ‚’ใ€`getPredicate()` ใฏๅ…ƒใฎ้–ขๆ•ฐใ‚’่ฟ”ใ—ใพใ™ใ€‚
88
+
89
+ ็ขบ่ชใฎใ‚ฟใ‚คใƒŸใƒณใ‚ฐใฏใ€ใ“ใ‚Œใ‚’ๅ—ใ‘ๅ–ใ‚‹ใ‚คใƒณใ‚ฟใƒผใƒ•ใ‚งใƒผใ‚นใŒๆฑบๅฎšใ—ใพใ™ใ€‚็พๅœจใฏ SFTP ใŒ้€ฒๅฑ•ใฎใชใ„ๅพ…ๆฉŸใ‚’ๅˆถๅพกใ™ใ‚‹ใŸใ‚ใซไฝฟใฃใฆใ„ใพใ™ใ€‚่ฉณ็ดฐใฏ [Network](network.ja.md#sftp) ใ‚’ๅ‚็…งใ—ใฆใใ ใ•ใ„ใ€‚
90
+
91
+ `SuspendAwareClock.now()` ใฏใ€ใ‚ทใ‚นใƒ†ใƒ ใฎใ‚นใƒชใƒผใƒ—ๆ™‚้–“ใ‚’ๅซใ‚€ใƒใ‚คใƒ†ใ‚ฃใƒ–ใฎใƒŠใƒŽ็ง’ๅ˜ไฝใฎๆ™‚ๅˆปใ‚’่ฟ”ใ—ใพใ™ใ€‚Android ๅˆ†ๅฒใฎใฟใงใ‚ตใƒใƒผใƒˆใ•ใ‚Œใ€ใƒ‡ใ‚นใ‚ฏใƒˆใƒƒใƒ—ใงใฎๅ‘ผใณๅ‡บใ—ใฏ SFMLError ใ‚’ๆŠ•ใ’ใพใ™ใ€‚็พๅœจใฎ่‡ชๅ‹•ใƒ€ใ‚ฆใƒณใƒญใƒผใƒ‰ใƒ•ใƒญใƒผใซใฏ Android ใฎใƒ“ใƒซใƒ‰ๅฏพ่ฑกใฏใ‚ใ‚Šใพใ›ใ‚“ใ€‚
92
+
93
+ ## ่‰ฒใ€็Ÿฉๅฝขใ€้ ‚็‚น
94
+
95
+ | ๅž‹ | ๆง‹็ฏ‰ใจไธปใชๆ“ไฝœ |
96
+ | --- | --- |
97
+ | Color | RGB๏ผRGBAใ€`0xRRGGBBAA`ใ€ใ‚ณใƒ”ใƒผใ€‚`r/g/b/a`ใ€`toInteger()` |
98
+ | FloatRect๏ผIntRect | `position` + `size`ใ€ใ‚ณใƒ”ใƒผใ€ๆ˜Ž็คบ็š„ๅค‰ๆ›ใ€‚`contains()`ใ€`findIntersection()`ใ€`getCenter()` |
99
+ | Vertex | `position`ใ€`color`ใ€`texCoords`ใ€ใพใŸใฏใ‚ณใƒ”ใƒผใ‚ณใƒณใ‚นใƒˆใƒฉใ‚ฏใ‚ฟใƒผ |
100
+
101
+ ใ“ใ‚Œใ‚‰ใฎๅ€คใฏไธปใซใ‚ฐใƒฉใƒ•ใ‚ฃใƒƒใ‚ฏใ‚นใฎใ‚คใƒณใ‚ฟใƒผใƒ•ใ‚งใƒผใ‚นใงไฝฟใ„ใพใ™ใ€‚Color ใฎๆˆๅˆ†ใฏ uint8 ใงไฟๅญ˜ใ•ใ‚Œใ€็›ดๆŽฅๆ›ธใ่พผใ‚€ใจใใฎๅน…ใซ็ธฎๅฐใ•ใ‚Œใพใ™ใ€‚่‰ฒใฎๅŠ ๆธ›็ฎ—ใฏ้ฃฝๅ’Œๆผ”็ฎ—ใงใ‚ใ‚Šใ€่‰ฒๅŒๅฃซใฎไน—็ฎ—ใฏใƒใƒฃใƒณใƒใƒซใ”ใจใซ `floor(a * b / 255)` ใ‚’่จˆ็ฎ—ใ—ใพใ™ใ€‚Color ใฎๅฎšๆ•ฐใฏ่ชญใฟๅ–ใ‚Šๅฐ‚็”จใงใ™ใ€‚
102
+
103
+ ็Ÿฉๅฝขใจ้ ‚็‚นใฎใƒกใƒณใƒใƒผใฏๅ…ฑๆœ‰ใƒ“ใƒฅใƒผใงใ™ใ€‚็Ÿฉๅฝขใซใฏๅทฆ็ซฏใจไธŠ็ซฏใ‚’ๅซใฟใ€ๅณ็ซฏใจไธ‹็ซฏใฏๅซใฟใพใ›ใ‚“ใ€‚่ฒ ใฎใ‚ตใ‚คใ‚บใฏๆญฃ่ฆๅŒ–ใ—ใŸ็ฏ„ๅ›ฒใจใ—ใฆ่จˆ็ฎ—ใ—ใ€ไบคๅทฎ้ƒจๅˆ†ใฎ้ข็ฉใŒๆญฃใงใชใ‘ใ‚Œใฐ `undefined` ใ‚’่ฟ”ใ—ใพใ™ใ€‚Vertex ใฎๆ—ขๅฎšใฎไฝ็ฝฎใจใƒ†ใ‚ฏใ‚นใƒใƒฃๅบงๆจ™ใฏใ‚ผใƒญใ€่‰ฒใฏ็™ฝใงใ™ใ€‚
104
+
105
+ <a id="input-streams"></a>
106
+ ## ๅ…ฅๅŠ›ใ‚นใƒˆใƒชใƒผใƒ 
107
+
108
+ InputStream ใฏใ‚ทใƒผใ‚ฏๅฏ่ƒฝใชใƒใ‚คใƒˆใ‚นใƒˆใƒชใƒผใƒ ใฎใƒ—ใƒญใƒˆใ‚ณใƒซใงใ™ใ€‚ใƒกใ‚ฝใƒƒใƒ‰ใฏๅŒๆœŸๅ€คใพใŸใฏ Promise ใ‚’่ฟ”ใ›ใพใ™ใ€‚
109
+
110
+ | ใƒกใ‚ฝใƒƒใƒ‰ | ๆˆปใ‚Šๅ€ค |
111
+ | --- | --- |
112
+ | `read(data)` | Uint8Array ใซๆ›ธใ่พผใฟใ€ๅฎŸ้š›ใฎใƒใ‚คใƒˆๆ•ฐใ‚’ bigint ใง่ฟ”ใ™ใ€‚EOF ใฏ `0n` |
113
+ | `seek(position)` | ๅฎŸ้š›ใฎใƒใ‚คใƒˆไฝ็ฝฎใ‚’ bigint ใง่ฟ”ใ™ |
114
+ | `tell()` | ็พๅœจใฎใƒใ‚คใƒˆไฝ็ฝฎใฎ bigint |
115
+ | `getSize()` | ็ทใƒใ‚คใƒˆๆ•ฐใฎ bigint |
116
+
117
+ `undefined` ใฏ I/O ใฎๅคฑๆ•—ใ‚’ๆ„ๅ‘ณใ—ใ€ๆŠ•ใ’ใ‚‰ใ‚ŒใŸใ‚จใƒฉใƒผใฏใใฎใพใพไผๆ’ญใ—ใพใ™ใ€‚ใ“ใ‚Œใ‚‰ 4 ใคใฎใƒกใ‚ฝใƒƒใƒ‰ใ‚’ๅฎŸ่ฃ…ใ—ใŸใ‚ชใƒ–ใ‚ธใ‚งใ‚ฏใƒˆใ‚‚ใ‚นใƒˆใƒชใƒผใƒ ใจใ—ใฆๆธกใ›ใพใ™ใ€‚Node Readable ใซใฏใ€ใ‚ทใƒผใ‚ฏๆฉŸ่ƒฝใ‚’่ฃœใ†ใ‚ขใƒ€ใƒ—ใ‚ฟใƒผใŒๅฟ…่ฆใงใ™ใ€‚
118
+
119
+ `MemoryInputStream(data)` ใฏๅ…ฅๅŠ›ใƒใ‚คใƒˆๅˆ—ใธใฎๅ‚็…งใ‚’ไฟๆŒใ—ใพใ™ใ€‚่ชญใฟ่พผใฟไธญใฏๅ†…ๅฎนใ‚’ๅค‰ๆ›ดใ›ใšใ€1 ๅ›žใฎๆ“ไฝœใŒใ‚ซใƒผใ‚ฝใƒซใ‚’ๅฐ‚ๆœ‰ใ™ใ‚‹ใ‚ˆใ†ใซใ—ใฆใใ ใ•ใ„ใ€‚`FileInputStream` ใฏ Node ใฎใƒ•ใ‚กใ‚คใƒซใƒใƒณใƒ‰ใƒซใ‚’ไฝฟใ„ใ€้žๅŒๆœŸใฎ่ชญใฟๆ›ธใใจใ‚ทใƒผใ‚ฏใ‚’ใ‚ชใƒ–ใ‚ธใ‚งใ‚ฏใƒˆๅ˜ไฝใง็›ดๅˆ—ใซๅฎŸ่กŒใ—ใพใ™ใ€‚
120
+
121
+ ```typescript
122
+ import { FileInputStream, Image } from 'sfml.js';
123
+
124
+ async function readImage(filename: string) {
125
+ const stream = new FileInputStream();
126
+ try {
127
+ if (!await stream.open(filename)) throw new Error('Cannot open file');
128
+ const image = new Image();
129
+ if (!await image.loadFromStream(stream)) throw new Error('Cannot decode image');
130
+ return image;
131
+ } finally {
132
+ await stream.close();
133
+ }
134
+ }
135
+ ```
136
+
137
+ ่ชญใฟ่พผใฟใฎๅฎŒไบ†ใ‚’ๅพ…ใฃใฆใ‹ใ‚‰ใ‚นใƒˆใƒชใƒผใƒ ใ‚’้–‰ใ˜ใฆใใ ใ•ใ„ใ€‚ๅŒใ˜ใ‚นใƒˆใƒชใƒผใƒ ใ‹ใ‚‰่ค‡ๆ•ฐๅ›ž่ชญใฟ่พผใ‚€ๅ ดๅˆใฏใ€1 ๅ›žใšใค await ใ—ใพใ™ใ€‚FileInputStream ใฎใƒ•ใ‚กใ‚คใƒซใ‚ชใƒ•ใ‚ปใƒƒใƒˆใฎ็ฏ„ๅ›ฒใฏ 0๏ฝž2โตยณโˆ’1 ใงใ™ใ€‚EOF ใงใƒ•ใ‚กใ‚คใƒซใŒ่‡ชๅ‹•็š„ใซ้–‰ใ˜ใ‚‹ใ“ใจใฏใชใใ€ๅ†ๅบฆ seek ใงใใพใ™ใ€‚
138
+
139
+ ## Unicode ใจใƒใƒผใ‚ธใƒงใƒณ
140
+
141
+ `Unicode.isGraphemeBoundary(text, position)`ใ€`isWordBoundary()`ใ€`isSentenceBoundary()` ใฏ SFML ใฎ Unicode ่ฆๅ‰‡ใ‚’ไฝฟใ„ใพใ™ใ€‚position ใฏ JS ๆ–‡ๅญ—ๅˆ—ใฎ UTF-16 ใ‚คใƒณใƒ‡ใƒƒใ‚ฏใ‚นใงใ€็ฏ„ๅ›ฒใฏ 0๏ฝž`text.length` ใงใ™ใ€‚ใ‚ตใƒญใ‚ฒใƒผใƒˆใƒšใ‚ขใฎ้€”ไธญใฏๅขƒ็•Œใงใฏใ‚ใ‚Šใพใ›ใ‚“ใ€‚
142
+
143
+ `version()` ใฏใ‚ญใƒฃใƒƒใ‚ทใƒฅใ•ใ‚ŒใŸ่ชญใฟๅ–ใ‚Šๅฐ‚็”จใฎ SFML ใƒฉใƒณใ‚ฟใ‚คใƒ ใƒใƒผใ‚ธใƒงใƒณใ‚’่ฟ”ใ—ใ€`major`ใ€`minor`ใ€`patch`ใ€`isRelease`ใ€`string` ใ‚’ๅซใฟใพใ™ใ€‚ใ“ใ‚Œใฏ npm ใƒ‘ใƒƒใ‚ฑใƒผใ‚ธใฎใƒใƒผใ‚ธใƒงใƒณใงใฏใ‚ใ‚Šใพใ›ใ‚“ใ€‚
144
+
145
+ ## ใ‚จใƒฉใƒผใจใƒญใ‚ฐ
146
+
147
+ SFMLError ใฏใƒใ‚คใƒณใƒ‡ใ‚ฃใƒณใ‚ฐๅฑคใพใŸใฏ SFML ใฎๅฎŸ่กŒๆ™‚ใ‚จใƒฉใƒผใ‚’่กจใ—ใ€`instanceof SFMLError` ใงๅˆคๅฎšใงใใพใ™ใ€‚ๅผ•ๆ•ฐใฎใ‚จใƒฉใƒผใซใฏ TypeError๏ผRangeError ใ‚’ไฝฟใ„ใ€ใƒฆใƒผใ‚ถใƒผใ‚ณใƒผใƒซใƒใƒƒใ‚ฏใŒๆŠ•ใ’ใŸใ‚จใƒฉใƒผใฏใใฎใพใพไผๆ’ญใ—ใพใ™ใ€‚SFML ใŒ่ฟ”ใ™้€šๅธธใฎๅคฑๆ•—ใ‚นใƒ†ใƒผใ‚ฟใ‚นใฏๅผ•ใ็ถšใ false๏ผundefined ใงใ‚ใ‚Šใ€ใ™ในใฆใŒไพ‹ๅค–ใซๅค‰ๆ›ใ•ใ‚Œใ‚‹ใ‚ใ‘ใงใฏใ‚ใ‚Šใพใ›ใ‚“ใ€‚
148
+
149
+ `err()` ใฏ `sf::err()` ใซๆ›ธใ่พผใ‚€ใ‚ทใƒณใ‚ฐใƒซใƒˆใƒณใฎ Node Writable ใ‚’่ฟ”ใ—ใพใ™ใ€‚`setErrorOutput(writable)` ใง SFML ใฎใƒญใ‚ฐใ‚’ใƒชใƒ€ใ‚คใƒฌใ‚ฏใƒˆใ—ใ€null ใ‚’ๆธกใ™ใจๅ‡บๅŠ›ใ‚’ๆŠ‘ๆญขใ—ใ€ๅผ•ๆ•ฐใ‚’็œ็•ฅใ™ใ‚‹ใจๆ—ขๅฎšใฎ stderr ใซๆˆปใ—ใพใ™ใ€‚
150
+
151
+ ```typescript
152
+ import { createWriteStream } from 'node:fs';
153
+ import { finished } from 'node:stream/promises';
154
+ import { err, setErrorOutput } from 'sfml.js';
155
+
156
+ const output = createWriteStream('sfml.log');
157
+ setErrorOutput(output);
158
+ err().write('SFML diagnostic\n');
159
+ setErrorOutput();
160
+ output.end();
161
+ await finished(output);
162
+ ```
163
+
164
+ ใƒญใ‚ฐใฎใƒซใƒผใƒ†ใ‚ฃใƒณใ‚ฐใฏใƒ—ใƒญใ‚ปใ‚นๅ˜ไฝใฎ่จญๅฎšใงใ‚ใ‚Šใ€Worker ใ‚‚ๆœ€ๅพŒใซ่จญๅฎšใ•ใ‚ŒใŸๅ†…ๅฎนใ‚’ๅ…ฑๆœ‰ใ—ใพใ™ใ€‚Node ่‡ช่บซใฎ stderr ใซใฏๅฝฑ้Ÿฟใ—ใพใ›ใ‚“ใ€‚ใƒใƒƒใ‚ฏใ‚ฐใƒฉใ‚ฆใƒณใƒ‰ใฎใƒญใ‚ฐใฏใƒใ‚คใƒˆใƒใƒฃใƒณใ‚ฏๅ˜ไฝใง้…้€ใ•ใ‚Œใ€UTF-8 ใฎๆ–‡ๅญ—ๅขƒ็•Œใ‚„่กŒๅขƒ็•Œใฏไฟ่จผใ•ใ‚Œใพใ›ใ‚“ใ€‚ใƒ†ใ‚ญใ‚นใƒˆใ‚’่งฃๆžใ™ใ‚‹ๅ ดๅˆใฏ StringDecoder ใ‚’ๅˆฉ็”จใงใใพใ™ใ€‚
165
+
166
+ <a id="sfml-cpp-reference"></a>
167
+ ## SFML C++ ใƒชใƒ•ใ‚กใƒฌใƒณใ‚น
168
+
169
+ ไธŠๆตใฎ [Vector2](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Vector2.html)ใ€[Angle](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Angle.html)ใ€[Time](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Time.html)ใ€[Clock](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Clock.html)ใ€[InputStream](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1InputStream.html) ใฏใ€ๆ•ฐๅญฆใ€ๆ™‚้–“ใ€ใ‚นใƒˆใƒชใƒผใƒ ใฎๆฆ‚ๅฟตใ‚’่ชฌๆ˜Žใ—ใฆใ„ใพใ™ใ€‚JavaScript ใฎๅๅ‰ไป˜ใๆผ”็ฎ—้–ขๆ•ฐใ€bigint ใซใ‚ˆใ‚‹ๆ™‚้–“่กจ็พใ€Promise ใ‚’่ฟ”ใ™ sleepใ€ใ‚นใƒˆใƒชใƒผใƒ ใฎใƒกใ‚ฝใƒƒใƒ‰ใซใคใ„ใฆใฏใ€ใ“ใฎใƒใ‚คใƒณใƒ‡ใ‚ฃใƒณใ‚ฐใฎใ‚ฌใ‚คใƒ‰ใซๅพ“ใฃใฆใใ ใ•ใ„ใ€‚
@@ -0,0 +1,171 @@
1
+ # System
2
+
3
+ [English](system.md) / [็ฎ€ไฝ“ไธญๆ–‡](system.zh-CN.md) / [ๆ—ฅๆœฌ่ชž](system.ja.md) / **ํ•œ๊ตญ์–ด**
4
+
5
+ > System์€ ๊ฐ’ ํƒ€์ž…, ์‹œ๊ฐ„, ์ž…๋ ฅ ์ŠคํŠธ๋ฆผ, Unicode ๊ฒฝ๊ณ„, ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์ผ๋ฐ˜์ ์ธ ์ˆ˜์น˜ ๊ณ„์‚ฐ์€ JS์—์„œ ์ˆ˜ํ–‰ํ•˜๋ฉฐ, ๋ฆฌ์†Œ์Šค ๊ด€๋ จ ์ž‘์—…์€ ์ธํ„ฐํŽ˜์ด์Šค์— ๋”ฐ๋ผ ๋„ค์ดํ‹ฐ๋ธŒ ์ธก์—์„œ ์‹คํ–‰๋ฉ๋‹ˆ๋‹ค.
6
+
7
+ [API ์•ˆ๋‚ด](api.ko.md) ยท [ํ•ต์‹ฌ ๊ฐœ๋…](concepts.ko.md)
8
+
9
+ ## ๋ฒกํ„ฐ์™€ ์—ฐ์‚ฐ
10
+
11
+ ```typescript
12
+ import { Vector2f, Vector2i, add, multiply, addAssign } from 'sfml.js';
13
+
14
+ const position = new Vector2f(10, 20);
15
+ const velocity = new Vector2f(2, 3);
16
+ const next = add(position, velocity);
17
+ const doubled = multiply(velocity, 2);
18
+ addAssign(position, velocity);
19
+ const pixels = new Vector2i(position);
20
+ ```
21
+
22
+ ์ผ๋ฐ˜ ์—ฐ์‚ฐ์€ ๋…๋ฆฝ์ ์ธ ๊ฐ’์„ ๋ฐ˜ํ™˜ํ•˜๋ฉฐ, `*Assign`์€ ์™ผ์ชฝ ํ”ผ์—ฐ์‚ฐ์ž๋ฅผ ์ˆ˜์ •ํ•˜๊ณ  ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. ๋Œ€์ž… ์‹œ ๋ฒกํ„ฐ์˜ ์Šค์นผ๋ผ ํƒ€์ž…์ด ์ž๋™ ๋ณ€ํ™˜๋˜์ง€๋Š” ์•Š์Šต๋‹ˆ๋‹ค. ๋ณ€ํ™˜์ด ํ•„์š”ํ•˜๋ฉด ํ•ด๋‹น ์ƒ์„ฑ์ž๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.
23
+
24
+ | ์Šค์นผ๋ผ ํƒœ๊ทธ | JS ์„ฑ๋ถ„ ํƒ€์ž… | ์ €์žฅ์†Œ |
25
+ | --- | --- | --- |
26
+ | `i8`/`u8` | number | Int8Array/Uint8Array |
27
+ | `i16`/`u16` | number | Int16Array/Uint16Array |
28
+ | `i32`/`u32` | number | Int32Array/Uint32Array |
29
+ | `i64`/`u64` | bigint | BigInt64Array/BigUint64Array |
30
+ | `f32`/`f64` | number | Float32Array/Float64Array |
31
+
32
+ `Vector2i/u/f`์™€ `Vector3i/u/f`๋Š” ๊ฐ๊ฐ i32/u32/f32์— ๋Œ€์‘ํ•ฉ๋‹ˆ๋‹ค. ๋‹ค๋ฅธ ์Šค์นผ๋ผ๋Š” `new Vector2('f64', x, y)`์™€ ๊ฐ™์€ ํ˜•์‹์œผ๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
33
+
34
+ ๋‘ ๋ฒกํ„ฐ ํƒ€์ž… ๋ชจ๋‘ `lengthSquared()`, `dot()`, `cross()`, ์„ฑ๋ถ„๋ณ„ ๊ณฑ์…ˆ๊ณผ ๋‚˜๋ˆ—์…ˆ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. 2์ฐจ์› ๋ฒกํ„ฐ์—๋Š” `perpendicular()`๋„ ์žˆ์Šต๋‹ˆ๋‹ค. ๋ถ€๋™์†Œ์ˆ˜์  ๋ฒกํ„ฐ๋Š” `length()`์™€ `normalized()`๋ฅผ ์ œ๊ณตํ•˜๋ฉฐ, ๋ถ€๋™์†Œ์ˆ˜์  2์ฐจ์› ๋ฒกํ„ฐ๋Š” ๊ฐ๋„, ํšŒ์ „, ํˆฌ์˜ ์—ฐ์‚ฐ๋„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์ •์ˆ˜ ๋ฒกํ„ฐ๋Š” ๋ถ€๋™์†Œ์ˆ˜์  ์ „์šฉ ๋ฉ”์„œ๋“œ๋ฅผ ์ง€์›ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
35
+
36
+ ๋ฒกํ„ฐ์˜ `multiply()`/`divide()`์—๋Š” ์Šค์นผ๋ผ๋ฅผ ์‚ฌ์šฉํ•˜๊ณ , ์„ฑ๋ถ„๋ณ„ ์—ฐ์‚ฐ์—๋Š” `componentWiseMul()`/`componentWiseDiv()`๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. 0์œผ๋กœ ๋‚˜๋ˆ„๊ธฐ, ์˜๋ฒกํ„ฐ ์ •๊ทœํ™”, ์˜๋ฒกํ„ฐ ์ถ•์œผ๋กœ์˜ ํˆฌ์˜์€ ์˜ˆ์™ธ๋ฅผ ๋ฐœ์ƒ์‹œํ‚ต๋‹ˆ๋‹ค. 64๋น„ํŠธ ์ •์ˆ˜ ๊ณ„์‚ฐ์€ bigint๋ฅผ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค. f32 ๊ณ„์‚ฐ์€ SFML์˜ ์ •๋ฐ€๋„ ๊ทœ์น™์— ๋”ฐ๋ผ ๋ฐ˜์˜ฌ๋ฆผ๋˜๋ฉฐ, ์‚ผ๊ฐํ•จ์ˆ˜ ์—ฐ์‚ฐ์—์„œ๋Š” ํ”Œ๋žซํผ ์ˆ˜ํ•™ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์— ๋”ฐ๋ฅธ ์ œํ•œ์ ์ธ ์ฐจ์ด๊ฐ€ ํ—ˆ์šฉ๋ฉ๋‹ˆ๋‹ค.
37
+
38
+ ## ๊ฐ๋„
39
+
40
+ ```typescript
41
+ import { Angle, degrees, radians, divide } from 'sfml.js';
42
+
43
+ const heading = degrees(90);
44
+ const turn = radians(Math.PI);
45
+ const copy = new Angle(heading);
46
+ const ratio = divide(turn, heading);
47
+ console.log(copy.asDegrees(), ratio);
48
+ ```
49
+
50
+ ํšŒ์ „ ์ธํ„ฐํŽ˜์ด์Šค๋Š” Angle์„ ๋ฐ›์Šต๋‹ˆ๋‹ค. `wrapSigned()`, `wrapUnsigned()`๋Š” ํ•ด๋‹น ๋ฒ”์œ„๋กœ ๋ž˜ํ•‘ํ•œ ๊ฐ๋„๋ฅผ ๋ฐ˜ํ™˜ํ•˜์ง€๋งŒ, ๋น„๊ต ์‹œ์—๋Š” ์ž๋™์œผ๋กœ ๋ž˜ํ•‘ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. `Angle.Zero`๋Š” ์ฝ๊ธฐ ์ „์šฉ ์ƒ์ˆ˜๋กœ, ๋ณต์‚ฌํ•œ ๋’ค ์ˆ˜์ •ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. Angle์€ float32๋ฅผ ์‚ฌ์šฉํ•˜๋ฉฐ, ๋‚˜๋จธ์ง€ ์—ฐ์‚ฐ์˜ ์ œ์ˆ˜๋Š” ์–‘์ˆ˜์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค.
51
+
52
+ ## ์‹œ๊ฐ„๊ณผ ์‹œ๊ณ„
53
+
54
+ ```typescript
55
+ import { Clock, milliseconds, microseconds, sleep } from 'sfml.js';
56
+
57
+ const clock = new Clock();
58
+ await sleep(milliseconds(16));
59
+ const elapsed = clock.restart();
60
+ console.log(elapsed.asSeconds(), elapsed.asMicroseconds());
61
+ console.log(microseconds(1000n).asMilliseconds());
62
+ ```
63
+
64
+ | ์ธํ„ฐํŽ˜์ด์Šค | ์˜๋ฏธ |
65
+ | --- | --- |
66
+ | `new Time()`/`new Time(source)`/`new Time(bigint)` | ๊ธธ์ด๊ฐ€ 0์ธ ์‹œ๊ฐ„, ๋ณต์‚ฌ, ๋งˆ์ดํฌ๋กœ์ดˆ๋กœ ์ƒ์„ฑ |
67
+ | `seconds(number)` | ์ดˆ๋ฅผ Time์œผ๋กœ ๋ณ€ํ™˜ |
68
+ | `milliseconds(number)` | int32 ๋ฐ€๋ฆฌ์ดˆ ์ž…๋ ฅ. ์†Œ์ˆ˜ ๋ถ€๋ถ„์€ 0 ๋ฐฉํ–ฅ์œผ๋กœ ๋ฒ„๋ฆผ |
69
+ | `microseconds(bigint)` | ๋งˆ์ดํฌ๋กœ์ดˆ ์ž…๋ ฅ |
70
+ | `asMicroseconds()`/`toDuration()` | ๋งˆ์ดํฌ๋กœ์ดˆ bigint |
71
+ | `asSeconds()`/`asMilliseconds()` | float32 ์ดˆ/int32 ๋ฐ€๋ฆฌ์ดˆ |
72
+ | `Clock.start()`/`stop()` | ์‹œ๊ฐ„ ์ธก์ • ์žฌ๊ฐœ/์ผ์‹œ ์ •์ง€ |
73
+ | `Clock.restart()`/`reset()` | ๊ธฐ์กด ๊ฒฝ๊ณผ ์‹œ๊ฐ„์„ ๋ฐ˜ํ™˜ํ•˜๊ณ  0์œผ๋กœ ์ดˆ๊ธฐํ™”ํ•œ ๋’ค ์‹คํ–‰/์ผ์‹œ ์ •์ง€ |
74
+
75
+ Time์€ ๋ถ€ํ˜ธ ์žˆ๋Š” int64 ๋งˆ์ดํฌ๋กœ์ดˆ๋ฅผ ์ €์žฅํ•˜๋ฉฐ, ์ •์ˆ˜ ๋ฐฐ์ˆ˜ ์—ฐ์‚ฐ์—๋Š” bigint๋ฅผ, ๋ถ€๋™์†Œ์ˆ˜์  ๋ฐฐ์ˆ˜์—๋Š” number๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. `Time.Zero`๋Š” ์ฝ๊ธฐ ์ „์šฉ ์ƒ์ˆ˜์ž…๋‹ˆ๋‹ค. ๋ฒ”์œ„๋ฅผ ๋ฒ—์–ด๋‚˜๊ฑฐ๋‚˜ ์ž˜๋ชป๋œ ๋‚˜๋ˆ—์…ˆ์„ ์ˆ˜ํ–‰ํ•˜๋ฉด RangeError๊ฐ€ ๋ฐœ์ƒํ•˜๋ฉฐ, ์ œ์ž๋ฆฌ ์—ฐ์‚ฐ์ด ์‹คํŒจํ•˜๋ฉด ์›๋ž˜ ๊ฐ’์„ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค.
76
+
77
+ Clock์€ `process.hrtime.bigint()`๋ฅผ ์‚ฌ์šฉํ•˜๊ณ  ๋…๋ฆฝ์ ์ธ Time ์Šค๋ƒ…์ƒท์„ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. ์ž์ฒด ํƒ€์ด๋จธ๋Š” ์—†์œผ๋ฉฐ, ์‹œ๊ณ„ ํ•ด์ƒ๋„์™€ ์‹œ์Šคํ…œ ์ ˆ์ „ ์ค‘์˜ ๋™์ž‘์€ Node.js์™€ ํ”Œ๋žซํผ์— ๋”ฐ๋ผ ๊ฒฐ์ •๋ฉ๋‹ˆ๋‹ค.
78
+
79
+ `sleep(time)`์€ Promise๋ฅผ ๋ฐ˜ํ™˜ํ•˜๊ณ  Node ํƒ€์ด๋จธ๋กœ ๊ธฐ๋‹ค๋ฆฌ๋ฉฐ ์ด๋ฒคํŠธ ๋ฃจํ”„๋ฅผ ์ฐจ๋‹จํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์–‘์ˆ˜ ์‹œ๊ฐ„์€ ๋ฐ€๋ฆฌ์ดˆ ๋‹จ์œ„๋กœ ์˜ฌ๋ฆผํ•ฉ๋‹ˆ๋‹ค. 0์ด๋‚˜ ์Œ์ˆ˜ ์‹œ๊ฐ„์€ ์ฆ‰์‹œ ์™„๋ฃŒ๋˜๋ฉฐ, ์‹ค์ œ ์žฌ๊ฐœ ์‹œ์ ์€ ์Šค์ผ€์ค„๋ง์˜ ์˜ํ–ฅ์„ ๋ฐ›์Šต๋‹ˆ๋‹ค.
80
+
81
+ ### ํƒ€์ž„์•„์›ƒ ์„ค์ •
82
+
83
+ `TimeoutWithPredicate`๋Š” ํ™•์ธ ์ฃผ๊ธฐ์™€ ์กฐ๊ฑด ํ•จ์ˆ˜๋ฅผ ์ €์žฅํ•  ๋ฟ, ์ž์ฒด์ ์œผ๋กœ ํƒ€์ด๋จธ๋ฅผ ์‹œ์ž‘ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
84
+
85
+ - `new TimeoutWithPredicate(time)`: ๊ณ ์ • ์ฃผ๊ธฐ์ด๋ฉฐ ์กฐ๊ฑด ํ•จ์ˆ˜๋Š” ํ•ญ์ƒ false๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.
86
+ - `new TimeoutWithPredicate(predicate, period?)`: ๊ธฐ๋ณธ ์ฃผ๊ธฐ๋Š” 1 ms์ด๋ฉฐ, true๋Š” ๊ณ„์† ๊ธฐ๋‹ค๋ฆฐ๋‹ค๋Š” ๋œป์ž…๋‹ˆ๋‹ค.
87
+ - `getPeriod()`๋Š” ์ฝ๊ธฐ ์ „์šฉ Time์„, `getPredicate()`๋Š” ์›๋ณธ ํ•จ์ˆ˜๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.
88
+
89
+ ์ด๋ฅผ ๋ฐ›๋Š” ์ธํ„ฐํŽ˜์ด์Šค๊ฐ€ ํ™•์ธ ์‹œ์ ์„ ๊ฒฐ์ •ํ•ฉ๋‹ˆ๋‹ค. ํ˜„์žฌ SFTP๋Š” ์ง„ํ–‰์ด ์—†๋Š” ๋™์•ˆ์˜ ๋Œ€๊ธฐ๋ฅผ ์ œ์–ดํ•˜๋Š” ๋ฐ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์ž์„ธํ•œ ๋‚ด์šฉ์€ [Network](network.ko.md#sftp)๋ฅผ ์ฐธ๊ณ ํ•˜์„ธ์š”.
90
+
91
+ `SuspendAwareClock.now()`๋Š” ์‹œ์Šคํ…œ ์ ˆ์ „ ์‹œ๊ฐ„์„ ํฌํ•จํ•˜๋Š” ๋„ค์ดํ‹ฐ๋ธŒ ๋‚˜๋…ธ์ดˆ ์‹œ์ ์„ ๋ฐ˜ํ™˜ํ•˜๋ฉฐ, Android ๋ถ„๊ธฐ์—์„œ๋งŒ ์ง€์›๋ฉ๋‹ˆ๋‹ค. ๋ฐ์Šคํฌํ†ฑ์—์„œ ํ˜ธ์ถœํ•˜๋ฉด SFMLError๊ฐ€ ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค. ํ˜„์žฌ ์ž๋™ ๋‹ค์šด๋กœ๋“œ ์ ˆ์ฐจ์—๋Š” Android ๋นŒ๋“œ ๋Œ€์ƒ์ด ์—†์Šต๋‹ˆ๋‹ค.
92
+
93
+ ## ์ƒ‰์ƒ, ์‚ฌ๊ฐํ˜•, ์ •์ 
94
+
95
+ | ํƒ€์ž… | ์ƒ์„ฑ ๋ฐ ์ฃผ์š” ์—ฐ์‚ฐ |
96
+ | --- | --- |
97
+ | Color | RGB/RGBA, `0xRRGGBBAA`, ๋ณต์‚ฌ; `r/g/b/a`, `toInteger()` |
98
+ | FloatRect/IntRect | `position` + `size`, ๋ณต์‚ฌ, ๋ช…์‹œ์  ๋ณ€ํ™˜; `contains()`, `findIntersection()`, `getCenter()` |
99
+ | Vertex | `position`, `color`, `texCoords` ๋˜๋Š” ๋ณต์‚ฌ ์ƒ์„ฑ |
100
+
101
+ ์ด ๊ฐ’๋“ค์€ ์ฃผ๋กœ ๊ทธ๋ž˜ํ”ฝ ์ธํ„ฐํŽ˜์ด์Šค์—์„œ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. Color ์„ฑ๋ถ„์€ uint8๋กœ ์ €์žฅ๋˜๋ฉฐ, ์ง์ ‘ ์“ฐ๋ฉด ํ•ด๋‹น ๋น„ํŠธ ํญ์œผ๋กœ ์ถ•์†Œ๋ฉ๋‹ˆ๋‹ค. ์ƒ‰์ƒ ๋ง์…ˆ๊ณผ ๋บ„์…ˆ์€ ํฌํ™” ์—ฐ์‚ฐ์ด๊ณ , ์ƒ‰์ƒ ๊ณฑ์…ˆ์€ ์ฑ„๋„๋ณ„๋กœ `floor(a * b / 255)`๋ฅผ ๊ณ„์‚ฐํ•ฉ๋‹ˆ๋‹ค. Color ์ƒ์ˆ˜๋Š” ์ฝ๊ธฐ ์ „์šฉ์ž…๋‹ˆ๋‹ค.
102
+
103
+ ์‚ฌ๊ฐํ˜•๊ณผ ์ •์ ์˜ ๋ฉค๋ฒ„๋Š” ๊ณต์œ  ๋ทฐ์ž…๋‹ˆ๋‹ค. ์‚ฌ๊ฐํ˜•์€ ์™ผ์ชฝ๊ณผ ์œ„์ชฝ ๊ฒฝ๊ณ„๋ฅผ ํฌํ•จํ•˜๊ณ  ์˜ค๋ฅธ์ชฝ๊ณผ ์•„๋ž˜์ชฝ ๊ฒฝ๊ณ„๋Š” ์ œ์™ธํ•ฉ๋‹ˆ๋‹ค. ์Œ์ˆ˜ ํฌ๊ธฐ๋Š” ์ •๊ทœํ™”๋œ ๋ฒ”์œ„๋กœ ๊ณ„์‚ฐํ•˜๋ฉฐ, ๊ต์ง‘ํ•ฉ์˜ ๋ฉด์ ์ด ์–‘์ˆ˜๊ฐ€ ์•„๋‹ˆ๋ฉด `undefined`๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. Vertex์˜ ๊ธฐ๋ณธ ์œ„์น˜์™€ ํ…์Šค์ฒ˜ ์ขŒํ‘œ๋Š” 0์ด๊ณ , ์ƒ‰์ƒ์€ ํฐ์ƒ‰์ž…๋‹ˆ๋‹ค.
104
+
105
+ <a id="input-streams"></a>
106
+ ## ์ž…๋ ฅ ์ŠคํŠธ๋ฆผ
107
+
108
+ InputStream์€ ํƒ์ƒ‰ ๊ฐ€๋Šฅํ•œ ๋ฐ”์ดํŠธ ์ŠคํŠธ๋ฆผ ํ”„๋กœํ† ์ฝœ์ด๋ฉฐ, ๋ฉ”์„œ๋“œ๋Š” ๋™๊ธฐ์‹ ๊ฐ’์ด๋‚˜ Promise๋ฅผ ๋ฐ˜ํ™˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
109
+
110
+ | ๋ฉ”์„œ๋“œ | ๋ฐ˜ํ™˜๊ฐ’ |
111
+ | --- | --- |
112
+ | `read(data)` | Uint8Array์— ์“ฐ๊ณ  ์‹ค์ œ ๋ฐ”์ดํŠธ ์ˆ˜๋ฅผ bigint๋กœ ๋ฐ˜ํ™˜. EOF๋Š” `0n` |
113
+ | `seek(position)` | ์‹ค์ œ ๋ฐ”์ดํŠธ ์œ„์น˜๋ฅผ bigint๋กœ ๋ฐ˜ํ™˜ |
114
+ | `tell()` | ํ˜„์žฌ ๋ฐ”์ดํŠธ ์œ„์น˜ bigint |
115
+ | `getSize()` | ์ „์ฒด ๋ฐ”์ดํŠธ ์ˆ˜ bigint |
116
+
117
+ `undefined`๋Š” I/O ์‹คํŒจ๋ฅผ ๋œปํ•˜๋ฉฐ, ๋ฐœ์ƒํ•œ ์˜ค๋ฅ˜๋Š” ๊ทธ๋Œ€๋กœ ์ „ํŒŒ๋ฉ๋‹ˆ๋‹ค. ์ด ๋„ค ๋ฉ”์„œ๋“œ๋ฅผ ๊ตฌํ˜„ํ•œ ๊ฐ์ฒด๋„ ์ŠคํŠธ๋ฆผ์œผ๋กœ ์ „๋‹ฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. Node Readable์—๋Š” ํƒ์ƒ‰ ๊ธฐ๋Šฅ์„ ์ถ”๊ฐ€๋กœ ๊ตฌํ˜„ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
118
+
119
+ `MemoryInputStream(data)`๋Š” ์ž…๋ ฅ ๋ฐ”์ดํŠธ์˜ ์ฐธ์กฐ๋ฅผ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค. ๋กœ๋”ฉ ์ค‘์—๋Š” ๋‚ด์šฉ์„ ๋ณ€๊ฒฝํ•˜์ง€ ๋ง๊ณ , ํ•œ ์ž‘์—…์ด ์ปค์„œ๋ฅผ ๋…์ ํ•˜๋„๋ก ํ•˜์„ธ์š”. `FileInputStream`์€ Node ํŒŒ์ผ ํ•ธ๋“ค์„ ์‚ฌ์šฉํ•˜๋ฉฐ, ๊ฐ์ฒด๋ณ„๋กœ ๋น„๋™๊ธฐ ์ฝ๊ธฐ/์“ฐ๊ธฐ์™€ ํƒ์ƒ‰์„ ์ง๋ ฌ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
120
+
121
+ ```typescript
122
+ import { FileInputStream, Image } from 'sfml.js';
123
+
124
+ async function readImage(filename: string) {
125
+ const stream = new FileInputStream();
126
+ try {
127
+ if (!await stream.open(filename)) throw new Error('Cannot open file');
128
+ const image = new Image();
129
+ if (!await image.loadFromStream(stream)) throw new Error('Cannot decode image');
130
+ return image;
131
+ } finally {
132
+ await stream.close();
133
+ }
134
+ }
135
+ ```
136
+
137
+ ๋กœ๋”ฉ์ด ์™„๋ฃŒ๋  ๋•Œ๊นŒ์ง€ ๊ธฐ๋‹ค๋ฆฐ ๋’ค ์ŠคํŠธ๋ฆผ์„ ๋‹ซ์œผ์„ธ์š”. ๊ฐ™์€ ์ŠคํŠธ๋ฆผ์—์„œ ์—ฌ๋Ÿฌ ๋ฒˆ ๋กœ๋“œํ•  ๋•Œ๋Š” ํ•˜๋‚˜์”ฉ awaitํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. FileInputStream์˜ ํŒŒ์ผ ์˜คํ”„์…‹ ๋ฒ”์œ„๋Š” 0~2โตยณโˆ’1์ž…๋‹ˆ๋‹ค. EOF์—์„œ ํŒŒ์ผ์„ ์ž๋™์œผ๋กœ ๋‹ซ์ง€ ์•Š์œผ๋ฏ€๋กœ ๋‹ค์‹œ seekํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
138
+
139
+ ## Unicode์™€ ๋ฒ„์ „
140
+
141
+ `Unicode.isGraphemeBoundary(text, position)`, `isWordBoundary()`, `isSentenceBoundary()`๋Š” SFML์˜ Unicode ๊ทœ์น™์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. position์€ JS ๋ฌธ์ž์—ด์˜ UTF-16 ์ธ๋ฑ์Šค๋กœ, ๋ฒ”์œ„๋Š” 0~`text.length`์ž…๋‹ˆ๋‹ค. ์„œ๋กœ๊ฒŒ์ดํŠธ ์Œ์˜ ์ค‘๊ฐ„์€ ๊ฒฝ๊ณ„๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค.
142
+
143
+ `version()`์€ ์บ์‹œ๋œ ์ฝ๊ธฐ ์ „์šฉ SFML ๋Ÿฐํƒ€์ž„ ๋ฒ„์ „์„ ๋ฐ˜ํ™˜ํ•˜๋ฉฐ, `major`, `minor`, `patch`, `isRelease`, `string`์„ ํฌํ•จํ•ฉ๋‹ˆ๋‹ค. npm ํŒจํ‚ค์ง€ ๋ฒ„์ „์€ ์•„๋‹™๋‹ˆ๋‹ค.
144
+
145
+ ## ์˜ค๋ฅ˜์™€ ๋กœ๊ทธ
146
+
147
+ SFMLError๋Š” ๋ฐ”์ธ๋”ฉ ๊ณ„์ธต์ด๋‚˜ SFML์˜ ์‹คํ–‰ ์‹คํŒจ๋ฅผ ๋‚˜ํƒ€๋‚ด๋ฉฐ, `instanceof SFMLError`๋กœ ํŒ๋ณ„ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋งค๊ฐœ๋ณ€์ˆ˜ ์˜ค๋ฅ˜์—๋Š” TypeError/RangeError๋ฅผ ์‚ฌ์šฉํ•˜๊ณ , ์‚ฌ์šฉ์ž ์ฝœ๋ฐฑ์˜ ์˜ค๋ฅ˜๋Š” ๊ทธ๋Œ€๋กœ ์ „ํŒŒ๋ฉ๋‹ˆ๋‹ค. SFML์ด ๋ฐ˜ํ™˜ํ•˜๋Š” ์ผ๋ฐ˜์ ์ธ ์‹คํŒจ ์ƒํƒœ๋Š” ์—ฌ์ „ํžˆ false/undefined์ด๋ฉฐ, ์ „๋ถ€ ์˜ˆ์™ธ๋กœ ๋ณ€ํ™˜๋˜์ง€๋Š” ์•Š์Šต๋‹ˆ๋‹ค.
148
+
149
+ `err()`๋Š” `sf::err()`์— ์“ฐ๋Š” ์‹ฑ๊ธ€ํ„ด Node Writable์„ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. `setErrorOutput(writable)`์€ SFML ๋กœ๊ทธ๋ฅผ ๋ฆฌ๋””๋ ‰์…˜ํ•˜๋ฉฐ, null์„ ์ „๋‹ฌํ•˜๋ฉด ์ถœ๋ ฅ์„ ๋„๊ณ  ์ธ์ˆ˜ ์—†์ด ํ˜ธ์ถœํ•˜๋ฉด ๊ธฐ๋ณธ stderr๋กœ ๋ณต์›ํ•ฉ๋‹ˆ๋‹ค.
150
+
151
+ ```typescript
152
+ import { createWriteStream } from 'node:fs';
153
+ import { finished } from 'node:stream/promises';
154
+ import { err, setErrorOutput } from 'sfml.js';
155
+
156
+ const output = createWriteStream('sfml.log');
157
+ setErrorOutput(output);
158
+ err().write('SFML diagnostic\n');
159
+ setErrorOutput();
160
+ output.end();
161
+ await finished(output);
162
+ ```
163
+
164
+ ๋กœ๊ทธ ๊ฒฝ๋กœ๋Š” ํ”„๋กœ์„ธ์Šค ์ „์ฒด ์„ค์ •์ด๋ฉฐ Worker๋„ ๊ฐ€์žฅ ์ตœ๊ทผ์˜ ์„ค์ •์„ ๊ณต์œ ํ•ฉ๋‹ˆ๋‹ค. Node ์ž์ฒด์˜ stderr์—๋Š” ์˜ํ–ฅ์„ ์ฃผ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋ฐฑ๊ทธ๋ผ์šด๋“œ ๋กœ๊ทธ๋Š” ๋ฐ”์ดํŠธ ์ฒญํฌ ๋‹จ์œ„๋กœ ์ „๋‹ฌ๋˜์–ด UTF-8 ๋ฌธ์ž ๊ฒฝ๊ณ„๋‚˜ ์ค„ ๊ฒฝ๊ณ„๊ฐ€ ๋ณด์žฅ๋˜์ง€ ์•Š์œผ๋ฏ€๋กœ, ํ…์ŠคํŠธ๋ฅผ ํŒŒ์‹ฑํ•  ๋•Œ๋Š” StringDecoder๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
165
+
166
+ <a id="sfml-cpp-reference"></a>
167
+ ## SFML C++ ๋ ˆํผ๋Ÿฐ์Šค
168
+
169
+ ์›๋ณธ ํด๋ž˜์Šค ๋ฌธ์„œ: [Vector2](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Vector2.html), [Angle](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Angle.html), [Time](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Time.html), [Clock](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Clock.html), [InputStream](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1InputStream.html).
170
+
171
+ C++ ๋ ˆํผ๋Ÿฐ์Šค๋Š” ์ˆ˜ํ•™, ์‹œ๊ฐ„, ์ŠคํŠธ๋ฆผ์˜ ๊ธฐ๋ณธ ๊ฐœ๋…์„ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค. JS์˜ ์ด๋ฆ„ ์žˆ๋Š” ์—ฐ์‚ฐ์ž, bigint ์‹œ๊ฐ„ ํ‘œํ˜„, Promise ๊ธฐ๋ฐ˜ sleep, ์ŠคํŠธ๋ฆผ ๋ฉ”์„œ๋“œ์˜ ๊ตฌ์ฒด์ ์ธ ๋™์ž‘์€ ์ด ๋ฐ”์ธ๋”ฉ์˜ ๊ฐ€์ด๋“œ๋ฅผ ๋”ฐ๋ฅด์„ธ์š”.