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,434 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.installWindowMethods = exports.Window = exports.registerMixedWindow = exports.registerWindowHooks = void 0;
|
|
4
|
+
const native_1 = require("../internal/native");
|
|
5
|
+
const graphics_state_1 = require("../internal/graphics-state");
|
|
6
|
+
const vector2_1 = require("../system/vector2");
|
|
7
|
+
const time_1 = require("../system/time");
|
|
8
|
+
const context_settings_1 = require("./context-settings");
|
|
9
|
+
const constants_1 = require("./gen/constants");
|
|
10
|
+
const video_mode_1 = require("./video-mode");
|
|
11
|
+
const cursor_1 = require("./cursor");
|
|
12
|
+
const event_1 = require("./event");
|
|
13
|
+
const mixedWindows = new WeakSet();
|
|
14
|
+
/**
|
|
15
|
+
* Window hooks are held only by weak keys, preventing Native from retaining
|
|
16
|
+
* JS objects through back references.
|
|
17
|
+
* @zh 窗口钩子仅由弱键持有,不让 Native 反向保留 JS 对象。
|
|
18
|
+
* @ja ウィンドウフックは弱いキーのみで保持し、Native が逆参照によって
|
|
19
|
+
* JS オブジェクトを保持しないようにする。
|
|
20
|
+
* @ko 윈도우 훅은 약한 키로만 유지하여 Native가 역참조로 JS 객체를 유지하지
|
|
21
|
+
* 않도록 한다.
|
|
22
|
+
*/
|
|
23
|
+
const windowHooks = new WeakMap();
|
|
24
|
+
/**
|
|
25
|
+
* Register dynamic hooks after construction, allowing render windows to
|
|
26
|
+
* initialize views before the creation hook.
|
|
27
|
+
* @zh 注册构造完成后的动态钩子,渲染窗口可在创建钩子前初始化视图。
|
|
28
|
+
* @ja 構築後に動的フックを登録し、描画ウィンドウが作成フックより前に
|
|
29
|
+
* ビューを初期化できるようにする。
|
|
30
|
+
* @ko 생성 완료 후 동적 훅을 등록하여 렌더 윈도우가 생성 훅 전에 뷰를
|
|
31
|
+
* 초기화할 수 있게 한다.
|
|
32
|
+
*/
|
|
33
|
+
function registerWindowHooks(window, onCreate, onResize) {
|
|
34
|
+
windowHooks.set(window, [onCreate, onResize]);
|
|
35
|
+
}
|
|
36
|
+
exports.registerWindowHooks = registerWindowHooks;
|
|
37
|
+
/**
|
|
38
|
+
* Consume notifications one by one after native operations return; closing
|
|
39
|
+
* or recreating clears the old window's remaining notifications.
|
|
40
|
+
* @zh 原生操作返回后逐条消费通知;关闭或重建会清除旧窗口的剩余通知。
|
|
41
|
+
* @ja ネイティブ操作が戻った後に通知を 1 件ずつ消費する。閉じる操作や再作成は
|
|
42
|
+
* 古いウィンドウの残りの通知を消去する。
|
|
43
|
+
* @ko 네이티브 작업이 반환된 후 알림을 하나씩 소비한다. 닫거나 다시 생성하면
|
|
44
|
+
* 이전 윈도우의 남은 알림을 지운다.
|
|
45
|
+
*/
|
|
46
|
+
function dispatchWindowHooks(window) {
|
|
47
|
+
let notification;
|
|
48
|
+
while ((notification =
|
|
49
|
+
native_1.native.takeWindowNotification(window[graphics_state_1.graphicsNative])) !== undefined) {
|
|
50
|
+
windowHooks.get(window)?.[notification === 'create' ? 0 : 1]();
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
function registerMixedWindow(window) {
|
|
54
|
+
mixedWindows.add(window);
|
|
55
|
+
}
|
|
56
|
+
exports.registerMixedWindow = registerMixedWindow;
|
|
57
|
+
/**
|
|
58
|
+
* An OS window with an OpenGL context, usable by Texture.update().
|
|
59
|
+
* @zh 带 OpenGL 上下文的操作系统窗口,可用于 Texture.update()。
|
|
60
|
+
* @ja OpenGL コンテキストを持つ OS ウィンドウ。Texture.update() で利用できる。
|
|
61
|
+
* @ko OpenGL 컨텍스트가 있는 OS 윈도우. Texture.update()에서 사용할 수 있다.
|
|
62
|
+
*/
|
|
63
|
+
class Window {
|
|
64
|
+
static [Symbol.hasInstance](value) {
|
|
65
|
+
return Function.prototype[Symbol.hasInstance].call(this, value) ||
|
|
66
|
+
(this === Window && typeof value === 'object' && value !== null &&
|
|
67
|
+
mixedWindows.has(value));
|
|
68
|
+
}
|
|
69
|
+
constructor(mode, title, options = {}) {
|
|
70
|
+
this[graphics_state_1.graphicsNative] = native_1.native.createWindow();
|
|
71
|
+
if (typeof mode === 'bigint') {
|
|
72
|
+
Window.prototype.create.call(this, mode, title);
|
|
73
|
+
}
|
|
74
|
+
else if (mode !== undefined) {
|
|
75
|
+
Window.prototype.create.bind(this)(mode, title, options);
|
|
76
|
+
}
|
|
77
|
+
registerWindowHooks(this, () => this.onCreate(), () => this.onResize());
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Called synchronously after an explicit create succeeds; derived hooks
|
|
81
|
+
* are not called during base construction with arguments.
|
|
82
|
+
* @zh 显式 create 成功后同步调用;有参基类构造期间不调用派生钩子。
|
|
83
|
+
* @ja 明示的な create の成功後に同期的に呼ばれる。引数付きの基底クラス構築中は
|
|
84
|
+
* 派生クラスのフックを呼ばない。
|
|
85
|
+
* @ko 명시적 create 성공 후 동기적으로 호출된다. 인수가 있는 기본 클래스 생성 중에는
|
|
86
|
+
* 파생 훅을 호출하지 않는다.
|
|
87
|
+
*/
|
|
88
|
+
onCreate() { }
|
|
89
|
+
/**
|
|
90
|
+
* Called synchronously after SFML actually reports a size change, without
|
|
91
|
+
* consuming the corresponding Resized event.
|
|
92
|
+
* @zh SFML 实际通知尺寸变化后同步调用,不消费对应的 Resized 事件。
|
|
93
|
+
* @ja SFML が実際にサイズ変更を通知した後で同期的に呼ばれる。
|
|
94
|
+
* 対応する Resized イベントは消費しない。
|
|
95
|
+
* @ko SFML이 실제 크기 변경을 알린 후 동기적으로 호출된다.
|
|
96
|
+
* 해당 Resized 이벤트는 소비하지 않는다.
|
|
97
|
+
*/
|
|
98
|
+
onResize() { }
|
|
99
|
+
create(mode, title, options = {}) {
|
|
100
|
+
if (typeof mode === 'bigint') {
|
|
101
|
+
native_1.native.openWindowHandle(this[graphics_state_1.graphicsNative], mode, (0, context_settings_1.contextSettings)(title ?? {}));
|
|
102
|
+
dispatchWindowHooks(this);
|
|
103
|
+
return;
|
|
104
|
+
}
|
|
105
|
+
const size = mode instanceof video_mode_1.VideoMode ? mode.size : mode;
|
|
106
|
+
const bits = mode instanceof video_mode_1.VideoMode ? mode.bitsPerPixel : 32;
|
|
107
|
+
(0, video_mode_1.windowSize)(size);
|
|
108
|
+
(0, video_mode_1.unsigned)(bits);
|
|
109
|
+
const { style = constants_1.Style.Default, state = constants_1.State.Windowed, settings = {} } = options;
|
|
110
|
+
(0, video_mode_1.unsigned)(style);
|
|
111
|
+
// eslint-disable-next-line no-bitwise
|
|
112
|
+
if ((style & ~constants_1.Style.Default) !== 0) {
|
|
113
|
+
throw new RangeError('Unknown window style');
|
|
114
|
+
}
|
|
115
|
+
if (state !== constants_1.State.Windowed && state !== constants_1.State.Fullscreen) {
|
|
116
|
+
throw new RangeError('Unknown window state');
|
|
117
|
+
}
|
|
118
|
+
native_1.native.openWindow(this[graphics_state_1.graphicsNative], size.x, size.y, title, bits, style, state, (0, context_settings_1.contextSettings)(settings));
|
|
119
|
+
dispatchWindowHooks(this);
|
|
120
|
+
}
|
|
121
|
+
/**
|
|
122
|
+
* Close the window; the object remains and create can be called again.
|
|
123
|
+
* @zh 关闭窗口;对象保留,可再次调用 create。
|
|
124
|
+
* @ja ウィンドウを閉じる。オブジェクトは残り、create を再度呼び出せる。
|
|
125
|
+
* @ko 윈도우를 닫는다. 객체는 유지되며 create를 다시 호출할 수 있다.
|
|
126
|
+
*/
|
|
127
|
+
close() {
|
|
128
|
+
native_1.native.closeWindow(this[graphics_state_1.graphicsNative]);
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Return whether the system window is still open.
|
|
132
|
+
* @zh 返回系统窗口是否仍然打开。
|
|
133
|
+
* @ja システムウィンドウがまだ開いているかどうかを返す。
|
|
134
|
+
* @ko 시스템 윈도우가 아직 열려 있는지 반환한다.
|
|
135
|
+
*/
|
|
136
|
+
isOpen() {
|
|
137
|
+
return native_1.native.isWindowOpen(this[graphics_state_1.graphicsNative]);
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* Return a copy of the client area's pixel dimensions.
|
|
141
|
+
* @zh 返回客户区像素尺寸的副本。
|
|
142
|
+
* @ja クライアント領域のピクセル寸法のコピーを返す。
|
|
143
|
+
* @ko 클라이언트 영역 픽셀 크기의 복사본을 반환한다.
|
|
144
|
+
*/
|
|
145
|
+
getSize() {
|
|
146
|
+
const [width, height] = native_1.native.getWindowSize(this[graphics_state_1.graphicsNative]);
|
|
147
|
+
return new vector2_1.Vector2u(width, height);
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* Return the window's pixel position on the desktop.
|
|
151
|
+
* @zh 返回窗口在桌面中的像素位置。
|
|
152
|
+
* @ja デスクトップ上のウィンドウのピクセル位置を返す。
|
|
153
|
+
* @ko 데스크톱에서 윈도우의 픽셀 위치를 반환한다.
|
|
154
|
+
*/
|
|
155
|
+
getPosition() {
|
|
156
|
+
return new vector2_1.Vector2i(...native_1.native.getWindowPosition(this[graphics_state_1.graphicsNative]));
|
|
157
|
+
}
|
|
158
|
+
/**
|
|
159
|
+
* Set the window's pixel position on the desktop.
|
|
160
|
+
* @zh 设置窗口在桌面中的像素位置。
|
|
161
|
+
* @ja デスクトップ上のウィンドウのピクセル位置を設定する。
|
|
162
|
+
* @ko 데스크톱에서 윈도우의 픽셀 위치를 설정한다.
|
|
163
|
+
*/
|
|
164
|
+
setPosition(position) {
|
|
165
|
+
if (!(position instanceof vector2_1.Vector2) || position.scalarType !== 'i32') {
|
|
166
|
+
throw new TypeError('Expected a Vector2i');
|
|
167
|
+
}
|
|
168
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'position', position.x, position.y);
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Set the client area's pixel dimensions; width and height must be positive.
|
|
172
|
+
* @zh 设置客户区像素尺寸,宽高必须为正。
|
|
173
|
+
* @ja クライアント領域のピクセル寸法を設定する。幅と高さは正でなければならない。
|
|
174
|
+
* @ko 클라이언트 영역의 픽셀 크기를 설정한다. 너비와 높이는 양수여야 한다.
|
|
175
|
+
*/
|
|
176
|
+
setSize(size) {
|
|
177
|
+
(0, video_mode_1.windowSize)(size);
|
|
178
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'size', size.x, size.y);
|
|
179
|
+
dispatchWindowHooks(this);
|
|
180
|
+
}
|
|
181
|
+
/**
|
|
182
|
+
* Set the client area's minimum pixel dimensions; undefined removes the
|
|
183
|
+
* limit.
|
|
184
|
+
* @zh 设置客户区最小像素尺寸;undefined 取消限制。
|
|
185
|
+
* @ja クライアント領域の最小ピクセル寸法を設定する。undefined は制限を解除する。
|
|
186
|
+
* @ko 클라이언트 영역의 최소 픽셀 크기를 설정한다. undefined는 제한을 해제한다.
|
|
187
|
+
*/
|
|
188
|
+
setMinimumSize(size) {
|
|
189
|
+
if (size !== undefined)
|
|
190
|
+
(0, video_mode_1.windowSize)(size);
|
|
191
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'minimumSize', size?.x, size?.y);
|
|
192
|
+
dispatchWindowHooks(this);
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
* Set the client area's maximum pixel dimensions; undefined removes the
|
|
196
|
+
* limit.
|
|
197
|
+
* @zh 设置客户区最大像素尺寸;undefined 取消限制。
|
|
198
|
+
* @ja クライアント領域の最大ピクセル寸法を設定する。undefined は制限を解除する。
|
|
199
|
+
* @ko 클라이언트 영역의 최대 픽셀 크기를 설정한다. undefined는 제한을 해제한다.
|
|
200
|
+
*/
|
|
201
|
+
setMaximumSize(size) {
|
|
202
|
+
if (size !== undefined)
|
|
203
|
+
(0, video_mode_1.windowSize)(size);
|
|
204
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'maximumSize', size?.x, size?.y);
|
|
205
|
+
dispatchWindowHooks(this);
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* Set the window title.
|
|
209
|
+
* @zh 设置窗口标题。
|
|
210
|
+
* @ja ウィンドウのタイトルを設定する。
|
|
211
|
+
* @ko 윈도우 제목을 설정한다.
|
|
212
|
+
*/
|
|
213
|
+
setTitle(title) {
|
|
214
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'title', title);
|
|
215
|
+
}
|
|
216
|
+
/**
|
|
217
|
+
* Set the RGBA8 window icon; pixel data must contain at least
|
|
218
|
+
* size.x×size.y×4 bytes.
|
|
219
|
+
* @zh 设置 RGBA8 窗口图标;像素数据至少包含 size.x×size.y×4 字节。
|
|
220
|
+
* @ja RGBA8 ウィンドウアイコンを設定する。ピクセルデータは最低
|
|
221
|
+
* size.x×size.y×4 バイト必要。
|
|
222
|
+
* @ko RGBA8 윈도우 아이콘을 설정한다. 픽셀 데이터는 최소 size.x×size.y×4 바이트가
|
|
223
|
+
* 필요하다.
|
|
224
|
+
*/
|
|
225
|
+
setIcon(size, pixels) {
|
|
226
|
+
(0, cursor_1.rgbaPixels)(size, pixels);
|
|
227
|
+
native_1.native.setWindowIcon(this[graphics_state_1.graphicsNative], size.x, size.y, pixels);
|
|
228
|
+
}
|
|
229
|
+
/**
|
|
230
|
+
* Show or hide the window.
|
|
231
|
+
* @zh 显示或隐藏窗口。
|
|
232
|
+
* @ja ウィンドウを表示または非表示にする。
|
|
233
|
+
* @ko 윈도우를 표시하거나 숨긴다.
|
|
234
|
+
*/
|
|
235
|
+
setVisible(visible) {
|
|
236
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'visible', visible);
|
|
237
|
+
}
|
|
238
|
+
/**
|
|
239
|
+
* Set whether the mouse cursor is visible in the client area.
|
|
240
|
+
* @zh 设置鼠标在客户区中是否显示光标。
|
|
241
|
+
* @ja クライアント領域内でマウスカーソルを表示するか設定する。
|
|
242
|
+
* @ko 클라이언트 영역에서 마우스 커서를 표시할지 설정한다.
|
|
243
|
+
*/
|
|
244
|
+
setMouseCursorVisible(visible) {
|
|
245
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'cursorVisible', visible);
|
|
246
|
+
}
|
|
247
|
+
/**
|
|
248
|
+
* Set whether to confine the mouse to the window, usually only effective
|
|
249
|
+
* while the window has focus.
|
|
250
|
+
* @zh 设置是否将鼠标限制在窗口内,通常仅在窗口获得焦点时生效。
|
|
251
|
+
* @ja マウスをウィンドウ内に制限するか設定する。
|
|
252
|
+
* 通常はウィンドウにフォーカスがある間のみ有効。
|
|
253
|
+
* @ko 마우스를 윈도우 안에 제한할지 설정한다.
|
|
254
|
+
* 일반적으로 윈도우가 포커스를 가진 동안에만 적용된다.
|
|
255
|
+
*/
|
|
256
|
+
setMouseCursorGrabbed(grabbed) {
|
|
257
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'cursorGrabbed', grabbed);
|
|
258
|
+
}
|
|
259
|
+
/**
|
|
260
|
+
* Set the cursor used within the window.
|
|
261
|
+
* @zh 设置窗口内使用的光标。
|
|
262
|
+
* @ja ウィンドウ内で使用するカーソルを設定する。
|
|
263
|
+
* @ko 윈도우 안에서 사용할 커서를 설정한다.
|
|
264
|
+
*/
|
|
265
|
+
setMouseCursor(cursor) {
|
|
266
|
+
if (!(cursor instanceof cursor_1.Cursor))
|
|
267
|
+
throw new TypeError('Expected a Cursor');
|
|
268
|
+
native_1.native.setWindowCursor(this[graphics_state_1.graphicsNative], cursor[graphics_state_1.graphicsNative]);
|
|
269
|
+
}
|
|
270
|
+
/**
|
|
271
|
+
* Set whether holding a key repeatedly generates KeyPressed events.
|
|
272
|
+
* @zh 设置长按键盘时是否重复产生 KeyPressed 事件。
|
|
273
|
+
* @ja キーを押し続けたときに KeyPressed イベントを繰り返し発生させるか設定する。
|
|
274
|
+
* @ko 키를 계속 누를 때 KeyPressed 이벤트를 반복 생성할지 설정한다.
|
|
275
|
+
*/
|
|
276
|
+
setKeyRepeatEnabled(enabled) {
|
|
277
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'keyRepeat', enabled);
|
|
278
|
+
}
|
|
279
|
+
/**
|
|
280
|
+
* Set the axis-change threshold for joystick movement events, from 0 to 100.
|
|
281
|
+
* @zh 设置触发手柄移动事件的轴变化阈值,范围 0~100。
|
|
282
|
+
* @ja ジョイスティック移動イベントを発生させる軸変化のしきい値を 0~100 で設定する。
|
|
283
|
+
* @ko 조이스틱 이동 이벤트를 발생시키는 축 변화 임계값을 0~100 범위로 설정한다.
|
|
284
|
+
*/
|
|
285
|
+
setJoystickThreshold(threshold) {
|
|
286
|
+
if (!Number.isFinite(threshold) || threshold < 0 || threshold > 100) {
|
|
287
|
+
throw new RangeError('Joystick threshold must be from 0 to 100');
|
|
288
|
+
}
|
|
289
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'joystickThreshold', threshold);
|
|
290
|
+
}
|
|
291
|
+
/**
|
|
292
|
+
* Request window focus from the system; the window manager decides whether
|
|
293
|
+
* to grant it.
|
|
294
|
+
* @zh 向系统请求窗口焦点,是否获准由窗口管理器决定。
|
|
295
|
+
* @ja システムにウィンドウのフォーカスを要求する。許可はウィンドウマネージャーが
|
|
296
|
+
* 決定する。
|
|
297
|
+
* @ko 시스템에 윈도우 포커스를 요청한다. 허용 여부는 윈도우 관리자가 결정한다.
|
|
298
|
+
*/
|
|
299
|
+
requestFocus() {
|
|
300
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'focus');
|
|
301
|
+
}
|
|
302
|
+
/**
|
|
303
|
+
* Return whether the window currently has input focus.
|
|
304
|
+
* @zh 返回窗口当前是否拥有输入焦点。
|
|
305
|
+
* @ja ウィンドウが現在入力フォーカスを持つかどうかを返す。
|
|
306
|
+
* @ko 윈도우가 현재 입력 포커스를 갖고 있는지 반환한다.
|
|
307
|
+
*/
|
|
308
|
+
hasFocus() {
|
|
309
|
+
return native_1.native.hasWindowFocus(this[graphics_state_1.graphicsNative]);
|
|
310
|
+
}
|
|
311
|
+
/**
|
|
312
|
+
* Return the platform-native window handle as bigint to preserve pointer
|
|
313
|
+
* precision.
|
|
314
|
+
* @zh 返回平台原生窗口句柄,以 bigint 保留指针精度。
|
|
315
|
+
* @ja ポインター精度を保つ bigint でプラットフォーム固有のウィンドウハンドルを返す。
|
|
316
|
+
* @ko 포인터 정밀도를 유지하도록 플랫폼 네이티브 윈도우 핸들을 bigint로 반환한다.
|
|
317
|
+
*/
|
|
318
|
+
getNativeHandle() {
|
|
319
|
+
return native_1.native.getWindowNativeHandle(this[graphics_state_1.graphicsNative]);
|
|
320
|
+
}
|
|
321
|
+
/**
|
|
322
|
+
* Returns the created VkSurfaceKHR, or undefined when creation fails.
|
|
323
|
+
* @zh 返回创建的 VkSurfaceKHR,创建失败时返回 undefined。
|
|
324
|
+
* @ja 作成した VkSurfaceKHR を返す。作成に失敗した場合は undefined。
|
|
325
|
+
* @ko 생성한 VkSurfaceKHR를 반환한다. 생성 실패 시 undefined를 반환한다.
|
|
326
|
+
*/
|
|
327
|
+
createVulkanSurface(instance, allocator = 0n) {
|
|
328
|
+
return native_1.native.createWindowVulkanSurface(this[graphics_state_1.graphicsNative], instance, allocator);
|
|
329
|
+
}
|
|
330
|
+
/**
|
|
331
|
+
* Return the actual OpenGL context settings, which may differ from those
|
|
332
|
+
* requested.
|
|
333
|
+
* @zh 返回实际创建的 OpenGL 上下文配置,可能与请求值不同。
|
|
334
|
+
* @ja 実際に作成された OpenGL コンテキスト設定を返す。要求値と異なる場合がある。
|
|
335
|
+
* @ko 실제 생성된 OpenGL 컨텍스트 설정을 반환한다. 요청한 값과 다를 수 있다.
|
|
336
|
+
*/
|
|
337
|
+
getSettings() {
|
|
338
|
+
return (0, context_settings_1.settingsFromBuffer)(native_1.native.getWindowSettings(this[graphics_state_1.graphicsNative]));
|
|
339
|
+
}
|
|
340
|
+
/**
|
|
341
|
+
* Set whether buffer swaps synchronize with the display refresh.
|
|
342
|
+
* @zh 设置缓冲交换是否与显示器刷新同步。
|
|
343
|
+
* @ja バッファ交換をディスプレイのリフレッシュに同期させるか設定する。
|
|
344
|
+
* @ko 버퍼 교환을 디스플레이 새로 고침과 동기화할지 설정한다.
|
|
345
|
+
*/
|
|
346
|
+
setVerticalSyncEnabled(enabled) {
|
|
347
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'verticalSync', enabled);
|
|
348
|
+
}
|
|
349
|
+
/**
|
|
350
|
+
* Set the maximum display calls per second; 0 removes the frame-rate
|
|
351
|
+
* limit, and waiting occurs inside display.
|
|
352
|
+
* @zh 设置每秒最大 display 次数;0 取消帧率限制,等待发生在 display 中。
|
|
353
|
+
* @ja 1 秒あたりの display の最大回数を設定する。0 はフレームレート制限を解除し、
|
|
354
|
+
* 待機は display 内で行われる。
|
|
355
|
+
* @ko 초당 최대 display 호출 수를 설정한다. 0은 프레임 속도 제한을 해제하며
|
|
356
|
+
* 대기는 display 안에서 이루어진다.
|
|
357
|
+
*/
|
|
358
|
+
setFramerateLimit(limit) {
|
|
359
|
+
(0, video_mode_1.unsigned)(limit);
|
|
360
|
+
native_1.native.windowCommand(this[graphics_state_1.graphicsNative], 'framerateLimit', limit);
|
|
361
|
+
}
|
|
362
|
+
/**
|
|
363
|
+
* Retrieve one window event without blocking; return undefined if the
|
|
364
|
+
* queue is empty.
|
|
365
|
+
* @zh 非阻塞取出一个窗口事件;队列为空时返回 undefined。
|
|
366
|
+
* @ja ブロックせずにウィンドウイベントを 1 件取り出す。キューが空なら undefined。
|
|
367
|
+
* @ko 블로킹 없이 윈도우 이벤트 하나를 꺼낸다. 큐가 비어 있으면 undefined를 반환한다.
|
|
368
|
+
*/
|
|
369
|
+
pollEvent() {
|
|
370
|
+
const raw = native_1.native.pollWindowEvent(this[graphics_state_1.graphicsNative]);
|
|
371
|
+
dispatchWindowHooks(this);
|
|
372
|
+
return raw === undefined ? undefined : (0, event_1.windowEvent)(raw);
|
|
373
|
+
}
|
|
374
|
+
/**
|
|
375
|
+
* Blocks the calling thread like SFML; Time.Zero waits indefinitely.
|
|
376
|
+
* @zh 与 SFML 一样阻塞调用线程;Time.Zero 表示无限等待。
|
|
377
|
+
* @ja SFML と同様に呼び出しスレッドをブロックする。Time.Zero は無期限に待機する。
|
|
378
|
+
* @ko SFML처럼 호출 스레드를 블로킹한다. Time.Zero는 무기한 대기한다.
|
|
379
|
+
*/
|
|
380
|
+
waitEvent(timeout = time_1.Time.Zero) {
|
|
381
|
+
if (!(timeout instanceof time_1.Time))
|
|
382
|
+
throw new TypeError('Expected a Time');
|
|
383
|
+
const raw = native_1.native.waitWindowEvent(this[graphics_state_1.graphicsNative], timeout.asMicroseconds());
|
|
384
|
+
dispatchWindowHooks(this);
|
|
385
|
+
return raw === undefined ? undefined : (0, event_1.windowEvent)(raw);
|
|
386
|
+
}
|
|
387
|
+
handleEvents(handlers, fallback) {
|
|
388
|
+
let event;
|
|
389
|
+
while ((event = this.pollEvent()) !== undefined) {
|
|
390
|
+
const handler = typeof handlers === 'function' ? handlers
|
|
391
|
+
: handlers[event.kind];
|
|
392
|
+
(handler ?? fallback)?.(event.data);
|
|
393
|
+
}
|
|
394
|
+
}
|
|
395
|
+
/**
|
|
396
|
+
* Activate or deactivate the window's OpenGL context on the current thread,
|
|
397
|
+
* returning whether it succeeded.
|
|
398
|
+
* @zh 激活或停用当前线程的窗口 OpenGL 上下文,返回是否成功。
|
|
399
|
+
* @ja 現在のスレッドでウィンドウの OpenGL コンテキストを有効化または無効化し、
|
|
400
|
+
* 成功したかどうかを返す。
|
|
401
|
+
* @ko 현재 스레드에서 윈도우의 OpenGL 컨텍스트를 활성화 또는 비활성화하고
|
|
402
|
+
* 성공 여부를 반환한다.
|
|
403
|
+
*/
|
|
404
|
+
setActive(active = true) {
|
|
405
|
+
return native_1.native.setWindowActive(this[graphics_state_1.graphicsNative], active);
|
|
406
|
+
}
|
|
407
|
+
/**
|
|
408
|
+
* Swap the OpenGL front and back buffers; vertical sync and frame-rate
|
|
409
|
+
* limits may block the current thread.
|
|
410
|
+
* @zh 交换 OpenGL 前后缓冲;垂直同步和帧率限制可能阻塞当前线程。
|
|
411
|
+
* @ja OpenGL のフロントバッファとバックバッファを交換する。垂直同期と
|
|
412
|
+
* フレームレート制限により現在のスレッドがブロックされる場合がある。
|
|
413
|
+
* @ko OpenGL 전면 및 후면 버퍼를 교환한다. 수직 동기화와 프레임 속도 제한이
|
|
414
|
+
* 현재 스레드를 블로킹할 수 있다.
|
|
415
|
+
*/
|
|
416
|
+
display() {
|
|
417
|
+
native_1.native.displayWindow(this[graphics_state_1.graphicsNative]);
|
|
418
|
+
}
|
|
419
|
+
}
|
|
420
|
+
exports.Window = Window;
|
|
421
|
+
/**
|
|
422
|
+
* Share Window methods with a RenderTarget subclass without another window.
|
|
423
|
+
* @zh 不创建另一个窗口,与 RenderTarget 子类共享 Window 方法。
|
|
424
|
+
* @ja 別のウィンドウを作らずに RenderTarget サブクラスと Window メソッドを共有する。
|
|
425
|
+
* @ko 다른 윈도우를 만들지 않고 RenderTarget 하위 클래스와 Window 메서드를 공유한다.
|
|
426
|
+
*/
|
|
427
|
+
function installWindowMethods(prototype) {
|
|
428
|
+
for (const key of Reflect.ownKeys(Window.prototype)) {
|
|
429
|
+
if (key === 'constructor' || key in prototype)
|
|
430
|
+
continue;
|
|
431
|
+
Object.defineProperty(prototype, key, Object.getOwnPropertyDescriptor(Window.prototype, key));
|
|
432
|
+
}
|
|
433
|
+
}
|
|
434
|
+
exports.installWindowMethods = installWindowMethods;
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# sfml.js ドキュメント
|
|
2
|
+
|
|
3
|
+
[English](README.md) / [简体中文](README.zh-CN.md) / **日本語** / [한국어](README.ko.md)
|
|
4
|
+
|
|
5
|
+
> このドキュメントは、現在のリポジトリの SFML 3.1.0 バインディングに対応しています。初めて使う場合は「クイックスタート」から読み、個々のメソッドのシグネチャを調べる場合は [TypeDoc](https://sfml.js.org/ja/reference/) を参照してください。
|
|
6
|
+
|
|
7
|
+
## はじめに
|
|
8
|
+
|
|
9
|
+
| ドキュメント | 内容 |
|
|
10
|
+
| --- | --- |
|
|
11
|
+
| [クイックスタート](getting-started.ja.md) | 依存関係のインストール、インポート方法の選択、最初のウィンドウの作成 |
|
|
12
|
+
| [基本概念](concepts.ja.md) | 値とリソースのコピー、読み込みの完了時点、draw が反映されるタイミング |
|
|
13
|
+
| [API ナビゲーション](api.ja.md) | 5 つのモジュールが提供する機能 |
|
|
14
|
+
| [サンプル一覧](../examples/README.ja.md) | リポジトリ内の完全なデモの実行 |
|
|
15
|
+
|
|
16
|
+
## モジュール別ガイド
|
|
17
|
+
|
|
18
|
+
| モジュール | 内容 |
|
|
19
|
+
| --- | --- |
|
|
20
|
+
| [System](system.ja.md) | ベクトル、角度、時間、入力ストリーム、Unicode、エラー処理 |
|
|
21
|
+
| [Window](window.ja.md) | ウィンドウのライフサイクル、イベント、リアルタイム入力、OpenGL、Vulkan |
|
|
22
|
+
| [Graphics](graphics.ja.md) | 画像、テクスチャ、スプライト、図形、テキスト、ビュー、描画 |
|
|
23
|
+
| [Audio](audio.ja.md) | 再生、ストリーミングでのデータ供給、エフェクト、録音、エンコードとデコード |
|
|
24
|
+
| [Network](network.ja.md) | Packet、TCP/UDP、DNS、TLS、HTTP、FTP、SFTP |
|
|
25
|
+
|
|
26
|
+
## 開発への参加
|
|
27
|
+
|
|
28
|
+
[開発ガイド](development.ja.md)では、ビルド、テスト、ソースコードの構成、現在のドキュメント公開手順を説明しています。
|
|
29
|
+
|
|
30
|
+
メソッドのシグネチャとエクスポート一覧は [src/index.ts](../src/index.ts) とそのソースコメントを基準とします。上流の概念は [SFML 3.1.0 C++ リファレンス](https://www.sfml-dev.org/documentation/3.1.0/)を参照してください。JavaScript への適応、特に Node.js の非同期処理、メモリ、ネットワークの挙動は、sfml.js のガイドと [TypeDoc](https://sfml.js.org/ja/reference/) を基準とします。
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# sfml.js 문서
|
|
2
|
+
|
|
3
|
+
[English](README.md) / [简体中文](README.zh-CN.md) / [日本語](README.ja.md) / **한국어**
|
|
4
|
+
|
|
5
|
+
> 이 문서는 현재 저장소의 SFML 3.1.0 바인딩을 설명합니다. 처음 사용한다면 '빠른 시작'부터 읽으세요. 구체적인 메서드 시그니처는 [TypeDoc](https://sfml.js.org/ko/reference/)에서 확인할 수 있습니다.
|
|
6
|
+
|
|
7
|
+
## 시작하기
|
|
8
|
+
|
|
9
|
+
| 문서 | 다루는 문제 |
|
|
10
|
+
| --- | --- |
|
|
11
|
+
| [빠른 시작](getting-started.ko.md) | 의존성 설치, 가져오기 방식 선택, 첫 번째 창 열기 |
|
|
12
|
+
| [핵심 개념](concepts.ko.md) | 값과 리소스의 복사 방식, 로딩 완료 시점, draw 적용 시점 |
|
|
13
|
+
| [API 안내](api.ko.md) | 다섯 모듈이 각각 제공하는 기능 |
|
|
14
|
+
| [예제 목록](../examples/README.ko.md) | 저장소에서 완전한 데모 실행하기 |
|
|
15
|
+
|
|
16
|
+
## 모듈별 문서
|
|
17
|
+
|
|
18
|
+
| 모듈 | 내용 |
|
|
19
|
+
| --- | --- |
|
|
20
|
+
| [System](system.ko.md) | 벡터, 각도, 시간, 입력 스트림, Unicode, 오류 처리 |
|
|
21
|
+
| [Window](window.ko.md) | 창 수명 주기, 이벤트, 실시간 입력, OpenGL, Vulkan |
|
|
22
|
+
| [Graphics](graphics.ko.md) | 이미지, 텍스처, 스프라이트, 도형, 텍스트, 뷰, 그리기 |
|
|
23
|
+
| [Audio](audio.ko.md) | 재생, 스트리밍 데이터 공급, 오디오 효과, 녹음, 코덱 |
|
|
24
|
+
| [Network](network.ko.md) | Packet, TCP/UDP, DNS, TLS, HTTP, FTP, SFTP |
|
|
25
|
+
|
|
26
|
+
## 개발 참여
|
|
27
|
+
|
|
28
|
+
[개발 가이드](development.ko.md)는 빌드, 테스트, 소스 구조, 현재의 문서 게시 절차를 설명합니다.
|
|
29
|
+
|
|
30
|
+
메서드 시그니처와 내보내기 목록은 [src/index.ts](../src/index.ts) 및 소스 주석을 기준으로 합니다. 업스트림 개념은 [SFML 3.1.0 C++ 문서 색인](https://www.sfml-dev.org/documentation/3.1.0/)을 참고하세요. JavaScript에 맞게 조정한 동작은 sfml.js 가이드와 [TypeDoc](https://sfml.js.org/ko/reference/)을 기준으로 하며, Node.js의 비동기 처리, 메모리, 네트워크 어댑테이션은 이 프로젝트의 설명을 따릅니다.
|
package/docs/README.md
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# sfml.js Documentation
|
|
2
|
+
|
|
3
|
+
**English** · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md)
|
|
4
|
+
|
|
5
|
+
> These guides cover the SFML 3.1.0 binding in the current repository. Start with "Quick start" if you are new to sfml.js; use [TypeDoc](https://sfml.js.org/reference/) to look up specific method signatures.
|
|
6
|
+
|
|
7
|
+
## Getting started
|
|
8
|
+
|
|
9
|
+
| Guide | What it covers |
|
|
10
|
+
| --- | --- |
|
|
11
|
+
| [Quick start](getting-started.md) | Install dependencies, choose an import style and open your first window |
|
|
12
|
+
| [Core concepts](concepts.md) | Copying values and resources, loading completion and when draws take effect |
|
|
13
|
+
| [API guide](api.md) | Capabilities of the five modules |
|
|
14
|
+
| [Examples](../examples/README.md) | Run complete demonstrations from the repository |
|
|
15
|
+
|
|
16
|
+
## Module guides
|
|
17
|
+
|
|
18
|
+
| Module | Contents |
|
|
19
|
+
| --- | --- |
|
|
20
|
+
| [System](system.md) | Vectors, angles, time, input streams, Unicode and error handling |
|
|
21
|
+
| [Window](window.md) | Window lifecycle, events, real-time input, OpenGL and Vulkan |
|
|
22
|
+
| [Graphics](graphics.md) | Images, textures, sprites, shapes, text, views and drawing |
|
|
23
|
+
| [Audio](audio.md) | Playback, streaming data, effects, recording and codecs |
|
|
24
|
+
| [Network](network.md) | Packet, TCP/UDP, DNS, TLS, HTTP, FTP and SFTP |
|
|
25
|
+
|
|
26
|
+
## Contributing
|
|
27
|
+
|
|
28
|
+
The [development guide](development.md) explains building, testing, source organization and the existing documentation publishing workflow.
|
|
29
|
+
|
|
30
|
+
Method signatures and exports are defined by [src/index.ts](../src/index.ts) and its source comments, published through [TypeDoc](https://sfml.js.org/reference/). Use the [SFML 3.1.0 C++ reference](https://www.sfml-dev.org/documentation/3.1.0/) for upstream concepts; use the sfml.js guides and TypeDoc for JavaScript adaptations, including Node.js asynchronous behavior, memory and networking.
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# sfml.js 文档
|
|
2
|
+
|
|
3
|
+
[English](README.md) · **简体中文** · [日本語](README.ja.md) · [한국어](README.ko.md)
|
|
4
|
+
|
|
5
|
+
> 本文档对应当前仓库的 SFML 3.1.0 绑定。第一次使用从「快速开始」阅读;查询具体方法签名时使用 [TypeDoc](https://sfml.js.org/zh/reference/)。
|
|
6
|
+
|
|
7
|
+
## 开始使用
|
|
8
|
+
|
|
9
|
+
| 文档 | 解决的问题 |
|
|
10
|
+
| --- | --- |
|
|
11
|
+
| [快速开始](getting-started.zh-CN.md) | 安装依赖、选择导入方式、打开第一个窗口 |
|
|
12
|
+
| [核心概念](concepts.zh-CN.md) | 值与资源如何复制、加载何时完成、draw 何时生效 |
|
|
13
|
+
| [API 导航](api.zh-CN.md) | 五个模块分别提供什么能力 |
|
|
14
|
+
| [示例目录](../examples/README.zh-CN.md) | 在仓库中运行完整演示 |
|
|
15
|
+
|
|
16
|
+
## 按模块阅读
|
|
17
|
+
|
|
18
|
+
| 模块 | 内容 |
|
|
19
|
+
| --- | --- |
|
|
20
|
+
| [System](system.zh-CN.md) | 向量、角度、时间、输入流、Unicode 与错误处理 |
|
|
21
|
+
| [Window](window.zh-CN.md) | 窗口生命周期、事件、实时输入、OpenGL 与 Vulkan |
|
|
22
|
+
| [Graphics](graphics.zh-CN.md) | 图片、纹理、精灵、形状、文字、视图与绘制 |
|
|
23
|
+
| [Audio](audio.zh-CN.md) | 播放、流式供数、音效、录音与编解码 |
|
|
24
|
+
| [Network](network.zh-CN.md) | Packet、TCP/UDP、DNS、TLS、HTTP、FTP 与 SFTP |
|
|
25
|
+
|
|
26
|
+
## 参与开发
|
|
27
|
+
|
|
28
|
+
[开发指南](development.zh-CN.md) 说明构建、测试、源码组织与现有文档发布流程。
|
|
29
|
+
|
|
30
|
+
方法签名和导出列表以 [src/index.ts](../src/index.ts) 及其源码注释为准。[SFML 3.1.0 官方 C++ 文档](https://www.sfml-dev.org/documentation/3.1.0/) 可用于理解上游概念、类和用法;各模块指南提供对应类的直达链接。JavaScript 的参数、Promise、事件循环、共享内存和网络适配以本项目说明及 TypeDoc 为准。
|
package/docs/api.ja.md
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
# API ナビゲーション
|
|
2
|
+
|
|
3
|
+
[English](api.md) / [简体中文](api.zh-CN.md) / **日本語** / [한국어](api.ko.md)
|
|
4
|
+
|
|
5
|
+
> sfml.js は SFML 3.1.0 を基盤としています。手書きのガイドでは使い方、戻り値、Node.js 向けの適応を説明し、完全なシグネチャと型制約は [TypeDoc](https://sfml.js.org/ja/reference/) がソースコードから生成します。
|
|
6
|
+
|
|
7
|
+
[ドキュメントトップ](README.ja.md) · [クイックスタート](getting-started.ja.md) · [基本概念](concepts.ja.md)
|
|
8
|
+
|
|
9
|
+
公開インターフェースはすべて `sfml.js` からインポートします。エクスポート一覧は [src/index.ts](../src/index.ts) を参照してください。アプリケーションコードから `dist/internal` やネイティブモジュールのハンドルにアクセスする必要はありません。
|
|
10
|
+
|
|
11
|
+
## 目的から選ぶ
|
|
12
|
+
|
|
13
|
+
| 目的 | ドキュメント | 主なインターフェース |
|
|
14
|
+
| --- | --- | --- |
|
|
15
|
+
| 座標、角度、フレーム時間の計算 | [System](system.ja.md) | Vector2/3、Angle、Time、Clock、名前付き演算関数 |
|
|
16
|
+
| 独自のファイルソースの利用 | [入力ストリーム](system.ja.md#input-streams) | InputStream、MemoryInputStream、FileInputStream |
|
|
17
|
+
| ウィンドウの作成と入力の受信 | [Window](window.ja.md) | RenderWindow、Window、Event、Keyboard、Mouse |
|
|
18
|
+
| 画像とアニメーションの表示 | [Graphics](graphics.ja.md) | Image、Texture、Sprite |
|
|
19
|
+
| 図形とテキストの描画 | [Graphics](graphics.ja.md) | Shape、Font、Glyph、Text |
|
|
20
|
+
| カメラ、オフスクリーン合成、大量のジオメトリ | [Graphics](graphics.ja.md) | View、RenderTexture、VertexArray、VertexBuffer |
|
|
21
|
+
| カスタム描画とシェーダー | [Graphics](graphics.ja.md) | Drawable、RenderStates、Shader、Glsl |
|
|
22
|
+
| 再生、録音、音声処理 | [Audio](audio.ja.md) | SoundBuffer、Sound、Music、SoundStream、SoundRecorder |
|
|
23
|
+
| ネットワーク通信とファイル転送 | [Network](network.ja.md) | Packet、TcpSocket、UdpSocket、Http、Ftp、Sftp |
|
|
24
|
+
|
|
25
|
+
## System
|
|
26
|
+
|
|
27
|
+
`Vector2`/`Vector3` は複数のスカラー型に対応し、`Vector2i/u/f` と `Vector3i/u/f` がよく使われる特殊化です。`degrees()`/`radians()` で Angle を、時間のファクトリー関数で Time を作成します。
|
|
28
|
+
|
|
29
|
+
JavaScript には C++ の演算子オーバーロードがないため、対応する操作には `add()`、`multiply()`、`equal()`、`*Assign()` を使います。`Clock`、非同期の `sleep()`、`TimeoutWithPredicate`、入力ストリーム、`Unicode`、エラーログのインターフェースもこのモジュールに含まれます。
|
|
30
|
+
|
|
31
|
+
詳細は [System](system.ja.md) を参照してください。
|
|
32
|
+
|
|
33
|
+
## Window
|
|
34
|
+
|
|
35
|
+
`Window` は OS のウィンドウと OpenGL コンテキストを提供します。2D 描画には通常、Window と RenderTarget の両方の機能を持つ `RenderWindow` を使います。
|
|
36
|
+
|
|
37
|
+
イベントは `pollEvent()`、`handleEvents()`、同期の `waitEvent()` で取得できます。キーボード、マウス、ジョイスティック、センサーにはリアルタイムの状態照会もあります。`Clipboard`、`Cursor`、`Context`、`Vulkan` はシステムとの連携を担います。
|
|
38
|
+
|
|
39
|
+
詳細は [Window](window.ja.md) を参照してください。
|
|
40
|
+
|
|
41
|
+
## Graphics
|
|
42
|
+
|
|
43
|
+
Image は CPU 側のピクセル、Texture は GPU テクスチャを保持し、Sprite はテクスチャを参照して描画します。Shape は円、矩形、凸多角形、独自の凸形状を提供します。Font と Text はフォントの読み込み、レイアウト、編集可能な頂点を提供します。
|
|
44
|
+
|
|
45
|
+
RenderTarget はウィンドウとオフスクリーンターゲットの描画インターフェースを統一します。View はカメラとビューポートを、RenderStates は変換、ブレンド、ステンシル、テクスチャ、Shader を制御します。頂点配列と GPU 頂点バッファを使えば、ジオメトリを直接構成できます。
|
|
46
|
+
|
|
47
|
+
詳細は [Graphics](graphics.ja.md) と[描画スナップショット](concepts.ja.md#draw-snapshots)を参照してください。
|
|
48
|
+
|
|
49
|
+
## Audio
|
|
50
|
+
|
|
51
|
+
短い効果音には SoundBuffer + Sound、長い音声には Music を使います。SoundSource は音量、パン、空間オーディオのプロパティを提供します。SoundStream、SoundRecorder、EffectProcessor は Worker コールバックで独自のデータを処理します。
|
|
52
|
+
|
|
53
|
+
詳細は [Audio](audio.ja.md) を参照し、特にサンプル数、チャンネルの並び、バッファの有効期間に注意してください。
|
|
54
|
+
|
|
55
|
+
## Network
|
|
56
|
+
|
|
57
|
+
Network は Node.js のトランスポートで SFML スタイルの API を実装しており、本番コードは SFML C++ Network を呼び出しません。Packet は SFML のエンコード規約を維持し、TCP、UDP、DNS、TLS、HTTP、FTP、SFTP の I/O には Promise を使います。
|
|
58
|
+
|
|
59
|
+
ステータスの戻り値、部分送信、プロトコルの制約、終了方法を含む詳細は [Network](network.ja.md) を参照してください。
|
|
60
|
+
|
|
61
|
+
## 互換性の範囲
|
|
62
|
+
|
|
63
|
+
| 項目 | 現在の挙動 |
|
|
64
|
+
| --- | --- |
|
|
65
|
+
| C++ のポインター、参照による出力引数 | オブジェクト、ビュー、戻り値のオブジェクトで表現 |
|
|
66
|
+
| C++ のテンプレートと演算子 | 明示的なスカラータグ、クラス、名前付き関数で表現 |
|
|
67
|
+
| ファイル読み込み | Promise を使用し、個別の失敗ステータスは各インターフェースに従う |
|
|
68
|
+
| デストラクター | ネイティブ側の所有権と JS 参照を組み合わせる。終了用インターフェースを持つリソースは明示的に閉じる |
|
|
69
|
+
| `drawAsync()`/`displayAsync()` | 未提供。旧サンプルは未対応であることを明示的に報告 |
|
|
70
|
+
| Android SuspendAwareClock | 条件付きコンパイルのインターフェースあり。現在のダウンロードフローはデスクトップ向け |
|
|
71
|
+
| Vulkan | 照会インターフェースをエクスポート済み。利用可否は SFML のプラットフォームバックエンドに依存し、macOS バックエンドでは利用不可 |
|
|
72
|
+
|
|
73
|
+
プラットフォームごとのビルドとテストの範囲は[開発ガイド](development.ja.md#testing)を参照してください。
|
|
74
|
+
|
|
75
|
+
<a id="sfml-cpp-reference"></a>
|
|
76
|
+
## SFML C++ リファレンス
|
|
77
|
+
|
|
78
|
+
[SFML 3.1.0 公式リファレンス](https://www.sfml-dev.org/documentation/3.1.0/)は C++ 側の概念を確認するための資料です。JavaScript のシグネチャは [TypeDoc](https://sfml.js.org/ja/reference/) を基準とし、バインディング固有の挙動は各モジュールのガイドに従ってください。
|
|
79
|
+
|
|
80
|
+
- [System の C++ リファレンス](system.ja.md#sfml-cpp-reference)
|
|
81
|
+
- [Window の C++ リファレンス](window.ja.md#sfml-cpp-reference)
|
|
82
|
+
- [Graphics の C++ リファレンス](graphics.ja.md#sfml-cpp-reference)
|
|
83
|
+
- [Audio の C++ リファレンス](audio.ja.md#sfml-cpp-reference)
|
|
84
|
+
- [Network の C++ リファレンス](network.ja.md#sfml-cpp-reference)
|