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,141 @@
1
+ import { audioHandle, type AudioHandle } from '../internal/audio-native';
2
+ import {
3
+ recorderCallbackSession, type AudioRecorderCallbacks,
4
+ } from '../internal/audio-recorder-session';
5
+ import { SoundRecorder } from './sound-recorder';
6
+ import {
7
+ SoundBuffer, adoptAudioBuffer, type ReadonlySoundBuffer,
8
+ } from './sound-buffer';
9
+
10
+ /**
11
+ * Recorder that saves captured PCM in a SoundBuffer.
12
+ * @zh 将采集的 PCM 保存在 SoundBuffer 中的录音器。
13
+ * @ja キャプチャした PCM を SoundBuffer に保存する録音器。
14
+ * @ko 캡처한 PCM을 SoundBuffer에 저장하는 녹음기입니다.
15
+ */
16
+ export class SoundBufferRecorder extends SoundRecorder {
17
+ private buffer: SoundBuffer = new SoundBuffer();
18
+ /**
19
+ * Create a recorder; call start to begin capture.
20
+ * @zh 创建录音器,调用 start 开始采集。
21
+ * @ja 録音器を作成します。start を呼ぶとキャプチャを開始します。
22
+ * @ko 녹음기를 생성합니다. start를 호출하면 캡처를 시작합니다.
23
+ */
24
+ constructor() { super(undefined, true); }
25
+ /**
26
+ * Return the most recently completed recording buffer;
27
+ * retrieve new results after await stop().
28
+ * @zh 返回最近完成的录音缓冲区;应在 await stop() 后取得新结果。
29
+ * @ja 最後に完成した録音バッファーを返します。
30
+ * 新しい結果は await stop() の後で取得してください。
31
+ * @ko 가장 최근 완성된 녹음 버퍼를 반환합니다.
32
+ * 새 결과는 await stop() 후에 가져와야 합니다.
33
+ */
34
+ getBuffer(): ReadonlySoundBuffer { return this.buffer; }
35
+ /**
36
+ * Called on the object's owning JS thread before capture begins; supports
37
+ * synchronous or asynchronous returns, with false rejecting capture.
38
+ * By default, clears this session's native PCM accumulator and recording
39
+ * buffer without accessing the microphone.
40
+ * @zh 在对象所属 JS 线程开始采集前调用;支持同步或异步返回,false 拒绝采集。
41
+ * 默认清空本次 Native PCM 聚合和录音缓冲区,不访问麦克风。
42
+ * @ja キャプチャ開始前にオブジェクトの所属 JS スレッドで呼ばれます。
43
+ * 同期・非同期の戻り値に対応し、false はキャプチャを拒否します。
44
+ * 既定では今回の Native PCM 蓄積領域と録音バッファーをクリアし、
45
+ * マイクにはアクセスしません。
46
+ * @ko 캡처 시작 전 객체가 속한 JS 스레드에서 호출됩니다.
47
+ * 동기 또는 비동기 반환을 지원하며 false는 캡처를 거부합니다.
48
+ * 기본적으로 이번 세션의 Native PCM 누적 영역과 녹음 버퍼를 비우며
49
+ * 마이크에 접근하지 않습니다.
50
+ */
51
+ protected onStart(): boolean | Promise<boolean> {
52
+ this.onBuffer(recorderCallbackSession(this[audioHandle], 'onStart').reset());
53
+ return true;
54
+ }
55
+ /**
56
+ * Serially process interleaved 16-bit PCM on the object's owning JS thread;
57
+ * lengths count samples, not frames. Native views are valid only until this
58
+ * synchronous or asynchronous callback ends; false stops capture
59
+ * asynchronously. By default, appends incoming samples to the native
60
+ * accumulator. You may modify samples before calling super; without super,
61
+ * samples are not saved.
62
+ * @zh 在对象所属 JS 线程串行处理交错的 16 位 PCM,长度单位为样本而非帧。
63
+ * Native 视图仅在本次同步或异步回调结束前有效;false 异步停止采集。
64
+ * 默认将传入样本追加到 Native 聚合器;可修改后调用 super,不调用则不保存。
65
+ * @ja オブジェクトの所属 JS スレッドで 16 ビットインターリーブ PCM を直列処理します。
66
+ * 長さはフレームではなくサンプル数です。Native ビューは今回の同期・非同期
67
+ * コールバック終了までのみ有効で、false はキャプチャを非同期で停止します。
68
+ * 既定では受け取ったサンプルを Native 蓄積領域に追加します。
69
+ * 変更後に super を呼ぶこともでき、呼ばない場合は保存しません。
70
+ * @ko 객체가 속한 JS 스레드에서 16비트 인터리브 PCM을 직렬로 처리합니다.
71
+ * 길이 단위는 프레임이 아닌 샘플입니다. Native 뷰는 이번 동기 또는 비동기
72
+ * 콜백이 끝날 때까지만 유효하며 false는 캡처를 비동기로 중지합니다.
73
+ * 기본적으로 입력 샘플을 Native 누적기에 추가합니다.
74
+ * 수정 후 super를 호출할 수 있으며, 호출하지 않으면 저장되지 않습니다.
75
+ */
76
+ protected onProcessSamples(samples: Int16Array): boolean | Promise<boolean> {
77
+ return recorderCallbackSession(this[audioHandle], 'onProcessSamples')
78
+ .append(samples);
79
+ }
80
+ /**
81
+ * Called once on the object's owning JS thread after the device stops and
82
+ * delivered callbacks finish; supports asynchronous completion.
83
+ * Rejection, cancellation, and errors also trigger it. By default, finalizes
84
+ * PCM appended through super into a SoundBuffer.
85
+ * @zh 在设备停止且已交付回调结束后,于对象所属 JS 线程调用一次,支持异步完成。
86
+ * 拒绝、取消和异常同样触发;默认将已通过 super 追加的 PCM 完成为 SoundBuffer。
87
+ * @ja デバイス停止と配信済みコールバックの完了後、オブジェクトの所属 JS スレッドで
88
+ * 一度呼ばれます。非同期完了に対応します。拒否・キャンセル・例外時も呼ばれます。
89
+ * 既定では super で追加された PCM を SoundBuffer として完成させます。
90
+ * @ko 장치가 중지되고 전달된 콜백이 끝난 후 객체가 속한 JS 스레드에서
91
+ * 한 번 호출되며 비동기 완료를 지원합니다. 거부, 취소, 오류 시에도 호출됩니다.
92
+ * 기본적으로 super를 통해 추가한 PCM을 SoundBuffer로 완성합니다.
93
+ */
94
+ protected onStop(): void | Promise<void> {
95
+ this.onBuffer(recorderCallbackSession(this[audioHandle], 'onStop').finalize());
96
+ }
97
+ /**
98
+ * Enable the queue only for subclasses overriding callbacks;
99
+ * ordinary instances retain the native fast path.
100
+ * @zh 只有覆写回调的子类启用队列,普通实例保持 Native 快路径。
101
+ * @ja コールバックをオーバーライドするサブクラスのみキューを有効にし、
102
+ * 通常のインスタンスでは Native 高速経路を維持します。
103
+ * @ko 콜백을 재정의한 하위 클래스만 큐를 활성화하며,
104
+ * 일반 인스턴스는 Native 고속 경로를 유지합니다.
105
+ */
106
+ protected recorderCallbacks(): AudioRecorderCallbacks | undefined {
107
+ if (this.onStart === SoundBufferRecorder.prototype.onStart &&
108
+ this.onProcessSamples === SoundBufferRecorder.prototype.onProcessSamples &&
109
+ this.onStop === SoundBufferRecorder.prototype.onStop) return undefined;
110
+ return SoundBufferRecorder.callbacks(new WeakRef(this));
111
+ }
112
+ /**
113
+ * Create weak-reference dispatchers outside instance scope so idle sessions
114
+ * do not keep wrappers alive.
115
+ * @zh 在实例作用域外创建弱引用派发器,避免空闲会话保活包装对象。
116
+ * @ja インスタンスのスコープ外で弱参照ディスパッチャーを作成し、
117
+ * アイドル中のセッションがラッパーの生存を維持しないようにします。
118
+ * @ko 인스턴스 범위 밖에서 약한 참조 디스패처를 생성하여
119
+ * 유휴 세션이 래퍼 객체를 계속 유지하지 않도록 합니다.
120
+ */
121
+ private static callbacks(weak: WeakRef<SoundBufferRecorder>): AudioRecorderCallbacks {
122
+ return {
123
+ onStart: () => weak.deref()?.onStart() ?? false,
124
+ onProcessSamples: samples =>
125
+ weak.deref()?.onProcessSamples(samples) ?? false,
126
+ onStop: () => weak.deref()?.onStop(),
127
+ };
128
+ }
129
+ /**
130
+ * Receive an independent native buffer; later recordings do not modify a
131
+ * previously returned SoundBuffer.
132
+ * @zh 接收独立 Native 缓冲区;后续录音不会修改已返回的 SoundBuffer。
133
+ * @ja 独立した Native バッファーを受け取ります。
134
+ * 後の録音で返却済みの SoundBuffer が変更されることはありません。
135
+ * @ko 독립적인 Native 버퍼를 받습니다.
136
+ * 이후 녹음은 이미 반환한 SoundBuffer를 수정하지 않습니다.
137
+ */
138
+ protected onBuffer(buffer: AudioHandle<'bufferData'>): void {
139
+ this.buffer = SoundBuffer[adoptAudioBuffer](buffer);
140
+ }
141
+ }
@@ -0,0 +1,275 @@
1
+ import {
2
+ audioNative, audioHandle, audioAsync, AudioQueue, type AudioHandle,
3
+ type AudioBufferMapping,
4
+ } from '../internal/audio-native';
5
+ import { nativeStruct } from '../internal/struct-view';
6
+ import { Time } from '../system/time';
7
+ import type { InputStream } from '../system/input-stream';
8
+ import { AudioInputStream } from '../internal/audio-input-stream';
9
+ import { audioReaders, audioWriters } from '../internal/audio-codec-registry';
10
+ import { InputSoundFile } from './input-sound-file';
11
+ import { OutputSoundFile } from './output-sound-file';
12
+ import {
13
+ channels, unsigned, samples, type SoundChannel, type ReadonlySamples,
14
+ type ChannelMap,
15
+ } from './value';
16
+
17
+ function view(mapping: AudioBufferMapping) {
18
+ return nativeStruct<{
19
+ sampleCount: bigint; sampleRate: number; channelCount: number;
20
+ duration: bigint; samples: Int16Array; channelMap: Int32Array;
21
+ }>(mapping.info, {
22
+ samples: new Int16Array(mapping.samples),
23
+ channelMap: new Int32Array(mapping.channelMap),
24
+ });
25
+ }
26
+
27
+ /**
28
+ * Read-only audio buffer interface; sample views retain their native storage.
29
+ * @zh 音频缓冲区的只读接口,样本视图保留其对应的原生存储。
30
+ * @ja 音声バッファーの読み取り専用インターフェース。
31
+ * サンプルビューは対応するネイティブストレージを保持します。
32
+ * @ko 오디오 버퍼의 읽기 전용 인터페이스입니다.
33
+ * 샘플 뷰는 해당 네이티브 저장소를 유지합니다.
34
+ */
35
+ export type ReadonlySoundBuffer = Readonly<Pick<SoundBuffer,
36
+ typeof audioHandle | 'getSamples' | 'getSampleCount' | 'getSampleRate' |
37
+ 'getChannelCount' | 'getChannelMap' | 'getDuration' | 'saveToFile'>>;
38
+
39
+ export const adoptAudioBuffer: unique symbol = Symbol('Audio.adoptBuffer');
40
+
41
+ /**
42
+ * Views retain the exact native allocation from which they were obtained.
43
+ * @zh 视图保留获取时对应的原生内存分配。
44
+ * @ja ビューは取得元となったネイティブメモリ割り当てをそのまま保持します。
45
+ * @ko 뷰는 자신을 얻은 원래 네이티브 메모리 할당을 그대로 유지합니다.
46
+ */
47
+ export class SoundBuffer {
48
+ readonly [audioHandle]: AudioHandle<'buffer'>;
49
+ private state: ReturnType<typeof view>;
50
+ private readonly queue = new AudioQueue();
51
+
52
+ /**
53
+ * Create an empty audio buffer or deep-copy an existing buffer.
54
+ * @zh 创建空音频缓冲区,或深复制现有缓冲区。
55
+ * @ja 空の音声バッファーを作成するか、既存のバッファーをディープコピーします。
56
+ * @ko 빈 오디오 버퍼를 생성하거나 기존 버퍼를 깊은 복사합니다.
57
+ */
58
+ constructor(source?: ReadonlySoundBuffer);
59
+ /**
60
+ * Copy interleaved 16-bit PCM; sample rate is in Hz and channelMap specifies
61
+ * each channel's position.
62
+ * @zh 复制交错 16 位 PCM;采样率以 Hz 计,channelMap 指定各声道位置。
63
+ * @ja 16 ビットインターリーブ PCM をコピーします。サンプルレートは Hz、
64
+ * channelMap は各チャンネルの位置を指定します。
65
+ * @ko 16비트 인터리브 PCM을 복사합니다. 샘플 레이트는 Hz 단위이며
66
+ * channelMap은 각 채널 위치를 지정합니다.
67
+ */
68
+ constructor(samples: Int16Array, channelCount: number, sampleRate: number,
69
+ channelMap: Iterable<SoundChannel>);
70
+ constructor(source?: ReadonlySoundBuffer | Int16Array,
71
+ channelCount?: number, sampleRate?: number,
72
+ channelMap?: Iterable<SoundChannel>) {
73
+ let mapping: AudioBufferMapping & { handle: AudioHandle<'buffer'> };
74
+ if (source instanceof Int16Array) {
75
+ mapping = audioNative.createAudioBuffer(source, unsigned(sampleRate!),
76
+ unsigned(channelCount!), channels(channelMap!));
77
+ } else {
78
+ if (source !== undefined && !(source instanceof SoundBuffer)) {
79
+ throw new TypeError('Expected a SoundBuffer or Int16Array');
80
+ }
81
+ mapping = audioNative.createAudioBuffer(source?.[audioHandle]);
82
+ }
83
+ this[audioHandle] = mapping.handle;
84
+ this.state = view(mapping);
85
+ }
86
+ /**
87
+ * Copy the current source data synchronously, retaining this buffer's
88
+ * identity.
89
+ * @zh 同步复制源缓冲区的当前数据,保留当前缓冲区的身份。
90
+ * @ja 元バッファーの現在のデータを同期的にコピーし、
91
+ * このバッファーの同一性を保持します。
92
+ * @ko 원본 버퍼의 현재 데이터를 동기적으로 복사하며 이 버퍼의 정체성을 유지합니다.
93
+ */
94
+ assign(source: ReadonlySoundBuffer): this {
95
+ if (!(source instanceof SoundBuffer)) {
96
+ throw new TypeError('Expected a SoundBuffer');
97
+ }
98
+ if (source === this) return this;
99
+ this.state = view(audioNative.assignAudioBuffer(
100
+ this[audioHandle], source[audioHandle]));
101
+ return this;
102
+ }
103
+ /** @internal */
104
+ static [adoptAudioBuffer](data: AudioHandle<'bufferData'>): SoundBuffer {
105
+ const result = new SoundBuffer();
106
+ result.state = view(audioNative.commitAudioBuffer(result[audioHandle], data));
107
+ return result;
108
+ }
109
+ /**
110
+ * Asynchronously decode an entire audio file into native PCM storage,
111
+ * returning whether it succeeded.
112
+ * @zh 异步解码整个音频文件到原生 PCM 存储,返回是否成功。
113
+ * @ja 音声ファイル全体をネイティブ PCM ストレージに非同期でデコードし、
114
+ * 成功したかどうかを返します。
115
+ * @ko 전체 오디오 파일을 네이티브 PCM 저장소에 비동기로 디코딩하고
116
+ * 성공 여부를 반환합니다.
117
+ */
118
+ loadFromFile(filename: string): Promise<boolean> {
119
+ return audioReaders.size ? this.loadDecoded(filename) : this.load(filename);
120
+ }
121
+ /**
122
+ * Asynchronously decode encoded audio bytes and replace the PCM,
123
+ * returning whether it succeeded.
124
+ * @zh 异步解码编码音频字节并替换 PCM,返回是否成功。
125
+ * @ja エンコード済み音声バイトを非同期でデコードして PCM を置き換え、
126
+ * 成功したかどうかを返します。
127
+ * @ko 인코딩된 오디오 바이트를 비동기로 디코딩하여 PCM을 교체하고
128
+ * 성공 여부를 반환합니다.
129
+ */
130
+ loadFromMemory(data: Uint8Array): Promise<boolean> {
131
+ return audioReaders.size ? this.loadDecoded(data) : this.load(data);
132
+ }
133
+ /**
134
+ * Asynchronously decode all samples from an input stream, returning whether
135
+ * it succeeded; stream errors reject the Promise.
136
+ * @zh 从输入流异步解码全部样本,返回是否成功;流异常会拒绝 Promise。
137
+ * @ja 入力ストリームの全サンプルを非同期でデコードし、成功したかどうかを返します。
138
+ * ストリームの例外は Promise を拒否します。
139
+ * @ko 입력 스트림의 모든 샘플을 비동기로 디코딩하고 성공 여부를 반환합니다.
140
+ * 스트림 오류는 Promise를 거부합니다.
141
+ */
142
+ loadFromStream(stream: InputStream): Promise<boolean> {
143
+ return audioReaders.size ? this.loadDecoded(stream)
144
+ : this.load(new AudioInputStream(stream));
145
+ }
146
+
147
+ /**
148
+ * Synchronously copy interleaved 16-bit PCM and replace the contents;
149
+ * sampleRate is in Hz. Return whether it succeeded.
150
+ * @zh 同步复制交错 16 位 PCM 并替换内容;sampleRate 为 Hz,返回是否成功。
151
+ * @ja 16 ビットインターリーブ PCM を同期的にコピーして内容を置き換えます。
152
+ * sampleRate は Hz で、成功したかどうかを返します。
153
+ * @ko 16비트 인터리브 PCM을 동기적으로 복사하여 내용을 교체합니다.
154
+ * sampleRate는 Hz 단위이며 성공 여부를 반환합니다.
155
+ */
156
+ loadFromSamples(data: Int16Array, channelCount: number, sampleRate: number,
157
+ channelMap: Iterable<SoundChannel>): boolean {
158
+ samples(data);
159
+ const result = audioNative.audioBufferSamples(data, unsigned(sampleRate),
160
+ unsigned(channelCount), channels(channelMap));
161
+ if (!result) return false;
162
+ this.state = view(audioNative.commitAudioBuffer(this[audioHandle], result));
163
+ return true;
164
+ }
165
+ /**
166
+ * Return a read-only typed PCM view, or undefined for an empty buffer.
167
+ * After reloading, existing views still reference the old storage.
168
+ * @zh 返回 PCM 只读类型视图;空缓冲区为 undefined,
169
+ * 重新加载后旧视图仍指向旧存储。
170
+ * @ja PCM の読み取り専用型ビューを返します。空のバッファーでは undefined。
171
+ * 再読み込み後も既存のビューは以前のストレージを参照します。
172
+ * @ko PCM의 읽기 전용 타입 뷰를 반환하며, 빈 버퍼이면 undefined입니다.
173
+ * 다시 로드한 후에도 기존 뷰는 이전 저장소를 참조합니다.
174
+ */
175
+ getSamples(): ReadonlySamples | undefined {
176
+ return this.state.samples.length ? this.state.samples : undefined;
177
+ }
178
+ /**
179
+ * Return the total sample count across all channels.
180
+ * @zh 返回所有声道合计的样本数量。
181
+ * @ja 全チャンネルのサンプル総数を返します。
182
+ * @ko 모든 채널의 샘플 총수를 반환합니다.
183
+ */
184
+ getSampleCount(): bigint { return this.state.sampleCount; }
185
+ /**
186
+ * Return the sample rate per channel, in Hz.
187
+ * @zh 返回每声道采样率,单位为 Hz。
188
+ * @ja チャンネルごとのサンプルレートを Hz で返します。
189
+ * @ko 채널별 샘플 레이트를 Hz 단위로 반환합니다.
190
+ */
191
+ getSampleRate(): number { return this.state.sampleRate; }
192
+ /**
193
+ * Return the number of channels.
194
+ * @zh 返回声道数量。
195
+ * @ja チャンネル数を返します。
196
+ * @ko 채널 수를 반환합니다.
197
+ */
198
+ getChannelCount(): number { return this.state.channelCount; }
199
+ /**
200
+ * Return a read-only view of channel positions in interleaved order.
201
+ * @zh 返回交错声道位置顺序的只读视图。
202
+ * @ja インターリーブ順のチャンネル位置の読み取り専用ビューを返します。
203
+ * @ko 인터리브 순서의 채널 위치를 나타내는 읽기 전용 뷰를 반환합니다.
204
+ */
205
+ getChannelMap(): ChannelMap { return this.state.channelMap; }
206
+ /**
207
+ * Return a copy of the total audio duration.
208
+ * @zh 返回音频总时长副本。
209
+ * @ja 音声全体の長さのコピーを返します。
210
+ * @ko 오디오 전체 길이의 복사본을 반환합니다.
211
+ */
212
+ getDuration(): Time { return new Time(this.state.duration); }
213
+ /**
214
+ * Asynchronously encode and save using the file extension to select the
215
+ * format, returning whether it succeeded.
216
+ * @zh 按文件扩展名异步编码保存,返回是否成功。
217
+ * @ja ファイルの拡張子に基づいて非同期でエンコード・保存し、
218
+ * 成功したかどうかを返します。
219
+ * @ko 파일 확장자에 따라 비동기로 인코딩하여 저장하고 성공 여부를 반환합니다.
220
+ */
221
+ saveToFile(filename: string): Promise<boolean> {
222
+ if (audioWriters.size) {
223
+ return this.queue.run(async () => {
224
+ const output = new OutputSoundFile();
225
+ try {
226
+ const ok = await output.openFromFile(filename, this.getSampleRate(),
227
+ this.getChannelCount(), this.getChannelMap());
228
+ if (!ok) return false;
229
+ if (this.state.samples.length) await output.write(this.state.samples);
230
+ return true;
231
+ } finally { await output.close(); }
232
+ });
233
+ }
234
+ return this.queue.run(() => audioAsync(callback =>
235
+ audioNative.saveAudioBuffer(this[audioHandle], filename, callback)));
236
+ }
237
+ private loadDecoded(input: string | Uint8Array | InputStream):
238
+ Promise<boolean> {
239
+ return this.queue.run(async () => {
240
+ const file = new InputSoundFile();
241
+ try {
242
+ const ok = typeof input === 'string' ? await file.openFromFile(input)
243
+ : input instanceof Uint8Array ? await file.openFromMemory(input)
244
+ : await file.openFromStream(input);
245
+ if (!ok) return false;
246
+ const count = file.getSampleCount();
247
+ if (count > 0xffffffffn) throw new RangeError('Sample buffer is too large');
248
+ const data = new Int16Array(
249
+ audioNative.allocateAudioSamples(Number(count)));
250
+ let position = 0;
251
+ while (position < data.length) {
252
+ const read = Number(await file.read(data.subarray(position)));
253
+ if (!read) return false;
254
+ position += read;
255
+ }
256
+ return this.loadFromSamples(data, file.getChannelCount(),
257
+ file.getSampleRate(), file.getChannelMap());
258
+ } finally { await file.close(); }
259
+ });
260
+ }
261
+ private load(input: string | Uint8Array | AudioInputStream): Promise<boolean> {
262
+ return this.queue.run(async () => {
263
+ const stream = input instanceof AudioInputStream ? input : undefined;
264
+ try {
265
+ const load = () => audioAsync<AudioHandle<'bufferData'> | undefined>(
266
+ callback => audioNative.loadAudioBuffer(
267
+ stream ? stream.handle : input as string | Uint8Array, callback));
268
+ const data = await (stream ? stream.run(load) : load());
269
+ if (!data) return false;
270
+ this.state = view(audioNative.commitAudioBuffer(this[audioHandle], data));
271
+ return true;
272
+ } finally { stream?.close(); }
273
+ });
274
+ }
275
+ }
@@ -0,0 +1,235 @@
1
+ import {
2
+ audioNative, audioAsync, AudioQueue, type AudioHandle,
3
+ type AudioReaderInfoMapping,
4
+ } from '../internal/audio-native';
5
+ import { AudioInputStream } from '../internal/audio-input-stream';
6
+ import {
7
+ audioReaders, audioWriters, findAudioReaderInput, findAudioWriter,
8
+ } from '../internal/audio-codec-registry';
9
+ import { SoundFileReader, SoundFileReaderInfo,
10
+ type SoundFileReaderConstructor } from './sound-file-reader';
11
+ import { SoundFileWriter,
12
+ type SoundFileWriterConstructor } from './sound-file-writer';
13
+ import { channels, unsigned, samples, type SoundChannel } from './value';
14
+ import type { InputStream } from '../system/input-stream';
15
+
16
+ class NativeReader extends SoundFileReader {
17
+ private readonly queue = new AudioQueue();
18
+ private stream?: AudioInputStream;
19
+ constructor(private readonly handle: AudioHandle<'reader'>) { super(); }
20
+ open(stream: InputStream): Promise<SoundFileReaderInfo | undefined> {
21
+ return this.queue.run(async () => {
22
+ const next = new AudioInputStream(stream);
23
+ try {
24
+ if (await stream.seek(0n) !== 0n) return undefined;
25
+ const mapping = await next.run(() =>
26
+ audioAsync<AudioReaderInfoMapping | undefined>(callback =>
27
+ audioNative.openAudioReader(this.handle, next.handle, callback)));
28
+ if (!mapping) return undefined;
29
+ this.stream?.close();
30
+ this.stream = next;
31
+ return new SoundFileReaderInfo(undefined, mapping);
32
+ } finally {
33
+ if (this.stream !== next) next.close();
34
+ }
35
+ });
36
+ }
37
+ read(data: Int16Array): Promise<bigint> {
38
+ samples(data);
39
+ return this.queue.run(() => this.run(() => audioAsync(callback =>
40
+ audioNative.readAudioReader(this.handle, data, callback))));
41
+ }
42
+ seek(offset: bigint): Promise<void> {
43
+ return this.queue.run(() => this.run(() => audioAsync(callback =>
44
+ audioNative.seekAudioReader(this.handle, offset, callback))));
45
+ }
46
+ close(): Promise<void> {
47
+ return this.queue.run(async () => {
48
+ await audioAsync<void>(callback =>
49
+ audioNative.closeAudioReader(this.handle, callback));
50
+ this.stream?.close();
51
+ this.stream = undefined;
52
+ });
53
+ }
54
+ private run<T>(action: () => Promise<T>): Promise<T> {
55
+ return this.stream ? this.stream.run(action) : action();
56
+ }
57
+ }
58
+
59
+ class NativeWriter extends SoundFileWriter {
60
+ private readonly queue = new AudioQueue();
61
+ private opened = false;
62
+ constructor(private readonly handle: AudioHandle<'writer'>) { super(); }
63
+ open(filename: string, rate: number, count: number,
64
+ map: Iterable<SoundChannel>): Promise<boolean> {
65
+ const channelMap = channels(map);
66
+ unsigned(rate);
67
+ unsigned(count);
68
+ return this.queue.run(async () => {
69
+ this.opened = await audioAsync<boolean>(callback =>
70
+ audioNative.openAudioWriter(this.handle, filename, rate, count,
71
+ channelMap, callback));
72
+ return this.opened;
73
+ });
74
+ }
75
+ write(data: Int16Array): Promise<void> {
76
+ samples(data);
77
+ return this.queue.run(async () => {
78
+ if (!this.opened) throw new Error('Writer is not open');
79
+ await audioAsync<void>(callback =>
80
+ audioNative.writeAudioWriter(this.handle, data, callback));
81
+ });
82
+ }
83
+ close(): Promise<void> {
84
+ return this.queue.run(async () => {
85
+ await audioAsync<void>(callback =>
86
+ audioNative.closeAudioWriter(this.handle, callback));
87
+ this.opened = false;
88
+ });
89
+ }
90
+ }
91
+
92
+ /**
93
+ * Registrations belong to the current Node environment.
94
+ * @zh 注册项属于当前 Node 环境。
95
+ * @ja 登録は現在の Node 環境に属します。
96
+ * @ko 등록 항목은 현재 Node 환경에 속합니다.
97
+ */
98
+ export class SoundFileFactory {
99
+ /**
100
+ * Register a custom decoder class with a static check method in the current
101
+ * Node environment.
102
+ * @zh 在当前 Node 环境注册带有静态 check 方法的自定义解码器类。
103
+ * @ja 静的 check メソッドを持つカスタムデコーダークラスを
104
+ * 現在の Node 環境に登録します。
105
+ * @ko 정적 check 메서드가 있는 사용자 정의 디코더 클래스를
106
+ * 현재 Node 환경에 등록합니다.
107
+ */
108
+ static registerReader(reader: SoundFileReaderConstructor): void {
109
+ if (typeof reader !== 'function' ||
110
+ !(reader.prototype instanceof SoundFileReader) ||
111
+ typeof reader.check !== 'function') {
112
+ throw new TypeError('Expected a SoundFileReader class with static check()');
113
+ }
114
+ audioReaders.add(reader);
115
+ }
116
+ /**
117
+ * Unregister a custom decoder class.
118
+ * @zh 取消自定义解码器类的注册。
119
+ * @ja カスタムデコーダークラスの登録を解除します。
120
+ * @ko 사용자 정의 디코더 클래스의 등록을 해제합니다.
121
+ */
122
+ static unregisterReader(reader: SoundFileReaderConstructor): void {
123
+ audioReaders.delete(reader);
124
+ }
125
+ /**
126
+ * Check whether a custom decoder class is registered.
127
+ * @zh 判断自定义解码器类是否已注册。
128
+ * @ja カスタムデコーダークラスが登録済みか判定します。
129
+ * @ko 사용자 정의 디코더 클래스의 등록 여부를 확인합니다.
130
+ */
131
+ static isReaderRegistered(reader: SoundFileReaderConstructor): boolean {
132
+ return audioReaders.has(reader);
133
+ }
134
+ /**
135
+ * Register a custom encoder class with a static check method in the current
136
+ * Node environment.
137
+ * @zh 在当前 Node 环境注册带有静态 check 方法的自定义编码器类。
138
+ * @ja 静的 check メソッドを持つカスタムエンコーダークラスを
139
+ * 現在の Node 環境に登録します。
140
+ * @ko 정적 check 메서드가 있는 사용자 정의 인코더 클래스를
141
+ * 현재 Node 환경에 등록합니다.
142
+ */
143
+ static registerWriter(writer: SoundFileWriterConstructor): void {
144
+ if (typeof writer !== 'function' ||
145
+ !(writer.prototype instanceof SoundFileWriter) ||
146
+ typeof writer.check !== 'function') {
147
+ throw new TypeError('Expected a SoundFileWriter class with static check()');
148
+ }
149
+ audioWriters.add(writer);
150
+ }
151
+ /**
152
+ * Unregister a custom encoder class.
153
+ * @zh 取消自定义编码器类的注册。
154
+ * @ja カスタムエンコーダークラスの登録を解除します。
155
+ * @ko 사용자 정의 인코더 클래스의 등록을 해제합니다.
156
+ */
157
+ static unregisterWriter(writer: SoundFileWriterConstructor): void {
158
+ audioWriters.delete(writer);
159
+ }
160
+ /**
161
+ * Check whether a custom encoder class is registered.
162
+ * @zh 判断自定义编码器类是否已注册。
163
+ * @ja カスタムエンコーダークラスが登録済みか判定します。
164
+ * @ko 사용자 정의 인코더 클래스의 등록 여부를 확인합니다.
165
+ */
166
+ static isWriterRegistered(writer: SoundFileWriterConstructor): boolean {
167
+ return audioWriters.has(writer);
168
+ }
169
+ /**
170
+ * Probe a file and create a matching decoder; return undefined if none
171
+ * matches. Calling open is still required before use.
172
+ * @zh 探测文件并创建匹配的解码器;未匹配返回 undefined,使用前仍需 open。
173
+ * @ja ファイルを判定して対応するデコーダーを作成します。
174
+ * 対応しない場合は undefined。使用前には別途 open が必要です。
175
+ * @ko 파일을 탐지하여 일치하는 디코더를 생성합니다.
176
+ * 일치 항목이 없으면 undefined이며, 사용 전 open을 호출해야 합니다.
177
+ */
178
+ static createReaderFromFilename(filename: string):
179
+ Promise<SoundFileReader | undefined> { return this.createReader(filename); }
180
+ /**
181
+ * Probe encoded audio bytes and create a matching decoder, or return
182
+ * undefined if none matches.
183
+ * @zh 探测编码音频字节并创建匹配的解码器,未匹配返回 undefined。
184
+ * @ja エンコード済み音声バイトを判定し、対応するデコーダーを作成します。
185
+ * 対応しない場合は undefined を返します。
186
+ * @ko 인코딩된 오디오 바이트를 탐지하여 일치하는 디코더를 생성합니다.
187
+ * 일치 항목이 없으면 undefined를 반환합니다.
188
+ */
189
+ static createReaderFromMemory(data: Uint8Array):
190
+ Promise<SoundFileReader | undefined> { return this.createReader(data); }
191
+ /**
192
+ * Probe stream contents and create a matching decoder, or return undefined
193
+ * if none matches.
194
+ * @zh 探测流内容并创建匹配的解码器,未匹配返回 undefined。
195
+ * @ja ストリームの内容を判定して対応するデコーダーを作成します。
196
+ * 対応しない場合は undefined を返します。
197
+ * @ko 스트림 내용을 탐지하여 일치하는 디코더를 생성합니다.
198
+ * 일치 항목이 없으면 undefined를 반환합니다.
199
+ */
200
+ static createReaderFromStream(stream: InputStream):
201
+ Promise<SoundFileReader | undefined> { return this.createReader(stream); }
202
+ /**
203
+ * Create an encoder by filename; return undefined if none matches.
204
+ * Calling open is still required before writing.
205
+ * @zh 按文件名创建编码器;未匹配返回 undefined,写入前仍需 open。
206
+ * @ja ファイル名からエンコーダーを作成します。対応しない場合は undefined。
207
+ * 書き込み前には別途 open が必要です。
208
+ * @ko 파일명을 기준으로 인코더를 생성합니다. 일치 항목이 없으면 undefined이며,
209
+ * 쓰기 전에 open을 호출해야 합니다.
210
+ */
211
+ static async createWriterFromFilename(filename: string):
212
+ Promise<SoundFileWriter | undefined> {
213
+ const custom = await findAudioWriter(filename);
214
+ if (custom) return custom;
215
+ const handle = audioNative.createAudioWriter(filename);
216
+ return handle ? new NativeWriter(handle) : undefined;
217
+ }
218
+ private static async createReader(input: string | Uint8Array | InputStream):
219
+ Promise<SoundFileReader | undefined> {
220
+ const custom = await findAudioReaderInput(input);
221
+ if (custom) {
222
+ await custom.owned?.close();
223
+ return custom.reader;
224
+ }
225
+ const bridge = typeof input === 'string' || input instanceof Uint8Array
226
+ ? undefined : new AudioInputStream(input);
227
+ try {
228
+ const create = () => audioAsync<AudioHandle<'reader'> | undefined>(
229
+ callback => audioNative.createAudioReader(
230
+ bridge ? bridge.handle : input as string | Uint8Array, callback));
231
+ const handle = await (bridge ? bridge.run(create) : create());
232
+ return handle ? new NativeReader(handle) : undefined;
233
+ } finally { bridge?.close(); }
234
+ }
235
+ }