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,178 @@
|
|
|
1
|
+
/// <reference types="node" />
|
|
2
|
+
import { Socket as UdpHandle } from 'node:dgram';
|
|
3
|
+
import { Socket, SocketStatus as Status, type SocketHandle } from './socket';
|
|
4
|
+
import { IpAddress } from './ip-address';
|
|
5
|
+
import { Packet } from './packet';
|
|
6
|
+
/**
|
|
7
|
+
* Result of receiving a single UDP datagram.
|
|
8
|
+
* @zh 单个 UDP 数据报的接收结果。
|
|
9
|
+
* @ja 単一の UDP データグラムの受信結果。
|
|
10
|
+
* @ko 단일 UDP 데이터그램 수신 결과.
|
|
11
|
+
*/
|
|
12
|
+
export interface DatagramResult {
|
|
13
|
+
/**
|
|
14
|
+
* Operation result status.
|
|
15
|
+
* @zh 操作结果状态。
|
|
16
|
+
* @ja 操作結果の状態。
|
|
17
|
+
* @ko 작업 결과 상태.
|
|
18
|
+
*/
|
|
19
|
+
status: Status;
|
|
20
|
+
/**
|
|
21
|
+
* Bytes written to the destination, or 0 on failure.
|
|
22
|
+
* @zh 写入目标的字节数,失败时为 0。
|
|
23
|
+
* @ja 出力先に書き込んだバイト数。失敗時は 0 です。
|
|
24
|
+
* @ko 대상에 쓴 바이트 수이며 실패 시 0입니다.
|
|
25
|
+
*/
|
|
26
|
+
received: number;
|
|
27
|
+
/**
|
|
28
|
+
* Sender address on successful receipt.
|
|
29
|
+
* @zh 成功接收时的发送方地址。
|
|
30
|
+
* @ja 受信成功時の送信元アドレス。
|
|
31
|
+
* @ko 수신 성공 시 송신자 주소.
|
|
32
|
+
*/
|
|
33
|
+
remoteAddress?: IpAddress;
|
|
34
|
+
/**
|
|
35
|
+
* Sender port, or 0 on failure.
|
|
36
|
+
* @zh 发送方端口,失败时为 0。
|
|
37
|
+
* @ja 送信元ポート。失敗時は 0 です。
|
|
38
|
+
* @ko 송신자 포트이며 실패 시 0입니다.
|
|
39
|
+
*/
|
|
40
|
+
remotePort: number;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* UDP socket preserving datagram boundaries; Packet data has no TCP
|
|
44
|
+
* length header.
|
|
45
|
+
* @zh 保留数据报边界的 UDP 套接字,Packet 不附加 TCP 长度头。
|
|
46
|
+
* @ja データグラム境界を保持する UDP ソケット。
|
|
47
|
+
* Packet に TCP の長さヘッダーは付加しません。
|
|
48
|
+
* @ko 데이터그램 경계를 유지하는 UDP 소켓.
|
|
49
|
+
* Packet에 TCP 길이 헤더를 붙이지 않습니다.
|
|
50
|
+
*/
|
|
51
|
+
export declare class UdpSocket extends Socket {
|
|
52
|
+
/**
|
|
53
|
+
* Maximum UDP datagram payload size in bytes allowed by this implementation.
|
|
54
|
+
* @zh 本实现允许的最大 UDP 数据报载荷字节数。
|
|
55
|
+
* @ja この実装で許容する UDP データグラムの最大ペイロードバイト数。
|
|
56
|
+
* @ko 이 구현에서 허용하는 최대 UDP 데이터그램 페이로드 바이트 수.
|
|
57
|
+
*/
|
|
58
|
+
static readonly MaxDatagramSize = 65507;
|
|
59
|
+
/**
|
|
60
|
+
* Underlying UDP socket handle.
|
|
61
|
+
* @zh 底层 UDP 套接字句柄。
|
|
62
|
+
* @ja 下位の UDP ソケットハンドル。
|
|
63
|
+
* @ko 기반 UDP 소켓 핸들.
|
|
64
|
+
*/
|
|
65
|
+
protected transport?: UdpHandle;
|
|
66
|
+
/** 是否已绑定端口。 */
|
|
67
|
+
private bound;
|
|
68
|
+
/** 绑定地址族,4 或 6。 */
|
|
69
|
+
private family;
|
|
70
|
+
/** 待交付的缓冲数据报队列。 */
|
|
71
|
+
private pending;
|
|
72
|
+
/** 待交付缓冲区的总字节数,上限 8 MiB。 */
|
|
73
|
+
private pendingBytes;
|
|
74
|
+
/** 接收操作串行队列。 */
|
|
75
|
+
private readonly reads;
|
|
76
|
+
/** 发送操作串行队列。 */
|
|
77
|
+
private readonly writes;
|
|
78
|
+
/**
|
|
79
|
+
* Create an unbound UDP socket with asynchronous blocking semantics
|
|
80
|
+
* by default.
|
|
81
|
+
* @zh 创建尚未绑定的 UDP 套接字,默认使用异步阻塞语义。
|
|
82
|
+
* @ja 未バインドの UDP ソケットを作成します。
|
|
83
|
+
* 既定では非同期ブロッキング動作を使います。
|
|
84
|
+
* @ko 바인딩되지 않은 UDP 소켓을 생성하며 기본적으로 비동기 블로킹 동작을
|
|
85
|
+
* 사용합니다.
|
|
86
|
+
*/
|
|
87
|
+
constructor();
|
|
88
|
+
/**
|
|
89
|
+
* Return the bound local port, or 0 when unbound.
|
|
90
|
+
* @zh 返回已绑定的本地端口,未绑定时为 0。
|
|
91
|
+
* @ja バインド済みのローカルポートを返し、未バインドなら 0 を返します。
|
|
92
|
+
* @ko 바인딩된 로컬 포트를 반환하며 바인딩되지 않았으면 0입니다.
|
|
93
|
+
*/
|
|
94
|
+
getLocalPort(): number;
|
|
95
|
+
/**
|
|
96
|
+
* Bind a local port and address asynchronously; port 0 lets the system assign
|
|
97
|
+
* a port. Use IPv4 by default.
|
|
98
|
+
* @zh 异步绑定本地端口和地址;port 为 0 时由系统分配,默认使用 IPv4。
|
|
99
|
+
* @ja ローカルポートとアドレスを非同期にバインドします。
|
|
100
|
+
* port が 0 ならシステムが割り当てます。既定では IPv4 を使用します。
|
|
101
|
+
* @ko 로컬 포트와 주소를 비동기로 바인딩합니다. port가 0이면 시스템이
|
|
102
|
+
* 할당하며 기본적으로 IPv4를 사용합니다.
|
|
103
|
+
*/
|
|
104
|
+
bind(port: number, address?: IpAddress): Promise<Status>;
|
|
105
|
+
/**
|
|
106
|
+
* Reject non-UDP Node transports before adoption.
|
|
107
|
+
* @zh 接管前拒绝非 UDP 的 Node 传输。
|
|
108
|
+
* @ja 引き継ぐ前に UDP 以外の Node トランスポートを拒否します。
|
|
109
|
+
* @ko 인수 전에 UDP가 아닌 Node 전송 객체를 거부합니다.
|
|
110
|
+
*/
|
|
111
|
+
protected validateHandle(handle: SocketHandle): void;
|
|
112
|
+
/**
|
|
113
|
+
* Integrate an allocated or adopted UDP handle into the same datagram queue
|
|
114
|
+
* and binding state.
|
|
115
|
+
* @zh 将分配或接管的 UDP 句柄接入同一数据报队列及绑定状态。
|
|
116
|
+
* @ja 割り当てまたは引き継いだ UDP ハンドルを同じデータグラムキューと
|
|
117
|
+
* バインド状態に組み込みます。
|
|
118
|
+
* @ko 할당하거나 인수한 UDP 핸들을 같은 데이터그램 큐와 바인딩 상태에
|
|
119
|
+
* 연결합니다.
|
|
120
|
+
*/
|
|
121
|
+
protected onCreate(): void;
|
|
122
|
+
/**
|
|
123
|
+
* Close the UDP transport and clear datagrams pending receipt.
|
|
124
|
+
* @zh 关闭 UDP 传输并清空待接收的数据报。
|
|
125
|
+
* @ja UDP トランスポートを閉じ、受信待ちのデータグラムを消去します。
|
|
126
|
+
* @ko UDP 전송 객체를 닫고 수신 대기 중인 데이터그램을 비웁니다.
|
|
127
|
+
*/
|
|
128
|
+
unbind(): void;
|
|
129
|
+
/**
|
|
130
|
+
* Clear the old transport's binding state and datagrams;
|
|
131
|
+
* the generation change cancels old reads.
|
|
132
|
+
* @zh 清空旧传输的绑定状态和数据报,旧读取通过代际变化取消。
|
|
133
|
+
* @ja 古いトランスポートのバインド状態とデータグラムを消去します。
|
|
134
|
+
* 世代の変更により古い読み取りをキャンセルします。
|
|
135
|
+
* @ko 기존 전송 객체의 바인딩 상태와 데이터그램을 비우며,
|
|
136
|
+
* 세대 변경으로 이전 읽기를 취소합니다.
|
|
137
|
+
*/
|
|
138
|
+
protected onClose(): void;
|
|
139
|
+
/**
|
|
140
|
+
* Send a call-time data snapshot as one datagram; if unbound, automatically
|
|
141
|
+
* bind an ephemeral port for the destination address family.
|
|
142
|
+
* @zh 发送调用时的数据快照为一个数据报;未绑定时按目标地址族自动绑定临时端口。
|
|
143
|
+
* @ja 呼び出し時のデータスナップショットを 1 つのデータグラムとして送信します。
|
|
144
|
+
* 未バインドなら宛先アドレスファミリーに応じて一時ポートに自動バインドします。
|
|
145
|
+
* @ko 호출 시점의 데이터 스냅샷을 하나의 데이터그램으로 송신합니다.
|
|
146
|
+
* 바인딩되지 않았으면 대상 주소 계열에 맞는 임시 포트에 자동 바인딩합니다.
|
|
147
|
+
*/
|
|
148
|
+
send(data: Uint8Array | Packet, address: IpAddress, port: number): Promise<Status>;
|
|
149
|
+
/** 发送字节数据报,未绑定时自动绑定。 */
|
|
150
|
+
private sendBytes;
|
|
151
|
+
/**
|
|
152
|
+
* Receive one complete datagram; discard it and return Error if the
|
|
153
|
+
* destination byte buffer is too small. With no data, nonblocking mode
|
|
154
|
+
* returns NotReady.
|
|
155
|
+
* @zh 接收一个完整数据报;目标字节区过小时丢弃并返回 Error,
|
|
156
|
+
* 非阻塞无数据为 NotReady。
|
|
157
|
+
* @ja 完全なデータグラムを 1 つ受信します。出力先バイト領域が小さすぎる場合は
|
|
158
|
+
* 破棄して Error を返し、非ブロッキングでデータがなければ NotReady を返します。
|
|
159
|
+
* @ko 완전한 데이터그램 하나를 수신합니다. 대상 바이트 버퍼가 너무 작으면
|
|
160
|
+
* 폐기하고 Error를 반환합니다. 논블로킹 모드에서 데이터가 없으면 NotReady입니다.
|
|
161
|
+
*/
|
|
162
|
+
receive(destination: Uint8Array | Packet): Promise<DatagramResult>;
|
|
163
|
+
/**
|
|
164
|
+
* Return the binding state; derived classes may extend this.
|
|
165
|
+
* @zh 返回绑定状态,允许派生类扩展。
|
|
166
|
+
* @ja バインド状態を返します。派生クラスで拡張できます。
|
|
167
|
+
* @ko 바인딩 상태를 반환하며 파생 클래스에서 확장할 수 있습니다.
|
|
168
|
+
*/
|
|
169
|
+
protected isAlive(): boolean;
|
|
170
|
+
/**
|
|
171
|
+
* Return readiness bits for pending datagrams and the current binding.
|
|
172
|
+
* @zh 返回待接收数据报和当前绑定对应的就绪位。
|
|
173
|
+
* @ja 受信待ちデータグラムと現在のバインドに対応する準備状態ビットを返します。
|
|
174
|
+
* @ko 수신 대기 데이터그램과 현재 바인딩에 해당하는 준비 상태 비트를 반환합니다.
|
|
175
|
+
*/
|
|
176
|
+
protected getReadiness(mask: number): number;
|
|
177
|
+
protected getNativeHandle(): UdpHandle | undefined;
|
|
178
|
+
}
|
|
@@ -0,0 +1,285 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.UdpSocket = void 0;
|
|
4
|
+
const node_dgram_1 = require("node:dgram");
|
|
5
|
+
const socket_1 = require("./socket");
|
|
6
|
+
const ip_address_1 = require("./ip-address");
|
|
7
|
+
const packet_1 = require("./packet");
|
|
8
|
+
const common_1 = require("./common");
|
|
9
|
+
/**
|
|
10
|
+
* UDP socket preserving datagram boundaries; Packet data has no TCP
|
|
11
|
+
* length header.
|
|
12
|
+
* @zh 保留数据报边界的 UDP 套接字,Packet 不附加 TCP 长度头。
|
|
13
|
+
* @ja データグラム境界を保持する UDP ソケット。
|
|
14
|
+
* Packet に TCP の長さヘッダーは付加しません。
|
|
15
|
+
* @ko 데이터그램 경계를 유지하는 UDP 소켓.
|
|
16
|
+
* Packet에 TCP 길이 헤더를 붙이지 않습니다.
|
|
17
|
+
*/
|
|
18
|
+
class UdpSocket extends socket_1.Socket {
|
|
19
|
+
/**
|
|
20
|
+
* Create an unbound UDP socket with asynchronous blocking semantics
|
|
21
|
+
* by default.
|
|
22
|
+
* @zh 创建尚未绑定的 UDP 套接字,默认使用异步阻塞语义。
|
|
23
|
+
* @ja 未バインドの UDP ソケットを作成します。
|
|
24
|
+
* 既定では非同期ブロッキング動作を使います。
|
|
25
|
+
* @ko 바인딩되지 않은 UDP 소켓을 생성하며 기본적으로 비동기 블로킹 동작을
|
|
26
|
+
* 사용합니다.
|
|
27
|
+
*/
|
|
28
|
+
constructor() {
|
|
29
|
+
super(socket_1.SocketType.Udp);
|
|
30
|
+
/** 是否已绑定端口。 */
|
|
31
|
+
this.bound = false;
|
|
32
|
+
/** 绑定地址族,4 或 6。 */
|
|
33
|
+
this.family = 4;
|
|
34
|
+
/** 待交付的缓冲数据报队列。 */
|
|
35
|
+
this.pending = [];
|
|
36
|
+
/** 待交付缓冲区的总字节数,上限 8 MiB。 */
|
|
37
|
+
this.pendingBytes = 0;
|
|
38
|
+
/** 接收操作串行队列。 */
|
|
39
|
+
this.reads = new common_1.SerialQueue();
|
|
40
|
+
/** 发送操作串行队列。 */
|
|
41
|
+
this.writes = new common_1.SerialQueue();
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Return the bound local port, or 0 when unbound.
|
|
45
|
+
* @zh 返回已绑定的本地端口,未绑定时为 0。
|
|
46
|
+
* @ja バインド済みのローカルポートを返し、未バインドなら 0 を返します。
|
|
47
|
+
* @ko 바인딩된 로컬 포트를 반환하며 바인딩되지 않았으면 0입니다.
|
|
48
|
+
*/
|
|
49
|
+
getLocalPort() {
|
|
50
|
+
return this.bound ? this.transport.address().port : 0;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Bind a local port and address asynchronously; port 0 lets the system assign
|
|
54
|
+
* a port. Use IPv4 by default.
|
|
55
|
+
* @zh 异步绑定本地端口和地址;port 为 0 时由系统分配,默认使用 IPv4。
|
|
56
|
+
* @ja ローカルポートとアドレスを非同期にバインドします。
|
|
57
|
+
* port が 0 ならシステムが割り当てます。既定では IPv4 を使用します。
|
|
58
|
+
* @ko 로컬 포트와 주소를 비동기로 바인딩합니다. port가 0이면 시스템이
|
|
59
|
+
* 할당하며 기본적으로 IPv4를 사용합니다.
|
|
60
|
+
*/
|
|
61
|
+
async bind(port, address = ip_address_1.IpAddress.Any) {
|
|
62
|
+
(0, common_1.uint)(port, 65535);
|
|
63
|
+
if (!(address instanceof ip_address_1.IpAddress))
|
|
64
|
+
throw new TypeError('Expected IpAddress');
|
|
65
|
+
this.create(address.getType());
|
|
66
|
+
const socket = this.transport;
|
|
67
|
+
const generation = this.epoch;
|
|
68
|
+
const ready = (0, common_1.waitFor)(this[socket_1.socketEvents], () => this.bound ||
|
|
69
|
+
!!this.failure || this.epoch !== generation);
|
|
70
|
+
socket.bind(port, address.toString());
|
|
71
|
+
await ready;
|
|
72
|
+
return this.epoch !== generation ? socket_1.SocketStatus.Disconnected
|
|
73
|
+
: this.bound ? socket_1.SocketStatus.Done : socket_1.SocketStatus.Error;
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Reject non-UDP Node transports before adoption.
|
|
77
|
+
* @zh 接管前拒绝非 UDP 的 Node 传输。
|
|
78
|
+
* @ja 引き継ぐ前に UDP 以外の Node トランスポートを拒否します。
|
|
79
|
+
* @ko 인수 전에 UDP가 아닌 Node 전송 객체를 거부합니다.
|
|
80
|
+
*/
|
|
81
|
+
validateHandle(handle) {
|
|
82
|
+
if (!(handle instanceof node_dgram_1.Socket))
|
|
83
|
+
throw new TypeError('Expected Node UDP');
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* Integrate an allocated or adopted UDP handle into the same datagram queue
|
|
87
|
+
* and binding state.
|
|
88
|
+
* @zh 将分配或接管的 UDP 句柄接入同一数据报队列及绑定状态。
|
|
89
|
+
* @ja 割り当てまたは引き継いだ UDP ハンドルを同じデータグラムキューと
|
|
90
|
+
* バインド状態に組み込みます。
|
|
91
|
+
* @ko 할당하거나 인수한 UDP 핸들을 같은 데이터그램 큐와 바인딩 상태에
|
|
92
|
+
* 연결합니다.
|
|
93
|
+
*/
|
|
94
|
+
onCreate() {
|
|
95
|
+
const socket = this.transport;
|
|
96
|
+
const generation = this.epoch;
|
|
97
|
+
// Node 运行时保存创建地址族,但当前 @types/node 未声明此字段。
|
|
98
|
+
const { type } = socket;
|
|
99
|
+
this.family = type === 'udp4' ? 4 : 6;
|
|
100
|
+
const current = () => this.transport === socket && this.epoch === generation;
|
|
101
|
+
const error = (error) => {
|
|
102
|
+
if (!current())
|
|
103
|
+
return;
|
|
104
|
+
this.failure = error;
|
|
105
|
+
this.changed();
|
|
106
|
+
};
|
|
107
|
+
const message = (data, peer) => {
|
|
108
|
+
if (!current())
|
|
109
|
+
return;
|
|
110
|
+
if (this.pendingBytes + data.length <= 8 * 1024 * 1024 &&
|
|
111
|
+
this.pending.length < 4096) {
|
|
112
|
+
this.pending.push({ data, peer });
|
|
113
|
+
this.pendingBytes += data.length;
|
|
114
|
+
this.changed();
|
|
115
|
+
}
|
|
116
|
+
};
|
|
117
|
+
const listening = () => {
|
|
118
|
+
if (!current())
|
|
119
|
+
return;
|
|
120
|
+
this.bound = true;
|
|
121
|
+
if (this.family === 4)
|
|
122
|
+
socket.setBroadcast(true);
|
|
123
|
+
this.changed();
|
|
124
|
+
};
|
|
125
|
+
const closed = () => {
|
|
126
|
+
if (!current())
|
|
127
|
+
return;
|
|
128
|
+
this.bound = false;
|
|
129
|
+
this.changed();
|
|
130
|
+
};
|
|
131
|
+
socket.on('error', error)
|
|
132
|
+
.on('message', message)
|
|
133
|
+
.on('listening', listening)
|
|
134
|
+
.on('close', closed);
|
|
135
|
+
this.detach = () => {
|
|
136
|
+
socket.off('error', error)
|
|
137
|
+
.off('message', message)
|
|
138
|
+
.off('listening', listening)
|
|
139
|
+
.off('close', closed);
|
|
140
|
+
};
|
|
141
|
+
try {
|
|
142
|
+
socket.address();
|
|
143
|
+
listening();
|
|
144
|
+
}
|
|
145
|
+
catch {
|
|
146
|
+
this.bound = false;
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* Close the UDP transport and clear datagrams pending receipt.
|
|
151
|
+
* @zh 关闭 UDP 传输并清空待接收的数据报。
|
|
152
|
+
* @ja UDP トランスポートを閉じ、受信待ちのデータグラムを消去します。
|
|
153
|
+
* @ko UDP 전송 객체를 닫고 수신 대기 중인 데이터그램을 비웁니다.
|
|
154
|
+
*/
|
|
155
|
+
unbind() { this.close(); }
|
|
156
|
+
/**
|
|
157
|
+
* Clear the old transport's binding state and datagrams;
|
|
158
|
+
* the generation change cancels old reads.
|
|
159
|
+
* @zh 清空旧传输的绑定状态和数据报,旧读取通过代际变化取消。
|
|
160
|
+
* @ja 古いトランスポートのバインド状態とデータグラムを消去します。
|
|
161
|
+
* 世代の変更により古い読み取りをキャンセルします。
|
|
162
|
+
* @ko 기존 전송 객체의 바인딩 상태와 데이터그램을 비우며,
|
|
163
|
+
* 세대 변경으로 이전 읽기를 취소합니다.
|
|
164
|
+
*/
|
|
165
|
+
onClose() {
|
|
166
|
+
this.bound = false;
|
|
167
|
+
this.pending = [];
|
|
168
|
+
this.pendingBytes = 0;
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Send a call-time data snapshot as one datagram; if unbound, automatically
|
|
172
|
+
* bind an ephemeral port for the destination address family.
|
|
173
|
+
* @zh 发送调用时的数据快照为一个数据报;未绑定时按目标地址族自动绑定临时端口。
|
|
174
|
+
* @ja 呼び出し時のデータスナップショットを 1 つのデータグラムとして送信します。
|
|
175
|
+
* 未バインドなら宛先アドレスファミリーに応じて一時ポートに自動バインドします。
|
|
176
|
+
* @ko 호출 시점의 데이터 스냅샷을 하나의 데이터그램으로 송신합니다.
|
|
177
|
+
* 바인딩되지 않았으면 대상 주소 계열에 맞는 임시 포트에 자동 바인딩합니다.
|
|
178
|
+
*/
|
|
179
|
+
send(data, address, port) {
|
|
180
|
+
(0, common_1.uint)(port, 65535);
|
|
181
|
+
if (!(address instanceof ip_address_1.IpAddress))
|
|
182
|
+
throw new TypeError('Expected IpAddress');
|
|
183
|
+
const input = Buffer.from(data instanceof packet_1.Packet ? data[packet_1.packetSend]() : (0, common_1.bytes)(data));
|
|
184
|
+
if (input.length > UdpSocket.MaxDatagramSize)
|
|
185
|
+
return Promise.resolve(socket_1.SocketStatus.Error);
|
|
186
|
+
if (!this.transport)
|
|
187
|
+
this.create(address.getType());
|
|
188
|
+
const generation = this.epoch;
|
|
189
|
+
return this.writes.run(() => this.sendBytes(input, address, port, generation));
|
|
190
|
+
}
|
|
191
|
+
/** 发送字节数据报,未绑定时自动绑定。 */
|
|
192
|
+
async sendBytes(input, address, port, generation) {
|
|
193
|
+
if (generation !== this.epoch)
|
|
194
|
+
return socket_1.SocketStatus.Disconnected;
|
|
195
|
+
if (this.family !== (address.isV4() ? 4 : 6))
|
|
196
|
+
return socket_1.SocketStatus.Error;
|
|
197
|
+
const socket = this.transport;
|
|
198
|
+
let onError;
|
|
199
|
+
const completion = new Promise(resolve => {
|
|
200
|
+
const done = (error) => {
|
|
201
|
+
if (generation !== this.epoch)
|
|
202
|
+
return resolve(socket_1.SocketStatus.Disconnected);
|
|
203
|
+
if (error)
|
|
204
|
+
this.failure = error;
|
|
205
|
+
resolve(error ? socket_1.SocketStatus.Error : socket_1.SocketStatus.Done);
|
|
206
|
+
};
|
|
207
|
+
// Node 在 bind 失败时丢弃排队的 send 回调,必须监听 error 完成它。
|
|
208
|
+
onError = done;
|
|
209
|
+
socket.once('error', onError);
|
|
210
|
+
try {
|
|
211
|
+
socket.send(input, port, address.toString(), done);
|
|
212
|
+
}
|
|
213
|
+
catch (error) {
|
|
214
|
+
done(error instanceof Error ? error : new Error(String(error)));
|
|
215
|
+
}
|
|
216
|
+
});
|
|
217
|
+
try {
|
|
218
|
+
return await this.awaitWrite(completion, generation);
|
|
219
|
+
}
|
|
220
|
+
finally {
|
|
221
|
+
socket.off('error', onError);
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
/**
|
|
225
|
+
* Receive one complete datagram; discard it and return Error if the
|
|
226
|
+
* destination byte buffer is too small. With no data, nonblocking mode
|
|
227
|
+
* returns NotReady.
|
|
228
|
+
* @zh 接收一个完整数据报;目标字节区过小时丢弃并返回 Error,
|
|
229
|
+
* 非阻塞无数据为 NotReady。
|
|
230
|
+
* @ja 完全なデータグラムを 1 つ受信します。出力先バイト領域が小さすぎる場合は
|
|
231
|
+
* 破棄して Error を返し、非ブロッキングでデータがなければ NotReady を返します。
|
|
232
|
+
* @ko 완전한 데이터그램 하나를 수신합니다. 대상 바이트 버퍼가 너무 작으면
|
|
233
|
+
* 폐기하고 Error를 반환합니다. 논블로킹 모드에서 데이터가 없으면 NotReady입니다.
|
|
234
|
+
*/
|
|
235
|
+
receive(destination) {
|
|
236
|
+
const output = destination instanceof packet_1.Packet ? undefined : (0, common_1.bytes)(destination);
|
|
237
|
+
const generation = this.epoch;
|
|
238
|
+
return this.reads.run(async () => {
|
|
239
|
+
const result = (status) => ({ status, received: 0, remotePort: 0 });
|
|
240
|
+
await this.awaitReady(() => this.pending.length > 0 || !this.bound ||
|
|
241
|
+
!!this.failure, generation);
|
|
242
|
+
if (generation !== this.epoch || !this.bound)
|
|
243
|
+
return result(socket_1.SocketStatus.Error);
|
|
244
|
+
const item = this.pending.shift();
|
|
245
|
+
if (!item)
|
|
246
|
+
return result(this.failure ? socket_1.SocketStatus.Error : socket_1.SocketStatus.NotReady);
|
|
247
|
+
this.pendingBytes -= item.data.length;
|
|
248
|
+
if (output && output.length < item.data.length)
|
|
249
|
+
return result(socket_1.SocketStatus.Error);
|
|
250
|
+
if (destination instanceof packet_1.Packet)
|
|
251
|
+
destination[packet_1.packetReceive](item.data);
|
|
252
|
+
else
|
|
253
|
+
item.data.copy(output);
|
|
254
|
+
return { status: socket_1.SocketStatus.Done, received: item.data.length,
|
|
255
|
+
remoteAddress: ip_address_1.IpAddress.fromString(item.peer.address),
|
|
256
|
+
remotePort: item.peer.port };
|
|
257
|
+
});
|
|
258
|
+
}
|
|
259
|
+
/**
|
|
260
|
+
* Return the binding state; derived classes may extend this.
|
|
261
|
+
* @zh 返回绑定状态,允许派生类扩展。
|
|
262
|
+
* @ja バインド状態を返します。派生クラスで拡張できます。
|
|
263
|
+
* @ko 바인딩 상태를 반환하며 파생 클래스에서 확장할 수 있습니다.
|
|
264
|
+
*/
|
|
265
|
+
isAlive() { return this.bound; }
|
|
266
|
+
/**
|
|
267
|
+
* Return readiness bits for pending datagrams and the current binding.
|
|
268
|
+
* @zh 返回待接收数据报和当前绑定对应的就绪位。
|
|
269
|
+
* @ja 受信待ちデータグラムと現在のバインドに対応する準備状態ビットを返します。
|
|
270
|
+
* @ko 수신 대기 데이터그램과 현재 바인딩에 해당하는 준비 상태 비트를 반환합니다.
|
|
271
|
+
*/
|
|
272
|
+
getReadiness(mask) {
|
|
273
|
+
// eslint-disable-next-line no-bitwise
|
|
274
|
+
return ((this.pending.length ? 1 : 0) | (this.bound ? 2 : 0)) & mask;
|
|
275
|
+
}
|
|
276
|
+
getNativeHandle() { return this.transport; }
|
|
277
|
+
}
|
|
278
|
+
/**
|
|
279
|
+
* Maximum UDP datagram payload size in bytes allowed by this implementation.
|
|
280
|
+
* @zh 本实现允许的最大 UDP 数据报载荷字节数。
|
|
281
|
+
* @ja この実装で許容する UDP データグラムの最大ペイロードバイト数。
|
|
282
|
+
* @ko 이 구현에서 허용하는 최대 UDP 데이터그램 페이로드 바이트 수.
|
|
283
|
+
*/
|
|
284
|
+
UdpSocket.MaxDatagramSize = 65507;
|
|
285
|
+
exports.UdpSocket = UdpSocket;
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { type NativeValueHandle } from '../internal/native';
|
|
2
|
+
import { angleStorage, angleNative, mutableValue, type ReadonlyValue } from '../internal/value-storage';
|
|
3
|
+
/**
|
|
4
|
+
* SFML's float32 remainder, whose truncated quotient must fit in int32.
|
|
5
|
+
* @zh SFML 的 float32 余数,截断后的商必须在 int32 范围内。
|
|
6
|
+
* @ja SFML の float32 剰余。切り捨てた商は int32 の範囲内でなければならない。
|
|
7
|
+
* @ko SFML의 float32 나머지. 소수부를 버린 몫은 int32 범위 내여야 한다.
|
|
8
|
+
*/
|
|
9
|
+
export declare function positiveRemainder(a: number, b: number): number;
|
|
10
|
+
/**
|
|
11
|
+
* sf::Angle's float32 value, with native ownership created on demand.
|
|
12
|
+
* @zh sf::Angle 的 float32 值,按需创建原生所有权。
|
|
13
|
+
* @ja sf::Angle の float32 値。ネイティブ所有権は必要に応じて作成される。
|
|
14
|
+
* @ko sf::Angle의 float32 값. 네이티브 소유권은 필요할 때 생성된다.
|
|
15
|
+
*/
|
|
16
|
+
export declare class Angle {
|
|
17
|
+
readonly [mutableValue] = true;
|
|
18
|
+
private readonly state;
|
|
19
|
+
/**
|
|
20
|
+
* Create a zero angle, or copy the angle value of source.
|
|
21
|
+
* @zh 创建零角度,或复制 source 的角度值。
|
|
22
|
+
* @ja ゼロ角度を作成するか、source の角度値をコピーする。
|
|
23
|
+
* @ko 영각을 생성하거나 source의 각도 값을 복사한다.
|
|
24
|
+
*/
|
|
25
|
+
constructor(source?: ReadonlyValue<Angle>);
|
|
26
|
+
get [angleStorage](): Float32Array;
|
|
27
|
+
get [angleNative](): NativeValueHandle<'angle'>;
|
|
28
|
+
/**
|
|
29
|
+
* Return the value in degrees, with 360 degrees per revolution.
|
|
30
|
+
* @zh 返回角度制数值,一周为 360 度。
|
|
31
|
+
* @ja 度数法の値を返す。1 回転は 360 度。
|
|
32
|
+
* @ko 도 단위 값을 반환한다. 한 바퀴는 360도이다.
|
|
33
|
+
*/
|
|
34
|
+
asDegrees(): number;
|
|
35
|
+
/**
|
|
36
|
+
* Return the value in radians, with 2π radians per revolution.
|
|
37
|
+
* @zh 返回弧度制数值,一周为 2π 弧度。
|
|
38
|
+
* @ja ラジアン値を返す。1 回転は 2π ラジアン。
|
|
39
|
+
* @ko 라디안 단위 값을 반환한다. 한 바퀴는 2π 라디안이다.
|
|
40
|
+
*/
|
|
41
|
+
asRadians(): number;
|
|
42
|
+
/**
|
|
43
|
+
* Return a new angle normalized to [-180°, 180°).
|
|
44
|
+
* @zh 返回归一化到 [-180°, 180°) 的新角度。
|
|
45
|
+
* @ja [-180°, 180°) に正規化した新しい角度を返す。
|
|
46
|
+
* @ko [-180°, 180°)로 정규화한 새 각도를 반환한다.
|
|
47
|
+
*/
|
|
48
|
+
wrapSigned(): Angle;
|
|
49
|
+
/**
|
|
50
|
+
* Return a new angle normalized to [0°, 360°).
|
|
51
|
+
* @zh 返回归一化到 [0°, 360°) 的新角度。
|
|
52
|
+
* @ja [0°, 360°) に正規化した新しい角度を返す。
|
|
53
|
+
* @ko [0°, 360°)로 정규화한 새 각도를 반환한다.
|
|
54
|
+
*/
|
|
55
|
+
wrapUnsigned(): Angle;
|
|
56
|
+
/**
|
|
57
|
+
* The read-only zero angle.
|
|
58
|
+
* @zh 只读的零角度。
|
|
59
|
+
* @ja 読み取り専用のゼロ角度。
|
|
60
|
+
* @ko 읽기 전용 영각.
|
|
61
|
+
*/
|
|
62
|
+
static readonly Zero: ReadonlyValue<Angle>;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Create an angle from radians, stored with float32 precision.
|
|
66
|
+
* @zh 从弧度值创建角度,按 float32 精度存储。
|
|
67
|
+
* @ja ラジアン値から角度を作成し、float32 精度で格納する。
|
|
68
|
+
* @ko 라디안 값으로 각도를 생성하고 float32 정밀도로 저장한다.
|
|
69
|
+
*/
|
|
70
|
+
export declare function radians(angle: number): Angle;
|
|
71
|
+
/**
|
|
72
|
+
* Create an angle from degrees, stored with float32 precision.
|
|
73
|
+
* @zh 从度数创建角度,按 float32 精度存储。
|
|
74
|
+
* @ja 度数から角度を作成し、float32 精度で格納する。
|
|
75
|
+
* @ko 도 단위 값으로 각도를 생성하고 float32 정밀도로 저장한다.
|
|
76
|
+
*/
|
|
77
|
+
export declare function degrees(angle: number): Angle;
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var _a;
|
|
3
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
|
+
exports.degrees = exports.radians = exports.Angle = exports.positiveRemainder = void 0;
|
|
5
|
+
const native_1 = require("../internal/native");
|
|
6
|
+
const lazy_value_1 = require("../internal/lazy-value");
|
|
7
|
+
const value_storage_1 = require("../internal/value-storage");
|
|
8
|
+
const pi = Math.fround(3.141592654);
|
|
9
|
+
const tau = Math.fround(pi * 2);
|
|
10
|
+
/**
|
|
11
|
+
* SFML's float32 remainder, whose truncated quotient must fit in int32.
|
|
12
|
+
* @zh SFML 的 float32 余数,截断后的商必须在 int32 范围内。
|
|
13
|
+
* @ja SFML の float32 剰余。切り捨てた商は int32 の範囲内でなければならない。
|
|
14
|
+
* @ko SFML의 float32 나머지. 소수부를 버린 몫은 int32 범위 내여야 한다.
|
|
15
|
+
*/
|
|
16
|
+
function positiveRemainder(a, b) {
|
|
17
|
+
if (!(b > 0))
|
|
18
|
+
throw new RangeError('Angle modulus must be positive');
|
|
19
|
+
// C++ int has no negative zero, unlike Math.trunc().
|
|
20
|
+
const truncated = Math.trunc(Math.fround(a / b));
|
|
21
|
+
const quotient = truncated === 0 ? 0 : truncated;
|
|
22
|
+
if (!Number.isFinite(quotient) ||
|
|
23
|
+
quotient < -2147483648 || quotient > 2147483647) {
|
|
24
|
+
throw new RangeError('Angle remainder quotient is outside int32 range');
|
|
25
|
+
}
|
|
26
|
+
const result = Math.fround(a - Math.fround(Math.fround(quotient) * b));
|
|
27
|
+
return result >= 0 ? result : Math.fround(result + b);
|
|
28
|
+
}
|
|
29
|
+
exports.positiveRemainder = positiveRemainder;
|
|
30
|
+
/**
|
|
31
|
+
* sf::Angle's float32 value, with native ownership created on demand.
|
|
32
|
+
* @zh sf::Angle 的 float32 值,按需创建原生所有权。
|
|
33
|
+
* @ja sf::Angle の float32 値。ネイティブ所有権は必要に応じて作成される。
|
|
34
|
+
* @ko sf::Angle의 float32 값. 네이티브 소유권은 필요할 때 생성된다.
|
|
35
|
+
*/
|
|
36
|
+
class Angle {
|
|
37
|
+
/**
|
|
38
|
+
* Create a zero angle, or copy the angle value of source.
|
|
39
|
+
* @zh 创建零角度,或复制 source 的角度值。
|
|
40
|
+
* @ja ゼロ角度を作成するか、source の角度値をコピーする。
|
|
41
|
+
* @ko 영각을 생성하거나 source의 각도 값을 복사한다.
|
|
42
|
+
*/
|
|
43
|
+
constructor(source) {
|
|
44
|
+
this[_a] = true;
|
|
45
|
+
this.state = new lazy_value_1.LazyValue(new Float32Array(1), buffer => native_1.native.wrapAngle(buffer));
|
|
46
|
+
if (source !== undefined) {
|
|
47
|
+
this[value_storage_1.angleStorage][0] = source.asRadians();
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
get [(_a = value_storage_1.mutableValue, value_storage_1.angleStorage)]() {
|
|
51
|
+
return this.state.values;
|
|
52
|
+
}
|
|
53
|
+
get [value_storage_1.angleNative]() {
|
|
54
|
+
return (0, lazy_value_1.nativeValue)(this, value_storage_1.angleNative, this.state);
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Return the value in degrees, with 360 degrees per revolution.
|
|
58
|
+
* @zh 返回角度制数值,一周为 360 度。
|
|
59
|
+
* @ja 度数法の値を返す。1 回転は 360 度。
|
|
60
|
+
* @ko 도 단위 값을 반환한다. 한 바퀴는 360도이다.
|
|
61
|
+
*/
|
|
62
|
+
asDegrees() {
|
|
63
|
+
return Math.fround(this.asRadians() * Math.fround(180 / pi));
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Return the value in radians, with 2π radians per revolution.
|
|
67
|
+
* @zh 返回弧度制数值,一周为 2π 弧度。
|
|
68
|
+
* @ja ラジアン値を返す。1 回転は 2π ラジアン。
|
|
69
|
+
* @ko 라디안 단위 값을 반환한다. 한 바퀴는 2π 라디안이다.
|
|
70
|
+
*/
|
|
71
|
+
asRadians() {
|
|
72
|
+
return this[value_storage_1.angleStorage][0];
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Return a new angle normalized to [-180°, 180°).
|
|
76
|
+
* @zh 返回归一化到 [-180°, 180°) 的新角度。
|
|
77
|
+
* @ja [-180°, 180°) に正規化した新しい角度を返す。
|
|
78
|
+
* @ko [-180°, 180°)로 정규화한 새 각도를 반환한다.
|
|
79
|
+
*/
|
|
80
|
+
wrapSigned() {
|
|
81
|
+
return radians(Math.fround(positiveRemainder(Math.fround(this.asRadians() + pi), tau) - pi));
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Return a new angle normalized to [0°, 360°).
|
|
85
|
+
* @zh 返回归一化到 [0°, 360°) 的新角度。
|
|
86
|
+
* @ja [0°, 360°) に正規化した新しい角度を返す。
|
|
87
|
+
* @ko [0°, 360°)로 정규화한 새 각도를 반환한다.
|
|
88
|
+
*/
|
|
89
|
+
wrapUnsigned() {
|
|
90
|
+
return radians(positiveRemainder(this.asRadians(), tau));
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* The read-only zero angle.
|
|
95
|
+
* @zh 只读的零角度。
|
|
96
|
+
* @ja 読み取り専用のゼロ角度。
|
|
97
|
+
* @ko 읽기 전용 영각.
|
|
98
|
+
*/
|
|
99
|
+
Angle.Zero = Object.freeze(new Angle());
|
|
100
|
+
exports.Angle = Angle;
|
|
101
|
+
/**
|
|
102
|
+
* Create an angle from radians, stored with float32 precision.
|
|
103
|
+
* @zh 从弧度值创建角度,按 float32 精度存储。
|
|
104
|
+
* @ja ラジアン値から角度を作成し、float32 精度で格納する。
|
|
105
|
+
* @ko 라디안 값으로 각도를 생성하고 float32 정밀도로 저장한다.
|
|
106
|
+
*/
|
|
107
|
+
function radians(angle) {
|
|
108
|
+
const result = new Angle();
|
|
109
|
+
result[value_storage_1.angleStorage][0] = angle;
|
|
110
|
+
return result;
|
|
111
|
+
}
|
|
112
|
+
exports.radians = radians;
|
|
113
|
+
/**
|
|
114
|
+
* Create an angle from degrees, stored with float32 precision.
|
|
115
|
+
* @zh 从度数创建角度,按 float32 精度存储。
|
|
116
|
+
* @ja 度数から角度を作成し、float32 精度で格納する。
|
|
117
|
+
* @ko 도 단위 값으로 각도를 생성하고 float32 정밀도로 저장한다.
|
|
118
|
+
*/
|
|
119
|
+
function degrees(angle) {
|
|
120
|
+
return radians(Math.fround(angle) * Math.fround(pi / 180));
|
|
121
|
+
}
|
|
122
|
+
exports.degrees = degrees;
|