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,156 @@
|
|
|
1
|
+
# 快速开始
|
|
2
|
+
|
|
3
|
+
[English](getting-started.md) · **简体中文** · [日本語](getting-started.ja.md) · [한국어](getting-started.ko.md)
|
|
4
|
+
|
|
5
|
+
> 目标:安装 sfml.js,运行一个能响应关闭事件的原生窗口。本文使用当前 SFML 3.1.0 API。
|
|
6
|
+
|
|
7
|
+
[文档首页](README.zh-CN.md) · [核心概念](concepts.zh-CN.md) · [示例](../examples/README.zh-CN.md)
|
|
8
|
+
|
|
9
|
+
<a id="requirements"></a>
|
|
10
|
+
|
|
11
|
+
## 安装环境
|
|
12
|
+
|
|
13
|
+
sfml.js 是 Node.js 原生扩展。安装时下载当前平台的 SFML 动态库,并在本机编译绑定;需要 Python 和 C++20 工具链。
|
|
14
|
+
|
|
15
|
+
包声明的 Node.js 范围是 `^18.19.0 || >=20.5.0`,现有 CI 配置使用 Node.js 20、22。初次配置可使用 Node.js 22。
|
|
16
|
+
|
|
17
|
+
### macOS
|
|
18
|
+
|
|
19
|
+
支持 macOS 13+ 的 x64、arm64 下载目标。安装 Xcode Command Line Tools,并确认 Python 可用:
|
|
20
|
+
|
|
21
|
+
```sh
|
|
22
|
+
xcode-select --install
|
|
23
|
+
python3 --version
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Node.js 的架构决定下载的 SFML 架构,可通过 `node -p process.arch` 查看。
|
|
27
|
+
|
|
28
|
+
### Linux
|
|
29
|
+
|
|
30
|
+
当前自动下载支持 x64。Ubuntu/Debian 可按仓库 CI 安装依赖:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
sudo apt-get update
|
|
34
|
+
sudo apt-get install -y \
|
|
35
|
+
build-essential python3 \
|
|
36
|
+
libgl1-mesa-dev libx11-dev libxrandr-dev libxcursor-dev libxi-dev \
|
|
37
|
+
libudev-dev libfreetype-dev libflac-dev libvorbis-dev \
|
|
38
|
+
libopenal-dev libmbedtls-dev
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
无显示器的 CI 还需要 `xvfb` 和 `xauth`,运行方法见 [开发指南](development.zh-CN.md#testing)。其他发行版使用对应的开发包。
|
|
42
|
+
|
|
43
|
+
### Windows
|
|
44
|
+
|
|
45
|
+
安装 Python 和 Visual Studio 2022 Build Tools,选择「使用 C++ 的桌面开发」及 Windows SDK。当前下载目标为 x64、ia32,编译工具链须与 Node.js 架构一致。
|
|
46
|
+
|
|
47
|
+
## 安装软件包
|
|
48
|
+
|
|
49
|
+
在应用目录执行:
|
|
50
|
+
|
|
51
|
+
```sh
|
|
52
|
+
npm install sfml.js
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
TypeScript 类型声明已包含在包内。npm 默认安装 `latest` 标签;可用以下命令查看已安装版本和发布标签:
|
|
56
|
+
|
|
57
|
+
```sh
|
|
58
|
+
npm ls sfml.js
|
|
59
|
+
npm view sfml.js dist-tags
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
如果需要直接体验当前仓库,按 [开发指南](development.zh-CN.md#get-the-source) 执行 `npm ci` 后运行仓库示例。
|
|
63
|
+
|
|
64
|
+
安装文件保存在依赖包的 `third_party/sfml/`,原生模块在 `build/Release/sfml.node`。下载需要访问 SFML 的 GitHub Release;版本和架构匹配时复用缓存。
|
|
65
|
+
|
|
66
|
+
`SFML_DOWNLOAD_MIRROR` 可指定下载代理前缀。最终 URL 为 `<前缀>/<完整 GitHub URL>`,所用代理必须支持这种格式,配置见 [下载地址实现](../tools/lib_downloader_urls.cjs)。
|
|
67
|
+
|
|
68
|
+
## 打开第一个窗口
|
|
69
|
+
|
|
70
|
+
新建 `hello.cjs`:
|
|
71
|
+
|
|
72
|
+
```javascript
|
|
73
|
+
const sf = require('sfml.js');
|
|
74
|
+
|
|
75
|
+
const window = new sf.RenderWindow(
|
|
76
|
+
new sf.VideoMode(new sf.Vector2u(800, 600)),
|
|
77
|
+
'Hello, sfml.js',
|
|
78
|
+
);
|
|
79
|
+
const circle = new sf.CircleShape({ radius: 80 });
|
|
80
|
+
circle.setPosition(new sf.Vector2f(320, 220));
|
|
81
|
+
circle.setFillColor(new sf.Color(76, 190, 110));
|
|
82
|
+
window.setFramerateLimit(60);
|
|
83
|
+
|
|
84
|
+
function frame() {
|
|
85
|
+
window.handleEvents({
|
|
86
|
+
Closed: () => window.close(),
|
|
87
|
+
KeyPressed: event => {
|
|
88
|
+
if (event.code === sf.Keyboard.Key.Escape) window.close();
|
|
89
|
+
},
|
|
90
|
+
});
|
|
91
|
+
if (!window.isOpen()) return;
|
|
92
|
+
|
|
93
|
+
window.clear(new sf.Color(24, 28, 32));
|
|
94
|
+
window.draw(circle);
|
|
95
|
+
window.display();
|
|
96
|
+
setImmediate(frame);
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
frame();
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
执行 `node hello.cjs`,窗口显示绿色圆形。按 Esc 或点击关闭按钮退出。
|
|
103
|
+
|
|
104
|
+
每帧先处理事件,再更新场景、清屏、绘制、呈现。`setImmediate(frame)` 在下一轮事件循环继续绘制,让文件、网络和 Worker 消息有机会运行。`display()` 是同步接口,帧率限制和垂直同步可能使它等待;它没有 `displayAsync()` 对应方法。
|
|
105
|
+
|
|
106
|
+
## 使用 TypeScript
|
|
107
|
+
|
|
108
|
+
从包入口导入公开类型:
|
|
109
|
+
|
|
110
|
+
```typescript
|
|
111
|
+
import { RenderWindow, Vector2u } from 'sfml.js';
|
|
112
|
+
|
|
113
|
+
const window = new RenderWindow(new Vector2u(800, 600), 'TypeScript');
|
|
114
|
+
window.close();
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
微秒时间与部分网络整数使用 `bigint`,应用的 TypeScript `target` 至少为 `ES2020`。在 CommonJS 应用中使用 `require('sfml.js')`,无需单独安装类型包。
|
|
118
|
+
|
|
119
|
+
## 加载图片
|
|
120
|
+
|
|
121
|
+
先创建资源,等待加载成功,再创建使用它的对象:
|
|
122
|
+
|
|
123
|
+
```javascript
|
|
124
|
+
const sf = require('sfml.js');
|
|
125
|
+
|
|
126
|
+
async function loadSprite(filename) {
|
|
127
|
+
const texture = new sf.Texture();
|
|
128
|
+
if (!await texture.loadFromFile(filename)) {
|
|
129
|
+
throw new Error(`Cannot load texture: ${filename}`);
|
|
130
|
+
}
|
|
131
|
+
return new sf.Sprite(texture);
|
|
132
|
+
}
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
将返回的 Sprite 放入窗口的 `draw()` 调用。相对文件路径按调用时的工作目录解析。
|
|
136
|
+
|
|
137
|
+
普通文件不存在或解码失败通常返回 `false`;类型错误、范围错误和运行异常通过抛错或 Promise rejection 报告。不能只捕获异常而忽略加载返回值。
|
|
138
|
+
|
|
139
|
+
## 常见问题
|
|
140
|
+
|
|
141
|
+
| 现象 | 检查项 |
|
|
142
|
+
| --- | --- |
|
|
143
|
+
| 找不到 `sfml.node` | 安装脚本是否被禁用;确认工具链后在应用中执行 `npm rebuild sfml.js` |
|
|
144
|
+
| `Unsupported SFML platform` | 对照支持的系统与 `process.arch`;当前没有 Linux arm64 自动下载包 |
|
|
145
|
+
| 无法创建窗口或 OpenGL 上下文 | 是否有图形会话及 OpenGL 驱动;Linux CI 使用 Xvfb |
|
|
146
|
+
| 窗口无响应、异步任务不完成 | 帧循环是否通过 `setImmediate` 等方式让出事件循环 |
|
|
147
|
+
| `await load...()` 没抛错但没有画面 | 检查布尔返回值、文件路径、Sprite 位置和纹理矩形 |
|
|
148
|
+
| 文本不显示中文 | 使用覆盖目标字符的字体,通过 `Font.openFromFile()` 加载 |
|
|
149
|
+
|
|
150
|
+
接下来阅读 [核心概念](concepts.zh-CN.md),或直接运行 [完整示例](../examples/README.zh-CN.md)。
|
|
151
|
+
|
|
152
|
+
<a id="sfml-cpp-reference"></a>
|
|
153
|
+
|
|
154
|
+
## SFML C++ 参考
|
|
155
|
+
|
|
156
|
+
[SFML 3.1.0 官方首页](https://www.sfml-dev.org/documentation/3.1.0/) 提供对应的 C++ 窗口、精灵、文字和音乐示例,可用于理解整体流程。C++ 的文件构造函数和阻塞循环不能原样搬到 JS:本绑定使用 Promise 加载资源,并通过 `setImmediate()` 在帧间让出事件循环。
|
|
@@ -0,0 +1,256 @@
|
|
|
1
|
+
# Graphics
|
|
2
|
+
|
|
3
|
+
[English](graphics.md) / [简体中文](graphics.zh-CN.md) / **日本語** / [한국어](graphics.ko.md)
|
|
4
|
+
|
|
5
|
+
> Image/Texture で素材を用意し、Sprite、Shape、Text、頂点でシーンを構成して、RenderWindow または RenderTexture に描画を渡します。
|
|
6
|
+
|
|
7
|
+
[API ナビゲーション](api.ja.md) · [ウィンドウとイベント](window.ja.md) · [描画スナップショット](concepts.ja.md#draw-snapshots)
|
|
8
|
+
|
|
9
|
+
## Image:CPU 側のピクセル
|
|
10
|
+
|
|
11
|
+
Image は RGBA8 のピクセルを保持します。`.pixels` はネイティブのメモリ割り当てに直接マッピングされた Uint8Array です。
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
import { Image, Color, Vector2u } from 'sfml.js';
|
|
15
|
+
|
|
16
|
+
const image = new Image(new Vector2u(64, 64), Color.White);
|
|
17
|
+
image.setPixel(new Vector2u(0, 0), Color.Red);
|
|
18
|
+
image.pixels[3] = 128;
|
|
19
|
+
if (!await image.saveToFile('image.png')) throw new Error('Cannot save image');
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
| インターフェース | 挙動 |
|
|
23
|
+
| --- | --- |
|
|
24
|
+
| 空のコンストラクター、サイズと色、サイズと RGBA バイト列、コピーコンストラクター | 独立したピクセルリソースを作成 |
|
|
25
|
+
| `loadFromFile/Memory/Stream()` | 非同期で読み込み、boolean を返す |
|
|
26
|
+
| `saveToFile()`/`saveToMemory(format)` | 非同期でエンコード。boolean/バイト列または undefined を返す |
|
|
27
|
+
| `getSize()`、`getPixel()`、`setPixel()` | サイズと単一ピクセルの操作 |
|
|
28
|
+
| `pixels`/`getPixelsPtr()` | 書き込み可能なビュー/型上の読み取り専用ビュー。後者は空の画像では undefined |
|
|
29
|
+
| `resize(size, color?)` | 再割り当てして塗りつぶす。サイズが同じでも以前の内容は保持しない |
|
|
30
|
+
| `copy()`、`createMaskFromColor()`、`flipHorizontally()`、`flipVertically()` | 領域のコピー、マスク、反転 |
|
|
31
|
+
|
|
32
|
+
生の RGBA 入力の長さは幅 × 高さ × 4 でなければならず、構築時にコピーされます。再読み込みや resize が成功した後も、古いビューは古いメモリ割り当てを維持します。読み込みに失敗した場合は現在の画像を保持します。ピクセルの buffer を切り離したりリサイズしたりしないでください。
|
|
33
|
+
|
|
34
|
+
非同期のメモリ読み込みでは呼び出し時にエンコード済み入力をコピーし、非同期の保存では呼び出し時点のピクセルをコピーします。読み取り、デコード、エンコードはバックグラウンドで実行しますが、スナップショットの作成にはメインスレッドのコストがかかります。入力ストリームの使用規則は [System](system.ja.md#input-streams) を参照してください。
|
|
35
|
+
|
|
36
|
+
## Texture:GPU テクスチャ
|
|
37
|
+
|
|
38
|
+
```typescript
|
|
39
|
+
import { Texture, Sprite } from 'sfml.js';
|
|
40
|
+
|
|
41
|
+
const texture = new Texture();
|
|
42
|
+
if (!await texture.loadFromFile('sprite.png')) {
|
|
43
|
+
throw new Error('Cannot load sprite.png');
|
|
44
|
+
}
|
|
45
|
+
texture.setSmooth(true);
|
|
46
|
+
const sprite = new Sprite(texture);
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
空のコンストラクターは非同期読み込みに適しています。`new Texture(size)` は GPU ストレージを割り当て、`new Texture(image)` はデコード済みの画像をアップロードし、`new Texture(sourceTexture)` は GPU 上の内容をコピーします。後者 2 つはファイルを読み取りません。
|
|
50
|
+
|
|
51
|
+
| インターフェース | 挙動 |
|
|
52
|
+
| --- | --- |
|
|
53
|
+
| `loadFromFile/Memory/Stream(source, sRgb?, area?)` | 非同期でデコードし、呼び出し元スレッドでアップロード。area は IntRect |
|
|
54
|
+
| `loadFromImage(image, sRgb?, area?)` | 同期的にアップロードし、boolean を返す |
|
|
55
|
+
| `update(pixels)`/`update(pixels, size, dest)` | RGBA 全体/一部をアップロード |
|
|
56
|
+
| `update(imageOrTextureOrWindow, dest?)` | 入力元の内容をコピー |
|
|
57
|
+
| `resize(size, sRgb?)` | ストレージを再構築。成功後のピクセルは未定義 |
|
|
58
|
+
| `copyToImage()` | GPU から同期的に読み戻し、独立した Image を取得 |
|
|
59
|
+
| `assign(source)`/`swap(other)` | 独立したコピー/内容の交換。対象オブジェクトの同一性は維持 |
|
|
60
|
+
| `setSmooth()`/`setRepeated()` | 平滑化/繰り返しサンプリング |
|
|
61
|
+
| `generateMipmap()` | mipmap を生成。内容を更新した後は再生成が必要 |
|
|
62
|
+
| `getNativeHandle()`/`Texture.bind()` | OpenGL 名/現在のコンテキストへのバインド |
|
|
63
|
+
| `Texture.getMaximumSize()` | 現在のデバイスの最大テクスチャ辺長 |
|
|
64
|
+
|
|
65
|
+
読み込みに失敗した場合は以前の内容を保持します。複数の読み込みは完了順に反映されるため、順序を確定したい場合は 1 件ずつ await してください。GPU へのアップロードと読み戻しは同期操作であり、大きなテクスチャは呼び出し元スレッドを占有します。
|
|
66
|
+
|
|
67
|
+
部分 update は拡大縮小やクリッピングを行わず、転送先の領域が範囲外なら例外を投げます。読み込み時の切り出し矩形は、いずれかのサイズがゼロなら画像全体を使います。それ以外の空でない領域は画像の範囲に調整され、不正な負のサイズや範囲外の始点は拒否されます。
|
|
68
|
+
|
|
69
|
+
テクスチャのサイズが変わっても、Sprite のテクスチャ矩形は自動的に変わりません。画像全体を使う場合は `sprite.setTexture(texture, true)` を呼んでください。テクスチャの内容やサンプリング設定を変更する前に、バインディングは古い状態に依存する描画を送信します。
|
|
70
|
+
|
|
71
|
+
## Sprite と変換
|
|
72
|
+
|
|
73
|
+
Sprite は Texture または別の Sprite から構築する必要があります。Sprite をコピーすると外観と変換をコピーし、同じテクスチャを参照します。
|
|
74
|
+
|
|
75
|
+
| インターフェース | セマンティクス |
|
|
76
|
+
| --- | --- |
|
|
77
|
+
| `setPosition()`/`move()` | 位置と相対移動。Vector2f |
|
|
78
|
+
| `setRotation()`/`rotate()` | 角度と相対回転。Angle |
|
|
79
|
+
| `setScale()`/`scale()`、`setOrigin()` | スケールと原点。Vector2f |
|
|
80
|
+
| `getTransform()`/`getInverseTransform()` | キャッシュされた読み取り専用行列。照会時に更新 |
|
|
81
|
+
| `setTexture(texture, resetRect?)` | テクスチャを切り替える。既定ではテクスチャ矩形を保持 |
|
|
82
|
+
| `setTextureRect(rect)` | 矩形をコピー。負のサイズで反転可能 |
|
|
83
|
+
| `setColor(color)` | 色と alpha の変調 |
|
|
84
|
+
| `getLocalBounds()`/`getGlobalBounds()` | ローカル/自身の変換適用後の軸平行境界 |
|
|
85
|
+
|
|
86
|
+
変換の getter が返す位置、スケール、原点、角度は独立した値です。変更後は setter で書き戻す必要があります。一方、`getTextureRect()` は読み取り専用のライブビューを返し、後続の setter によってその内容が更新されます。
|
|
87
|
+
|
|
88
|
+
global bounds には、draw に渡した外側の RenderStates は含まれません。Shape と Text も同じ変換インターフェースを提供します。
|
|
89
|
+
|
|
90
|
+
## Shape
|
|
91
|
+
|
|
92
|
+
```typescript
|
|
93
|
+
import { CircleShape, RectangleShape, Vector2f, Color } from 'sfml.js';
|
|
94
|
+
|
|
95
|
+
const circle = new CircleShape({ radius: 24, pointCount: 48 });
|
|
96
|
+
circle.setFillColor(Color.Cyan);
|
|
97
|
+
circle.setOutlineColor(Color.White);
|
|
98
|
+
circle.setOutlineThickness(2);
|
|
99
|
+
const rectangle = new RectangleShape(new Vector2f(120, 40));
|
|
100
|
+
rectangle.setPosition(new Vector2f(60, 20));
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
ConvexShape は点の数を受け取り、その後 `setPoint()` で凸多角形の頂点を設定します。3 種類の形状はいずれも同じクラスからのコピー構築、テクスチャ、塗りつぶし、輪郭、境界の照会に対応しています。
|
|
104
|
+
|
|
105
|
+
独自の形状は Shape を継承し、`getPointCount()` と `getPoint()` を実装します。点の集合を変更した後は protected の `update()` を呼びます。点の集合は凸形状の要件を満たす必要があります。update がジオメトリを生成し、描画の送信時に JS の点取得メソッドが再度呼ばれることはありません。
|
|
106
|
+
|
|
107
|
+
輪郭の太さは負の値にもできます。miter limit の既定値は 10、最小値は 1 です。ジオメトリ、輪郭の太さ、miter limit を変更する前に、古いジオメトリを参照するコマンドを送信します。
|
|
108
|
+
|
|
109
|
+
## Font、Glyph、Text
|
|
110
|
+
|
|
111
|
+
```typescript
|
|
112
|
+
import { Font, Text, TextStyle, LineAlignment, Color, Vector2f } from 'sfml.js';
|
|
113
|
+
|
|
114
|
+
const font = new Font();
|
|
115
|
+
if (!await font.openFromFile('font.ttf')) throw new Error('Cannot open font');
|
|
116
|
+
const text = new Text({ font, string: 'Hello\nSFML', characterSize: 30 });
|
|
117
|
+
text.setPosition(new Vector2f(20, 30));
|
|
118
|
+
text.setStyle(TextStyle.Bold);
|
|
119
|
+
text.setLineAlignment(LineAlignment.Center);
|
|
120
|
+
text.setFillColor(Color.White);
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
Font の読み込みメソッドは `openFromFile/Memory/Stream()` であり、loadFromFile ではありません。読み込みに失敗した場合は以前のフォントを保持します。メモリ入力はネイティブ側が保持します。ファイルから読み込む場合は、フォントの使用中も元のファイルを利用できる状態にしてください。
|
|
124
|
+
|
|
125
|
+
Font はグリフ、カーニング、行間、アセンダー、ディセンダー、下線のメトリクスを提供します。`getGlyph()` は Unicode コードポイント、`getGlyphById()` はフォント内部の ID で照会します。`getTexture(size)` はグリフの追加に伴って拡大する読み取り専用のアトラスを返します。
|
|
126
|
+
|
|
127
|
+
Text はフォント、文字列、文字サイズ、間隔、塗りつぶし、輪郭、スタイル、行揃え、書記素のグループ化、文字方向の設定に対応しています。`getShapedGlyphs()` はグリフ一覧を返し、`setGlyphPreProcessor()` ではグリフごとに外観を調整できます。
|
|
128
|
+
|
|
129
|
+
`getShapedGlyphs()` と前処理コールバックの cluster は JS の UTF-16 インデックスを使います。たとえば `A😀中` では 0、1、3 です。非推奨の `findCharacterPos()` は Unicode コードポイントのインデックスを使います。前処理コールバック内で、現在の Text のレイアウトプロパティを再び変更したり、ジオメトリを照会したりすることはできません。
|
|
130
|
+
|
|
131
|
+
`getVertexData()` と `getOutlineVertexData()` は編集可能な頂点を提供します。変更は後続の draw に影響し、再レイアウトすると新しいジオメトリが生成されます。古いビューは元のメモリ割り当てを維持します。各 draw は頂点のスナップショットを保存します。
|
|
132
|
+
|
|
133
|
+
## View と座標
|
|
134
|
+
|
|
135
|
+
View は中心、サイズ、回転、viewport、scissor を制御します。
|
|
136
|
+
|
|
137
|
+
```typescript
|
|
138
|
+
import { RenderTexture, View, Vector2u, Vector2f } from 'sfml.js';
|
|
139
|
+
|
|
140
|
+
const target = new RenderTexture(new Vector2u(800, 600));
|
|
141
|
+
const camera = new View(target.getDefaultView());
|
|
142
|
+
camera.move(new Vector2f(100, 0));
|
|
143
|
+
camera.zoom(0.5);
|
|
144
|
+
target.setView(camera);
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
setView は値をコピーします。`getView()` と `getDefaultView()` は安定した読み取り専用参照を返すため、変更したい場合は View にコピーしてください。
|
|
148
|
+
|
|
149
|
+
`mapPixelToCoords(Vector2i, view?)` はピクセル座標をワールド座標に変換し、`mapCoordsToPixel(Vector2f, view?)` は逆変換します。view を省略した場合は現在のビューを使います。
|
|
150
|
+
|
|
151
|
+
viewport と scissor は、ターゲット全体に対する正規化された矩形を使います。scissor は `[0, 1]` の範囲内である必要があり、draw、clear、clearStencil のすべてに影響します。
|
|
152
|
+
|
|
153
|
+
## RenderTexture とオフスクリーン合成
|
|
154
|
+
|
|
155
|
+
```typescript
|
|
156
|
+
import { RenderTexture, Vector2u, Sprite, Color } from 'sfml.js';
|
|
157
|
+
|
|
158
|
+
const source = new RenderTexture(new Vector2u(64, 64));
|
|
159
|
+
source.clear(Color.Red);
|
|
160
|
+
source.display();
|
|
161
|
+
|
|
162
|
+
const output = new RenderTexture(new Vector2u(128, 128));
|
|
163
|
+
output.clear();
|
|
164
|
+
output.draw(new Sprite(source.getTexture()));
|
|
165
|
+
output.display();
|
|
166
|
+
await output.getTexture().copyToImage().saveToFile('offscreen.png');
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
`getTexture()` は安定した読み取り専用の GPU テクスチャビューを返します。ピクセルをコピーせず、暗黙に display を呼ぶこともありません。`flush()` は描画を送信するだけなので、新しい内容をサンプリングする前には display が必要です。同じターゲット内で自身のテクスチャを直接サンプリングすることはできません。
|
|
170
|
+
|
|
171
|
+
`resize(size, settings?)` が成功すると、現在のビューと既定のビューがリセットされ、ピクセルの内容は未定義になります。失敗時は元のターゲットを保持します。既存のテクスチャビューは引き続き有効ですが、関連する Sprite のテクスチャ矩形は必要に応じて再設定してください。
|
|
172
|
+
|
|
173
|
+
ContextSettings は depthBits、stencilBits、antiAliasingLevel、majorVersion、minorVersion、attributeFlags、sRgbCapable に対応します。実際の機能はドライバーに依存し、SFML Graphics には互換性のある OpenGL コンテキストが必要です。
|
|
174
|
+
|
|
175
|
+
## Drawable と RenderStates
|
|
176
|
+
|
|
177
|
+
独自の複合オブジェクトは Drawable を継承し、同期的な protected draw を実装します。呼び出しごとに独立した RenderStates の値コピーを受け取りますが、リソースの参照は共有されます。
|
|
178
|
+
|
|
179
|
+
```typescript
|
|
180
|
+
import { Drawable, RenderTarget, RenderStates, Transformable } from 'sfml.js';
|
|
181
|
+
|
|
182
|
+
class Group extends Drawable {
|
|
183
|
+
/** 複合オブジェクトのローカル変換。 */
|
|
184
|
+
readonly pose = new Transformable();
|
|
185
|
+
|
|
186
|
+
/** 順番に描画する子オブジェクトを保持する。 */
|
|
187
|
+
constructor(readonly children: Drawable[]) { super(); }
|
|
188
|
+
|
|
189
|
+
/** ローカル変換を親の状態に合成してから各子オブジェクトを描画する。 */
|
|
190
|
+
protected draw(target: RenderTarget, states: RenderStates): void {
|
|
191
|
+
states.transform.combine(this.pose.getTransform());
|
|
192
|
+
for (const child of this.children) target.draw(child, states);
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
| RenderStates のフィールド | 既定値 |
|
|
198
|
+
| --- | --- |
|
|
199
|
+
| transform | 恒等変換 |
|
|
200
|
+
| blendMode | BlendAlpha |
|
|
201
|
+
| stencilMode | 既定の StencilMode |
|
|
202
|
+
| coordinateType | CoordinateType.Pixels |
|
|
203
|
+
| texture/shader | null |
|
|
204
|
+
|
|
205
|
+
draw は RenderStates、状態オプション、または単独の Transform、Texture、Shader、BlendMode、StencilMode などを受け取ります。Sprite と Shape は自身のテクスチャと座標モードを使います。
|
|
206
|
+
|
|
207
|
+
ステンシルマスクには、ターゲットが stencilBits を提供している必要があります。`clear(color, stencil)` は色とステンシルを同時にクリアし、`clearStencil()` はステンシルだけをクリアします。BlendMode は Alpha、Add、Multiply、Min、Max、None のプリセットを提供します。
|
|
208
|
+
|
|
209
|
+
## 頂点と GPU バッファ
|
|
210
|
+
|
|
211
|
+
```typescript
|
|
212
|
+
import { VertexArray, Vertex, PrimitiveType, Vector2f, Color } from 'sfml.js';
|
|
213
|
+
|
|
214
|
+
const triangle = new VertexArray(PrimitiveType.Triangles, 3);
|
|
215
|
+
triangle.setVertex(0, new Vertex(new Vector2f(10, 10), Color.Red));
|
|
216
|
+
triangle.setVertex(1, new Vertex(new Vector2f(100, 10), Color.Green));
|
|
217
|
+
triangle.setVertex(2, new Vertex(new Vector2f(10, 100), Color.Blue));
|
|
218
|
+
triangle.getVertex(1).position.x = 120;
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
VertexArray は get/setVertex、append、resize、clear、getBounds、反復処理に対応しています。draw は連続した頂点データのスナップショットを即座に保存し、その後の変更や容量拡張が記録済みの画像を変えることはありません。構造を変更した後はメンバーを再取得し、反復処理中には構造を変更しないでください。
|
|
222
|
+
|
|
223
|
+
SFML 3 は Points、Lines、LineStrip、Triangles、TriangleStrip、TriangleFan に対応しています。複数の四角形を三角形として 1 つの VertexArray にまとめることで、実際の SFML draw の呼び出し回数を減らせます。
|
|
224
|
+
|
|
225
|
+
VertexBuffer は頂点を GPU に保存します。先に `create(count)`、次に `update(vertices)` を呼び、両方の真偽値の戻り値を確認してください。Usage は Stream、Dynamic、Static を提供します。範囲を指定した描画には `target.draw(buffer, firstVertex, vertexCount, states?)` を使います。
|
|
226
|
+
|
|
227
|
+
`assign()` は GPU データ、プリミティブ、usage をディープコピーします。`update(sourceBuffer)` はデータをコピーし、転送先のプリミティブと usage は保持します。`swap()` はリソースを交換します。ストレージを変更する前に古い描画を送信します。GL 名は変わる場合があるため、使用前に再取得してください。
|
|
228
|
+
|
|
229
|
+
## Shader、Transform、GLSL
|
|
230
|
+
|
|
231
|
+
Shader は非同期の `loadFromFile/Memory/Stream()` を使い、単一ステージまたは vertex/fragment/geometry の組み合わせに対応しています。再読み込みが成功するとプログラムを置き換えて uniform の状態をクリアし、失敗時は以前のプログラムを保持します。
|
|
232
|
+
|
|
233
|
+
`setUniform()` は number、boolean、Glsl のベクトル/行列、Texture、`Shader.CurrentTexture` を受け取ります。number は既定で float として扱い、整数には第 3 引数の `'int'` を使います。uniform を変更する前に記録済みの描画を送信します。
|
|
234
|
+
|
|
235
|
+
`Glsl.Vec2/3/4`、`Ivec2/3/4`、`Bvec2/3/4` は GLSL のベクトルに対応します。Mat3/Mat4 は配列、同じサイズの行列、Transform から構築し、`.array` は列優先の Float32Array です。4 次元ベクトルと行列には、汎用のベクトル算術演算関数はありません。
|
|
236
|
+
|
|
237
|
+
Transform は平行移動、回転、拡大縮小、combine に対応し、インプレースで変更して自身を返します。合成は右からの乗算であり、`translate(...).scale(...)` は点に対して先に拡大縮小を、次に平行移動を適用します。getMatrix は読み取り専用のライブ配列を返します。特異行列の逆行列を求めると、独立した恒等変換を返します。
|
|
238
|
+
|
|
239
|
+
`Shader.isAvailable()`、`isGeometryAvailable()`、`VertexBuffer.isAvailable()` で機能を照会できます。Texture/Shader/VertexBuffer の bind を直接使う前に、記録済みの SFML コマンドを明示的に送信してください。
|
|
240
|
+
|
|
241
|
+
## サンプルと性能検証
|
|
242
|
+
|
|
243
|
+
[サンプル一覧](../examples/README.ja.md)には、テクスチャ、スプライト、テキスト、頂点、複合描画、オフスクリーン合成の独立した実行入口があります。
|
|
244
|
+
|
|
245
|
+
ビルド後に `tools/benchmark-image.cjs`、`tools/benchmark-drawable.cjs`、`tools/benchmark-vertex-array.cjs` を実行すると、現在の実装を計測できます。ベンチマークにおける呼び出し元スレッドの時間には、記録、送信、ドライバーの処理が含まれます。GPU 時間や実際のゲームのフレームレートと直接同一視することはできません。
|
|
246
|
+
|
|
247
|
+
<a id="sfml-cpp-reference"></a>
|
|
248
|
+
## SFML C++ リファレンス
|
|
249
|
+
|
|
250
|
+
上流の描画概念は、次の SFML 3.1.0 リファレンスを参照してください。
|
|
251
|
+
|
|
252
|
+
- 画像と描画オブジェクト:[Image](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Image.html)、[Texture](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Texture.html)、[Sprite](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Sprite.html)、[Shape](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Shape.html)。
|
|
253
|
+
- テキストとカメラ:[Font](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Font.html)、[Text](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Text.html)、[View](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1View.html)。
|
|
254
|
+
- 描画とジオメトリ:[RenderTexture](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1RenderTexture.html)、[RenderTarget](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1RenderTarget.html)、[Drawable](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Drawable.html)、[Shader](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1Shader.html)、[VertexArray](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1VertexArray.html)、[VertexBuffer](https://www.sfml-dev.org/documentation/3.1.0/classsf_1_1VertexBuffer.html)。
|
|
255
|
+
|
|
256
|
+
C++ リファレンスは描画の仕組みを理解するための資料です。JavaScript のリソース構築と読み込み、draw が記録するスナップショットの挙動は、このガイドと[基本概念](concepts.ja.md#draw-snapshots)に従ってください。
|