sfml.js 0.0.1 → 1.0.0-rc.1

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 (696) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +24 -16
  3. package/binding.gyp +95 -183
  4. package/dist/audio/effect-processor.d.ts +22 -0
  5. package/dist/audio/effect-processor.js +28 -0
  6. package/dist/audio/input-sound-file.d.ts +52 -0
  7. package/dist/audio/input-sound-file.js +167 -0
  8. package/dist/audio/listener.d.ts +28 -0
  9. package/dist/audio/listener.js +86 -0
  10. package/dist/audio/music.d.ts +60 -0
  11. package/dist/audio/music.js +192 -0
  12. package/dist/audio/output-sound-file.d.ts +15 -0
  13. package/dist/audio/output-sound-file.js +70 -0
  14. package/dist/audio/playback-device.d.ts +35 -0
  15. package/dist/audio/playback-device.js +71 -0
  16. package/dist/audio/sound-buffer-recorder.d.ts +34 -0
  17. package/dist/audio/sound-buffer-recorder.js +62 -0
  18. package/dist/audio/sound-buffer.d.ts +45 -0
  19. package/dist/audio/sound-buffer.js +152 -0
  20. package/dist/audio/sound-file-factory.d.ts +27 -0
  21. package/dist/audio/sound-file-factory.js +152 -0
  22. package/dist/audio/sound-file-reader.d.ts +60 -0
  23. package/dist/audio/sound-file-reader.js +61 -0
  24. package/dist/audio/sound-file-writer.d.ts +17 -0
  25. package/dist/audio/sound-file-writer.js +9 -0
  26. package/dist/audio/sound-recorder.d.ts +60 -0
  27. package/dist/audio/sound-recorder.js +162 -0
  28. package/dist/audio/sound-source.d.ts +108 -0
  29. package/dist/audio/sound-source.js +161 -0
  30. package/dist/audio/sound-stream.d.ts +28 -0
  31. package/dist/audio/sound-stream.js +47 -0
  32. package/dist/audio/sound.d.ts +14 -0
  33. package/dist/audio/sound.js +39 -0
  34. package/dist/audio/value.d.ts +116 -0
  35. package/dist/audio/value.js +157 -0
  36. package/dist/audio/worker.d.ts +88 -0
  37. package/dist/audio/worker.js +2 -0
  38. package/dist/graphics/blend-mode.d.ts +82 -0
  39. package/dist/graphics/blend-mode.js +98 -0
  40. package/dist/graphics/boolean-vector.d.ts +48 -0
  41. package/dist/graphics/boolean-vector.js +116 -0
  42. package/dist/graphics/circle-shape.d.ts +27 -0
  43. package/dist/graphics/circle-shape.js +41 -0
  44. package/dist/graphics/color.d.ts +93 -0
  45. package/dist/graphics/color.js +146 -0
  46. package/dist/graphics/convex-shape.d.ts +18 -0
  47. package/dist/graphics/convex-shape.js +33 -0
  48. package/dist/graphics/drawable.d.ts +9 -0
  49. package/dist/graphics/drawable.js +15 -0
  50. package/dist/graphics/font.d.ts +70 -0
  51. package/dist/graphics/font.js +221 -0
  52. package/dist/graphics/glsl-matrix.d.ts +25 -0
  53. package/dist/graphics/glsl-matrix.js +69 -0
  54. package/dist/graphics/glsl.d.ts +57 -0
  55. package/dist/graphics/glsl.js +112 -0
  56. package/dist/graphics/glyph.d.ts +44 -0
  57. package/dist/graphics/glyph.js +74 -0
  58. package/dist/graphics/image.d.ts +57 -0
  59. package/dist/graphics/image.js +181 -0
  60. package/dist/graphics/primitive-type.d.ts +16 -0
  61. package/dist/graphics/primitive-type.js +25 -0
  62. package/dist/graphics/rect.d.ts +67 -0
  63. package/dist/graphics/rect.js +164 -0
  64. package/dist/graphics/rectangle-shape.d.ts +18 -0
  65. package/dist/graphics/rectangle-shape.js +34 -0
  66. package/dist/graphics/render-states.d.ts +60 -0
  67. package/dist/graphics/render-states.js +74 -0
  68. package/dist/graphics/render-target.d.ts +99 -0
  69. package/dist/graphics/render-target.js +341 -0
  70. package/dist/graphics/render-texture.d.ts +46 -0
  71. package/dist/graphics/render-texture.js +120 -0
  72. package/dist/graphics/render-window.d.ts +49 -0
  73. package/dist/graphics/render-window.js +106 -0
  74. package/dist/graphics/shader.d.ts +63 -0
  75. package/dist/graphics/shader.js +215 -0
  76. package/dist/graphics/shape.d.ts +77 -0
  77. package/dist/graphics/shape.js +180 -0
  78. package/dist/graphics/sprite.d.ts +44 -0
  79. package/dist/graphics/sprite.js +116 -0
  80. package/dist/graphics/stencil-mode.d.ts +69 -0
  81. package/dist/graphics/stencil-mode.js +72 -0
  82. package/dist/graphics/swap.d.ts +6 -0
  83. package/dist/graphics/swap.js +16 -0
  84. package/dist/graphics/text.d.ts +238 -0
  85. package/dist/graphics/text.js +354 -0
  86. package/dist/graphics/texture.d.ts +78 -0
  87. package/dist/graphics/texture.js +274 -0
  88. package/dist/graphics/transform.d.ts +50 -0
  89. package/dist/graphics/transform.js +195 -0
  90. package/dist/graphics/transformable.d.ts +13 -0
  91. package/dist/graphics/transformable.js +27 -0
  92. package/dist/graphics/vertex-array.d.ts +54 -0
  93. package/dist/graphics/vertex-array.js +176 -0
  94. package/dist/graphics/vertex-buffer.d.ts +69 -0
  95. package/dist/graphics/vertex-buffer.js +167 -0
  96. package/dist/graphics/vertex.d.ts +42 -0
  97. package/dist/graphics/vertex.js +98 -0
  98. package/dist/graphics/view.d.ts +54 -0
  99. package/dist/graphics/view.js +209 -0
  100. package/dist/index.d.ts +116 -0
  101. package/dist/index.js +251 -0
  102. package/dist/internal/audio-codec-registry.d.ts +13 -0
  103. package/dist/internal/audio-codec-registry.js +64 -0
  104. package/dist/internal/audio-input-stream.d.ts +13 -0
  105. package/dist/internal/audio-input-stream.js +44 -0
  106. package/dist/internal/audio-music-pump.d.ts +63 -0
  107. package/dist/internal/audio-music-pump.js +193 -0
  108. package/dist/internal/audio-native.d.ts +145 -0
  109. package/dist/internal/audio-native.js +24 -0
  110. package/dist/internal/audio-recorder-session.d.ts +77 -0
  111. package/dist/internal/audio-recorder-session.js +182 -0
  112. package/dist/internal/audio-worker-session.d.ts +18 -0
  113. package/dist/internal/audio-worker-session.js +82 -0
  114. package/dist/internal/audio-worker.d.ts +1 -0
  115. package/dist/internal/audio-worker.js +134 -0
  116. package/dist/internal/glsl-value.d.ts +26 -0
  117. package/dist/internal/glsl-value.js +44 -0
  118. package/dist/internal/graphics-state.d.ts +45 -0
  119. package/dist/internal/graphics-state.js +123 -0
  120. package/dist/internal/input-stream.d.ts +4 -0
  121. package/dist/internal/input-stream.js +25 -0
  122. package/dist/internal/lazy-value.d.ts +17 -0
  123. package/dist/internal/lazy-value.js +43 -0
  124. package/dist/internal/native.d.ts +317 -0
  125. package/dist/internal/native.js +8 -0
  126. package/dist/internal/numeric-properties.d.ts +2 -0
  127. package/dist/internal/numeric-properties.js +39 -0
  128. package/dist/internal/render-states.d.ts +4 -0
  129. package/dist/internal/render-states.js +44 -0
  130. package/dist/internal/scalar.d.ts +44 -0
  131. package/dist/internal/scalar.js +95 -0
  132. package/dist/internal/shaped-glyph.d.ts +32 -0
  133. package/dist/internal/shaped-glyph.js +51 -0
  134. package/dist/internal/struct-view.d.ts +11 -0
  135. package/dist/internal/struct-view.js +39 -0
  136. package/dist/internal/text-indices.d.ts +7 -0
  137. package/dist/internal/text-indices.js +22 -0
  138. package/dist/internal/transformable.d.ts +53 -0
  139. package/dist/internal/transformable.js +121 -0
  140. package/dist/internal/value-storage.d.ts +26 -0
  141. package/dist/internal/value-storage.js +21 -0
  142. package/dist/network/common.d.ts +18 -0
  143. package/dist/network/common.js +73 -0
  144. package/dist/network/dns.d.ts +35 -0
  145. package/dist/network/dns.js +93 -0
  146. package/dist/network/ftp.d.ts +81 -0
  147. package/dist/network/ftp.js +233 -0
  148. package/dist/network/gen/constants.d.ts +252 -0
  149. package/dist/network/gen/constants.js +260 -0
  150. package/dist/network/http.d.ts +150 -0
  151. package/dist/network/http.js +424 -0
  152. package/dist/network/ip-address.d.ts +57 -0
  153. package/dist/network/ip-address.js +161 -0
  154. package/dist/network/packet.d.ts +78 -0
  155. package/dist/network/packet.js +238 -0
  156. package/dist/network/sftp.d.ts +220 -0
  157. package/dist/network/sftp.js +557 -0
  158. package/dist/network/socket-selector.d.ts +38 -0
  159. package/dist/network/socket-selector.js +125 -0
  160. package/dist/network/socket.d.ts +89 -0
  161. package/dist/network/socket.js +225 -0
  162. package/dist/network/tcp-listener.d.ts +36 -0
  163. package/dist/network/tcp-listener.js +126 -0
  164. package/dist/network/tcp-socket.d.ts +108 -0
  165. package/dist/network/tcp-socket.js +362 -0
  166. package/dist/network/tls-material.d.ts +6 -0
  167. package/dist/network/tls-material.js +36 -0
  168. package/dist/network/udp-socket.d.ts +60 -0
  169. package/dist/network/udp-socket.js +197 -0
  170. package/dist/system/angle.d.ts +27 -0
  171. package/dist/system/angle.js +72 -0
  172. package/dist/system/clock.d.ts +22 -0
  173. package/dist/system/clock.js +56 -0
  174. package/dist/system/err.d.ts +6 -0
  175. package/dist/system/err.js +49 -0
  176. package/dist/system/error.d.ts +5 -0
  177. package/dist/system/error.js +12 -0
  178. package/dist/system/file-input-stream.d.ts +21 -0
  179. package/dist/system/file-input-stream.js +101 -0
  180. package/dist/system/input-stream.d.ts +30 -0
  181. package/dist/system/input-stream.js +54 -0
  182. package/dist/system/operators.d.ts +164 -0
  183. package/dist/system/operators.js +402 -0
  184. package/dist/system/sleep.d.ts +4 -0
  185. package/dist/system/sleep.js +23 -0
  186. package/dist/system/suspend-aware-clock.d.ts +7 -0
  187. package/dist/system/suspend-aware-clock.js +14 -0
  188. package/dist/system/time.d.ts +31 -0
  189. package/dist/system/time.js +134 -0
  190. package/dist/system/timeout-with-predicate.d.ts +19 -0
  191. package/dist/system/timeout-with-predicate.js +35 -0
  192. package/dist/system/unicode.d.ts +18 -0
  193. package/dist/system/unicode.js +31 -0
  194. package/dist/system/vector2.d.ts +98 -0
  195. package/dist/system/vector2.js +225 -0
  196. package/dist/system/vector3.d.ts +83 -0
  197. package/dist/system/vector3.js +178 -0
  198. package/dist/system/version.d.ts +15 -0
  199. package/dist/system/version.js +18 -0
  200. package/dist/window/clipboard.d.ts +4 -0
  201. package/dist/window/clipboard.js +16 -0
  202. package/dist/window/context-settings.d.ts +29 -0
  203. package/dist/window/context-settings.js +59 -0
  204. package/dist/window/context.d.ts +27 -0
  205. package/dist/window/context.js +77 -0
  206. package/dist/window/cursor.d.ts +20 -0
  207. package/dist/window/cursor.js +56 -0
  208. package/dist/window/event.d.ts +176 -0
  209. package/dist/window/event.js +57 -0
  210. package/dist/window/gen/constants.d.ts +637 -0
  211. package/dist/window/gen/constants.js +651 -0
  212. package/dist/window/joystick.d.ts +25 -0
  213. package/dist/window/joystick.js +44 -0
  214. package/dist/window/keyboard.d.ts +14 -0
  215. package/dist/window/keyboard.js +37 -0
  216. package/dist/window/mouse.d.ts +10 -0
  217. package/dist/window/mouse.js +36 -0
  218. package/dist/window/sensor.d.ts +9 -0
  219. package/dist/window/sensor.js +23 -0
  220. package/dist/window/touch.d.ts +12 -0
  221. package/dist/window/touch.js +29 -0
  222. package/dist/window/video-mode.d.ts +26 -0
  223. package/dist/window/video-mode.js +69 -0
  224. package/dist/window/vulkan.d.ts +9 -0
  225. package/dist/window/vulkan.js +22 -0
  226. package/dist/window/window.d.ts +103 -0
  227. package/dist/window/window.js +227 -0
  228. package/docs/api.md +1113 -0
  229. package/docs/audio.md +212 -0
  230. package/docs/development.md +77 -0
  231. package/docs/network.md +169 -0
  232. package/native/addon.cc +129 -0
  233. package/native/audio-binding.cc +543 -0
  234. package/native/audio-codec-binding.cc +246 -0
  235. package/native/audio-device-binding.cc +160 -0
  236. package/native/audio-file-binding.cc +192 -0
  237. package/native/audio-recorder-binding.cc +237 -0
  238. package/native/audio-recorder.h +39 -0
  239. package/native/audio-state.h +220 -0
  240. package/native/audio-stream-binding.cc +284 -0
  241. package/native/audio-stream.h +28 -0
  242. package/native/audio-worker-binding.cc +447 -0
  243. package/native/audio-worker.h +121 -0
  244. package/native/batch-drawable.cc +189 -0
  245. package/native/batch-drawable.h +57 -0
  246. package/native/context-binding.cc +180 -0
  247. package/native/context-settings.h +74 -0
  248. package/native/deferred-delete.cc +49 -0
  249. package/native/deferred-delete.h +84 -0
  250. package/native/error-stream-binding.cc +270 -0
  251. package/native/exception-boundary.h +97 -0
  252. package/native/font-binding.cc +210 -0
  253. package/native/font-state.h +27 -0
  254. package/native/graphics-binding.cc +338 -0
  255. package/native/graphics-state.h +253 -0
  256. package/native/image-binding.cc +258 -0
  257. package/native/image-state.h +93 -0
  258. package/native/input-binding.cc +246 -0
  259. package/native/numeric-fields.h +96 -0
  260. package/native/render-window-binding.cc +103 -0
  261. package/native/render-window-state.h +22 -0
  262. package/native/shader-binding.cc +292 -0
  263. package/native/shape-binding.cc +283 -0
  264. package/native/shape-state.h +68 -0
  265. package/native/shaped-glyph-storage.h +45 -0
  266. package/native/shared-handle.h +69 -0
  267. package/native/stream-binding.cc +286 -0
  268. package/native/system-binding.cc +91 -0
  269. package/native/text-binding.cc +205 -0
  270. package/native/text-state.h +101 -0
  271. package/native/texture-binding.cc +330 -0
  272. package/native/texture-resource.h +52 -0
  273. package/native/time-value.h +28 -0
  274. package/native/transformable-binding.cc +23 -0
  275. package/native/transformable-state.h +44 -0
  276. package/native/value-binding.h +200 -0
  277. package/native/value-layout.h +116 -0
  278. package/native/values-binding.cc +27 -0
  279. package/native/vertex-binding.cc +50 -0
  280. package/native/vertex-buffer-binding.cc +232 -0
  281. package/native/vertex-storage.h +20 -0
  282. package/native/view-data.h +24 -0
  283. package/native/window-binding.cc +388 -0
  284. package/native/window-event.h +92 -0
  285. package/native/window-owner.h +81 -0
  286. package/package.json +77 -35
  287. package/src/audio/effect-processor.ts +41 -0
  288. package/src/audio/input-sound-file.ts +173 -0
  289. package/src/audio/listener.ts +74 -0
  290. package/src/audio/music.ts +191 -0
  291. package/src/audio/output-sound-file.ts +64 -0
  292. package/src/audio/playback-device.ts +59 -0
  293. package/src/audio/sound-buffer-recorder.ts +61 -0
  294. package/src/audio/sound-buffer.ts +170 -0
  295. package/src/audio/sound-file-factory.ts +162 -0
  296. package/src/audio/sound-file-reader.ts +93 -0
  297. package/src/audio/sound-file-writer.ts +19 -0
  298. package/src/audio/sound-recorder.ts +180 -0
  299. package/src/audio/sound-source.ts +168 -0
  300. package/src/audio/sound-stream.ts +60 -0
  301. package/src/audio/sound.ts +36 -0
  302. package/src/audio/value.ts +165 -0
  303. package/src/audio/worker.ts +90 -0
  304. package/src/graphics/blend-mode.ts +125 -0
  305. package/src/graphics/boolean-vector.ts +139 -0
  306. package/src/graphics/circle-shape.ts +56 -0
  307. package/src/graphics/color.ts +189 -0
  308. package/src/graphics/convex-shape.ts +38 -0
  309. package/src/graphics/drawable.ts +19 -0
  310. package/src/graphics/font.ts +248 -0
  311. package/src/graphics/glsl-matrix.ts +73 -0
  312. package/src/graphics/glsl.ts +121 -0
  313. package/src/graphics/glyph.ts +97 -0
  314. package/src/graphics/image.ts +231 -0
  315. package/src/graphics/primitive-type.ts +21 -0
  316. package/src/graphics/rect.ts +214 -0
  317. package/src/graphics/rectangle-shape.ts +39 -0
  318. package/src/graphics/render-states.ts +110 -0
  319. package/src/graphics/render-target.ts +431 -0
  320. package/src/graphics/render-texture.ts +150 -0
  321. package/src/graphics/render-window.ts +155 -0
  322. package/src/graphics/shader.ts +224 -0
  323. package/src/graphics/shape.ts +231 -0
  324. package/src/graphics/sprite.ts +143 -0
  325. package/src/graphics/stencil-mode.ts +97 -0
  326. package/src/graphics/swap.ts +17 -0
  327. package/src/graphics/text.ts +423 -0
  328. package/src/graphics/texture.ts +352 -0
  329. package/src/graphics/transform.ts +242 -0
  330. package/src/graphics/transformable.ts +26 -0
  331. package/src/graphics/vertex-array.ts +201 -0
  332. package/src/graphics/vertex-buffer.ts +209 -0
  333. package/src/graphics/vertex.ts +142 -0
  334. package/src/graphics/view.ts +237 -0
  335. package/src/index.ts +147 -0
  336. package/src/internal/audio-codec-registry.ts +68 -0
  337. package/src/internal/audio-input-stream.ts +42 -0
  338. package/src/internal/audio-music-pump.ts +199 -0
  339. package/src/internal/audio-native.ts +176 -0
  340. package/src/internal/audio-recorder-session.ts +234 -0
  341. package/src/internal/audio-worker-session.ts +89 -0
  342. package/src/internal/audio-worker.ts +146 -0
  343. package/src/internal/glsl-value.ts +54 -0
  344. package/src/internal/graphics-state.ts +131 -0
  345. package/src/internal/input-stream.ts +30 -0
  346. package/src/internal/lazy-value.ts +62 -0
  347. package/src/internal/native.ts +581 -0
  348. package/src/internal/numeric-properties.ts +37 -0
  349. package/src/internal/render-states.ts +42 -0
  350. package/src/internal/scalar.ts +109 -0
  351. package/src/internal/shaped-glyph.ts +68 -0
  352. package/src/internal/struct-view.ts +49 -0
  353. package/src/internal/text-indices.ts +19 -0
  354. package/src/internal/transformable.ts +189 -0
  355. package/src/internal/value-storage.ts +33 -0
  356. package/src/network/common.ts +53 -0
  357. package/src/network/dns.ts +102 -0
  358. package/src/network/ftp.ts +202 -0
  359. package/src/network/gen/constants.ts +253 -0
  360. package/src/network/http.ts +372 -0
  361. package/src/network/ip-address.ts +158 -0
  362. package/src/network/packet.ts +217 -0
  363. package/src/network/sftp.ts +574 -0
  364. package/src/network/socket-selector.ts +112 -0
  365. package/src/network/socket.ts +203 -0
  366. package/src/network/tcp-listener.ts +115 -0
  367. package/src/network/tcp-socket.ts +370 -0
  368. package/src/network/tls-material.ts +30 -0
  369. package/src/network/udp-socket.ts +176 -0
  370. package/src/system/angle.ts +82 -0
  371. package/src/system/clock.ts +61 -0
  372. package/src/system/err.ts +46 -0
  373. package/src/system/error.ts +8 -0
  374. package/src/system/file-input-stream.ts +100 -0
  375. package/src/system/input-stream.ts +66 -0
  376. package/src/system/operators.ts +554 -0
  377. package/src/system/sleep.ts +20 -0
  378. package/src/system/suspend-aware-clock.ts +12 -0
  379. package/src/system/time.ts +149 -0
  380. package/src/system/timeout-with-predicate.ts +53 -0
  381. package/src/system/unicode.ts +28 -0
  382. package/src/system/vector2.ts +345 -0
  383. package/src/system/vector3.ts +267 -0
  384. package/src/system/version.ts +30 -0
  385. package/src/window/clipboard.ts +12 -0
  386. package/src/window/context-settings.ts +78 -0
  387. package/src/window/context.ts +92 -0
  388. package/src/window/cursor.ts +78 -0
  389. package/src/window/event.ts +227 -0
  390. package/src/window/gen/constants.ts +655 -0
  391. package/src/window/joystick.ts +52 -0
  392. package/src/window/keyboard.ts +42 -0
  393. package/src/window/mouse.ts +37 -0
  394. package/src/window/sensor.ts +20 -0
  395. package/src/window/touch.ts +27 -0
  396. package/src/window/video-mode.ts +85 -0
  397. package/src/window/vulkan.ts +19 -0
  398. package/src/window/window.ts +311 -0
  399. package/test/native/audio-probes.cc +181 -0
  400. package/test/native/deferred-delete-probes.cc +62 -0
  401. package/test/native/drawable-probes.cc +168 -0
  402. package/test/native/exception-probes.cc +83 -0
  403. package/test/native/image-probes.cc +105 -0
  404. package/test/native/matrix-probes.cc +67 -0
  405. package/test/native/network-oracle.cc +32 -0
  406. package/test/native/render-texture-probes.cc +193 -0
  407. package/test/native/shader-probes.cc +69 -0
  408. package/test/native/shape-probes.cc +160 -0
  409. package/test/native/sprite-probes.cc +146 -0
  410. package/test/native/system-probes.cc +109 -0
  411. package/test/native/text-probes.cc +211 -0
  412. package/test/native/texture-probes.cc +200 -0
  413. package/test/native/time-probes.cc +143 -0
  414. package/test/native/transform-probes.cc +92 -0
  415. package/test/native/transformable-probes.cc +152 -0
  416. package/test/native/value-oracle.h +88 -0
  417. package/test/native/value-probes.cc +379 -0
  418. package/test/native/vertex-array-probes.cc +82 -0
  419. package/test/native/vertex-buffer-probes.cc +87 -0
  420. package/test/native/view-probes.cc +150 -0
  421. package/test/native/window-probes.cc +172 -0
  422. package/test/tsconfig.json +8 -0
  423. package/tools/configure-lsp.cjs +23 -0
  424. package/tools/generate-network-constants.cjs +47 -0
  425. package/tools/generate-window-constants.cjs +164 -0
  426. package/tools/lib_downloader.cjs +92 -0
  427. package/tools/lib_downloader_urls.cjs +23 -0
  428. package/tsconfig.json +11 -4
  429. package/index.d.ts +0 -1
  430. package/lib/clock.d.ts +0 -8
  431. package/lib/clock.js +0 -5
  432. package/lib/color.d.ts +0 -11
  433. package/lib/color.js +0 -98
  434. package/lib/common.js +0 -47
  435. package/lib/drawable/circle_shape.d.ts +0 -5
  436. package/lib/drawable/circle_shape.js +0 -26
  437. package/lib/drawable/convex_shape.d.ts +0 -5
  438. package/lib/drawable/convex_shape.js +0 -35
  439. package/lib/drawable/drawable.d.ts +0 -6
  440. package/lib/drawable/drawable.js +0 -18
  441. package/lib/drawable/plugin_package.d.ts +0 -31
  442. package/lib/drawable/plugin_package.js +0 -102
  443. package/lib/drawable/rectangle_shape.d.ts +0 -9
  444. package/lib/drawable/rectangle_shape.js +0 -28
  445. package/lib/drawable/shape.d.ts +0 -14
  446. package/lib/drawable/shape.js +0 -30
  447. package/lib/drawable/sprite.d.ts +0 -17
  448. package/lib/drawable/sprite.js +0 -53
  449. package/lib/drawable/text.d.ts +0 -26
  450. package/lib/drawable/text.js +0 -88
  451. package/lib/drawable/transformable.d.ts +0 -28
  452. package/lib/drawable/transformable.js +0 -113
  453. package/lib/drawable/vertex_array.d.ts +0 -40
  454. package/lib/drawable/vertex_array.js +0 -128
  455. package/lib/font.d.ts +0 -24
  456. package/lib/font.js +0 -137
  457. package/lib/image.d.ts +0 -26
  458. package/lib/image.js +0 -147
  459. package/lib/joystick.d.ts +0 -21
  460. package/lib/joystick.js +0 -72
  461. package/lib/keyboard.d.ts +0 -113
  462. package/lib/keyboard.js +0 -17
  463. package/lib/mouse.d.ts +0 -6
  464. package/lib/mouse.js +0 -39
  465. package/lib/poll_event.d.ts +0 -138
  466. package/lib/rect.d.ts +0 -18
  467. package/lib/rect.js +0 -119
  468. package/lib/render_window.d.ts +0 -67
  469. package/lib/render_window.js +0 -197
  470. package/lib/sensor.d.ts +0 -12
  471. package/lib/sensor.js +0 -34
  472. package/lib/sfml.d.ts +0 -32
  473. package/lib/sfml.js +0 -36
  474. package/lib/sound/base.d.ts +0 -33
  475. package/lib/sound/base.js +0 -109
  476. package/lib/sound/music.d.ts +0 -15
  477. package/lib/sound/music.js +0 -65
  478. package/lib/sound/sound.d.ts +0 -16
  479. package/lib/sound/sound.js +0 -55
  480. package/lib/sound/sound_buffer.d.ts +0 -14
  481. package/lib/sound/sound_buffer.js +0 -78
  482. package/lib/texture.d.ts +0 -21
  483. package/lib/texture.js +0 -127
  484. package/lib/time.d.ts +0 -13
  485. package/lib/time.js +0 -41
  486. package/lib/touch.d.ts +0 -7
  487. package/lib/touch.js +0 -34
  488. package/lib/vector2.d.ts +0 -49
  489. package/lib/vector2.js +0 -141
  490. package/lib/vector3.d.ts +0 -47
  491. package/lib/vector3.js +0 -154
  492. package/lib/vertex.d.ts +0 -14
  493. package/lib/vertex.js +0 -177
  494. package/lib/video_mode.d.ts +0 -12
  495. package/lib/video_mode.js +0 -99
  496. package/src/base_class_with_loading.h +0 -21
  497. package/src/clock.cc +0 -71
  498. package/src/clock.h +0 -30
  499. package/src/color.cc +0 -189
  500. package/src/color.h +0 -49
  501. package/src/drawable/circle_shape.cc +0 -78
  502. package/src/drawable/circle_shape.h +0 -28
  503. package/src/drawable/convex_shape.cc +0 -57
  504. package/src/drawable/convex_shape.h +0 -29
  505. package/src/drawable/drawable-inl.h +0 -29
  506. package/src/drawable/drawable.cc +0 -41
  507. package/src/drawable/drawable.h +0 -49
  508. package/src/drawable/package_plugin-inl.h +0 -191
  509. package/src/drawable/package_plugin.h +0 -60
  510. package/src/drawable/rectangle_shape.cc +0 -69
  511. package/src/drawable/rectangle_shape.h +0 -29
  512. package/src/drawable/shape.cc +0 -67
  513. package/src/drawable/shape.h +0 -39
  514. package/src/drawable/sprite.cc +0 -122
  515. package/src/drawable/sprite.h +0 -45
  516. package/src/drawable/text.cc +0 -133
  517. package/src/drawable/text.h +0 -54
  518. package/src/drawable/vertex_array.cc +0 -248
  519. package/src/drawable/vertex_array.h +0 -46
  520. package/src/font.cc +0 -214
  521. package/src/font.h +0 -44
  522. package/src/gen/.gitkeep +0 -0
  523. package/src/gen/joystick_axis.cc +0 -30
  524. package/src/gen/keycode.cc +0 -226
  525. package/src/gen/mouse_button.cc +0 -30
  526. package/src/gen/sensor_type.cc +0 -26
  527. package/src/image.cc +0 -379
  528. package/src/image.h +0 -72
  529. package/src/joystick.cc +0 -132
  530. package/src/joystick.h +0 -32
  531. package/src/keyboard.cc +0 -65
  532. package/src/keyboard.h +0 -27
  533. package/src/mouse.cc +0 -95
  534. package/src/mouse.h +0 -30
  535. package/src/plugins/transformable_plugin-inl.h +0 -121
  536. package/src/plugins/transformable_plugin.h +0 -42
  537. package/src/poll_event.cc +0 -326
  538. package/src/poll_event.h +0 -18
  539. package/src/rect-inl.h +0 -154
  540. package/src/rect.cc +0 -28
  541. package/src/rect.h +0 -105
  542. package/src/render_window.cc +0 -413
  543. package/src/render_window.h +0 -111
  544. package/src/render_window_async_display.cc +0 -49
  545. package/src/render_window_async_draw.cc +0 -56
  546. package/src/resizable_buffer.h +0 -104
  547. package/src/sensor.cc +0 -82
  548. package/src/sensor.h +0 -28
  549. package/src/sfml.cc +0 -85
  550. package/src/sound/music.cc +0 -113
  551. package/src/sound/music.h +0 -35
  552. package/src/sound/sound.cc +0 -116
  553. package/src/sound/sound.h +0 -41
  554. package/src/sound/sound_buffer.cc +0 -226
  555. package/src/sound/sound_buffer.h +0 -46
  556. package/src/sound/sound_source.cc +0 -124
  557. package/src/sound/sound_source.h +0 -80
  558. package/src/texture.cc +0 -246
  559. package/src/texture.h +0 -47
  560. package/src/time.cc +0 -177
  561. package/src/time.h +0 -42
  562. package/src/touch.cc +0 -54
  563. package/src/touch.h +0 -23
  564. package/src/utils-inl.h +0 -48
  565. package/src/utils.h +0 -21
  566. package/src/vector2-inl.h +0 -198
  567. package/src/vector2.cc +0 -36
  568. package/src/vector2.h +0 -133
  569. package/src/vector3-inl.h +0 -200
  570. package/src/vector3.cc +0 -36
  571. package/src/vector3.h +0 -134
  572. package/src/vertex.cc +0 -238
  573. package/src/vertex.h +0 -114
  574. package/src/video_mode.cc +0 -184
  575. package/src/video_mode.h +0 -38
  576. package/src/workers/load_from_file_worker.h +0 -79
  577. package/src/workers/save_to_file_worker.h +0 -79
  578. package/third_party/sfml/include/SFML/Audio/AlResource.hpp +0 -70
  579. package/third_party/sfml/include/SFML/Audio/Export.hpp +0 -48
  580. package/third_party/sfml/include/SFML/Audio/InputSoundFile.hpp +0 -268
  581. package/third_party/sfml/include/SFML/Audio/Listener.hpp +0 -234
  582. package/third_party/sfml/include/SFML/Audio/Music.hpp +0 -337
  583. package/third_party/sfml/include/SFML/Audio/OutputSoundFile.hpp +0 -133
  584. package/third_party/sfml/include/SFML/Audio/Sound.hpp +0 -264
  585. package/third_party/sfml/include/SFML/Audio/SoundBuffer.hpp +0 -352
  586. package/third_party/sfml/include/SFML/Audio/SoundBufferRecorder.hpp +0 -144
  587. package/third_party/sfml/include/SFML/Audio/SoundFileFactory.hpp +0 -197
  588. package/third_party/sfml/include/SFML/Audio/SoundFileFactory.inl +0 -100
  589. package/third_party/sfml/include/SFML/Audio/SoundFileReader.hpp +0 -165
  590. package/third_party/sfml/include/SFML/Audio/SoundFileWriter.hpp +0 -125
  591. package/third_party/sfml/include/SFML/Audio/SoundRecorder.hpp +0 -410
  592. package/third_party/sfml/include/SFML/Audio/SoundSource.hpp +0 -332
  593. package/third_party/sfml/include/SFML/Audio/SoundStream.hpp +0 -420
  594. package/third_party/sfml/include/SFML/Audio.hpp +0 -56
  595. package/third_party/sfml/include/SFML/Config.hpp +0 -248
  596. package/third_party/sfml/include/SFML/GpuPreference.hpp +0 -74
  597. package/third_party/sfml/include/SFML/Graphics/BlendMode.hpp +0 -219
  598. package/third_party/sfml/include/SFML/Graphics/CircleShape.hpp +0 -154
  599. package/third_party/sfml/include/SFML/Graphics/Color.hpp +0 -275
  600. package/third_party/sfml/include/SFML/Graphics/ConvexShape.hpp +0 -153
  601. package/third_party/sfml/include/SFML/Graphics/Drawable.hpp +0 -126
  602. package/third_party/sfml/include/SFML/Graphics/Export.hpp +0 -48
  603. package/third_party/sfml/include/SFML/Graphics/Font.hpp +0 -496
  604. package/third_party/sfml/include/SFML/Graphics/Glsl.hpp +0 -227
  605. package/third_party/sfml/include/SFML/Graphics/Glsl.inl +0 -155
  606. package/third_party/sfml/include/SFML/Graphics/Glyph.hpp +0 -81
  607. package/third_party/sfml/include/SFML/Graphics/Image.hpp +0 -346
  608. package/third_party/sfml/include/SFML/Graphics/PrimitiveType.hpp +0 -58
  609. package/third_party/sfml/include/SFML/Graphics/Rect.hpp +0 -274
  610. package/third_party/sfml/include/SFML/Graphics/Rect.inl +0 -171
  611. package/third_party/sfml/include/SFML/Graphics/RectangleShape.hpp +0 -132
  612. package/third_party/sfml/include/SFML/Graphics/RenderStates.hpp +0 -174
  613. package/third_party/sfml/include/SFML/Graphics/RenderTarget.hpp +0 -518
  614. package/third_party/sfml/include/SFML/Graphics/RenderTexture.hpp +0 -334
  615. package/third_party/sfml/include/SFML/Graphics/RenderWindow.hpp +0 -302
  616. package/third_party/sfml/include/SFML/Graphics/Shader.hpp +0 -875
  617. package/third_party/sfml/include/SFML/Graphics/Shape.hpp +0 -355
  618. package/third_party/sfml/include/SFML/Graphics/Sprite.hpp +0 -279
  619. package/third_party/sfml/include/SFML/Graphics/Text.hpp +0 -513
  620. package/third_party/sfml/include/SFML/Graphics/Texture.hpp +0 -733
  621. package/third_party/sfml/include/SFML/Graphics/Transform.hpp +0 -497
  622. package/third_party/sfml/include/SFML/Graphics/Transformable.hpp +0 -429
  623. package/third_party/sfml/include/SFML/Graphics/Vertex.hpp +0 -148
  624. package/third_party/sfml/include/SFML/Graphics/VertexArray.hpp +0 -223
  625. package/third_party/sfml/include/SFML/Graphics/VertexBuffer.hpp +0 -408
  626. package/third_party/sfml/include/SFML/Graphics/View.hpp +0 -343
  627. package/third_party/sfml/include/SFML/Graphics.hpp +0 -68
  628. package/third_party/sfml/include/SFML/Main.hpp +0 -43
  629. package/third_party/sfml/include/SFML/Network/Export.hpp +0 -48
  630. package/third_party/sfml/include/SFML/Network/Ftp.hpp +0 -616
  631. package/third_party/sfml/include/SFML/Network/Http.hpp +0 -482
  632. package/third_party/sfml/include/SFML/Network/IpAddress.hpp +0 -328
  633. package/third_party/sfml/include/SFML/Network/Packet.hpp +0 -545
  634. package/third_party/sfml/include/SFML/Network/Socket.hpp +0 -219
  635. package/third_party/sfml/include/SFML/Network/SocketHandle.hpp +0 -57
  636. package/third_party/sfml/include/SFML/Network/SocketSelector.hpp +0 -263
  637. package/third_party/sfml/include/SFML/Network/TcpListener.hpp +0 -170
  638. package/third_party/sfml/include/SFML/Network/TcpSocket.hpp +0 -316
  639. package/third_party/sfml/include/SFML/Network/UdpSocket.hpp +0 -292
  640. package/third_party/sfml/include/SFML/Network.hpp +0 -53
  641. package/third_party/sfml/include/SFML/OpenGL.hpp +0 -78
  642. package/third_party/sfml/include/SFML/System/Clock.hpp +0 -117
  643. package/third_party/sfml/include/SFML/System/Err.hpp +0 -80
  644. package/third_party/sfml/include/SFML/System/Export.hpp +0 -48
  645. package/third_party/sfml/include/SFML/System/FileInputStream.hpp +0 -169
  646. package/third_party/sfml/include/SFML/System/InputStream.hpp +0 -152
  647. package/third_party/sfml/include/SFML/System/Lock.hpp +0 -139
  648. package/third_party/sfml/include/SFML/System/MemoryInputStream.hpp +0 -148
  649. package/third_party/sfml/include/SFML/System/Mutex.hpp +0 -148
  650. package/third_party/sfml/include/SFML/System/NativeActivity.hpp +0 -62
  651. package/third_party/sfml/include/SFML/System/NonCopyable.hpp +0 -129
  652. package/third_party/sfml/include/SFML/System/Sleep.hpp +0 -52
  653. package/third_party/sfml/include/SFML/System/String.hpp +0 -669
  654. package/third_party/sfml/include/SFML/System/String.inl +0 -53
  655. package/third_party/sfml/include/SFML/System/Thread.hpp +0 -282
  656. package/third_party/sfml/include/SFML/System/Thread.inl +0 -90
  657. package/third_party/sfml/include/SFML/System/ThreadLocal.hpp +0 -103
  658. package/third_party/sfml/include/SFML/System/ThreadLocalPtr.hpp +0 -158
  659. package/third_party/sfml/include/SFML/System/ThreadLocalPtr.inl +0 -77
  660. package/third_party/sfml/include/SFML/System/Time.hpp +0 -488
  661. package/third_party/sfml/include/SFML/System/Utf.hpp +0 -763
  662. package/third_party/sfml/include/SFML/System/Utf.inl +0 -752
  663. package/third_party/sfml/include/SFML/System/Vector2.hpp +0 -301
  664. package/third_party/sfml/include/SFML/System/Vector2.inl +0 -161
  665. package/third_party/sfml/include/SFML/System/Vector3.hpp +0 -302
  666. package/third_party/sfml/include/SFML/System/Vector3.inl +0 -168
  667. package/third_party/sfml/include/SFML/System.hpp +0 -60
  668. package/third_party/sfml/include/SFML/Window/Clipboard.hpp +0 -119
  669. package/third_party/sfml/include/SFML/Window/Context.hpp +0 -195
  670. package/third_party/sfml/include/SFML/Window/ContextSettings.hpp +0 -149
  671. package/third_party/sfml/include/SFML/Window/Cursor.hpp +0 -241
  672. package/third_party/sfml/include/SFML/Window/Event.hpp +0 -285
  673. package/third_party/sfml/include/SFML/Window/Export.hpp +0 -48
  674. package/third_party/sfml/include/SFML/Window/GlResource.hpp +0 -109
  675. package/third_party/sfml/include/SFML/Window/Joystick.hpp +0 -227
  676. package/third_party/sfml/include/SFML/Window/Keyboard.hpp +0 -491
  677. package/third_party/sfml/include/SFML/Window/Mouse.hpp +0 -180
  678. package/third_party/sfml/include/SFML/Window/Sensor.hpp +0 -150
  679. package/third_party/sfml/include/SFML/Window/Touch.hpp +0 -137
  680. package/third_party/sfml/include/SFML/Window/VideoMode.hpp +0 -228
  681. package/third_party/sfml/include/SFML/Window/Vulkan.hpp +0 -115
  682. package/third_party/sfml/include/SFML/Window/Window.hpp +0 -354
  683. package/third_party/sfml/include/SFML/Window/WindowBase.hpp +0 -518
  684. package/third_party/sfml/include/SFML/Window/WindowHandle.hpp +0 -101
  685. package/third_party/sfml/include/SFML/Window/WindowStyle.hpp +0 -53
  686. package/third_party/sfml/include/SFML/Window.hpp +0 -58
  687. package/tools/clang_format.js +0 -9
  688. package/tools/copier/linux.js +0 -21
  689. package/tools/copier/macos.js +0 -34
  690. package/tools/copier/windows.js +0 -33
  691. package/tools/joystick_axis.js +0 -63
  692. package/tools/keycode.js +0 -92
  693. package/tools/lib_downloader.js +0 -107
  694. package/tools/lib_downloader_urls.js +0 -59
  695. package/tools/mouse_button.js +0 -92
  696. package/tools/sensor_type.js +0 -63
@@ -0,0 +1,71 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.setNotificationCallback = exports.isDefaultDevice = exports.getDeviceSampleRate = exports.getDevice = exports.setDeviceToNull = exports.setDeviceToDefault = exports.setDevice = exports.getDefaultDevice = exports.getAvailableDevices = exports.Notification = void 0;
4
+ const audio_native_1 = require("../internal/audio-native");
5
+ /** 音频播放设备的生命周期通知。 */
6
+ var Notification;
7
+ (function (Notification) {
8
+ /** 设备开始运行。 */
9
+ Notification[Notification["DeviceStarted"] = 0] = "DeviceStarted";
10
+ /** 设备停止运行。 */
11
+ Notification[Notification["DeviceStopped"] = 1] = "DeviceStopped";
12
+ /** 音频输出路由发生变化。 */
13
+ Notification[Notification["DeviceRerouted"] = 2] = "DeviceRerouted";
14
+ /** 系统中断开始。 */
15
+ Notification[Notification["DeviceInterruptionBegan"] = 3] = "DeviceInterruptionBegan";
16
+ /** 系统中断结束。 */
17
+ Notification[Notification["DeviceInterruptionEnded"] = 4] = "DeviceInterruptionEnded";
18
+ /** 设备解除锁定。 */
19
+ Notification[Notification["DeviceUnlocked"] = 5] = "DeviceUnlocked";
20
+ })(Notification = exports.Notification || (exports.Notification = {}));
21
+ let state;
22
+ let values;
23
+ function command(id, name) {
24
+ if (!state) {
25
+ state = audio_native_1.audioNative.createAudioDeviceState();
26
+ values = new Uint32Array(state.buffer);
27
+ }
28
+ return audio_native_1.audioNative.audioDevice(state.handle, id, name);
29
+ }
30
+ /** 返回可用播放设备名称。 */
31
+ function getAvailableDevices() { return command(0); }
32
+ exports.getAvailableDevices = getAvailableDevices;
33
+ /** 返回系统默认播放设备名称;不可用时为 undefined。 */
34
+ function getDefaultDevice() {
35
+ return command(1);
36
+ }
37
+ exports.getDefaultDevice = getDefaultDevice;
38
+ /** 切换到指定名称的播放设备,返回是否成功。 */
39
+ function setDevice(name) {
40
+ command(2, name);
41
+ return values[3] !== 0;
42
+ }
43
+ exports.setDevice = setDevice;
44
+ /** 切换到系统默认播放设备,返回是否成功。 */
45
+ function setDeviceToDefault() {
46
+ command(3);
47
+ return values[3] !== 0;
48
+ }
49
+ exports.setDeviceToDefault = setDeviceToDefault;
50
+ /** 切换到不输出声音的空设备,返回是否成功。 */
51
+ function setDeviceToNull() { command(4); return values[3] !== 0; }
52
+ exports.setDeviceToNull = setDeviceToNull;
53
+ /** 返回当前播放设备名称;不可用时为 undefined。 */
54
+ function getDevice() {
55
+ return command(5);
56
+ }
57
+ exports.getDevice = getDevice;
58
+ /** 返回当前设备采样率(Hz);不可用时为 undefined。 */
59
+ function getDeviceSampleRate() {
60
+ command(6);
61
+ return values[1] ? values[0] : undefined;
62
+ }
63
+ exports.getDeviceSampleRate = getDeviceSampleRate;
64
+ /** 返回当前设备是否跟随系统默认设备。 */
65
+ function isDefaultDevice() { command(7); return values[2] !== 0; }
66
+ exports.isDefaultDevice = isDefaultDevice;
67
+ /** 设置设备通知回调;undefined 或 null 移除回调。 */
68
+ function setNotificationCallback(callback) {
69
+ audio_native_1.audioNative.audioDeviceNotifications(callback);
70
+ }
71
+ exports.setNotificationCallback = setNotificationCallback;
@@ -0,0 +1,34 @@
1
+ import { type AudioHandle } from '../internal/audio-native';
2
+ import { type AudioRecorderCallbacks } from '../internal/audio-recorder-session';
3
+ import { SoundRecorder } from './sound-recorder';
4
+ import { type ReadonlySoundBuffer } from './sound-buffer';
5
+ /** 将采集的 PCM 保存在 SoundBuffer 中的录音器。 */
6
+ export declare class SoundBufferRecorder extends SoundRecorder {
7
+ private buffer;
8
+ /** 创建录音器,调用 start 开始采集。 */
9
+ constructor();
10
+ /** 返回最近完成的录音缓冲区;应在 await stop() 后取得新结果。 */
11
+ getBuffer(): ReadonlySoundBuffer;
12
+ /**
13
+ * 在对象所属 JS 线程开始采集前调用;支持同步或异步返回,false 拒绝采集。
14
+ * 默认清空本次 Native PCM 聚合和录音缓冲区,不访问麦克风。
15
+ */
16
+ protected onStart(): boolean | Promise<boolean>;
17
+ /**
18
+ * 在对象所属 JS 线程串行处理交错的 16 位 PCM,长度单位为样本而非帧。
19
+ * Native 视图仅在本次同步或异步回调结束前有效;false 异步停止采集。
20
+ * 默认将传入样本追加到 Native 聚合器;可修改后调用 super,不调用则不保存。
21
+ */
22
+ protected onProcessSamples(samples: Int16Array): boolean | Promise<boolean>;
23
+ /**
24
+ * 在设备停止且已交付回调结束后,于对象所属 JS 线程调用一次,支持异步完成。
25
+ * 拒绝、取消和异常同样触发;默认将已通过 super 追加的 PCM 完成为 SoundBuffer。
26
+ */
27
+ protected onStop(): void | Promise<void>;
28
+ /** 只有覆写回调的子类启用队列,普通实例保持 Native 快路径。 */
29
+ protected recorderCallbacks(): AudioRecorderCallbacks | undefined;
30
+ /** 在实例作用域外创建弱引用派发器,避免空闲会话保活包装对象。 */
31
+ private static callbacks;
32
+ /** 接收独立 Native 缓冲区;后续录音不会修改已返回的 SoundBuffer。 */
33
+ protected onBuffer(buffer: AudioHandle<'bufferData'>): void;
34
+ }
@@ -0,0 +1,62 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SoundBufferRecorder = void 0;
4
+ const audio_native_1 = require("../internal/audio-native");
5
+ const audio_recorder_session_1 = require("../internal/audio-recorder-session");
6
+ const sound_recorder_1 = require("./sound-recorder");
7
+ const sound_buffer_1 = require("./sound-buffer");
8
+ /** 将采集的 PCM 保存在 SoundBuffer 中的录音器。 */
9
+ class SoundBufferRecorder extends sound_recorder_1.SoundRecorder {
10
+ /** 创建录音器,调用 start 开始采集。 */
11
+ constructor() {
12
+ super(undefined, true);
13
+ this.buffer = new sound_buffer_1.SoundBuffer();
14
+ }
15
+ /** 返回最近完成的录音缓冲区;应在 await stop() 后取得新结果。 */
16
+ getBuffer() { return this.buffer; }
17
+ /**
18
+ * 在对象所属 JS 线程开始采集前调用;支持同步或异步返回,false 拒绝采集。
19
+ * 默认清空本次 Native PCM 聚合和录音缓冲区,不访问麦克风。
20
+ */
21
+ onStart() {
22
+ this.onBuffer((0, audio_recorder_session_1.recorderCallbackSession)(this[audio_native_1.audioHandle], 'onStart').reset());
23
+ return true;
24
+ }
25
+ /**
26
+ * 在对象所属 JS 线程串行处理交错的 16 位 PCM,长度单位为样本而非帧。
27
+ * Native 视图仅在本次同步或异步回调结束前有效;false 异步停止采集。
28
+ * 默认将传入样本追加到 Native 聚合器;可修改后调用 super,不调用则不保存。
29
+ */
30
+ onProcessSamples(samples) {
31
+ return (0, audio_recorder_session_1.recorderCallbackSession)(this[audio_native_1.audioHandle], 'onProcessSamples')
32
+ .append(samples);
33
+ }
34
+ /**
35
+ * 在设备停止且已交付回调结束后,于对象所属 JS 线程调用一次,支持异步完成。
36
+ * 拒绝、取消和异常同样触发;默认将已通过 super 追加的 PCM 完成为 SoundBuffer。
37
+ */
38
+ onStop() {
39
+ this.onBuffer((0, audio_recorder_session_1.recorderCallbackSession)(this[audio_native_1.audioHandle], 'onStop').finalize());
40
+ }
41
+ /** 只有覆写回调的子类启用队列,普通实例保持 Native 快路径。 */
42
+ recorderCallbacks() {
43
+ if (this.onStart === SoundBufferRecorder.prototype.onStart &&
44
+ this.onProcessSamples === SoundBufferRecorder.prototype.onProcessSamples &&
45
+ this.onStop === SoundBufferRecorder.prototype.onStop)
46
+ return undefined;
47
+ return SoundBufferRecorder.callbacks(new WeakRef(this));
48
+ }
49
+ /** 在实例作用域外创建弱引用派发器,避免空闲会话保活包装对象。 */
50
+ static callbacks(weak) {
51
+ return {
52
+ onStart: () => weak.deref()?.onStart() ?? false,
53
+ onProcessSamples: samples => weak.deref()?.onProcessSamples(samples) ?? false,
54
+ onStop: () => weak.deref()?.onStop(),
55
+ };
56
+ }
57
+ /** 接收独立 Native 缓冲区;后续录音不会修改已返回的 SoundBuffer。 */
58
+ onBuffer(buffer) {
59
+ this.buffer = sound_buffer_1.SoundBuffer[sound_buffer_1.adoptAudioBuffer](buffer);
60
+ }
61
+ }
62
+ exports.SoundBufferRecorder = SoundBufferRecorder;
@@ -0,0 +1,45 @@
1
+ import { audioHandle, type AudioHandle } from '../internal/audio-native';
2
+ import { Time } from '../system/time';
3
+ import type { InputStream } from '../system/input-stream';
4
+ import { type SoundChannel, type ReadonlySamples, type ChannelMap } from './value';
5
+ /** 音频缓冲区的只读接口,样本视图保留其对应的原生存储。 */
6
+ export type ReadonlySoundBuffer = Readonly<Pick<SoundBuffer, typeof audioHandle | 'getSamples' | 'getSampleCount' | 'getSampleRate' | 'getChannelCount' | 'getChannelMap' | 'getDuration' | 'saveToFile'>>;
7
+ export declare const adoptAudioBuffer: unique symbol;
8
+ /** Views retain the exact native allocation from which they were obtained. */
9
+ export declare class SoundBuffer {
10
+ readonly [audioHandle]: AudioHandle<'buffer'>;
11
+ private state;
12
+ private readonly queue;
13
+ /** 创建空音频缓冲区,或深复制现有缓冲区。 */
14
+ constructor(source?: ReadonlySoundBuffer);
15
+ /** 复制交错 16 位 PCM;采样率以 Hz 计,channelMap 指定各声道位置。 */
16
+ constructor(samples: Int16Array, channelCount: number, sampleRate: number, channelMap: Iterable<SoundChannel>);
17
+ /** Copy the current source data synchronously, retaining this buffer's identity. */
18
+ assign(source: ReadonlySoundBuffer): this;
19
+ /** @internal */
20
+ static [adoptAudioBuffer](data: AudioHandle<'bufferData'>): SoundBuffer;
21
+ /** 异步解码整个音频文件到原生 PCM 存储,返回是否成功。 */
22
+ loadFromFile(filename: string): Promise<boolean>;
23
+ /** 异步解码编码音频字节并替换 PCM,返回是否成功。 */
24
+ loadFromMemory(data: Uint8Array): Promise<boolean>;
25
+ /** 从输入流异步解码全部样本,返回是否成功;流异常会拒绝 Promise。 */
26
+ loadFromStream(stream: InputStream): Promise<boolean>;
27
+ /** 同步复制交错 16 位 PCM 并替换内容;sampleRate 为 Hz,返回是否成功。 */
28
+ loadFromSamples(data: Int16Array, channelCount: number, sampleRate: number, channelMap: Iterable<SoundChannel>): boolean;
29
+ /** 返回 PCM 只读类型视图;空缓冲区为 undefined,重新加载后旧视图仍指向旧存储。 */
30
+ getSamples(): ReadonlySamples | undefined;
31
+ /** 返回所有声道合计的样本数量。 */
32
+ getSampleCount(): bigint;
33
+ /** 返回每声道采样率,单位为 Hz。 */
34
+ getSampleRate(): number;
35
+ /** 返回声道数量。 */
36
+ getChannelCount(): number;
37
+ /** 返回交错声道位置顺序的只读视图。 */
38
+ getChannelMap(): ChannelMap;
39
+ /** 返回音频总时长副本。 */
40
+ getDuration(): Time;
41
+ /** 按文件扩展名异步编码保存,返回是否成功。 */
42
+ saveToFile(filename: string): Promise<boolean>;
43
+ private loadDecoded;
44
+ private load;
45
+ }
@@ -0,0 +1,152 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SoundBuffer = exports.adoptAudioBuffer = void 0;
4
+ const audio_native_1 = require("../internal/audio-native");
5
+ const struct_view_1 = require("../internal/struct-view");
6
+ const time_1 = require("../system/time");
7
+ const audio_input_stream_1 = require("../internal/audio-input-stream");
8
+ const audio_codec_registry_1 = require("../internal/audio-codec-registry");
9
+ const input_sound_file_1 = require("./input-sound-file");
10
+ const output_sound_file_1 = require("./output-sound-file");
11
+ const value_1 = require("./value");
12
+ function view(mapping) {
13
+ return (0, struct_view_1.nativeStruct)(mapping.info, {
14
+ samples: new Int16Array(mapping.samples),
15
+ channelMap: new Int32Array(mapping.channelMap),
16
+ });
17
+ }
18
+ exports.adoptAudioBuffer = Symbol('Audio.adoptBuffer');
19
+ /** Views retain the exact native allocation from which they were obtained. */
20
+ class SoundBuffer {
21
+ constructor(source, channelCount, sampleRate, channelMap) {
22
+ this.queue = new audio_native_1.AudioQueue();
23
+ let mapping;
24
+ if (source instanceof Int16Array) {
25
+ mapping = audio_native_1.audioNative.createAudioBuffer(source, (0, value_1.unsigned)(sampleRate), (0, value_1.unsigned)(channelCount), (0, value_1.channels)(channelMap));
26
+ }
27
+ else {
28
+ if (source !== undefined && !(source instanceof SoundBuffer)) {
29
+ throw new TypeError('Expected a SoundBuffer or Int16Array');
30
+ }
31
+ mapping = audio_native_1.audioNative.createAudioBuffer(source?.[audio_native_1.audioHandle]);
32
+ }
33
+ this[audio_native_1.audioHandle] = mapping.handle;
34
+ this.state = view(mapping);
35
+ }
36
+ /** Copy the current source data synchronously, retaining this buffer's identity. */
37
+ assign(source) {
38
+ if (!(source instanceof SoundBuffer)) {
39
+ throw new TypeError('Expected a SoundBuffer');
40
+ }
41
+ if (source === this)
42
+ return this;
43
+ this.state = view(audio_native_1.audioNative.assignAudioBuffer(this[audio_native_1.audioHandle], source[audio_native_1.audioHandle]));
44
+ return this;
45
+ }
46
+ /** @internal */
47
+ static [exports.adoptAudioBuffer](data) {
48
+ const result = new SoundBuffer();
49
+ result.state = view(audio_native_1.audioNative.commitAudioBuffer(result[audio_native_1.audioHandle], data));
50
+ return result;
51
+ }
52
+ /** 异步解码整个音频文件到原生 PCM 存储,返回是否成功。 */
53
+ loadFromFile(filename) {
54
+ return audio_codec_registry_1.audioReaders.size ? this.loadDecoded(filename) : this.load(filename);
55
+ }
56
+ /** 异步解码编码音频字节并替换 PCM,返回是否成功。 */
57
+ loadFromMemory(data) {
58
+ return audio_codec_registry_1.audioReaders.size ? this.loadDecoded(data) : this.load(data);
59
+ }
60
+ /** 从输入流异步解码全部样本,返回是否成功;流异常会拒绝 Promise。 */
61
+ loadFromStream(stream) {
62
+ return audio_codec_registry_1.audioReaders.size ? this.loadDecoded(stream)
63
+ : this.load(new audio_input_stream_1.AudioInputStream(stream));
64
+ }
65
+ /** 同步复制交错 16 位 PCM 并替换内容;sampleRate 为 Hz,返回是否成功。 */
66
+ loadFromSamples(data, channelCount, sampleRate, channelMap) {
67
+ (0, value_1.samples)(data);
68
+ const result = audio_native_1.audioNative.audioBufferSamples(data, (0, value_1.unsigned)(sampleRate), (0, value_1.unsigned)(channelCount), (0, value_1.channels)(channelMap));
69
+ if (!result)
70
+ return false;
71
+ this.state = view(audio_native_1.audioNative.commitAudioBuffer(this[audio_native_1.audioHandle], result));
72
+ return true;
73
+ }
74
+ /** 返回 PCM 只读类型视图;空缓冲区为 undefined,重新加载后旧视图仍指向旧存储。 */
75
+ getSamples() {
76
+ return this.state.samples.length ? this.state.samples : undefined;
77
+ }
78
+ /** 返回所有声道合计的样本数量。 */
79
+ getSampleCount() { return this.state.sampleCount; }
80
+ /** 返回每声道采样率,单位为 Hz。 */
81
+ getSampleRate() { return this.state.sampleRate; }
82
+ /** 返回声道数量。 */
83
+ getChannelCount() { return this.state.channelCount; }
84
+ /** 返回交错声道位置顺序的只读视图。 */
85
+ getChannelMap() { return this.state.channelMap; }
86
+ /** 返回音频总时长副本。 */
87
+ getDuration() { return new time_1.Time(this.state.duration); }
88
+ /** 按文件扩展名异步编码保存,返回是否成功。 */
89
+ saveToFile(filename) {
90
+ if (audio_codec_registry_1.audioWriters.size) {
91
+ return this.queue.run(async () => {
92
+ const output = new output_sound_file_1.OutputSoundFile();
93
+ try {
94
+ const ok = await output.openFromFile(filename, this.getSampleRate(), this.getChannelCount(), this.getChannelMap());
95
+ if (!ok)
96
+ return false;
97
+ if (this.state.samples.length)
98
+ await output.write(this.state.samples);
99
+ return true;
100
+ }
101
+ finally {
102
+ await output.close();
103
+ }
104
+ });
105
+ }
106
+ return this.queue.run(() => (0, audio_native_1.audioAsync)(callback => audio_native_1.audioNative.saveAudioBuffer(this[audio_native_1.audioHandle], filename, callback)));
107
+ }
108
+ loadDecoded(input) {
109
+ return this.queue.run(async () => {
110
+ const file = new input_sound_file_1.InputSoundFile();
111
+ try {
112
+ const ok = typeof input === 'string' ? await file.openFromFile(input)
113
+ : input instanceof Uint8Array ? await file.openFromMemory(input)
114
+ : await file.openFromStream(input);
115
+ if (!ok)
116
+ return false;
117
+ const count = file.getSampleCount();
118
+ if (count > 0xffffffffn)
119
+ throw new RangeError('Sample buffer is too large');
120
+ const data = new Int16Array(audio_native_1.audioNative.allocateAudioSamples(Number(count)));
121
+ let position = 0;
122
+ while (position < data.length) {
123
+ const read = Number(await file.read(data.subarray(position)));
124
+ if (!read)
125
+ return false;
126
+ position += read;
127
+ }
128
+ return this.loadFromSamples(data, file.getChannelCount(), file.getSampleRate(), file.getChannelMap());
129
+ }
130
+ finally {
131
+ await file.close();
132
+ }
133
+ });
134
+ }
135
+ load(input) {
136
+ return this.queue.run(async () => {
137
+ const stream = input instanceof audio_input_stream_1.AudioInputStream ? input : undefined;
138
+ try {
139
+ const load = () => (0, audio_native_1.audioAsync)(callback => audio_native_1.audioNative.loadAudioBuffer(stream ? stream.handle : input, callback));
140
+ const data = await (stream ? stream.run(load) : load());
141
+ if (!data)
142
+ return false;
143
+ this.state = view(audio_native_1.audioNative.commitAudioBuffer(this[audio_native_1.audioHandle], data));
144
+ return true;
145
+ }
146
+ finally {
147
+ stream?.close();
148
+ }
149
+ });
150
+ }
151
+ }
152
+ exports.SoundBuffer = SoundBuffer;
@@ -0,0 +1,27 @@
1
+ import { SoundFileReader, type SoundFileReaderConstructor } from './sound-file-reader';
2
+ import { SoundFileWriter, type SoundFileWriterConstructor } from './sound-file-writer';
3
+ import type { InputStream } from '../system/input-stream';
4
+ /** Registrations belong to the current Node environment. */
5
+ export declare class SoundFileFactory {
6
+ /** 在当前 Node 环境注册带有静态 check 方法的自定义解码器类。 */
7
+ static registerReader(reader: SoundFileReaderConstructor): void;
8
+ /** 取消自定义解码器类的注册。 */
9
+ static unregisterReader(reader: SoundFileReaderConstructor): void;
10
+ /** 判断自定义解码器类是否已注册。 */
11
+ static isReaderRegistered(reader: SoundFileReaderConstructor): boolean;
12
+ /** 在当前 Node 环境注册带有静态 check 方法的自定义编码器类。 */
13
+ static registerWriter(writer: SoundFileWriterConstructor): void;
14
+ /** 取消自定义编码器类的注册。 */
15
+ static unregisterWriter(writer: SoundFileWriterConstructor): void;
16
+ /** 判断自定义编码器类是否已注册。 */
17
+ static isWriterRegistered(writer: SoundFileWriterConstructor): boolean;
18
+ /** 探测文件并创建匹配的解码器;未匹配返回 undefined,使用前仍需 open。 */
19
+ static createReaderFromFilename(filename: string): Promise<SoundFileReader | undefined>;
20
+ /** 探测编码音频字节并创建匹配的解码器,未匹配返回 undefined。 */
21
+ static createReaderFromMemory(data: Uint8Array): Promise<SoundFileReader | undefined>;
22
+ /** 探测流内容并创建匹配的解码器,未匹配返回 undefined。 */
23
+ static createReaderFromStream(stream: InputStream): Promise<SoundFileReader | undefined>;
24
+ /** 按文件名创建编码器;未匹配返回 undefined,写入前仍需 open。 */
25
+ static createWriterFromFilename(filename: string): Promise<SoundFileWriter | undefined>;
26
+ private static createReader;
27
+ }
@@ -0,0 +1,152 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SoundFileFactory = void 0;
4
+ const audio_native_1 = require("../internal/audio-native");
5
+ const audio_input_stream_1 = require("../internal/audio-input-stream");
6
+ const audio_codec_registry_1 = require("../internal/audio-codec-registry");
7
+ const sound_file_reader_1 = require("./sound-file-reader");
8
+ const sound_file_writer_1 = require("./sound-file-writer");
9
+ const value_1 = require("./value");
10
+ class NativeReader extends sound_file_reader_1.SoundFileReader {
11
+ constructor(handle) {
12
+ super();
13
+ this.handle = handle;
14
+ this.queue = new audio_native_1.AudioQueue();
15
+ }
16
+ open(stream) {
17
+ return this.queue.run(async () => {
18
+ const next = new audio_input_stream_1.AudioInputStream(stream);
19
+ try {
20
+ if (await stream.seek(0n) !== 0n)
21
+ return undefined;
22
+ const mapping = await next.run(() => (0, audio_native_1.audioAsync)(callback => audio_native_1.audioNative.openAudioReader(this.handle, next.handle, callback)));
23
+ if (!mapping)
24
+ return undefined;
25
+ this.stream?.close();
26
+ this.stream = next;
27
+ return new sound_file_reader_1.SoundFileReaderInfo(undefined, mapping);
28
+ }
29
+ finally {
30
+ if (this.stream !== next)
31
+ next.close();
32
+ }
33
+ });
34
+ }
35
+ read(data) {
36
+ (0, value_1.samples)(data);
37
+ return this.queue.run(() => this.run(() => (0, audio_native_1.audioAsync)(callback => audio_native_1.audioNative.readAudioReader(this.handle, data, callback))));
38
+ }
39
+ seek(offset) {
40
+ return this.queue.run(() => this.run(() => (0, audio_native_1.audioAsync)(callback => audio_native_1.audioNative.seekAudioReader(this.handle, offset, callback))));
41
+ }
42
+ close() {
43
+ return this.queue.run(async () => {
44
+ await (0, audio_native_1.audioAsync)(callback => audio_native_1.audioNative.closeAudioReader(this.handle, callback));
45
+ this.stream?.close();
46
+ this.stream = undefined;
47
+ });
48
+ }
49
+ run(action) {
50
+ return this.stream ? this.stream.run(action) : action();
51
+ }
52
+ }
53
+ class NativeWriter extends sound_file_writer_1.SoundFileWriter {
54
+ constructor(handle) {
55
+ super();
56
+ this.handle = handle;
57
+ this.queue = new audio_native_1.AudioQueue();
58
+ this.opened = false;
59
+ }
60
+ open(filename, rate, count, map) {
61
+ const channelMap = (0, value_1.channels)(map);
62
+ (0, value_1.unsigned)(rate);
63
+ (0, value_1.unsigned)(count);
64
+ return this.queue.run(async () => {
65
+ this.opened = await (0, audio_native_1.audioAsync)(callback => audio_native_1.audioNative.openAudioWriter(this.handle, filename, rate, count, channelMap, callback));
66
+ return this.opened;
67
+ });
68
+ }
69
+ write(data) {
70
+ (0, value_1.samples)(data);
71
+ return this.queue.run(async () => {
72
+ if (!this.opened)
73
+ throw new Error('Writer is not open');
74
+ await (0, audio_native_1.audioAsync)(callback => audio_native_1.audioNative.writeAudioWriter(this.handle, data, callback));
75
+ });
76
+ }
77
+ close() {
78
+ return this.queue.run(async () => {
79
+ await (0, audio_native_1.audioAsync)(callback => audio_native_1.audioNative.closeAudioWriter(this.handle, callback));
80
+ this.opened = false;
81
+ });
82
+ }
83
+ }
84
+ /** Registrations belong to the current Node environment. */
85
+ class SoundFileFactory {
86
+ /** 在当前 Node 环境注册带有静态 check 方法的自定义解码器类。 */
87
+ static registerReader(reader) {
88
+ if (typeof reader !== 'function' ||
89
+ !(reader.prototype instanceof sound_file_reader_1.SoundFileReader) ||
90
+ typeof reader.check !== 'function') {
91
+ throw new TypeError('Expected a SoundFileReader class with static check()');
92
+ }
93
+ audio_codec_registry_1.audioReaders.add(reader);
94
+ }
95
+ /** 取消自定义解码器类的注册。 */
96
+ static unregisterReader(reader) {
97
+ audio_codec_registry_1.audioReaders.delete(reader);
98
+ }
99
+ /** 判断自定义解码器类是否已注册。 */
100
+ static isReaderRegistered(reader) {
101
+ return audio_codec_registry_1.audioReaders.has(reader);
102
+ }
103
+ /** 在当前 Node 环境注册带有静态 check 方法的自定义编码器类。 */
104
+ static registerWriter(writer) {
105
+ if (typeof writer !== 'function' ||
106
+ !(writer.prototype instanceof sound_file_writer_1.SoundFileWriter) ||
107
+ typeof writer.check !== 'function') {
108
+ throw new TypeError('Expected a SoundFileWriter class with static check()');
109
+ }
110
+ audio_codec_registry_1.audioWriters.add(writer);
111
+ }
112
+ /** 取消自定义编码器类的注册。 */
113
+ static unregisterWriter(writer) {
114
+ audio_codec_registry_1.audioWriters.delete(writer);
115
+ }
116
+ /** 判断自定义编码器类是否已注册。 */
117
+ static isWriterRegistered(writer) {
118
+ return audio_codec_registry_1.audioWriters.has(writer);
119
+ }
120
+ /** 探测文件并创建匹配的解码器;未匹配返回 undefined,使用前仍需 open。 */
121
+ static createReaderFromFilename(filename) { return this.createReader(filename); }
122
+ /** 探测编码音频字节并创建匹配的解码器,未匹配返回 undefined。 */
123
+ static createReaderFromMemory(data) { return this.createReader(data); }
124
+ /** 探测流内容并创建匹配的解码器,未匹配返回 undefined。 */
125
+ static createReaderFromStream(stream) { return this.createReader(stream); }
126
+ /** 按文件名创建编码器;未匹配返回 undefined,写入前仍需 open。 */
127
+ static async createWriterFromFilename(filename) {
128
+ const custom = await (0, audio_codec_registry_1.findAudioWriter)(filename);
129
+ if (custom)
130
+ return custom;
131
+ const handle = audio_native_1.audioNative.createAudioWriter(filename);
132
+ return handle ? new NativeWriter(handle) : undefined;
133
+ }
134
+ static async createReader(input) {
135
+ const custom = await (0, audio_codec_registry_1.findAudioReaderInput)(input);
136
+ if (custom) {
137
+ await custom.owned?.close();
138
+ return custom.reader;
139
+ }
140
+ const bridge = typeof input === 'string' || input instanceof Uint8Array
141
+ ? undefined : new audio_input_stream_1.AudioInputStream(input);
142
+ try {
143
+ const create = () => (0, audio_native_1.audioAsync)(callback => audio_native_1.audioNative.createAudioReader(bridge ? bridge.handle : input, callback));
144
+ const handle = await (bridge ? bridge.run(create) : create());
145
+ return handle ? new NativeReader(handle) : undefined;
146
+ }
147
+ finally {
148
+ bridge?.close();
149
+ }
150
+ }
151
+ }
152
+ exports.SoundFileFactory = SoundFileFactory;
@@ -0,0 +1,60 @@
1
+ import { audioHandle, type AudioHandle, type AudioReaderInfoMapping } from '../internal/audio-native';
2
+ import type { InputStream } from '../system/input-stream';
3
+ import { type SoundChannel, type ChannelMap } from './value';
4
+ /** 自定义音频解码器返回的格式信息。 */
5
+ export interface SoundFileReaderInfoInput {
6
+ /** 所有交错声道合计的样本总数。 */
7
+ sampleCount: bigint;
8
+ /** 声道数量。 */
9
+ channelCount: number;
10
+ /** 每声道采样率,单位为 Hz。 */
11
+ sampleRate: number;
12
+ /** 按交错顺序排列的声道位置。 */
13
+ channelMap: Iterable<SoundChannel>;
14
+ }
15
+ /** sf::SoundFileReader::Info with directly mapped scalar fields. */
16
+ export declare class SoundFileReaderInfo {
17
+ readonly [audioHandle]: AudioHandle<'readerInfo'>;
18
+ private readonly count;
19
+ private readonly channels;
20
+ private readonly rate;
21
+ private map;
22
+ /** 创建空格式信息或复制 value;mapping 供原生解码器内部映射使用。 */
23
+ constructor(value?: SoundFileReaderInfoInput, mapping?: AudioReaderInfoMapping);
24
+ /** 所有声道合计的样本总数。 */
25
+ get sampleCount(): bigint;
26
+ /** 设置无符号 64 位样本总数。 */
27
+ set sampleCount(value: bigint);
28
+ /** 声道数量。 */
29
+ get channelCount(): number;
30
+ /** 设置声道数量。 */
31
+ set channelCount(value: number);
32
+ /** 每声道采样率,单位为 Hz。 */
33
+ get sampleRate(): number;
34
+ /** 设置采样率,单位为 Hz。 */
35
+ set sampleRate(value: number);
36
+ /** 交错声道位置的只读视图。 */
37
+ get channelMap(): ChannelMap;
38
+ /** 复制声道位置映射。 */
39
+ set channelMap(value: Iterable<SoundChannel>);
40
+ }
41
+ /** 自定义音频解码器接口,读写位置以所有声道合计的样本数计。 */
42
+ export declare abstract class SoundFileReader {
43
+ /** 解码器格式信息类型。 */
44
+ static readonly Info: typeof SoundFileReaderInfo;
45
+ /** 打开输入流并返回格式信息;无法打开时返回 undefined。 */
46
+ abstract open(stream: InputStream): SoundFileReaderInfo | undefined | Promise<SoundFileReaderInfo | undefined>;
47
+ /** 移动到指定交错样本偏移,偏移从零开始。 */
48
+ abstract seek(sampleOffset: bigint): void | Promise<void>;
49
+ /** 解码到提供的缓冲区,返回实际样本数;末尾返回 0n。 */
50
+ abstract read(samples: Int16Array): bigint | Promise<bigint>;
51
+ /** 释放解码器持有的资源;默认无操作。 */
52
+ close(): void | Promise<void>;
53
+ }
54
+ /** 可注册的解码器类,需提供无参数构造函数及格式探测方法。 */
55
+ export interface SoundFileReaderConstructor {
56
+ /** 创建尚未打开的解码器实例。 */
57
+ new (): SoundFileReader;
58
+ /** 探测输入流是否属于本解码器支持的格式。 */
59
+ check(stream: InputStream): boolean | Promise<boolean>;
60
+ }