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.
- package/LICENSE +1 -1
- package/README.ja.md +173 -0
- package/README.ko.md +173 -0
- package/README.md +129 -20
- package/README.zh-CN.md +173 -0
- package/assets/branding/sfml-js-symbol-pentagon.svg +24 -0
- package/assets/branding/sfml-js-wordmark-dark.svg +20 -0
- package/assets/branding/sfml-js-wordmark.svg +19 -0
- package/assets/breakout.png +0 -0
- package/binding.gyp +95 -183
- package/dist/audio/effect-processor.d.ts +67 -0
- package/dist/audio/effect-processor.js +58 -0
- package/dist/audio/input-sound-file.d.ts +138 -0
- package/dist/audio/input-sound-file.js +253 -0
- package/dist/audio/listener.d.ts +90 -0
- package/dist/audio/listener.js +148 -0
- package/dist/audio/music.d.ts +210 -0
- package/dist/audio/music.js +353 -0
- package/dist/audio/output-sound-file.d.ts +47 -0
- package/dist/audio/output-sound-file.js +102 -0
- package/dist/audio/playback-device.d.ts +121 -0
- package/dist/audio/playback-device.js +152 -0
- package/dist/audio/sound-buffer-recorder.d.ts +114 -0
- package/dist/audio/sound-buffer-recorder.js +142 -0
- package/dist/audio/sound-buffer.d.ts +150 -0
- package/dist/audio/sound-buffer.js +237 -0
- package/dist/audio/sound-file-factory.d.ts +100 -0
- package/dist/audio/sound-file-factory.js +225 -0
- package/dist/audio/sound-file-reader.d.ts +191 -0
- package/dist/audio/sound-file-reader.js +132 -0
- package/dist/audio/sound-file-writer.d.ts +59 -0
- package/dist/audio/sound-file-writer.js +20 -0
- package/dist/audio/sound-recorder.d.ts +184 -0
- package/dist/audio/sound-recorder.js +286 -0
- package/dist/audio/sound-source.d.ts +336 -0
- package/dist/audio/sound-source.js +389 -0
- package/dist/audio/sound-stream.d.ts +76 -0
- package/dist/audio/sound-stream.js +83 -0
- package/dist/audio/sound.d.ts +41 -0
- package/dist/audio/sound.js +66 -0
- package/dist/audio/value.d.ts +359 -0
- package/dist/audio/value.js +353 -0
- package/dist/audio/worker.d.ts +306 -0
- package/dist/audio/worker.js +2 -0
- package/dist/graphics/blend-mode.d.ts +248 -0
- package/dist/graphics/blend-mode.js +234 -0
- package/dist/graphics/boolean-vector.d.ts +134 -0
- package/dist/graphics/boolean-vector.js +202 -0
- package/dist/graphics/circle-shape.d.ts +84 -0
- package/dist/graphics/circle-shape.js +72 -0
- package/dist/graphics/color.d.ts +278 -0
- package/dist/graphics/color.js +291 -0
- package/dist/graphics/convex-shape.d.ts +56 -0
- package/dist/graphics/convex-shape.js +59 -0
- package/dist/graphics/drawable.d.ts +22 -0
- package/dist/graphics/drawable.js +20 -0
- package/dist/graphics/font.d.ts +199 -0
- package/dist/graphics/font.js +319 -0
- package/dist/graphics/glsl-matrix.d.ts +62 -0
- package/dist/graphics/glsl-matrix.js +106 -0
- package/dist/graphics/glsl.d.ts +165 -0
- package/dist/graphics/glsl.js +215 -0
- package/dist/graphics/glyph.d.ts +133 -0
- package/dist/graphics/glyph.js +138 -0
- package/dist/graphics/image.d.ts +192 -0
- package/dist/graphics/image.js +285 -0
- package/dist/graphics/primitive-type.d.ts +51 -0
- package/dist/graphics/primitive-type.js +60 -0
- package/dist/graphics/rect.d.ts +203 -0
- package/dist/graphics/rect.js +249 -0
- package/dist/graphics/rectangle-shape.d.ts +55 -0
- package/dist/graphics/rectangle-shape.js +60 -0
- package/dist/graphics/render-states.d.ts +188 -0
- package/dist/graphics/render-states.js +115 -0
- package/dist/graphics/render-target.d.ts +222 -0
- package/dist/graphics/render-target.js +434 -0
- package/dist/graphics/render-texture.d.ts +130 -0
- package/dist/graphics/render-texture.js +187 -0
- package/dist/graphics/render-window.d.ts +138 -0
- package/dist/graphics/render-window.js +154 -0
- package/dist/graphics/shader.d.ts +192 -0
- package/dist/graphics/shader.js +321 -0
- package/dist/graphics/shape.d.ts +189 -0
- package/dist/graphics/shape.js +277 -0
- package/dist/graphics/sprite.d.ts +104 -0
- package/dist/graphics/sprite.js +164 -0
- package/dist/graphics/stencil-mode.d.ts +230 -0
- package/dist/graphics/stencil-mode.js +173 -0
- package/dist/graphics/swap.d.ts +17 -0
- package/dist/graphics/swap.js +16 -0
- package/dist/graphics/text.d.ts +759 -0
- package/dist/graphics/text.js +724 -0
- package/dist/graphics/texture.d.ts +255 -0
- package/dist/graphics/texture.js +390 -0
- package/dist/graphics/transform.d.ts +129 -0
- package/dist/graphics/transform.js +274 -0
- package/dist/graphics/transformable.d.ts +24 -0
- package/dist/graphics/transformable.js +38 -0
- package/dist/graphics/vertex-array.d.ts +123 -0
- package/dist/graphics/vertex-array.js +234 -0
- package/dist/graphics/vertex-buffer.d.ts +205 -0
- package/dist/graphics/vertex-buffer.js +256 -0
- package/dist/graphics/vertex.d.ts +111 -0
- package/dist/graphics/vertex.js +134 -0
- package/dist/graphics/view.d.ts +172 -0
- package/dist/graphics/view.js +296 -0
- package/dist/index.d.ts +116 -0
- package/dist/index.js +251 -0
- package/dist/internal/audio-codec-registry.d.ts +13 -0
- package/dist/internal/audio-codec-registry.js +64 -0
- package/dist/internal/audio-input-stream.d.ts +13 -0
- package/dist/internal/audio-input-stream.js +44 -0
- package/dist/internal/audio-music-pump.d.ts +63 -0
- package/dist/internal/audio-music-pump.js +193 -0
- package/dist/internal/audio-native.d.ts +145 -0
- package/dist/internal/audio-native.js +24 -0
- package/dist/internal/audio-recorder-session.d.ts +77 -0
- package/dist/internal/audio-recorder-session.js +182 -0
- package/dist/internal/audio-worker-session.d.ts +18 -0
- package/dist/internal/audio-worker-session.js +82 -0
- package/dist/internal/audio-worker.d.ts +1 -0
- package/dist/internal/audio-worker.js +134 -0
- package/dist/internal/glsl-value.d.ts +51 -0
- package/dist/internal/glsl-value.js +69 -0
- package/dist/internal/graphics-state.d.ts +45 -0
- package/dist/internal/graphics-state.js +123 -0
- package/dist/internal/input-stream.d.ts +4 -0
- package/dist/internal/input-stream.js +25 -0
- package/dist/internal/lazy-value.d.ts +17 -0
- package/dist/internal/lazy-value.js +43 -0
- package/dist/internal/native.d.ts +317 -0
- package/dist/internal/native.js +8 -0
- package/dist/internal/numeric-properties.d.ts +2 -0
- package/dist/internal/numeric-properties.js +39 -0
- package/dist/internal/render-states.d.ts +4 -0
- package/dist/internal/render-states.js +44 -0
- package/dist/internal/scalar.d.ts +52 -0
- package/dist/internal/scalar.js +95 -0
- package/dist/internal/shaped-glyph.d.ts +32 -0
- package/dist/internal/shaped-glyph.js +51 -0
- package/dist/internal/struct-view.d.ts +11 -0
- package/dist/internal/struct-view.js +39 -0
- package/dist/internal/text-indices.d.ts +7 -0
- package/dist/internal/text-indices.js +22 -0
- package/dist/internal/transformable.d.ts +124 -0
- package/dist/internal/transformable.js +121 -0
- package/dist/internal/value-storage.d.ts +33 -0
- package/dist/internal/value-storage.js +21 -0
- package/dist/network/common.d.ts +23 -0
- package/dist/network/common.js +78 -0
- package/dist/network/dns.d.ts +124 -0
- package/dist/network/dns.js +142 -0
- package/dist/network/ftp.d.ts +265 -0
- package/dist/network/ftp.js +417 -0
- package/dist/network/gen/constants.d.ts +878 -0
- package/dist/network/gen/constants.js +886 -0
- package/dist/network/http.d.ts +458 -0
- package/dist/network/http.js +732 -0
- package/dist/network/ip-address.d.ts +210 -0
- package/dist/network/ip-address.js +301 -0
- package/dist/network/packet.d.ts +249 -0
- package/dist/network/packet.js +326 -0
- package/dist/network/sftp.d.ts +661 -0
- package/dist/network/sftp.js +826 -0
- package/dist/network/socket-selector.d.ts +132 -0
- package/dist/network/socket-selector.js +214 -0
- package/dist/network/socket.d.ts +301 -0
- package/dist/network/socket.js +402 -0
- package/dist/network/tcp-listener.d.ts +114 -0
- package/dist/network/tcp-listener.js +199 -0
- package/dist/network/tcp-socket.d.ts +307 -0
- package/dist/network/tcp-socket.js +493 -0
- package/dist/network/tls-material.d.ts +22 -0
- package/dist/network/tls-material.js +52 -0
- package/dist/network/udp-socket.d.ts +178 -0
- package/dist/network/udp-socket.js +285 -0
- package/dist/system/angle.d.ts +77 -0
- package/dist/system/angle.js +122 -0
- package/dist/system/clock.d.ts +65 -0
- package/dist/system/clock.js +99 -0
- package/dist/system/err.d.ts +18 -0
- package/dist/system/err.js +61 -0
- package/dist/system/error.d.ts +15 -0
- package/dist/system/error.js +22 -0
- package/dist/system/file-input-stream.d.ts +68 -0
- package/dist/system/file-input-stream.js +148 -0
- package/dist/system/input-stream.d.ts +114 -0
- package/dist/system/input-stream.js +106 -0
- package/dist/system/operators.d.ts +291 -0
- package/dist/system/operators.js +505 -0
- package/dist/system/sleep.d.ts +9 -0
- package/dist/system/sleep.js +28 -0
- package/dist/system/suspend-aware-clock.d.ts +22 -0
- package/dist/system/suspend-aware-clock.js +29 -0
- package/dist/system/time.d.ts +100 -0
- package/dist/system/time.js +188 -0
- package/dist/system/timeout-with-predicate.d.ts +60 -0
- package/dist/system/timeout-with-predicate.js +52 -0
- package/dist/system/unicode.d.ts +54 -0
- package/dist/system/unicode.js +67 -0
- package/dist/system/vector2.d.ts +302 -0
- package/dist/system/vector2.js +314 -0
- package/dist/system/vector3.d.ts +249 -0
- package/dist/system/vector3.js +266 -0
- package/dist/system/version.d.ts +51 -0
- package/dist/system/version.js +24 -0
- package/dist/window/clipboard.d.ts +14 -0
- package/dist/window/clipboard.js +26 -0
- package/dist/window/context-settings.d.ts +94 -0
- package/dist/window/context-settings.js +84 -0
- package/dist/window/context.d.ts +87 -0
- package/dist/window/context.js +122 -0
- package/dist/window/cursor.d.ts +58 -0
- package/dist/window/cursor.js +80 -0
- package/dist/window/event.d.ts +529 -0
- package/dist/window/event.js +87 -0
- package/dist/window/gen/constants.d.ts +2213 -0
- package/dist/window/gen/constants.js +2227 -0
- package/dist/window/joystick.d.ts +81 -0
- package/dist/window/joystick.js +80 -0
- package/dist/window/keyboard.d.ts +50 -0
- package/dist/window/keyboard.js +59 -0
- package/dist/window/mouse.d.ts +31 -0
- package/dist/window/mouse.js +57 -0
- package/dist/window/sensor.d.ts +26 -0
- package/dist/window/sensor.js +40 -0
- package/dist/window/touch.d.ts +27 -0
- package/dist/window/touch.js +44 -0
- package/dist/window/video-mode.d.ts +77 -0
- package/dist/window/video-mode.js +99 -0
- package/dist/window/vulkan.d.ts +32 -0
- package/dist/window/vulkan.js +45 -0
- package/dist/window/window.d.ts +355 -0
- package/dist/window/window.js +434 -0
- package/docs/README.ja.md +30 -0
- package/docs/README.ko.md +30 -0
- package/docs/README.md +30 -0
- package/docs/README.zh-CN.md +30 -0
- package/docs/api.ja.md +84 -0
- package/docs/api.ko.md +84 -0
- package/docs/api.md +81 -0
- package/docs/api.zh-CN.md +81 -0
- package/docs/audio.ja.md +249 -0
- package/docs/audio.ko.md +251 -0
- package/docs/audio.md +252 -0
- package/docs/audio.zh-CN.md +252 -0
- package/docs/concepts.ja.md +130 -0
- package/docs/concepts.ko.md +130 -0
- package/docs/concepts.md +131 -0
- package/docs/concepts.zh-CN.md +131 -0
- package/docs/development.ja.md +148 -0
- package/docs/development.ko.md +148 -0
- package/docs/development.md +150 -0
- package/docs/development.zh-CN.md +150 -0
- package/docs/getting-started.ja.md +154 -0
- package/docs/getting-started.ko.md +154 -0
- package/docs/getting-started.md +156 -0
- package/docs/getting-started.zh-CN.md +156 -0
- package/docs/graphics.ja.md +256 -0
- package/docs/graphics.ko.md +254 -0
- package/docs/graphics.md +255 -0
- package/docs/graphics.zh-CN.md +257 -0
- package/docs/network.ja.md +214 -0
- package/docs/network.ko.md +216 -0
- package/docs/network.md +218 -0
- package/docs/network.zh-CN.md +218 -0
- package/docs/system.ja.md +169 -0
- package/docs/system.ko.md +171 -0
- package/docs/system.md +173 -0
- package/docs/system.zh-CN.md +173 -0
- package/docs/window.ja.md +138 -0
- package/docs/window.ko.md +140 -0
- package/docs/window.md +141 -0
- package/docs/window.zh-CN.md +141 -0
- package/native/addon.cc +129 -0
- package/native/audio-binding.cc +543 -0
- package/native/audio-codec-binding.cc +246 -0
- package/native/audio-device-binding.cc +160 -0
- package/native/audio-file-binding.cc +192 -0
- package/native/audio-recorder-binding.cc +237 -0
- package/native/audio-recorder.h +39 -0
- package/native/audio-state.h +220 -0
- package/native/audio-stream-binding.cc +284 -0
- package/native/audio-stream.h +28 -0
- package/native/audio-worker-binding.cc +447 -0
- package/native/audio-worker.h +121 -0
- package/native/batch-drawable.cc +189 -0
- package/native/batch-drawable.h +57 -0
- package/native/context-binding.cc +180 -0
- package/native/context-settings.h +74 -0
- package/native/deferred-delete.cc +49 -0
- package/native/deferred-delete.h +84 -0
- package/native/error-stream-binding.cc +270 -0
- package/native/exception-boundary.h +97 -0
- package/native/font-binding.cc +210 -0
- package/native/font-state.h +27 -0
- package/native/graphics-binding.cc +338 -0
- package/native/graphics-state.h +253 -0
- package/native/image-binding.cc +258 -0
- package/native/image-state.h +93 -0
- package/native/input-binding.cc +246 -0
- package/native/numeric-fields.h +96 -0
- package/native/render-window-binding.cc +103 -0
- package/native/render-window-state.h +22 -0
- package/native/shader-binding.cc +292 -0
- package/native/shape-binding.cc +283 -0
- package/native/shape-state.h +68 -0
- package/native/shaped-glyph-storage.h +45 -0
- package/native/shared-handle.h +69 -0
- package/native/stream-binding.cc +286 -0
- package/native/system-binding.cc +91 -0
- package/native/text-binding.cc +205 -0
- package/native/text-state.h +101 -0
- package/native/texture-binding.cc +330 -0
- package/native/texture-resource.h +52 -0
- package/native/time-value.h +28 -0
- package/native/transformable-binding.cc +23 -0
- package/native/transformable-state.h +44 -0
- package/native/value-binding.h +200 -0
- package/native/value-layout.h +116 -0
- package/native/values-binding.cc +27 -0
- package/native/vertex-binding.cc +50 -0
- package/native/vertex-buffer-binding.cc +232 -0
- package/native/vertex-storage.h +20 -0
- package/native/view-data.h +24 -0
- package/native/window-binding.cc +388 -0
- package/native/window-event.h +92 -0
- package/native/window-owner.h +81 -0
- package/package.json +87 -35
- package/src/audio/effect-processor.ts +86 -0
- package/src/audio/input-sound-file.ts +259 -0
- package/src/audio/listener.ts +136 -0
- package/src/audio/music.ts +357 -0
- package/src/audio/output-sound-file.ts +96 -0
- package/src/audio/playback-device.ts +145 -0
- package/src/audio/sound-buffer-recorder.ts +141 -0
- package/src/audio/sound-buffer.ts +275 -0
- package/src/audio/sound-file-factory.ts +235 -0
- package/src/audio/sound-file-reader.ts +224 -0
- package/src/audio/sound-file-writer.ts +61 -0
- package/src/audio/sound-recorder.ts +315 -0
- package/src/audio/sound-source.ts +396 -0
- package/src/audio/sound-stream.ts +108 -0
- package/src/audio/sound.ts +63 -0
- package/src/audio/value.ts +408 -0
- package/src/audio/worker.ts +308 -0
- package/src/graphics/blend-mode.ts +291 -0
- package/src/graphics/boolean-vector.ts +225 -0
- package/src/graphics/circle-shape.ts +113 -0
- package/src/graphics/color.ts +374 -0
- package/src/graphics/convex-shape.ts +76 -0
- package/src/graphics/drawable.ts +32 -0
- package/src/graphics/font.ts +377 -0
- package/src/graphics/glsl-matrix.ts +110 -0
- package/src/graphics/glsl.ts +229 -0
- package/src/graphics/glyph.ts +186 -0
- package/src/graphics/image.ts +366 -0
- package/src/graphics/primitive-type.ts +56 -0
- package/src/graphics/rect.ts +350 -0
- package/src/graphics/rectangle-shape.ts +76 -0
- package/src/graphics/render-states.ts +238 -0
- package/src/graphics/render-target.ts +554 -0
- package/src/graphics/render-texture.ts +234 -0
- package/src/graphics/render-window.ts +250 -0
- package/src/graphics/shader.ts +353 -0
- package/src/graphics/shape.ts +343 -0
- package/src/graphics/sprite.ts +203 -0
- package/src/graphics/stencil-mode.ts +258 -0
- package/src/graphics/swap.ts +28 -0
- package/src/graphics/text.ts +944 -0
- package/src/graphics/texture.ts +529 -0
- package/src/graphics/transform.ts +321 -0
- package/src/graphics/transformable.ts +37 -0
- package/src/graphics/vertex-array.ts +270 -0
- package/src/graphics/vertex-buffer.ts +345 -0
- package/src/graphics/vertex.ts +211 -0
- package/src/graphics/view.ts +355 -0
- package/src/index.ts +147 -0
- package/src/internal/audio-codec-registry.ts +68 -0
- package/src/internal/audio-input-stream.ts +42 -0
- package/src/internal/audio-music-pump.ts +199 -0
- package/src/internal/audio-native.ts +176 -0
- package/src/internal/audio-recorder-session.ts +234 -0
- package/src/internal/audio-worker-session.ts +89 -0
- package/src/internal/audio-worker.ts +146 -0
- package/src/internal/glsl-value.ts +79 -0
- package/src/internal/graphics-state.ts +131 -0
- package/src/internal/input-stream.ts +30 -0
- package/src/internal/lazy-value.ts +62 -0
- package/src/internal/native.ts +581 -0
- package/src/internal/numeric-properties.ts +37 -0
- package/src/internal/render-states.ts +42 -0
- package/src/internal/scalar.ts +117 -0
- package/src/internal/shaped-glyph.ts +68 -0
- package/src/internal/struct-view.ts +49 -0
- package/src/internal/text-indices.ts +19 -0
- package/src/internal/transformable.ts +260 -0
- package/src/internal/value-storage.ts +40 -0
- package/src/network/common.ts +58 -0
- package/src/network/dns.ts +191 -0
- package/src/network/ftp.ts +386 -0
- package/src/network/gen/constants.ts +879 -0
- package/src/network/http.ts +680 -0
- package/src/network/ip-address.ts +311 -0
- package/src/network/packet.ts +388 -0
- package/src/network/sftp.ts +1015 -0
- package/src/network/socket-selector.ts +206 -0
- package/src/network/socket.ts +415 -0
- package/src/network/tcp-listener.ts +193 -0
- package/src/network/tcp-socket.ts +569 -0
- package/src/network/tls-material.ts +46 -0
- package/src/network/udp-socket.ts +294 -0
- package/src/system/angle.ts +132 -0
- package/src/system/clock.ts +104 -0
- package/src/system/err.ts +58 -0
- package/src/system/error.ts +18 -0
- package/src/system/file-input-stream.ts +147 -0
- package/src/system/input-stream.ts +150 -0
- package/src/system/operators.ts +681 -0
- package/src/system/sleep.ts +25 -0
- package/src/system/suspend-aware-clock.ts +27 -0
- package/src/system/time.ts +218 -0
- package/src/system/timeout-with-predicate.ts +94 -0
- package/src/system/unicode.ts +64 -0
- package/src/system/vector2.ts +549 -0
- package/src/system/vector3.ts +433 -0
- package/src/system/version.ts +66 -0
- package/src/window/clipboard.ts +22 -0
- package/src/window/context-settings.ts +143 -0
- package/src/window/context.ts +152 -0
- package/src/window/cursor.ts +116 -0
- package/src/window/event.ts +580 -0
- package/src/window/gen/constants.ts +2231 -0
- package/src/window/joystick.ts +108 -0
- package/src/window/keyboard.ts +78 -0
- package/src/window/mouse.ts +58 -0
- package/src/window/sensor.ts +37 -0
- package/src/window/touch.ts +42 -0
- package/src/window/video-mode.ts +136 -0
- package/src/window/vulkan.ts +42 -0
- package/src/window/window.ts +579 -0
- package/test/native/audio-probes.cc +181 -0
- package/test/native/deferred-delete-probes.cc +62 -0
- package/test/native/drawable-probes.cc +168 -0
- package/test/native/exception-probes.cc +83 -0
- package/test/native/image-probes.cc +105 -0
- package/test/native/matrix-probes.cc +67 -0
- package/test/native/network-oracle.cc +32 -0
- package/test/native/render-texture-probes.cc +193 -0
- package/test/native/shader-probes.cc +69 -0
- package/test/native/shape-probes.cc +160 -0
- package/test/native/sprite-probes.cc +146 -0
- package/test/native/system-probes.cc +109 -0
- package/test/native/text-probes.cc +211 -0
- package/test/native/texture-probes.cc +200 -0
- package/test/native/time-probes.cc +143 -0
- package/test/native/transform-probes.cc +92 -0
- package/test/native/transformable-probes.cc +152 -0
- package/test/native/value-oracle.h +88 -0
- package/test/native/value-probes.cc +379 -0
- package/test/native/vertex-array-probes.cc +82 -0
- package/test/native/vertex-buffer-probes.cc +87 -0
- package/test/native/view-probes.cc +150 -0
- package/test/native/window-probes.cc +172 -0
- package/test/tsconfig.json +8 -0
- package/tools/configure-lsp.cjs +23 -0
- package/tools/constant-docs.cjs +109 -0
- package/tools/constant-docs.json +1318 -0
- package/tools/generate-network-constants.cjs +59 -0
- package/tools/generate-window-constants.cjs +178 -0
- package/tools/lib_downloader.cjs +92 -0
- package/tools/lib_downloader_urls.cjs +23 -0
- package/tsconfig.json +11 -4
- package/index.d.ts +0 -1
- package/lib/clock.d.ts +0 -8
- package/lib/clock.js +0 -5
- package/lib/color.d.ts +0 -11
- package/lib/color.js +0 -98
- package/lib/common.js +0 -47
- package/lib/drawable/circle_shape.d.ts +0 -5
- package/lib/drawable/circle_shape.js +0 -26
- package/lib/drawable/convex_shape.d.ts +0 -5
- package/lib/drawable/convex_shape.js +0 -35
- package/lib/drawable/drawable.d.ts +0 -6
- package/lib/drawable/drawable.js +0 -18
- package/lib/drawable/plugin_package.d.ts +0 -31
- package/lib/drawable/plugin_package.js +0 -102
- package/lib/drawable/rectangle_shape.d.ts +0 -9
- package/lib/drawable/rectangle_shape.js +0 -28
- package/lib/drawable/shape.d.ts +0 -14
- package/lib/drawable/shape.js +0 -30
- package/lib/drawable/sprite.d.ts +0 -17
- package/lib/drawable/sprite.js +0 -53
- package/lib/drawable/text.d.ts +0 -26
- package/lib/drawable/text.js +0 -88
- package/lib/drawable/transformable.d.ts +0 -28
- package/lib/drawable/transformable.js +0 -113
- package/lib/drawable/vertex_array.d.ts +0 -40
- package/lib/drawable/vertex_array.js +0 -128
- package/lib/font.d.ts +0 -24
- package/lib/font.js +0 -137
- package/lib/image.d.ts +0 -26
- package/lib/image.js +0 -147
- package/lib/joystick.d.ts +0 -21
- package/lib/joystick.js +0 -72
- package/lib/keyboard.d.ts +0 -113
- package/lib/keyboard.js +0 -17
- package/lib/mouse.d.ts +0 -6
- package/lib/mouse.js +0 -39
- package/lib/poll_event.d.ts +0 -138
- package/lib/rect.d.ts +0 -18
- package/lib/rect.js +0 -119
- package/lib/render_window.d.ts +0 -67
- package/lib/render_window.js +0 -197
- package/lib/sensor.d.ts +0 -12
- package/lib/sensor.js +0 -34
- package/lib/sfml.d.ts +0 -32
- package/lib/sfml.js +0 -36
- package/lib/sound/base.d.ts +0 -33
- package/lib/sound/base.js +0 -109
- package/lib/sound/music.d.ts +0 -15
- package/lib/sound/music.js +0 -65
- package/lib/sound/sound.d.ts +0 -16
- package/lib/sound/sound.js +0 -55
- package/lib/sound/sound_buffer.d.ts +0 -14
- package/lib/sound/sound_buffer.js +0 -78
- package/lib/texture.d.ts +0 -21
- package/lib/texture.js +0 -127
- package/lib/time.d.ts +0 -13
- package/lib/time.js +0 -41
- package/lib/touch.d.ts +0 -7
- package/lib/touch.js +0 -34
- package/lib/vector2.d.ts +0 -49
- package/lib/vector2.js +0 -141
- package/lib/vector3.d.ts +0 -47
- package/lib/vector3.js +0 -154
- package/lib/vertex.d.ts +0 -14
- package/lib/vertex.js +0 -177
- package/lib/video_mode.d.ts +0 -12
- package/lib/video_mode.js +0 -99
- package/src/base_class_with_loading.h +0 -21
- package/src/clock.cc +0 -71
- package/src/clock.h +0 -30
- package/src/color.cc +0 -189
- package/src/color.h +0 -49
- package/src/drawable/circle_shape.cc +0 -78
- package/src/drawable/circle_shape.h +0 -28
- package/src/drawable/convex_shape.cc +0 -57
- package/src/drawable/convex_shape.h +0 -29
- package/src/drawable/drawable-inl.h +0 -29
- package/src/drawable/drawable.cc +0 -41
- package/src/drawable/drawable.h +0 -49
- package/src/drawable/package_plugin-inl.h +0 -191
- package/src/drawable/package_plugin.h +0 -60
- package/src/drawable/rectangle_shape.cc +0 -69
- package/src/drawable/rectangle_shape.h +0 -29
- package/src/drawable/shape.cc +0 -67
- package/src/drawable/shape.h +0 -39
- package/src/drawable/sprite.cc +0 -122
- package/src/drawable/sprite.h +0 -45
- package/src/drawable/text.cc +0 -133
- package/src/drawable/text.h +0 -54
- package/src/drawable/vertex_array.cc +0 -248
- package/src/drawable/vertex_array.h +0 -46
- package/src/font.cc +0 -214
- package/src/font.h +0 -44
- package/src/gen/.gitkeep +0 -0
- package/src/gen/joystick_axis.cc +0 -30
- package/src/gen/keycode.cc +0 -226
- package/src/gen/mouse_button.cc +0 -30
- package/src/gen/sensor_type.cc +0 -26
- package/src/image.cc +0 -379
- package/src/image.h +0 -72
- package/src/joystick.cc +0 -132
- package/src/joystick.h +0 -32
- package/src/keyboard.cc +0 -65
- package/src/keyboard.h +0 -27
- package/src/mouse.cc +0 -95
- package/src/mouse.h +0 -30
- package/src/plugins/transformable_plugin-inl.h +0 -121
- package/src/plugins/transformable_plugin.h +0 -42
- package/src/poll_event.cc +0 -326
- package/src/poll_event.h +0 -18
- package/src/rect-inl.h +0 -154
- package/src/rect.cc +0 -28
- package/src/rect.h +0 -105
- package/src/render_window.cc +0 -413
- package/src/render_window.h +0 -111
- package/src/render_window_async_display.cc +0 -49
- package/src/render_window_async_draw.cc +0 -56
- package/src/resizable_buffer.h +0 -104
- package/src/sensor.cc +0 -82
- package/src/sensor.h +0 -28
- package/src/sfml.cc +0 -85
- package/src/sound/music.cc +0 -113
- package/src/sound/music.h +0 -35
- package/src/sound/sound.cc +0 -116
- package/src/sound/sound.h +0 -41
- package/src/sound/sound_buffer.cc +0 -226
- package/src/sound/sound_buffer.h +0 -46
- package/src/sound/sound_source.cc +0 -124
- package/src/sound/sound_source.h +0 -80
- package/src/texture.cc +0 -246
- package/src/texture.h +0 -47
- package/src/time.cc +0 -177
- package/src/time.h +0 -42
- package/src/touch.cc +0 -54
- package/src/touch.h +0 -23
- package/src/utils-inl.h +0 -48
- package/src/utils.h +0 -21
- package/src/vector2-inl.h +0 -198
- package/src/vector2.cc +0 -36
- package/src/vector2.h +0 -133
- package/src/vector3-inl.h +0 -200
- package/src/vector3.cc +0 -36
- package/src/vector3.h +0 -134
- package/src/vertex.cc +0 -238
- package/src/vertex.h +0 -114
- package/src/video_mode.cc +0 -184
- package/src/video_mode.h +0 -38
- package/src/workers/load_from_file_worker.h +0 -79
- package/src/workers/save_to_file_worker.h +0 -79
- package/third_party/sfml/include/SFML/Audio/AlResource.hpp +0 -70
- package/third_party/sfml/include/SFML/Audio/Export.hpp +0 -48
- package/third_party/sfml/include/SFML/Audio/InputSoundFile.hpp +0 -268
- package/third_party/sfml/include/SFML/Audio/Listener.hpp +0 -234
- package/third_party/sfml/include/SFML/Audio/Music.hpp +0 -337
- package/third_party/sfml/include/SFML/Audio/OutputSoundFile.hpp +0 -133
- package/third_party/sfml/include/SFML/Audio/Sound.hpp +0 -264
- package/third_party/sfml/include/SFML/Audio/SoundBuffer.hpp +0 -352
- package/third_party/sfml/include/SFML/Audio/SoundBufferRecorder.hpp +0 -144
- package/third_party/sfml/include/SFML/Audio/SoundFileFactory.hpp +0 -197
- package/third_party/sfml/include/SFML/Audio/SoundFileFactory.inl +0 -100
- package/third_party/sfml/include/SFML/Audio/SoundFileReader.hpp +0 -165
- package/third_party/sfml/include/SFML/Audio/SoundFileWriter.hpp +0 -125
- package/third_party/sfml/include/SFML/Audio/SoundRecorder.hpp +0 -410
- package/third_party/sfml/include/SFML/Audio/SoundSource.hpp +0 -332
- package/third_party/sfml/include/SFML/Audio/SoundStream.hpp +0 -420
- package/third_party/sfml/include/SFML/Audio.hpp +0 -56
- package/third_party/sfml/include/SFML/Config.hpp +0 -248
- package/third_party/sfml/include/SFML/GpuPreference.hpp +0 -74
- package/third_party/sfml/include/SFML/Graphics/BlendMode.hpp +0 -219
- package/third_party/sfml/include/SFML/Graphics/CircleShape.hpp +0 -154
- package/third_party/sfml/include/SFML/Graphics/Color.hpp +0 -275
- package/third_party/sfml/include/SFML/Graphics/ConvexShape.hpp +0 -153
- package/third_party/sfml/include/SFML/Graphics/Drawable.hpp +0 -126
- package/third_party/sfml/include/SFML/Graphics/Export.hpp +0 -48
- package/third_party/sfml/include/SFML/Graphics/Font.hpp +0 -496
- package/third_party/sfml/include/SFML/Graphics/Glsl.hpp +0 -227
- package/third_party/sfml/include/SFML/Graphics/Glsl.inl +0 -155
- package/third_party/sfml/include/SFML/Graphics/Glyph.hpp +0 -81
- package/third_party/sfml/include/SFML/Graphics/Image.hpp +0 -346
- package/third_party/sfml/include/SFML/Graphics/PrimitiveType.hpp +0 -58
- package/third_party/sfml/include/SFML/Graphics/Rect.hpp +0 -274
- package/third_party/sfml/include/SFML/Graphics/Rect.inl +0 -171
- package/third_party/sfml/include/SFML/Graphics/RectangleShape.hpp +0 -132
- package/third_party/sfml/include/SFML/Graphics/RenderStates.hpp +0 -174
- package/third_party/sfml/include/SFML/Graphics/RenderTarget.hpp +0 -518
- package/third_party/sfml/include/SFML/Graphics/RenderTexture.hpp +0 -334
- package/third_party/sfml/include/SFML/Graphics/RenderWindow.hpp +0 -302
- package/third_party/sfml/include/SFML/Graphics/Shader.hpp +0 -875
- package/third_party/sfml/include/SFML/Graphics/Shape.hpp +0 -355
- package/third_party/sfml/include/SFML/Graphics/Sprite.hpp +0 -279
- package/third_party/sfml/include/SFML/Graphics/Text.hpp +0 -513
- package/third_party/sfml/include/SFML/Graphics/Texture.hpp +0 -733
- package/third_party/sfml/include/SFML/Graphics/Transform.hpp +0 -497
- package/third_party/sfml/include/SFML/Graphics/Transformable.hpp +0 -429
- package/third_party/sfml/include/SFML/Graphics/Vertex.hpp +0 -148
- package/third_party/sfml/include/SFML/Graphics/VertexArray.hpp +0 -223
- package/third_party/sfml/include/SFML/Graphics/VertexBuffer.hpp +0 -408
- package/third_party/sfml/include/SFML/Graphics/View.hpp +0 -343
- package/third_party/sfml/include/SFML/Graphics.hpp +0 -68
- package/third_party/sfml/include/SFML/Main.hpp +0 -43
- package/third_party/sfml/include/SFML/Network/Export.hpp +0 -48
- package/third_party/sfml/include/SFML/Network/Ftp.hpp +0 -616
- package/third_party/sfml/include/SFML/Network/Http.hpp +0 -482
- package/third_party/sfml/include/SFML/Network/IpAddress.hpp +0 -328
- package/third_party/sfml/include/SFML/Network/Packet.hpp +0 -545
- package/third_party/sfml/include/SFML/Network/Socket.hpp +0 -219
- package/third_party/sfml/include/SFML/Network/SocketHandle.hpp +0 -57
- package/third_party/sfml/include/SFML/Network/SocketSelector.hpp +0 -263
- package/third_party/sfml/include/SFML/Network/TcpListener.hpp +0 -170
- package/third_party/sfml/include/SFML/Network/TcpSocket.hpp +0 -316
- package/third_party/sfml/include/SFML/Network/UdpSocket.hpp +0 -292
- package/third_party/sfml/include/SFML/Network.hpp +0 -53
- package/third_party/sfml/include/SFML/OpenGL.hpp +0 -78
- package/third_party/sfml/include/SFML/System/Clock.hpp +0 -117
- package/third_party/sfml/include/SFML/System/Err.hpp +0 -80
- package/third_party/sfml/include/SFML/System/Export.hpp +0 -48
- package/third_party/sfml/include/SFML/System/FileInputStream.hpp +0 -169
- package/third_party/sfml/include/SFML/System/InputStream.hpp +0 -152
- package/third_party/sfml/include/SFML/System/Lock.hpp +0 -139
- package/third_party/sfml/include/SFML/System/MemoryInputStream.hpp +0 -148
- package/third_party/sfml/include/SFML/System/Mutex.hpp +0 -148
- package/third_party/sfml/include/SFML/System/NativeActivity.hpp +0 -62
- package/third_party/sfml/include/SFML/System/NonCopyable.hpp +0 -129
- package/third_party/sfml/include/SFML/System/Sleep.hpp +0 -52
- package/third_party/sfml/include/SFML/System/String.hpp +0 -669
- package/third_party/sfml/include/SFML/System/String.inl +0 -53
- package/third_party/sfml/include/SFML/System/Thread.hpp +0 -282
- package/third_party/sfml/include/SFML/System/Thread.inl +0 -90
- package/third_party/sfml/include/SFML/System/ThreadLocal.hpp +0 -103
- package/third_party/sfml/include/SFML/System/ThreadLocalPtr.hpp +0 -158
- package/third_party/sfml/include/SFML/System/ThreadLocalPtr.inl +0 -77
- package/third_party/sfml/include/SFML/System/Time.hpp +0 -488
- package/third_party/sfml/include/SFML/System/Utf.hpp +0 -763
- package/third_party/sfml/include/SFML/System/Utf.inl +0 -752
- package/third_party/sfml/include/SFML/System/Vector2.hpp +0 -301
- package/third_party/sfml/include/SFML/System/Vector2.inl +0 -161
- package/third_party/sfml/include/SFML/System/Vector3.hpp +0 -302
- package/third_party/sfml/include/SFML/System/Vector3.inl +0 -168
- package/third_party/sfml/include/SFML/System.hpp +0 -60
- package/third_party/sfml/include/SFML/Window/Clipboard.hpp +0 -119
- package/third_party/sfml/include/SFML/Window/Context.hpp +0 -195
- package/third_party/sfml/include/SFML/Window/ContextSettings.hpp +0 -149
- package/third_party/sfml/include/SFML/Window/Cursor.hpp +0 -241
- package/third_party/sfml/include/SFML/Window/Event.hpp +0 -285
- package/third_party/sfml/include/SFML/Window/Export.hpp +0 -48
- package/third_party/sfml/include/SFML/Window/GlResource.hpp +0 -109
- package/third_party/sfml/include/SFML/Window/Joystick.hpp +0 -227
- package/third_party/sfml/include/SFML/Window/Keyboard.hpp +0 -491
- package/third_party/sfml/include/SFML/Window/Mouse.hpp +0 -180
- package/third_party/sfml/include/SFML/Window/Sensor.hpp +0 -150
- package/third_party/sfml/include/SFML/Window/Touch.hpp +0 -137
- package/third_party/sfml/include/SFML/Window/VideoMode.hpp +0 -228
- package/third_party/sfml/include/SFML/Window/Vulkan.hpp +0 -115
- package/third_party/sfml/include/SFML/Window/Window.hpp +0 -354
- package/third_party/sfml/include/SFML/Window/WindowBase.hpp +0 -518
- package/third_party/sfml/include/SFML/Window/WindowHandle.hpp +0 -101
- package/third_party/sfml/include/SFML/Window/WindowStyle.hpp +0 -53
- package/third_party/sfml/include/SFML/Window.hpp +0 -58
- package/tools/clang_format.js +0 -9
- package/tools/copier/linux.js +0 -21
- package/tools/copier/macos.js +0 -34
- package/tools/copier/windows.js +0 -33
- package/tools/joystick_axis.js +0 -63
- package/tools/keycode.js +0 -92
- package/tools/lib_downloader.js +0 -107
- package/tools/lib_downloader_urls.js +0 -59
- package/tools/mouse_button.js +0 -92
- package/tools/sensor_type.js +0 -63
package/docs/api.ko.md
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
# API 안내
|
|
2
|
+
|
|
3
|
+
[English](api.md) / [简体中文](api.zh-CN.md) / [日本語](api.ja.md) / **한국어**
|
|
4
|
+
|
|
5
|
+
> sfml.js는 SFML 3.1.0을 기반으로 합니다. 직접 작성한 가이드는 사용법, 반환값, Node.js에 맞춘 조정을 설명하며, 전체 시그니처와 타입 제약은 소스에서 생성한 [TypeDoc](https://sfml.js.org/ko/reference/)에서 제공합니다.
|
|
6
|
+
|
|
7
|
+
[문서 홈](README.ko.md) · [빠른 시작](getting-started.ko.md) · [핵심 개념](concepts.ko.md)
|
|
8
|
+
|
|
9
|
+
모든 공개 인터페이스는 `sfml.js`에서 가져옵니다. 내보내기 목록은 [src/index.ts](../src/index.ts)를 참고하세요. 애플리케이션 코드에서 `dist/internal`이나 네이티브 모듈 핸들에 접근할 필요는 없습니다.
|
|
10
|
+
|
|
11
|
+
## 작업별 선택
|
|
12
|
+
|
|
13
|
+
| 작업 | 문서 | 주요 인터페이스 |
|
|
14
|
+
| --- | --- | --- |
|
|
15
|
+
| 좌표, 각도, 프레임 시간 계산 | [System](system.ko.md) | Vector2/3, Angle, Time, Clock, 이름 있는 연산자 |
|
|
16
|
+
| 사용자 정의 파일 소스 연결 | [입력 스트림](system.ko.md#input-streams) | InputStream, MemoryInputStream, FileInputStream |
|
|
17
|
+
| 창 열기와 입력 수신 | [Window](window.ko.md) | RenderWindow, Window, Event, Keyboard, Mouse |
|
|
18
|
+
| 이미지와 애니메이션 표시 | [Graphics](graphics.ko.md) | Image, Texture, Sprite |
|
|
19
|
+
| 도형과 텍스트 그리기 | [Graphics](graphics.ko.md) | Shape, Font, Glyph, Text |
|
|
20
|
+
| 카메라, 오프스크린 합성, 일괄 지오메트리 처리 | [Graphics](graphics.ko.md) | View, RenderTexture, VertexArray, VertexBuffer |
|
|
21
|
+
| 사용자 정의 그리기와 셰이더 | [Graphics](graphics.ko.md) | Drawable, RenderStates, Shader, Glsl |
|
|
22
|
+
| 재생, 녹음, 오디오 처리 | [Audio](audio.ko.md) | SoundBuffer, Sound, Music, SoundStream, SoundRecorder |
|
|
23
|
+
| 네트워크 연결과 파일 전송 | [Network](network.ko.md) | Packet, TcpSocket, UdpSocket, Http, Ftp, Sftp |
|
|
24
|
+
|
|
25
|
+
## System
|
|
26
|
+
|
|
27
|
+
`Vector2`/`Vector3`는 여러 스칼라 타입을 지원합니다. `Vector2i/u/f`와 `Vector3i/u/f`는 자주 사용하는 특수화입니다. `degrees()`/`radians()`로 Angle을, 시간 팩토리 함수로 Time을 생성합니다.
|
|
28
|
+
|
|
29
|
+
JavaScript에는 C++ 연산자 오버로딩이 없으므로 해당 연산에는 `add()`, `multiply()`, `equal()`, `*Assign()`을 사용합니다. `Clock`, 비동기 `sleep()`, `TimeoutWithPredicate`, 입력 스트림, `Unicode`, 오류 로그 인터페이스도 이 모듈에 속합니다.
|
|
30
|
+
|
|
31
|
+
자세한 내용은 [System](system.ko.md)을 참고하세요.
|
|
32
|
+
|
|
33
|
+
## Window
|
|
34
|
+
|
|
35
|
+
`Window`는 시스템 창과 OpenGL 컨텍스트를 제공합니다. 2D 그리기에는 보통 Window와 RenderTarget의 기능을 함께 갖춘 `RenderWindow`를 사용합니다.
|
|
36
|
+
|
|
37
|
+
이벤트는 `pollEvent()`, `handleEvents()`, 동기식 `waitEvent()`로 가져올 수 있습니다. 키보드, 마우스, 조이스틱, 센서에는 실시간 조회 기능도 있습니다. `Clipboard`, `Cursor`, `Context`, `Vulkan`은 시스템 통합 기능을 담당합니다.
|
|
38
|
+
|
|
39
|
+
자세한 내용은 [Window](window.ko.md)를 참고하세요.
|
|
40
|
+
|
|
41
|
+
## Graphics
|
|
42
|
+
|
|
43
|
+
Image는 CPU 측 픽셀을, Texture는 GPU 텍스처를 저장하며, Sprite는 텍스처를 참조해 그립니다. Shape는 원, 사각형, 볼록 다각형, 사용자 정의 볼록 도형을 제공합니다. Font와 Text는 폰트 로딩, 텍스트 레이아웃, 편집 가능한 정점을 제공합니다.
|
|
44
|
+
|
|
45
|
+
RenderTarget은 창과 오프스크린 대상의 그리기 인터페이스를 통일합니다. View는 카메라와 뷰포트를 제어하고, RenderStates는 변환, 블렌딩, 스텐실, 텍스처, Shader를 제어합니다. 정점 배열과 GPU 정점 버퍼로 지오메트리를 직접 구성할 수 있습니다.
|
|
46
|
+
|
|
47
|
+
자세한 내용은 [Graphics](graphics.ko.md)와 [그리기 스냅샷](concepts.ko.md#draw-snapshots)을 참고하세요.
|
|
48
|
+
|
|
49
|
+
## Audio
|
|
50
|
+
|
|
51
|
+
짧은 효과음에는 SoundBuffer + Sound를, 긴 오디오에는 Music을 사용합니다. SoundSource는 볼륨, 패닝, 공간 오디오 속성을 제공합니다. SoundStream, SoundRecorder, EffectProcessor는 Worker 콜백으로 사용자 정의 데이터를 처리합니다.
|
|
52
|
+
|
|
53
|
+
자세한 내용은 [Audio](audio.ko.md)를 참고하세요. 특히 샘플 수, 채널 배치, 버퍼의 유효 기간에 주의해야 합니다.
|
|
54
|
+
|
|
55
|
+
## Network
|
|
56
|
+
|
|
57
|
+
Network는 Node.js 전송 계층으로 SFML 스타일 API를 구현합니다. 실제 서비스 코드는 SFML C++ Network를 호출하지 않습니다. Packet은 SFML 인코딩 규칙을 유지하며, TCP, UDP, DNS, TLS, HTTP, FTP, SFTP의 I/O는 Promise를 사용합니다.
|
|
58
|
+
|
|
59
|
+
상태 반환, 부분 전송, 프로토콜 제한, 종료 방법을 포함한 자세한 내용은 [Network](network.ko.md)를 참고하세요.
|
|
60
|
+
|
|
61
|
+
## 호환 범위
|
|
62
|
+
|
|
63
|
+
| 항목 | 현재 동작 |
|
|
64
|
+
| --- | --- |
|
|
65
|
+
| C++ 포인터, 참조 출력 매개변수 | 객체, 뷰, 반환 객체로 표현 |
|
|
66
|
+
| C++ 템플릿 및 연산자 | 명시적인 스칼라 태그, 클래스, 이름 있는 함수로 표현 |
|
|
67
|
+
| 파일 로딩 | Promise 사용, 구체적인 실패 상태는 각 인터페이스의 규칙을 유지 |
|
|
68
|
+
| 소멸 | 네이티브 소유권과 JS 참조를 함께 사용하며, 닫기 인터페이스가 있는 리소스는 명시적으로 닫아야 함 |
|
|
69
|
+
| `drawAsync()`/`displayAsync()` | 제공하지 않으며, 이전 예제에서 명시적으로 미지원으로 보고 |
|
|
70
|
+
| Android SuspendAwareClock | 조건부 컴파일 인터페이스가 있으며, 현재 다운로드 절차는 데스크톱 대상 |
|
|
71
|
+
| Vulkan | 조회 인터페이스가 내보내지며, 사용 가능 여부는 SFML 플랫폼 백엔드에 따라 결정됨. macOS 백엔드에서는 사용 불가 |
|
|
72
|
+
|
|
73
|
+
플랫폼별 빌드와 테스트 범위는 [개발 가이드](development.ko.md#testing)를 참고하세요.
|
|
74
|
+
|
|
75
|
+
<a id="sfml-cpp-reference"></a>
|
|
76
|
+
## SFML C++ 레퍼런스
|
|
77
|
+
|
|
78
|
+
[SFML 3.1.0 공식 문서 색인](https://www.sfml-dev.org/documentation/3.1.0/)은 C++ API의 개념을 확인하는 기준입니다. JavaScript 시그니처와 타입 제약은 [TypeDoc](https://sfml.js.org/ko/reference/)을 기준으로 하세요. 각 모듈의 관련 원본 클래스와 JS 차이는 아래에서 확인할 수 있습니다.
|
|
79
|
+
|
|
80
|
+
- [System C++ 레퍼런스](system.ko.md#sfml-cpp-reference)
|
|
81
|
+
- [Window C++ 레퍼런스](window.ko.md#sfml-cpp-reference)
|
|
82
|
+
- [Graphics C++ 레퍼런스](graphics.ko.md#sfml-cpp-reference)
|
|
83
|
+
- [Audio C++ 레퍼런스](audio.ko.md#sfml-cpp-reference)
|
|
84
|
+
- [Network C++ 레퍼런스](network.ko.md#sfml-cpp-reference)
|
package/docs/api.md
ADDED
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# API Guide
|
|
2
|
+
|
|
3
|
+
**English** · [简体中文](api.zh-CN.md) · [日本語](api.ja.md) · [한국어](api.ko.md)
|
|
4
|
+
|
|
5
|
+
> sfml.js is based on SFML 3.1.0. The handwritten guides explain usage, return values and Node.js adaptations; [TypeDoc](https://sfml.js.org/reference/) generates complete signatures and type constraints from the source.
|
|
6
|
+
|
|
7
|
+
[Documentation](README.md) · [Quick start](getting-started.md) · [Core concepts](concepts.md)
|
|
8
|
+
|
|
9
|
+
Import all public APIs from `sfml.js`; see [src/index.ts](../src/index.ts) for the export list. Application code does not need to access `dist/internal` or native module handles.
|
|
10
|
+
|
|
11
|
+
## Choose by task
|
|
12
|
+
|
|
13
|
+
| Task | Guide | Main APIs |
|
|
14
|
+
| --- | --- | --- |
|
|
15
|
+
| Calculate coordinates, angles and frame times | [System](system.md) | Vector2/3, Angle, Time, Clock, named operators |
|
|
16
|
+
| Integrate custom file sources | [Input streams](system.md#input-streams) | InputStream, MemoryInputStream, FileInputStream |
|
|
17
|
+
| Open windows and receive input | [Window](window.md) | RenderWindow, Window, Event, Keyboard, Mouse |
|
|
18
|
+
| Display images and animation | [Graphics](graphics.md) | Image, Texture, Sprite |
|
|
19
|
+
| Draw shapes and text | [Graphics](graphics.md) | Shape, Font, Glyph, Text |
|
|
20
|
+
| Cameras, off-screen composition and batched geometry | [Graphics](graphics.md) | View, RenderTexture, VertexArray, VertexBuffer |
|
|
21
|
+
| Custom drawing and shaders | [Graphics](graphics.md) | Drawable, RenderStates, Shader, Glsl |
|
|
22
|
+
| Play, record and process audio | [Audio](audio.md) | SoundBuffer, Sound, Music, SoundStream, SoundRecorder |
|
|
23
|
+
| Connect to networks and transfer files | [Network](network.md) | Packet, TcpSocket, UdpSocket, Http, Ftp, Sftp |
|
|
24
|
+
|
|
25
|
+
## System
|
|
26
|
+
|
|
27
|
+
`Vector2`/`Vector3` support multiple scalar types; `Vector2i/u/f` and `Vector3i/u/f` are common specializations. `degrees()`/`radians()` create an Angle, and time factories create a Time.
|
|
28
|
+
|
|
29
|
+
JavaScript does not support C++ operator overloading, so use `add()`, `multiply()`, `equal()` and `*Assign()` for the corresponding operations. This module also includes `Clock`, asynchronous `sleep()`, `TimeoutWithPredicate`, input streams, `Unicode` and error logging APIs.
|
|
30
|
+
|
|
31
|
+
See [System](system.md).
|
|
32
|
+
|
|
33
|
+
## Window
|
|
34
|
+
|
|
35
|
+
`Window` provides a system window and an OpenGL context. For 2D drawing, use `RenderWindow`, which combines Window and RenderTarget capabilities.
|
|
36
|
+
|
|
37
|
+
Receive events through `pollEvent()`, `handleEvents()` or synchronous `waitEvent()`. Keyboard, mouse, joystick and sensor APIs also provide real-time queries. `Clipboard`, `Cursor`, `Context` and `Vulkan` cover system integration.
|
|
38
|
+
|
|
39
|
+
See [Window](window.md).
|
|
40
|
+
|
|
41
|
+
## Graphics
|
|
42
|
+
|
|
43
|
+
Image stores CPU-side pixels, Texture stores a GPU texture, and Sprite references a texture for drawing. Shape provides circles, rectangles, convex polygons and custom convex shapes; Font and Text provide font loading, layout and editable vertices.
|
|
44
|
+
|
|
45
|
+
RenderTarget unifies drawing APIs for windows and off-screen targets. View controls the camera and viewport; RenderStates controls transforms, blending, stencil settings, textures and shaders. Vertex arrays and GPU vertex buffers let you organize geometry directly.
|
|
46
|
+
|
|
47
|
+
See [Graphics](graphics.md) and [draw snapshots](concepts.md#draw-snapshots).
|
|
48
|
+
|
|
49
|
+
## Audio
|
|
50
|
+
|
|
51
|
+
Use SoundBuffer + Sound for short effects and Music for long audio. SoundSource provides volume, panning and spatial audio properties; SoundStream, SoundRecorder and EffectProcessor use Worker callbacks to process custom data.
|
|
52
|
+
|
|
53
|
+
See [Audio](audio.md), paying particular attention to sample counts, channel layout and buffer lifetime.
|
|
54
|
+
|
|
55
|
+
## Network
|
|
56
|
+
|
|
57
|
+
Network implements SFML-style APIs using Node.js transports; production code does not call SFML C++ Network. Packet preserves SFML encoding conventions; TCP, UDP, DNS, TLS, HTTP, FTP and SFTP I/O use promises.
|
|
58
|
+
|
|
59
|
+
See [Network](network.md) for returned statuses, partial sends, protocol limits and shutdown methods.
|
|
60
|
+
|
|
61
|
+
## Compatibility boundaries
|
|
62
|
+
|
|
63
|
+
| Feature | Current behavior |
|
|
64
|
+
| --- | --- |
|
|
65
|
+
| C++ pointers and reference output parameters | Represented as objects, views or returned objects |
|
|
66
|
+
| C++ templates and operators | Represented by explicit scalar tags, classes and named functions |
|
|
67
|
+
| File loading | Uses promises, preserving each API's specific failure status |
|
|
68
|
+
| Destruction | Native ownership works with JS references; explicitly close resources that expose a close method |
|
|
69
|
+
| `drawAsync()`/`displayAsync()` | Not provided; legacy examples explicitly report them as unsupported |
|
|
70
|
+
| Android SuspendAwareClock | Conditionally compiled API; the current download flow targets desktops |
|
|
71
|
+
| Vulkan | Query APIs are exported; availability depends on the SFML platform backend, with no macOS backend |
|
|
72
|
+
|
|
73
|
+
See the [development guide](development.md#testing) for platform build and test coverage.
|
|
74
|
+
|
|
75
|
+
<a id="sfml-cpp-reference"></a>
|
|
76
|
+
|
|
77
|
+
## SFML C++ reference
|
|
78
|
+
|
|
79
|
+
[TypeDoc](https://sfml.js.org/reference/) is the authority for JavaScript signatures and types. The [SFML 3.1.0 reference index](https://www.sfml-dev.org/documentation/3.1.0/) is the authority for upstream C++ concepts, not a drop-in JavaScript API reference.
|
|
80
|
+
|
|
81
|
+
Each module guide links to relevant C++ classes and explains binding-specific differences: [System](system.md#sfml-cpp-reference), [Window](window.md#sfml-cpp-reference), [Graphics](graphics.md#sfml-cpp-reference), [Audio](audio.md#sfml-cpp-reference) and [Network](network.md#sfml-cpp-reference).
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# API 导航
|
|
2
|
+
|
|
3
|
+
[English](api.md) · **简体中文** · [日本語](api.ja.md) · [한국어](api.ko.md)
|
|
4
|
+
|
|
5
|
+
> sfml.js 以 SFML 3.1.0 为基础。手写指南解释使用方式、返回值和 Node.js 适配;完整签名与类型约束由 [TypeDoc](https://sfml.js.org/zh/reference/) 从源码生成。
|
|
6
|
+
|
|
7
|
+
[文档首页](README.zh-CN.md) · [快速开始](getting-started.zh-CN.md) · [核心概念](concepts.zh-CN.md)
|
|
8
|
+
|
|
9
|
+
所有公开接口均从 `sfml.js` 导入,导出清单见 [src/index.ts](../src/index.ts)。业务代码无需访问 `dist/internal` 或原生模块句柄。
|
|
10
|
+
|
|
11
|
+
## 按任务选择
|
|
12
|
+
|
|
13
|
+
| 任务 | 文档 | 主要接口 |
|
|
14
|
+
| --- | --- | --- |
|
|
15
|
+
| 计算坐标、角度和帧时间 | [System](system.zh-CN.md) | Vector2/3、Angle、Time、Clock、具名运算符 |
|
|
16
|
+
| 接入自定义文件来源 | [输入流](system.zh-CN.md#input-streams) | InputStream、MemoryInputStream、FileInputStream |
|
|
17
|
+
| 打开窗口、接收输入 | [Window](window.zh-CN.md) | RenderWindow、Window、Event、Keyboard、Mouse |
|
|
18
|
+
| 显示图片与动画 | [Graphics](graphics.zh-CN.md) | Image、Texture、Sprite |
|
|
19
|
+
| 绘制形状与文字 | [Graphics](graphics.zh-CN.md) | Shape、Font、Glyph、Text |
|
|
20
|
+
| 相机、离屏合成与批量几何 | [Graphics](graphics.zh-CN.md) | View、RenderTexture、VertexArray、VertexBuffer |
|
|
21
|
+
| 自定义绘制与着色器 | [Graphics](graphics.zh-CN.md) | Drawable、RenderStates、Shader、Glsl |
|
|
22
|
+
| 播放、录音及音频处理 | [Audio](audio.zh-CN.md) | SoundBuffer、Sound、Music、SoundStream、SoundRecorder |
|
|
23
|
+
| 联网与传输文件 | [Network](network.zh-CN.md) | Packet、TcpSocket、UdpSocket、Http、Ftp、Sftp |
|
|
24
|
+
|
|
25
|
+
## System
|
|
26
|
+
|
|
27
|
+
`Vector2`/`Vector3` 支持多种标量类型;`Vector2i/u/f` 和 `Vector3i/u/f` 是常用特化。`degrees()`/`radians()` 创建 Angle,时间工厂创建 Time。
|
|
28
|
+
|
|
29
|
+
JavaScript 没有 C++ 运算符重载,对应操作使用 `add()`、`multiply()`、`equal()` 及 `*Assign()`。`Clock`、异步 `sleep()`、`TimeoutWithPredicate`、输入流、`Unicode` 和错误日志接口也属于本模块。
|
|
30
|
+
|
|
31
|
+
详见 [System](system.zh-CN.md)。
|
|
32
|
+
|
|
33
|
+
## Window
|
|
34
|
+
|
|
35
|
+
`Window` 提供系统窗口及 OpenGL 上下文;二维绘制一般使用同时具有 Window 与 RenderTarget 能力的 `RenderWindow`。
|
|
36
|
+
|
|
37
|
+
事件可通过 `pollEvent()`、`handleEvents()` 或同步 `waitEvent()` 获取。键盘、鼠标、摇杆和传感器还提供实时查询。`Clipboard`、`Cursor`、`Context` 与 `Vulkan` 覆盖系统集成。
|
|
38
|
+
|
|
39
|
+
详见 [Window](window.zh-CN.md)。
|
|
40
|
+
|
|
41
|
+
## Graphics
|
|
42
|
+
|
|
43
|
+
Image 保存 CPU 侧像素,Texture 保存 GPU 纹理,Sprite 引用纹理进行绘制。Shape 提供圆、矩形、凸多边形和自定义凸形状;Font 与 Text 提供字体加载、排版及可编辑顶点。
|
|
44
|
+
|
|
45
|
+
RenderTarget 统一窗口和离屏目标的绘制接口。View 控制相机与视口,RenderStates 控制变换、混合、模板、纹理和 Shader。顶点数组及 GPU 顶点缓冲用于直接组织几何。
|
|
46
|
+
|
|
47
|
+
详见 [Graphics](graphics.zh-CN.md) 和 [绘制快照](concepts.zh-CN.md#draw-snapshots)。
|
|
48
|
+
|
|
49
|
+
## Audio
|
|
50
|
+
|
|
51
|
+
短音效使用 SoundBuffer + Sound,长音频使用 Music。SoundSource 提供音量、声像和空间音频属性;SoundStream、SoundRecorder、EffectProcessor 使用 Worker 回调处理自定义数据。
|
|
52
|
+
|
|
53
|
+
详见 [Audio](audio.zh-CN.md),特别注意样本数、声道排列及缓冲有效期。
|
|
54
|
+
|
|
55
|
+
## Network
|
|
56
|
+
|
|
57
|
+
Network 使用 Node.js 传输实现 SFML 风格 API,生产代码不调用 SFML C++ Network。Packet 保留 SFML 编码约定;TCP、UDP、DNS、TLS、HTTP、FTP 和 SFTP 的 I/O 使用 Promise。
|
|
58
|
+
|
|
59
|
+
详见 [Network](network.zh-CN.md),包括状态返回、部分发送、协议限制与关闭方式。
|
|
60
|
+
|
|
61
|
+
## 兼容边界
|
|
62
|
+
|
|
63
|
+
| 项目 | 当前行为 |
|
|
64
|
+
| --- | --- |
|
|
65
|
+
| C++ 指针、引用输出参数 | 用对象、视图或返回对象表达 |
|
|
66
|
+
| C++ 模板及运算符 | 用明确的标量标签、类和具名函数表达 |
|
|
67
|
+
| 文件加载 | 使用 Promise,具体失败状态按接口保留 |
|
|
68
|
+
| 析构 | Native 所有权配合 JS 引用;有关闭接口的资源应显式关闭 |
|
|
69
|
+
| `drawAsync()`/`displayAsync()` | 未提供,旧示例明确报告不支持 |
|
|
70
|
+
| Android SuspendAwareClock | 有条件编译接口;当前下载流程面向桌面 |
|
|
71
|
+
| Vulkan | 已导出查询接口;可用性取决于 SFML 平台后端,macOS 后端不可用 |
|
|
72
|
+
|
|
73
|
+
平台构建与测试范围见 [开发指南](development.zh-CN.md#testing)。
|
|
74
|
+
|
|
75
|
+
<a id="sfml-cpp-reference"></a>
|
|
76
|
+
|
|
77
|
+
## SFML C++ 参考
|
|
78
|
+
|
|
79
|
+
[SFML 3.1.0 官方文档](https://www.sfml-dev.org/documentation/3.1.0/) 解释 C++ 类和上游概念,TypeDoc 则是 sfml.js 的 JavaScript/TypeScript 签名参考。两者配合阅读:先用上游文档理解功能,再按本项目指南调用。
|
|
80
|
+
|
|
81
|
+
各模块的上游链接与适配边界:[System](system.zh-CN.md#sfml-cpp-reference)、[Window](window.zh-CN.md#sfml-cpp-reference)、[Graphics](graphics.zh-CN.md#sfml-cpp-reference)、[Audio](audio.zh-CN.md#sfml-cpp-reference)、[Network](network.zh-CN.md#sfml-cpp-reference)。
|
package/docs/audio.ja.md
ADDED
|
@@ -0,0 +1,249 @@
|
|
|
1
|
+
# Audio
|
|
2
|
+
|
|
3
|
+
[English](audio.md) / [简体中文](audio.zh-CN.md) / **日本語** / [한국어](audio.ko.md)
|
|
4
|
+
|
|
5
|
+
> 短い効果音には SoundBuffer + Sound、長い音声には Music を使います。独自のデータ供給、録音処理、エフェクトは Node Worker で実行します。
|
|
6
|
+
|
|
7
|
+
[API ナビゲーション](api.ja.md) · [基本概念](concepts.ja.md) · [サンプル](../examples/README.ja.md)
|
|
8
|
+
|
|
9
|
+
## インターフェースの選択
|
|
10
|
+
|
|
11
|
+
| 目的 | インターフェース |
|
|
12
|
+
| --- | --- |
|
|
13
|
+
| 短い効果音を読み込んで繰り返し再生 | SoundBuffer、Sound |
|
|
14
|
+
| ファイル、メモリ、入力ストリームのストリーミング再生 | Music |
|
|
15
|
+
| PCM を独自に生成 | SoundStream + Worker モジュール |
|
|
16
|
+
| 音量、パン、空間プロパティの調整 | SoundSource、Listener |
|
|
17
|
+
| 再生デバイスの選択 | PlaybackDevice |
|
|
18
|
+
| バッファへの録音 | SoundBufferRecorder |
|
|
19
|
+
| 収録データの独自処理 | SoundRecorder + Worker モジュール |
|
|
20
|
+
| 音源出力の処理 | EffectProcessor |
|
|
21
|
+
| 音声ファイルの読み書きと形式の拡張 | InputSoundFile、OutputSoundFile、SoundFileFactory |
|
|
22
|
+
|
|
23
|
+
ファイルと圧縮データには「空のコンストラクター + await open/load」を使います。SoundBuffer と Sound はコピーコンストラクターを提供し、SoundBuffer は PCM からの構築にも対応します。完全なシグネチャは [TypeDoc](https://sfml.js.org/ja/reference/) を参照してください。
|
|
24
|
+
|
|
25
|
+
## 短い効果音の再生
|
|
26
|
+
|
|
27
|
+
```js
|
|
28
|
+
const sf = require('sfml.js');
|
|
29
|
+
|
|
30
|
+
async function play() {
|
|
31
|
+
const buffer = new sf.SoundBuffer();
|
|
32
|
+
if (!await buffer.loadFromFile('sound.wav')) {
|
|
33
|
+
throw new Error('Cannot load sound.wav');
|
|
34
|
+
}
|
|
35
|
+
const sound = new sf.Sound(buffer);
|
|
36
|
+
sound.setVolume(25);
|
|
37
|
+
sound.play();
|
|
38
|
+
while (sound.getStatus() === sf.SoundStatus.Playing) {
|
|
39
|
+
await sf.sleep(sf.milliseconds(10));
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
play().catch(error => {
|
|
43
|
+
console.error(error);
|
|
44
|
+
process.exitCode = 1;
|
|
45
|
+
});
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
`setLooping()` でループを制御し、`setPlayingOffset()` で再生位置を調整します。複数の Sound は同じ SoundBuffer を共有できます。Sound をコピーしても Worker のエフェクトは共有しません。
|
|
49
|
+
|
|
50
|
+
## 音楽の再生
|
|
51
|
+
|
|
52
|
+
以下のコードは async 関数内で実行してください。
|
|
53
|
+
|
|
54
|
+
```javascript
|
|
55
|
+
const music = new sf.Music();
|
|
56
|
+
try {
|
|
57
|
+
if (!await music.openFromFile('music.ogg')) {
|
|
58
|
+
throw new Error('Cannot open music.ogg');
|
|
59
|
+
}
|
|
60
|
+
music.play();
|
|
61
|
+
await sf.sleep(sf.seconds(5));
|
|
62
|
+
} finally {
|
|
63
|
+
await music.close();
|
|
64
|
+
}
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Music は SoundStream を継承し、再生時間とループ区間を提供します。getter が返した Time を読み取っても、再生位置を直接変更することはできません。変更には setter を呼ぶ必要があります。
|
|
68
|
+
|
|
69
|
+
## PCM と共有メモリ
|
|
70
|
+
|
|
71
|
+
`getSamples()` は `sf::SoundBuffer::getSamples()` にマッピングされた Int16Array を返し、空のバッファでは undefined を返します。音声サンプルはチャンネルをインターリーブして配置します。sampleCount は全チャンネルを含むサンプル数で、bigint を使います。サンプルレートとチャンネル数は number、duration と playingOffset は Time を使います。
|
|
72
|
+
|
|
73
|
+
SoundBuffer の sampleRate と duration は安定した SFML フィールドに直接マッピングされ、サンプル数とチャンネル数はネイティブ側の派生フィールドに保存されます。Cone、TimeSpan、SoundFileReader.Info の数値は、それぞれのネイティブ構造体にマッピングされます。SoundSource と Listener は、安定したネイティブの数値制御領域を使って引数と結果を受け渡します。各制御操作では引き続き SFML の setter/getter を呼び、オーディオエンジンが同期、変換、状態更新を行います。位置、方向、Cone、Time は独立した値を返すため、getter の結果を変更しても音源は変わりません。
|
|
74
|
+
|
|
75
|
+
PCM と読み取り専用の channelMap ビューの BackingStore は、対応するネイティブメモリの割り当てを維持します。SoundBuffer の再読み込みが成功すると、古いビューは古い割り当てを指し続け、関連する Sound は新しいバッファに切り替わります。読み込みに失敗した場合は現在のリソースを保持します。SoundBufferRecorder は録音ごとに新しいネイティブ recorder を使い、終了時にはその `getBuffer()` を直接マッピングします。以前の録音のビューも引き続き有効です。
|
|
76
|
+
|
|
77
|
+
`new SoundBuffer(samples, channelCount, sampleRate, channelMap)` は Int16Array から同期的に構築します。配列ビューの長さをサンプル数として使い、SFML がサンプルをコピーします。読み込みに失敗すると SFMLError を投げます。
|
|
78
|
+
|
|
79
|
+
`target.assign(source)` は source の現在のサンプルとメタデータをネイティブ側でディープコピーし、target を返します。転送先の JS オブジェクトとネイティブハンドルは変わらず、関連する Sound は転送先の新しい割り当てに再バインドされます。以前に取得したサンプルとチャンネルのビューは古い割り当てを維持します。source には録音が返す ReadonlySoundBuffer も使えます。自己代入は直ちに返り、ビューや再生状態を変更しません。このメソッドと `loadFromSamples()` は現在のリソースを同期的に置き換えますが、すでに開始済みの非同期読み込みが成功すると、その結果も後から反映されます。操作順序を固定したい場合は、先に読み込みを await してください。
|
|
80
|
+
|
|
81
|
+
```js
|
|
82
|
+
const source = new sf.SoundBuffer(
|
|
83
|
+
new Int16Array([ 1000, -1000, 500, -500 ]),
|
|
84
|
+
1, 44100, [ sf.SoundChannel.Mono ],
|
|
85
|
+
);
|
|
86
|
+
const target = new sf.SoundBuffer();
|
|
87
|
+
target.assign(source);
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
ReadonlySamples、ChannelMap、ReadonlySoundBuffer の読み取り専用制約は TypeScript の型に適用されます。実行時にサンプルごとの Proxy はありません。JS から無理に書き込んだり、これらの読み取り専用ビューの基盤 buffer を切り離したり転送したりしないでください。独立した書き込み可能なデータが必要な場合は `slice()` を使います。
|
|
91
|
+
|
|
92
|
+
`loadFromSamples()` は SFML を同期的に呼び、SFML がコピー済みのサンプルを保持します。非同期のメモリ読み込みとファイルの read/write は、操作に関わる基盤メモリの割り当てを保持します。呼び出し側は Promise が完了するまで、入力/出力バッファを変更、切り離し、リサイズしてはいけません。`Music.openFromMemory()` と `InputSoundFile.openFromMemory()` の圧縮データは、リソースを閉じるか開き直すまで変更しないでください。
|
|
93
|
+
|
|
94
|
+
## 音源のコピー代入
|
|
95
|
+
|
|
96
|
+
`SoundSource.assign(source)` は、ピッチ、パン、音量、空間化、位置、方向、音響コーン、速度、ドップラー、指向性減衰係数、相対位置モード、距離、ゲイン、減衰の設定を同期的にコピーし、転送先自身を返します。Music と独自の SoundStream はこのメソッドを継承します。転送先の内容、ループ設定、再生位置、再生状態、エフェクトは保持され、コピー元には影響しません。コピーは 1 回のネイティブ呼び出しで完了し、SFML の setter がエンジンを更新します。制御領域の fast buffer は元のマッピングを維持します。
|
|
97
|
+
|
|
98
|
+
`Sound.assign(sourceSound)` は Sound を受け取り、上記のプロパティ、ループ設定、SoundBuffer のバインドを同期的にコピーします。2 つの Sound は同じバッファを参照し、代入は JS 参照、ネイティブ側の寿命維持、関連付けリストを更新します。転送先は停止して再生位置がゼロに戻り、コピー元の再生は変わりません。転送先は自身の EffectProcessor を保持します。既存のエフェクトキューは世代番号の更新によって無効化され、その後、古いブロックが破棄されます。転送先のネイティブ sf::Sound インスタンスと制御領域は変わりません。
|
|
99
|
+
|
|
100
|
+
どちらの assign も、自己代入では直ちに返ります。Sound に対して基底クラスのプロパティだけをコピーしたい場合は、`SoundSource.prototype.assign.call(targetSound, source)` を明示的に呼べます。変数の型を SoundSource としても、JS の動的なメソッドディスパッチは変わりません。
|
|
101
|
+
|
|
102
|
+
SFML 3.1.0 の `SoundSource::operator=` は directionalAttenuationFactor をコピーしませんが、このバインディングのプロパティコピーにはこのフィールドも含まれます。
|
|
103
|
+
|
|
104
|
+
```js
|
|
105
|
+
music.assign(sound); // 音源プロパティをコピーし、music の内容と再生状態は保持する。
|
|
106
|
+
targetSound.assign(sourceSound); // 同じバッファにバインドし、targetSound を停止して再生位置をゼロに戻す。
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
## Worker によるデータ供給
|
|
110
|
+
|
|
111
|
+
すべての Audio Worker はモジュールのファクトリーを使い、CommonJS と ESM に対応します。`module` はファイルパスまたは URL、`exportName` の既定値は `default` です。`data` は Worker の structured clone 規則に従って渡されます。ファクトリーは `{ sampleRate, channelCount, blockFrames }` と data を受け取り、対応するコールバックオブジェクトを返します。Promise を返すこともできます。
|
|
112
|
+
|
|
113
|
+
リポジトリの [audio-worker.cjs](../examples/audio-worker.cjs) には、実行可能な `tone` と `filter` のファクトリーがあります。
|
|
114
|
+
|
|
115
|
+
```js
|
|
116
|
+
const path = require('node:path');
|
|
117
|
+
const sf = require('sfml.js');
|
|
118
|
+
|
|
119
|
+
async function playStream() {
|
|
120
|
+
const stream = new sf.SoundStream({
|
|
121
|
+
module: path.resolve('examples/audio-worker.cjs'),
|
|
122
|
+
exportName: 'tone',
|
|
123
|
+
data: { frequency: 330 },
|
|
124
|
+
sampleRate: 44100,
|
|
125
|
+
channelCount: 1,
|
|
126
|
+
channelMap: [ sf.SoundChannel.Mono ],
|
|
127
|
+
blockFrames: 1024,
|
|
128
|
+
queueBlocks: 8,
|
|
129
|
+
});
|
|
130
|
+
try {
|
|
131
|
+
if (!await stream.ready) return;
|
|
132
|
+
stream.play();
|
|
133
|
+
await sf.sleep(sf.seconds(2));
|
|
134
|
+
} finally {
|
|
135
|
+
await stream.close();
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
playStream().catch(error => {
|
|
139
|
+
console.error(error);
|
|
140
|
+
process.exitCode = 1;
|
|
141
|
+
});
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
| コールバック | 契約 |
|
|
145
|
+
|------|------|
|
|
146
|
+
| `onGetData(chunk)` | ネイティブ側が提供する `chunk.samples` に書き込み、`chunk.sampleCount` を設定する。true は継続、false は最後のブロックを意味する |
|
|
147
|
+
| `onSeek(time)` | 生成側のカーソルを Time に移動する。初期化時にも 1 回呼ばれる |
|
|
148
|
+
| `onLoop()` | 最後のブロックの準備段階で呼ばれる。インターリーブされたサンプルのオフセットを bigint で返し、undefined は今回のループを禁止する。省略時は既定で `0n` を返す |
|
|
149
|
+
| `onClose()` | Worker の終了前にリソースをクリーンアップする |
|
|
150
|
+
|
|
151
|
+
`chunk.samples` を置き換えることはできません。sampleCount はスロットの容量を超えてはならず、チャンネル数の整数倍である必要があります。データ供給を続ける場合は、ゼロサンプルを送信できません。最後のブロックには有効なサンプルを含められます。seek 時にネイティブ側が世代番号を更新し、デバイススレッドが以前にキューへ入れたデータを破棄します。その後 Worker が新しい onSeek を実行します。
|
|
152
|
+
|
|
153
|
+
コールバックが受け取る TypedArray は、再利用可能なネイティブスロットです。そのコールバックが完了するまでの間だけ、そのコールバックが専有します。保持して後からアクセスしないでください。内容を残す必要がある場合は自身で `slice()` します。Promise が完了して初めてスロットが送信または解放されます。コールバックは必ず最終的に完了する必要があります。完了しないユーザー Promise は、正常な `close()` や録音キューの排出を妨げます。
|
|
154
|
+
|
|
155
|
+
## エフェクト
|
|
156
|
+
|
|
157
|
+
以下のコードは、作成済みの Sound に続けて async 関数内で実行します。`path` は `node:path` を指し、Worker モジュールのパスはリポジトリのルートを基準とします。
|
|
158
|
+
|
|
159
|
+
```js
|
|
160
|
+
const effect = new sf.EffectProcessor({
|
|
161
|
+
module: path.resolve('examples/audio-worker.cjs'),
|
|
162
|
+
exportName: 'filter',
|
|
163
|
+
blockFrames: 1024,
|
|
164
|
+
queueBlocks: 8,
|
|
165
|
+
maxChannelCount: 8,
|
|
166
|
+
});
|
|
167
|
+
await effect.ready;
|
|
168
|
+
sound.setEffectProcessor(effect);
|
|
169
|
+
// 使用後は、先に音源から取り外してから Worker を終了する。
|
|
170
|
+
sound.setEffectProcessor();
|
|
171
|
+
await effect.close();
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
エフェクトのファクトリーは `process(input, inputFrameCount, output, outputFrameCount, channelCount)` を返します。input と output はネイティブの float32 キューへのマッピングです。入力はすでに空間化されており、channelCount は今回のデバイス出力のチャンネル数です。`{ inputFrameCount, outputFrameCount }` を返して実際に消費・生成したフレーム数を指定でき、部分的な消費も可能です。void を返すと、入力をすべて消費し、同じフレーム数を出力したものとみなします。残響処理以外の呼び出しでは、少なくとも 1 フレームを消費または生成する必要があります。
|
|
175
|
+
|
|
176
|
+
input が null の場合は残響処理を表します。残響を出力でき、最後に出力フレーム数としてゼロを返すと終了します。各フレームは channelCount 個のインターリーブされた float32 サンプルを持ち、今回渡された有効なビューの範囲だけにアクセスできます。`maxChannelCount` は事前割り当ての容量で、既定値は 8 です。実際のチャンネル数が容量を超えると無音を出力します。ファクトリーの context 内の channelCount は容量を表し、実際の処理では process の引数を基準とします。sampleRate は Worker の作成時に読み取るため、デバイスの切り替え後には、サンプルレートに依存するエフェクトを作り直す必要があります。
|
|
177
|
+
|
|
178
|
+
1 つの EffectProcessor を同時に取り付けられる音源は 1 つだけです。取り外した後は別の音源に取り付けられます。取り付けと取り外しは、音源の再生位置と再生/一時停止状態を保持します。取り付けたままの EffectProcessor を明示的に閉じると、その音源のエフェクト経路は無音を出力します。
|
|
179
|
+
|
|
180
|
+
## 録音
|
|
181
|
+
|
|
182
|
+
以下のコードは async 関数内で実行し、`sf` はパッケージのインポートを指します。先に入力デバイスが利用できることを確認し、OS のマイク権限を許可してください。
|
|
183
|
+
|
|
184
|
+
```js
|
|
185
|
+
const recorder = new sf.SoundBufferRecorder();
|
|
186
|
+
recorder.setChannelCount(1);
|
|
187
|
+
try {
|
|
188
|
+
if (!await recorder.start(44100)) throw new Error('Cannot start recording');
|
|
189
|
+
await sf.sleep(sf.seconds(1));
|
|
190
|
+
} finally {
|
|
191
|
+
await recorder.stop();
|
|
192
|
+
}
|
|
193
|
+
const recorded = recorder.getBuffer();
|
|
194
|
+
console.log(recorded.getSampleCount());
|
|
195
|
+
if (!await recorded.saveToFile('recorded.wav')) throw new Error('Cannot save recording');
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
`start()`、`stop()`、`setDevice()` は Promise を返します。チャンネル数は 1 または 2 に対応します。変更する前に録音を停止し、処理中の操作を待ってください。再生デバイスと入力デバイスは別々に照会・選択します。
|
|
199
|
+
|
|
200
|
+
独自の SoundRecorder は SoundStream と同じ Worker 設定を使います。ファクトリーは任意の `onStart()`、必須の `onProcessSamples(samples)`、任意の `onStop()` を返します。onStart が false を返すと開始を取り消します。onProcessSamples はコールバック中だけ有効なネイティブの Int16Array を受け取ります。false を返すと非同期タスクが収録を停止します。通常の `await stop()` はキューの排出と onStop の完了を待ちますが、コールバックが自ら false を返した場合は、キュー内の残りのサンプルを破棄します。
|
|
201
|
+
|
|
202
|
+
## ファイルストリームとコーデックの拡張
|
|
203
|
+
|
|
204
|
+
SoundBuffer、Music、InputSoundFile は、既存の InputStream、MemoryInputStream、FileInputStream に対応しています。ファイルの読み書き、開く操作、閉じる操作はオブジェクト単位で直列に実行し、異なるオブジェクト間では並列に実行できます。開く操作が成功してからネイティブのメタデータを公開します。非同期の read/seek が完了するまで、getter は前回公開された結果を返します。
|
|
205
|
+
|
|
206
|
+
SFML 内蔵のファイル/メモリのデコードはスレッド内で実行します。非同期 InputStream は、独立したネイティブのデコードスレッドと libuv 通知のブリッジを使い、JS のファイル I/O を待つことで libuv のワーカースレッドプールを占有し尽くすのを防ぎます。InputStream の read の書き込み先バッファはネイティブ側で割り当て、完了時に有効なバイト列のスナップショットを取得します。
|
|
207
|
+
|
|
208
|
+
Music の通常のファイル/メモリ入力は `sf::Music` を使います。InputStream または登録済みの JS Reader からの入力は、容量を制限した PCM プリフェッチを使い、既定は 1024 フレーム、8 スロットです。非同期デコードはデバイスコールバックの外で実行し、再生、シーク、ループはネイティブの SoundStream を通じてデータを消費します。JS のカスタム Reader は呼び出し元の環境で動作するため、時間のかかる同期的な JS デコードは、その環境のイベントループを占有します。
|
|
209
|
+
|
|
210
|
+
SFML 内蔵の Reader/Writer は、SoundFileFactory で作成した後も `open()` を呼ぶ必要があります。WAV、FLAC、Ogg の書き込みと読み戻しにはランタイムテストがあります。その他の SFML 内蔵入力形式は、現在の SFML ビルドが提供するデコード対応を引き継ぎます。
|
|
211
|
+
|
|
212
|
+
拡張 Reader は SoundFileReader を継承し、静的な `check(stream)`、`open(stream)`、`seek(sampleOffset)`、`read(samples)`、任意の `close()` を提供します。open は `new SoundFileReader.Info({ sampleCount, sampleRate, channelCount, channelMap })` または undefined を返します。read は渡された Int16Array に書き込み、実際のサンプル数を bigint で返します。拡張 Writer は SoundFileWriter を継承し、静的な `check(filename)`、`open(filename, sampleRate, channelCount, channelMap)`、`write(samples)`、任意の `close()` を提供します。これらのメソッドは Promise を返せます。
|
|
213
|
+
|
|
214
|
+
`SoundFileFactory.registerReader(ReaderClass)` と `registerWriter(WriterClass)` で登録し、対応する unregister メソッドで解除します。同じクラスを繰り返し登録しても重複して追加されません。JS のレジストリーは現在の Node 環境に属するため、Worker は自身の環境で登録する必要があります。すべての公開 SoundBuffer、Music、音声ファイルの入口は、登録済みの JS クラスを先に調べ、一致しなければ SFML 内蔵のファクトリーにフォールバックします。テンプレートによる登録インターフェースは JS クラスで実現し、プロセス全体の C++ ファクトリーへ JS の関数ポインターを組み込むことはありません。完全な拡張例は [audio-codec.test.cjs](../test/audio-codec.test.cjs) を参照してください。
|
|
215
|
+
|
|
216
|
+
## バッファ、状態、クリーンアップ
|
|
217
|
+
|
|
218
|
+
Worker の既定値は `blockFrames = 1024`、`queueBlocks = 8` です。64~65536 フレーム、2~32 スロット、1~32 チャンネルを指定できます。スロットのメモリはネイティブ側で事前に割り当て、acquire/release によって公開と返却を行います。PCM を postMessage でコピーすることはありません。postMessage は ready、エラー、停止の通知だけを伝えます。
|
|
219
|
+
|
|
220
|
+
44100 Hz の 1024 フレームは 23.22 ms で、8 スロットには約 185.76 ms のサンプルを格納できます。これはブロックの長さとキューの容量であり、エンドツーエンドの遅延を保証する値ではありません。Worker は 2 ms ごとに利用可能なスロットを非同期で確認します。デバイスの出力は SFML とシステムのバッファにも影響されます。
|
|
221
|
+
|
|
222
|
+
| 状況 | 挙動と統計の単位 |
|
|
223
|
+
|------|----------------|
|
|
224
|
+
| Stream に準備済みの PCM がない | 無音を出力。underruns はブロック不足の回数を集計 |
|
|
225
|
+
| 録音キューが満杯 | 新しいサンプルを破棄。overruns はインターリーブされたサンプル数を集計 |
|
|
226
|
+
| エフェクトの入力キューが満杯 | 今回受信した入力フレームを破棄。overruns はフレーム数を集計 |
|
|
227
|
+
| エフェクトの出力が不足 | 不足部分を無音で補う。underruns はフレーム数を集計 |
|
|
228
|
+
| processed | Stream/Recorder はインターリーブされたサンプル数、EffectProcessor は消費した入力フレーム数 |
|
|
229
|
+
|
|
230
|
+
`getWorkerStats()` は bigint の統計スナップショットを、`getWorkerError()` は記録済みの非同期エラーを返します。Worker の初期化エラーは ready を reject させ、close/stop も Worker のエラーを報告します。C++ の例外は SFMLError にマッピングされ、SFML の診断は既存の `err()`/`setErrorOutput()` 経路に出力されます。
|
|
231
|
+
|
|
232
|
+
Audio Worker は初期化が完了すると unref され、それだけでは Node プロセスを存続させません。再生中はウィンドウループや `await sleep()` でイベントループを維持してください。終了時には `await stream.close()`、`await music.close()`、`await effect.close()`、`await recorder.stop()` を使います。ファイル書き込みは `await output.close()` で末尾処理とリソースのクリーンアップを完了します。ネイティブの音源と録音リソースは、プロジェクトのバックグラウンド解放機構を引き継ぎます。ビューは対応する割り当てを維持し、Node 環境の終了時には、その環境に属するリソースが終了します。
|
|
233
|
+
|
|
234
|
+
再生デバイスの通知は、コールバックを登録した JS スレッドへ非同期で配送され、オーディオデバイスのスレッドでは実行されません。SFML の通知コールバックはプロセス単位の単一スロットであり、最後の登録が以前の登録を置き換えます。`setNotificationCallback()` を呼ぶと登録を解除し、未配送の通知を破棄します。
|
|
235
|
+
|
|
236
|
+
## デモと検証
|
|
237
|
+
|
|
238
|
+
`npm run demo:audio`、またはビルド後に `node examples/audio.cjs` を実行します。1~4 で Sound、WorkerStream、Music、録音再生を切り替えます。Space は再生/一時停止、S は停止、E はエフェクトの切り替え、R は録音開始、T は録音終了です。矢印キーでパンと音量を操作し、Esc で閉じます。録音はメモリ内だけに保持します。
|
|
239
|
+
|
|
240
|
+
`node examples/audio.cjs --smoke --frames=90` は、スピーカー再生、Worker PCM、エフェクト処理、Music、マイク録音と再生を自動的に検証してから終了します。このモードはローカルの入力デバイスを有効にします。通常起動ではユーザーのキー入力を待ちます。
|
|
241
|
+
|
|
242
|
+
自動テストは、SFML フィールドとの比較、PCM ビュー、リソースのライフサイクル、WAV/FLAC/Ogg、非同期入力ストリーム、Worker のデータ供給とシーク、エフェクト、録音キュー、独自のコーデックを対象としています。テストコードは [test/audio.test.cjs](../test/audio.test.cjs)、[Worker テスト](../test/audio-worker.test.cjs)、[コーデックテスト](../test/audio-codec.test.cjs)を参照してください。
|
|
243
|
+
|
|
244
|
+
実際の音声出力、マイク収録、デバイスのホットプラグは対象デバイスで検証する必要があります。CI のビルドとテスト設定は[開発ガイド](development.ja.md#testing)を参照してください。
|
|
245
|
+
|
|
246
|
+
<a id="sfml-cpp-reference"></a>
|
|
247
|
+
## SFML C++ リファレンス
|
|
248
|
+
|
|
249
|
+
上流の [SoundBuffer](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1SoundBuffer.html)、[Sound](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Sound.html)、[Music](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Music.html)、[SoundStream](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1SoundStream.html)、[SoundRecorder](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1SoundRecorder.html)、[SoundFileFactory](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1SoundFileFactory.html) で、再生、空間オーディオ、音声ファイルの概念を確認できます。JS の非同期リソースメソッド、Worker コールバック、共有バッファの寿命は C++ と異なるため、このガイドの契約を優先してください。
|