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