sfml.js 1.0.0 → 1.1.0
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/README.ja.md +10 -9
- package/README.ko.md +10 -9
- package/README.md +10 -9
- package/README.zh-CN.md +10 -9
- package/binding.gyp +23 -16
- package/dist/audio/effect-processor.js +9 -3
- package/dist/audio/input-sound-file.js +41 -15
- package/dist/audio/listener.js +33 -11
- package/dist/audio/music.js +41 -18
- package/dist/audio/output-sound-file.js +4 -2
- package/dist/audio/playback-device.js +11 -3
- package/dist/audio/sound-buffer-recorder.js +8 -5
- package/dist/audio/sound-buffer.js +40 -17
- package/dist/audio/sound-file-factory.js +21 -9
- package/dist/audio/sound-file-reader.js +21 -7
- package/dist/audio/sound-recorder.js +36 -15
- package/dist/audio/sound-source.js +117 -40
- package/dist/audio/sound-stream.js +14 -5
- package/dist/audio/sound.js +9 -4
- package/dist/audio/value.js +42 -16
- package/dist/graphics/blend-mode.js +2 -1
- package/dist/graphics/boolean-vector.d.ts +1 -2
- package/dist/graphics/boolean-vector.js +19 -9
- package/dist/graphics/color.js +2 -1
- package/dist/graphics/convex-shape.js +7 -3
- package/dist/graphics/font.js +52 -23
- package/dist/graphics/glsl-matrix.js +8 -3
- package/dist/graphics/glsl.js +47 -16
- package/dist/graphics/glyph.js +27 -10
- package/dist/graphics/image.js +30 -14
- package/dist/graphics/rect.js +15 -8
- package/dist/graphics/render-states.js +18 -9
- package/dist/graphics/render-target.js +49 -23
- package/dist/graphics/render-texture.js +24 -12
- package/dist/graphics/render-window.js +6 -3
- package/dist/graphics/shader.js +67 -32
- package/dist/graphics/shape.js +25 -13
- package/dist/graphics/sprite.js +19 -9
- package/dist/graphics/stencil-mode.js +10 -6
- package/dist/graphics/swap.js +2 -1
- package/dist/graphics/text.js +123 -48
- package/dist/graphics/texture.js +48 -24
- package/dist/graphics/transform.js +29 -13
- package/dist/graphics/transformable.js +2 -1
- package/dist/graphics/vertex-array.js +40 -18
- package/dist/graphics/vertex-buffer.js +39 -19
- package/dist/graphics/vertex.js +6 -3
- package/dist/graphics/view.js +30 -14
- package/dist/index.d.ts +4 -4
- package/dist/internal/audio-codec-registry.js +12 -6
- package/dist/internal/audio-input-stream.js +2 -1
- package/dist/internal/audio-music-pump.js +58 -24
- package/dist/internal/audio-recorder-session.js +17 -7
- package/dist/internal/audio-worker-session.js +28 -10
- package/dist/internal/audio-worker.js +40 -21
- package/dist/internal/glsl-value.d.ts +3 -1
- package/dist/internal/glsl-value.js +18 -8
- package/dist/internal/graphics-state.js +29 -15
- package/dist/internal/input-stream.d.ts +3 -1
- package/dist/internal/input-stream.js +16 -7
- package/dist/internal/numeric-properties.js +2 -1
- package/dist/internal/render-states.js +2 -1
- package/dist/internal/scalar.js +22 -13
- package/dist/internal/shaped-glyph.d.ts +3 -1
- package/dist/internal/shaped-glyph.js +12 -4
- package/dist/internal/struct-view.d.ts +3 -1
- package/dist/internal/struct-view.js +3 -1
- package/dist/internal/transformable.js +2 -1
- package/dist/network/common.js +23 -11
- package/dist/network/dns.js +25 -17
- package/dist/network/ftp.js +43 -18
- package/dist/network/http.js +126 -56
- package/dist/network/ip-address.js +50 -25
- package/dist/network/packet.js +63 -25
- package/dist/network/sftp.js +175 -74
- package/dist/network/socket-selector.js +28 -14
- package/dist/network/socket.js +71 -30
- package/dist/network/tcp-listener.js +42 -19
- package/dist/network/tcp-socket.js +111 -53
- package/dist/network/tls-material.js +2 -1
- package/dist/network/udp-socket.js +68 -33
- package/dist/system/angle.js +2 -1
- package/dist/system/clock.js +4 -2
- package/dist/system/err.js +5 -2
- package/dist/system/file-input-stream.js +8 -4
- package/dist/system/input-stream.js +6 -3
- package/dist/system/operators.d.ts +1 -1
- package/dist/system/operators.js +90 -50
- package/dist/system/sleep.js +4 -2
- package/dist/system/time.js +12 -6
- package/dist/system/vector2.js +6 -7
- package/dist/system/vector3.js +11 -6
- package/dist/window/clipboard.js +2 -1
- package/dist/window/context.js +10 -5
- package/dist/window/cursor.js +2 -1
- package/dist/window/event.js +9 -5
- package/dist/window/mouse.js +4 -2
- package/dist/window/video-mode.js +2 -1
- package/dist/window/window.js +19 -12
- package/native/addon.cc +25 -12
- package/native/audio-binding.cc +266 -126
- package/native/audio-codec-binding.cc +147 -77
- package/native/audio-device-binding.cc +76 -49
- package/native/audio-file-binding.cc +116 -67
- package/native/audio-recorder-binding.cc +147 -98
- package/native/audio-recorder.h +1 -1
- package/native/audio-state.h +53 -30
- package/native/audio-stream-binding.cc +148 -94
- package/native/audio-stream.h +5 -4
- package/native/audio-worker-binding.cc +163 -81
- package/native/audio-worker.h +35 -19
- package/native/batch-drawable.cc +29 -16
- package/native/batch-drawable.h +11 -8
- package/native/context-binding.cc +40 -27
- package/native/context-settings.h +15 -8
- package/native/deferred-delete.cc +9 -6
- package/native/deferred-delete.h +7 -8
- package/native/error-stream-binding.cc +42 -28
- package/native/font-binding.cc +89 -48
- package/native/graphics-binding.cc +122 -72
- package/native/graphics-state.h +50 -36
- package/native/image-binding.cc +38 -24
- package/native/image-state.h +26 -18
- package/native/input-binding.cc +42 -27
- package/native/render-window-binding.cc +38 -23
- package/native/shader-binding.cc +115 -50
- package/native/shape-binding.cc +94 -49
- package/native/shape-state.h +18 -9
- package/native/shaped-glyph-storage.h +9 -5
- package/native/stream-binding.cc +143 -117
- package/native/system-binding.cc +17 -12
- package/native/text-binding.cc +68 -35
- package/native/text-state.h +25 -18
- package/native/texture-binding.cc +42 -33
- package/native/texture-resource.h +20 -12
- package/native/time-value.h +3 -1
- package/native/transformable-binding.cc +12 -6
- package/native/transformable-state.h +6 -6
- package/native/value-binding.h +46 -28
- package/native/value-layout.h +10 -10
- package/native/values-binding.cc +29 -23
- package/native/vertex-binding.cc +18 -12
- package/native/vertex-buffer-binding.cc +38 -24
- package/native/vertex-storage.h +2 -2
- package/native/view-data.h +4 -3
- package/native/window-binding.cc +75 -45
- package/native/window-event.h +20 -11
- package/native/window-owner.h +15 -12
- package/package.json +40 -48
- package/src/audio/effect-processor.ts +9 -3
- package/src/audio/input-sound-file.ts +108 -36
- package/src/audio/listener.ts +39 -13
- package/src/audio/music.ts +112 -47
- package/src/audio/output-sound-file.ts +40 -11
- package/src/audio/playback-device.ts +23 -8
- package/src/audio/sound-buffer-recorder.ts +35 -13
- package/src/audio/sound-buffer.ts +166 -58
- package/src/audio/sound-file-factory.ts +127 -49
- package/src/audio/sound-file-reader.ts +49 -15
- package/src/audio/sound-recorder.ts +100 -34
- package/src/audio/sound-source.ts +142 -45
- package/src/audio/sound-stream.ts +15 -5
- package/src/audio/sound.ts +12 -4
- package/src/audio/value.ts +89 -26
- package/src/graphics/blend-mode.ts +3 -1
- package/src/graphics/boolean-vector.ts +56 -26
- package/src/graphics/color.ts +3 -1
- package/src/graphics/convex-shape.ts +10 -3
- package/src/graphics/font.ts +171 -50
- package/src/graphics/glsl-matrix.ts +9 -3
- package/src/graphics/glsl.ts +81 -35
- package/src/graphics/glyph.ts +67 -26
- package/src/graphics/image.ts +119 -45
- package/src/graphics/rect.ts +56 -24
- package/src/graphics/render-states.ts +31 -14
- package/src/graphics/render-target.ts +197 -81
- package/src/graphics/render-texture.ts +36 -12
- package/src/graphics/render-window.ts +9 -3
- package/src/graphics/shader.ts +186 -61
- package/src/graphics/shape.ts +93 -35
- package/src/graphics/sprite.ts +64 -25
- package/src/graphics/stencil-mode.ts +12 -6
- package/src/graphics/swap.ts +3 -2
- package/src/graphics/text.ts +229 -74
- package/src/graphics/texture.ts +180 -61
- package/src/graphics/transform.ts +132 -47
- package/src/graphics/transformable.ts +3 -1
- package/src/graphics/vertex-array.ts +87 -35
- package/src/graphics/vertex-buffer.ts +97 -33
- package/src/graphics/vertex.ts +9 -3
- package/src/graphics/view.ts +59 -21
- package/src/index.ts +101 -23
- package/src/internal/audio-codec-registry.ts +18 -6
- package/src/internal/audio-input-stream.ts +6 -2
- package/src/internal/audio-music-pump.ts +116 -41
- package/src/internal/audio-native.ts +249 -96
- package/src/internal/audio-recorder-session.ts +68 -24
- package/src/internal/audio-worker-session.ts +65 -21
- package/src/internal/audio-worker.ts +85 -41
- package/src/internal/glsl-value.ts +26 -11
- package/src/internal/graphics-state.ts +57 -20
- package/src/internal/input-stream.ts +23 -10
- package/src/internal/native.ts +252 -99
- package/src/internal/numeric-properties.ts +2 -1
- package/src/internal/render-states.ts +3 -1
- package/src/internal/scalar.ts +33 -14
- package/src/internal/shaped-glyph.ts +25 -12
- package/src/internal/struct-view.ts +40 -13
- package/src/internal/transformable.ts +3 -1
- package/src/network/common.ts +35 -11
- package/src/network/dns.ts +95 -38
- package/src/network/ftp.ts +129 -47
- package/src/network/http.ts +232 -77
- package/src/network/ip-address.ts +118 -48
- package/src/network/packet.ts +161 -54
- package/src/network/sftp.ts +498 -168
- package/src/network/socket-selector.ts +66 -26
- package/src/network/socket.ts +133 -46
- package/src/network/tcp-listener.ts +78 -29
- package/src/network/tcp-socket.ts +240 -95
- package/src/network/tls-material.ts +6 -2
- package/src/network/udp-socket.ts +147 -53
- package/src/system/angle.ts +3 -1
- package/src/system/clock.ts +12 -4
- package/src/system/err.ts +5 -2
- package/src/system/file-input-stream.ts +12 -4
- package/src/system/input-stream.ts +9 -3
- package/src/system/operators.ts +290 -115
- package/src/system/sleep.ts +6 -2
- package/src/system/time.ts +18 -6
- package/src/system/timeout-with-predicate.ts +19 -8
- package/src/system/vector2.ts +101 -49
- package/src/system/vector3.ts +85 -36
- package/src/window/clipboard.ts +3 -1
- package/src/window/context.ts +15 -5
- package/src/window/cursor.ts +3 -1
- package/src/window/event.ts +26 -12
- package/src/window/mouse.ts +6 -2
- package/src/window/video-mode.ts +3 -1
- package/src/window/window.ts +119 -37
- package/test/native/audio-probes.cc +74 -36
- package/test/native/deferred-delete-probes.cc +17 -11
- package/test/native/drawable-probes.cc +70 -36
- package/test/native/exception-probes.cc +14 -9
- package/test/native/image-probes.cc +20 -10
- package/test/native/matrix-probes.cc +8 -4
- package/test/native/network-oracle.cc +17 -11
- package/test/native/render-texture-probes.cc +33 -24
- package/test/native/shader-probes.cc +9 -9
- package/test/native/shape-probes.cc +37 -23
- package/test/native/sprite-probes.cc +41 -25
- package/test/native/system-probes.cc +58 -35
- package/test/native/text-probes.cc +77 -44
- package/test/native/texture-probes.cc +43 -26
- package/test/native/time-probes.cc +18 -12
- package/test/native/transform-probes.cc +15 -10
- package/test/native/transformable-probes.cc +23 -17
- package/test/native/value-oracle.h +9 -4
- package/test/native/value-probes.cc +31 -23
- package/test/native/vertex-array-probes.cc +22 -14
- package/test/native/vertex-buffer-probes.cc +28 -17
- package/test/native/view-probes.cc +29 -17
- package/test/native/window-probes.cc +66 -33
- package/tools/ensure-sfml.cjs +9 -0
- package/tools/generate-network-constants.cjs +11 -6
- package/tools/generate-window-constants.cjs +31 -12
- package/docs/README.ja.md +0 -30
- package/docs/README.ko.md +0 -30
- package/docs/README.md +0 -30
- package/docs/README.zh-CN.md +0 -30
- package/docs/api.ja.md +0 -84
- package/docs/api.ko.md +0 -84
- package/docs/api.md +0 -81
- package/docs/api.zh-CN.md +0 -81
- package/docs/audio.ja.md +0 -249
- package/docs/audio.ko.md +0 -251
- package/docs/audio.md +0 -252
- package/docs/audio.zh-CN.md +0 -252
- package/docs/concepts.ja.md +0 -130
- package/docs/concepts.ko.md +0 -130
- package/docs/concepts.md +0 -131
- package/docs/concepts.zh-CN.md +0 -131
- package/docs/development.ja.md +0 -144
- package/docs/development.ko.md +0 -144
- package/docs/development.md +0 -146
- package/docs/development.zh-CN.md +0 -146
- package/docs/getting-started.ja.md +0 -154
- package/docs/getting-started.ko.md +0 -154
- package/docs/getting-started.md +0 -156
- package/docs/getting-started.zh-CN.md +0 -156
- package/docs/graphics.ja.md +0 -256
- package/docs/graphics.ko.md +0 -254
- package/docs/graphics.md +0 -255
- package/docs/graphics.zh-CN.md +0 -257
- package/docs/network.ja.md +0 -214
- package/docs/network.ko.md +0 -216
- package/docs/network.md +0 -218
- package/docs/network.zh-CN.md +0 -218
- package/docs/system.ja.md +0 -169
- package/docs/system.ko.md +0 -171
- package/docs/system.md +0 -173
- package/docs/system.zh-CN.md +0 -173
- package/docs/window.ja.md +0 -138
- package/docs/window.ko.md +0 -140
- package/docs/window.md +0 -141
- package/docs/window.zh-CN.md +0 -141
- package/native/exception-boundary.h +0 -97
- package/native/numeric-fields.h +0 -96
- package/native/shared-handle.h +0 -107
- package/test/tsconfig.json +0 -8
- package/tools/configure-lsp.cjs +0 -23
- package/tools/lib_downloader.cjs +0 -92
- package/tools/lib_downloader_urls.cjs +0 -23
|
@@ -1,13 +1,15 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
1
|
+
#define GL_SILENCE_DEPRECATION
|
|
2
|
+
|
|
3
|
+
#include <vector>
|
|
4
|
+
|
|
3
5
|
#include "../../native/texture-resource.h"
|
|
4
|
-
#include
|
|
6
|
+
#include "../../native/window-event.h"
|
|
7
|
+
#include "shared-handle.h"
|
|
8
|
+
#include <SFML/OpenGL.hpp>
|
|
5
9
|
#include <SFML/Window/Context.hpp>
|
|
10
|
+
#include <SFML/Window/Cursor.hpp>
|
|
6
11
|
#include <SFML/Window/VideoMode.hpp>
|
|
7
12
|
#include <SFML/Window/Window.hpp>
|
|
8
|
-
#define GL_SILENCE_DEPRECATION
|
|
9
|
-
#include <SFML/OpenGL.hpp>
|
|
10
|
-
#include <vector>
|
|
11
13
|
|
|
12
14
|
namespace {
|
|
13
15
|
|
|
@@ -18,22 +20,37 @@ std::weak_ptr<sf::Cursor> watchedCursor;
|
|
|
18
20
|
// chains SFML's Win32 window procedure back to itself.
|
|
19
21
|
struct WindowHost {
|
|
20
22
|
HWND handle{};
|
|
21
|
-
~WindowHost() {
|
|
23
|
+
~WindowHost() {
|
|
24
|
+
if (handle) DestroyWindow(handle);
|
|
25
|
+
}
|
|
22
26
|
};
|
|
23
27
|
|
|
24
28
|
NAN_METHOD(CreateWindowHost) {
|
|
25
29
|
auto owner = std::make_shared<WindowHost>();
|
|
26
|
-
owner->handle = CreateWindowExW(0,
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
+
owner->handle = CreateWindowExW(0,
|
|
31
|
+
L"STATIC",
|
|
32
|
+
L"SFML external host",
|
|
33
|
+
WS_POPUP | WS_VISIBLE,
|
|
34
|
+
0,
|
|
35
|
+
0,
|
|
36
|
+
Nan::To<int>(info[0]).FromJust(),
|
|
37
|
+
Nan::To<int>(info[1]).FromJust(),
|
|
38
|
+
nullptr,
|
|
39
|
+
nullptr,
|
|
40
|
+
GetModuleHandleW(nullptr),
|
|
41
|
+
nullptr);
|
|
30
42
|
if (!owner->handle) return Nan::ThrowError("Cannot create external window");
|
|
31
43
|
auto result = Nan::New<v8::Object>();
|
|
32
|
-
Nan::Set(
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
44
|
+
Nan::Set(
|
|
45
|
+
result,
|
|
46
|
+
Nan::New("handle").ToLocalChecked(),
|
|
47
|
+
v8::BigInt::NewFromUnsigned(
|
|
48
|
+
info.GetIsolate(), reinterpret_cast<std::uintptr_t>(owner->handle)))
|
|
49
|
+
.FromJust();
|
|
50
|
+
Nan::Set(result,
|
|
51
|
+
Nan::New("owner").ToLocalChecked(),
|
|
52
|
+
sfmljs::SharedHandle<WindowHost>::Create(owner))
|
|
53
|
+
.FromJust();
|
|
37
54
|
info.GetReturnValue().Set(result);
|
|
38
55
|
}
|
|
39
56
|
|
|
@@ -61,11 +78,20 @@ NAN_METHOD(WindowEventFixtures) {
|
|
|
61
78
|
sf::Event::FocusLost{},
|
|
62
79
|
sf::Event::FocusGained{},
|
|
63
80
|
sf::Event::TextEntered{U'\U0001F642'},
|
|
64
|
-
sf::Event::KeyPressed{sf::Keyboard::Key::Unknown,
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
81
|
+
sf::Event::KeyPressed{sf::Keyboard::Key::Unknown,
|
|
82
|
+
sf::Keyboard::Scan::A,
|
|
83
|
+
true,
|
|
84
|
+
false,
|
|
85
|
+
true,
|
|
86
|
+
false},
|
|
87
|
+
sf::Event::KeyReleased{sf::Keyboard::Key::Escape,
|
|
88
|
+
sf::Keyboard::Scan::Escape,
|
|
89
|
+
false,
|
|
90
|
+
true,
|
|
91
|
+
false,
|
|
92
|
+
true},
|
|
93
|
+
sf::Event::MouseWheelScrolled{
|
|
94
|
+
sf::Mouse::Wheel::Horizontal, -1.5f, {-12, 34}},
|
|
69
95
|
sf::Event::MouseButtonPressed{sf::Mouse::Button::Extra1, {-1, 2}},
|
|
70
96
|
sf::Event::MouseButtonReleased{sf::Mouse::Button::Extra2, {3, -4}},
|
|
71
97
|
sf::Event::MouseMoved{{-5, 6}},
|
|
@@ -80,7 +106,8 @@ NAN_METHOD(WindowEventFixtures) {
|
|
|
80
106
|
sf::Event::TouchBegan{1, {-9, 10}},
|
|
81
107
|
sf::Event::TouchMoved{2, {11, -12}},
|
|
82
108
|
sf::Event::TouchEnded{3, {-13, 14}},
|
|
83
|
-
sf::Event::SensorChanged{sf::Sensor::Type::Gyroscope,
|
|
109
|
+
sf::Event::SensorChanged{sf::Sensor::Type::Gyroscope,
|
|
110
|
+
{1.25f, -2.5f, 3.75f}},
|
|
84
111
|
};
|
|
85
112
|
auto result = Nan::New<v8::Array>(events.size());
|
|
86
113
|
for (std::uint32_t i = 0; i < events.size(); ++i) {
|
|
@@ -91,7 +118,8 @@ NAN_METHOD(WindowEventFixtures) {
|
|
|
91
118
|
|
|
92
119
|
NAN_METHOD(CompareVideoModes) {
|
|
93
120
|
for (int i = 0; i < 6; ++i) {
|
|
94
|
-
if (!info[i]->IsUint32())
|
|
121
|
+
if (!info[i]->IsUint32())
|
|
122
|
+
return Nan::ThrowTypeError("Expected mode fields");
|
|
95
123
|
}
|
|
96
124
|
const sf::VideoMode a({Nan::To<unsigned>(info[0]).FromJust(),
|
|
97
125
|
Nan::To<unsigned>(info[1]).FromJust()},
|
|
@@ -99,7 +127,7 @@ NAN_METHOD(CompareVideoModes) {
|
|
|
99
127
|
const sf::VideoMode b({Nan::To<unsigned>(info[3]).FromJust(),
|
|
100
128
|
Nan::To<unsigned>(info[4]).FromJust()},
|
|
101
129
|
Nan::To<unsigned>(info[5]).FromJust());
|
|
102
|
-
const bool values[]{a == b, a != b, a
|
|
130
|
+
const bool values[]{a == b, a != b, a<b, a> b, a <= b, a >= b};
|
|
103
131
|
auto result = Nan::New<v8::Array>(6);
|
|
104
132
|
for (std::uint32_t i = 0; i < 6; ++i) {
|
|
105
133
|
Nan::Set(result, i, Nan::New(values[i])).FromJust();
|
|
@@ -114,9 +142,9 @@ NAN_METHOD(DrawWindowTexture) {
|
|
|
114
142
|
auto texture = sfmljs::ReadTexture(info[1]);
|
|
115
143
|
if (!texture) return;
|
|
116
144
|
if (!window->owner()->setActive()) return Nan::ThrowError("Inactive window");
|
|
117
|
-
#define GL_FUNCTION(name)
|
|
118
|
-
const auto name =
|
|
119
|
-
sf::Context::getFunction(#name));
|
|
145
|
+
#define GL_FUNCTION(name) \
|
|
146
|
+
const auto name = \
|
|
147
|
+
reinterpret_cast<decltype(&::name)>(sf::Context::getFunction(#name));
|
|
120
148
|
GL_FUNCTION(glViewport)
|
|
121
149
|
GL_FUNCTION(glDisable)
|
|
122
150
|
GL_FUNCTION(glEnable)
|
|
@@ -131,8 +159,9 @@ NAN_METHOD(DrawWindowTexture) {
|
|
|
131
159
|
using BindFramebuffer = void (*)(GLenum, GLuint);
|
|
132
160
|
auto bindFramebuffer = reinterpret_cast<BindFramebuffer>(
|
|
133
161
|
sf::Context::getFunction("glBindFramebuffer"));
|
|
134
|
-
if (!bindFramebuffer)
|
|
135
|
-
|
|
162
|
+
if (!bindFramebuffer)
|
|
163
|
+
bindFramebuffer = reinterpret_cast<BindFramebuffer>(
|
|
164
|
+
sf::Context::getFunction("glBindFramebufferEXT"));
|
|
136
165
|
// RenderTexture can reuse the window context and leave its FBO bound.
|
|
137
166
|
if (bindFramebuffer) bindFramebuffer(0x8D40 /* GL_FRAMEBUFFER */, 0);
|
|
138
167
|
const auto size = window->owner()->getSize();
|
|
@@ -149,10 +178,14 @@ NAN_METHOD(DrawWindowTexture) {
|
|
|
149
178
|
sf::Texture::bind(texture.get());
|
|
150
179
|
glColor4f(1, 1, 1, 1);
|
|
151
180
|
glBegin(GL_TRIANGLE_STRIP);
|
|
152
|
-
glTexCoord2f(0, 0);
|
|
153
|
-
|
|
154
|
-
glTexCoord2f(
|
|
155
|
-
|
|
181
|
+
glTexCoord2f(0, 0);
|
|
182
|
+
glVertex2f(-1, 1);
|
|
183
|
+
glTexCoord2f(1, 0);
|
|
184
|
+
glVertex2f(1, 1);
|
|
185
|
+
glTexCoord2f(0, 1);
|
|
186
|
+
glVertex2f(-1, -1);
|
|
187
|
+
glTexCoord2f(1, 1);
|
|
188
|
+
glVertex2f(1, -1);
|
|
156
189
|
glEnd();
|
|
157
190
|
sf::Texture::bind(nullptr);
|
|
158
191
|
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
const path = require('node:path');
|
|
4
|
+
const { execFileSync } = require('node:child_process');
|
|
5
|
+
const { root } = require('sfml.js-interop/paths');
|
|
6
|
+
|
|
7
|
+
// The downloader runs itself; its paths are relative to its own package.
|
|
8
|
+
execFileSync(process.execPath,
|
|
9
|
+
[ path.join(root, 'tools/lib_downloader.cjs') ], { stdio: 'inherit' });
|
|
@@ -4,7 +4,8 @@ const fs = require('node:fs');
|
|
|
4
4
|
const { readFileSync, writeFileSync, mkdirSync } = fs;
|
|
5
5
|
const { resolve, dirname } = require('node:path');
|
|
6
6
|
const { constantDoc } = require('./constant-docs.cjs');
|
|
7
|
-
const
|
|
7
|
+
const packageRoot = resolve(__dirname, '..');
|
|
8
|
+
const { sfmlInclude } = require('sfml.js-interop/paths');
|
|
8
9
|
const declarations = [
|
|
9
10
|
[ 'Ftp', 'TransferMode', 'TransferMode' ],
|
|
10
11
|
[ 'Ftp', 'Status', 'FtpStatus' ],
|
|
@@ -19,15 +20,19 @@ const descriptions = {
|
|
|
19
20
|
};
|
|
20
21
|
let output = '// Generated from the bundled SFML Network headers.\n';
|
|
21
22
|
for (const [ file, original, exported ] of declarations) {
|
|
22
|
-
const raw = readFileSync(resolve(
|
|
23
|
-
`
|
|
23
|
+
const raw = readFileSync(resolve(sfmlInclude,
|
|
24
|
+
`SFML/Network/${file}.hpp`), 'utf8');
|
|
24
25
|
const rawBody = raw.match(new RegExp(
|
|
25
26
|
`enum class ${original}\\s*\\{([^}]+)\\}`))?.[1];
|
|
26
|
-
if (!rawBody)
|
|
27
|
+
if (!rawBody) {
|
|
28
|
+
throw new Error(`Missing ${file}::${original}`);
|
|
29
|
+
}
|
|
27
30
|
const docs = new Map();
|
|
28
31
|
for (const line of rawBody.split('\n')) {
|
|
29
32
|
const match = line.match(/^\s*(\w+)\b.*?\/\/!<\s*(.+)$/);
|
|
30
|
-
if (match)
|
|
33
|
+
if (match) {
|
|
34
|
+
docs.set(match[1], match[2].replace(/\*\//g, '* /'));
|
|
35
|
+
}
|
|
31
36
|
}
|
|
32
37
|
const body = rawBody.replace(/\/\/[^\n]*/g, '');
|
|
33
38
|
output += `${constantDoc(descriptions[exported])}\n`;
|
|
@@ -46,7 +51,7 @@ for (const [ file, original, exported ] of declarations) {
|
|
|
46
51
|
}
|
|
47
52
|
output += '}\n';
|
|
48
53
|
}
|
|
49
|
-
const path = resolve(
|
|
54
|
+
const path = resolve(packageRoot, 'src/network/gen/constants.ts');
|
|
50
55
|
const current = fs.existsSync(path) ? readFileSync(path, 'utf8') : null;
|
|
51
56
|
if (process.argv.includes('--check')) {
|
|
52
57
|
if (current !== output) {
|
|
@@ -4,8 +4,9 @@ const fs = require('node:fs');
|
|
|
4
4
|
const path = require('node:path');
|
|
5
5
|
const { constantDoc } = require('./constant-docs.cjs');
|
|
6
6
|
|
|
7
|
-
const
|
|
8
|
-
const
|
|
7
|
+
const packageRoot = path.resolve(__dirname, '..');
|
|
8
|
+
const { sfmlInclude } = require('sfml.js-interop/paths');
|
|
9
|
+
const headers = path.join(sfmlInclude, 'SFML/Window');
|
|
9
10
|
const definitions = [
|
|
10
11
|
[ 'WindowEnums', '', 'Style' ],
|
|
11
12
|
[ 'WindowEnums', 'State', 'State' ],
|
|
@@ -46,7 +47,9 @@ function memberDocs(file, pattern) {
|
|
|
46
47
|
const docs = new Map();
|
|
47
48
|
for (const line of body.split('\n')) {
|
|
48
49
|
const match = line.match(/^\s*(\w+)\b.*?\/\/!<\s*(.+)$/);
|
|
49
|
-
if (match)
|
|
50
|
+
if (match) {
|
|
51
|
+
docs.set(match[1], match[2].replace(/\*\//g, '* /'));
|
|
52
|
+
}
|
|
50
53
|
}
|
|
51
54
|
return docs;
|
|
52
55
|
}
|
|
@@ -83,14 +86,22 @@ function evaluate(expression, symbols) {
|
|
|
83
86
|
let index = 0;
|
|
84
87
|
function atom() {
|
|
85
88
|
const token = tokens[index++];
|
|
86
|
-
if (token === '-')
|
|
89
|
+
if (token === '-') {
|
|
90
|
+
return -atom();
|
|
91
|
+
}
|
|
87
92
|
if (token === '(') {
|
|
88
93
|
const value = or();
|
|
89
|
-
if (tokens[index++] !== ')')
|
|
94
|
+
if (tokens[index++] !== ')') {
|
|
95
|
+
throw new Error('Unclosed expression');
|
|
96
|
+
}
|
|
90
97
|
return value;
|
|
91
98
|
}
|
|
92
|
-
if (/^(0x[\da-f]+|\d+)$/i.test(token))
|
|
93
|
-
|
|
99
|
+
if (/^(0x[\da-f]+|\d+)$/i.test(token)) {
|
|
100
|
+
return Number(token);
|
|
101
|
+
}
|
|
102
|
+
if (!symbols.has(token)) {
|
|
103
|
+
throw new Error(`Unknown constant: ${token}`);
|
|
104
|
+
}
|
|
94
105
|
return symbols.get(token);
|
|
95
106
|
}
|
|
96
107
|
function sum() {
|
|
@@ -119,7 +130,9 @@ function evaluate(expression, symbols) {
|
|
|
119
130
|
return value;
|
|
120
131
|
}
|
|
121
132
|
const value = or();
|
|
122
|
-
if (index !== tokens.length)
|
|
133
|
+
if (index !== tokens.length) {
|
|
134
|
+
throw new Error(`Unparsed: ${expression}`);
|
|
135
|
+
}
|
|
123
136
|
return value;
|
|
124
137
|
}
|
|
125
138
|
|
|
@@ -132,7 +145,9 @@ for (const [ file, name, output ] of definitions) {
|
|
|
132
145
|
const pattern = name ? `enum\\s+class\\s+${name}\\s*`
|
|
133
146
|
: 'namespace\\s+Style\\s*\\{\\s*enum\\s*';
|
|
134
147
|
const match = source(file).match(new RegExp(`${pattern}\\{([^}]+)\\}`));
|
|
135
|
-
if (!match)
|
|
148
|
+
if (!match) {
|
|
149
|
+
throw new Error(`Missing enum ${file}/${name}`);
|
|
150
|
+
}
|
|
136
151
|
const docs = memberDocs(file, pattern);
|
|
137
152
|
const symbols = scopes.get(file) || new Map();
|
|
138
153
|
scopes.set(file, symbols);
|
|
@@ -140,7 +155,9 @@ for (const [ file, name, output ] of definitions) {
|
|
|
140
155
|
ts.push('', constantDoc(descriptions[output]), `export enum ${output} {`);
|
|
141
156
|
for (const item of match[1].split(',').map(s => s.trim()).filter(Boolean)) {
|
|
142
157
|
const member = item.match(/^(\w+)(?:\s*=\s*(.+))?$/);
|
|
143
|
-
if (!member)
|
|
158
|
+
if (!member) {
|
|
159
|
+
throw new Error(`Unsupported enumerator: ${item}`);
|
|
160
|
+
}
|
|
144
161
|
const [ , key, expression ] = member;
|
|
145
162
|
const value = expression ? evaluate(expression, symbols) : previous + 1;
|
|
146
163
|
symbols.set(key, value);
|
|
@@ -156,7 +173,9 @@ for (const [ file, name, output ] of definitions) {
|
|
|
156
173
|
}
|
|
157
174
|
for (const [ file, name, output ] of counts) {
|
|
158
175
|
const match = source(file).match(new RegExp(`${name}\\s*\\{([^}]+)\\}`));
|
|
159
|
-
if (!match)
|
|
176
|
+
if (!match) {
|
|
177
|
+
throw new Error(`Missing count ${file}/${name}`);
|
|
178
|
+
}
|
|
160
179
|
const value = evaluate(match[1], scopes.get(file));
|
|
161
180
|
ts.push('', countDoc(file, name),
|
|
162
181
|
`export const ${output} = ${value};`);
|
|
@@ -164,7 +183,7 @@ for (const [ file, name, output ] of counts) {
|
|
|
164
183
|
for (const [ file, lines ] of [
|
|
165
184
|
[ 'src/window/gen/constants.ts', ts ],
|
|
166
185
|
]) {
|
|
167
|
-
const output = path.join(
|
|
186
|
+
const output = path.join(packageRoot, file);
|
|
168
187
|
const content = lines.join('\n') + '\n';
|
|
169
188
|
if (process.argv.includes('--check')) {
|
|
170
189
|
if (!fs.existsSync(output) || fs.readFileSync(output, 'utf8') !== content) {
|
package/docs/README.ja.md
DELETED
|
@@ -1,30 +0,0 @@
|
|
|
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/) を基準とします。
|
package/docs/README.ko.md
DELETED
|
@@ -1,30 +0,0 @@
|
|
|
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
DELETED
|
@@ -1,30 +0,0 @@
|
|
|
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.
|
package/docs/README.zh-CN.md
DELETED
|
@@ -1,30 +0,0 @@
|
|
|
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
DELETED
|
@@ -1,84 +0,0 @@
|
|
|
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)
|
package/docs/api.ko.md
DELETED
|
@@ -1,84 +0,0 @@
|
|
|
1
|
-
# API 안내
|
|
2
|
-
|
|
3
|
-
[English](api.md) / [简体中文](api.zh-CN.md) / [日本語](api.ja.md) / **한국어**
|
|
4
|
-
|
|
5
|
-
> sfml.js는 SFML 3.1.0을 기반으로 합니다. 직접 작성한 가이드는 사용법, 반환값, Node.js에 맞춘 조정을 설명하며, 전체 시그니처와 타입 제약은 소스에서 생성한 [TypeDoc](https://sfml.js.org/ko/reference/)에서 제공합니다.
|
|
6
|
-
|
|
7
|
-
[문서 홈](README.ko.md) · [빠른 시작](getting-started.ko.md) · [핵심 개념](concepts.ko.md)
|
|
8
|
-
|
|
9
|
-
모든 공개 인터페이스는 `sfml.js`에서 가져옵니다. 내보내기 목록은 [src/index.ts](../src/index.ts)를 참고하세요. 애플리케이션 코드에서 `dist/internal`이나 네이티브 모듈 핸들에 접근할 필요는 없습니다.
|
|
10
|
-
|
|
11
|
-
## 작업별 선택
|
|
12
|
-
|
|
13
|
-
| 작업 | 문서 | 주요 인터페이스 |
|
|
14
|
-
| --- | --- | --- |
|
|
15
|
-
| 좌표, 각도, 프레임 시간 계산 | [System](system.ko.md) | Vector2/3, Angle, Time, Clock, 이름 있는 연산자 |
|
|
16
|
-
| 사용자 정의 파일 소스 연결 | [입력 스트림](system.ko.md#input-streams) | InputStream, MemoryInputStream, FileInputStream |
|
|
17
|
-
| 창 열기와 입력 수신 | [Window](window.ko.md) | RenderWindow, Window, Event, Keyboard, Mouse |
|
|
18
|
-
| 이미지와 애니메이션 표시 | [Graphics](graphics.ko.md) | Image, Texture, Sprite |
|
|
19
|
-
| 도형과 텍스트 그리기 | [Graphics](graphics.ko.md) | Shape, Font, Glyph, Text |
|
|
20
|
-
| 카메라, 오프스크린 합성, 일괄 지오메트리 처리 | [Graphics](graphics.ko.md) | View, RenderTexture, VertexArray, VertexBuffer |
|
|
21
|
-
| 사용자 정의 그리기와 셰이더 | [Graphics](graphics.ko.md) | Drawable, RenderStates, Shader, Glsl |
|
|
22
|
-
| 재생, 녹음, 오디오 처리 | [Audio](audio.ko.md) | SoundBuffer, Sound, Music, SoundStream, SoundRecorder |
|
|
23
|
-
| 네트워크 연결과 파일 전송 | [Network](network.ko.md) | Packet, TcpSocket, UdpSocket, Http, Ftp, Sftp |
|
|
24
|
-
|
|
25
|
-
## System
|
|
26
|
-
|
|
27
|
-
`Vector2`/`Vector3`는 여러 스칼라 타입을 지원합니다. `Vector2i/u/f`와 `Vector3i/u/f`는 자주 사용하는 특수화입니다. `degrees()`/`radians()`로 Angle을, 시간 팩토리 함수로 Time을 생성합니다.
|
|
28
|
-
|
|
29
|
-
JavaScript에는 C++ 연산자 오버로딩이 없으므로 해당 연산에는 `add()`, `multiply()`, `equal()`, `*Assign()`을 사용합니다. `Clock`, 비동기 `sleep()`, `TimeoutWithPredicate`, 입력 스트림, `Unicode`, 오류 로그 인터페이스도 이 모듈에 속합니다.
|
|
30
|
-
|
|
31
|
-
자세한 내용은 [System](system.ko.md)을 참고하세요.
|
|
32
|
-
|
|
33
|
-
## Window
|
|
34
|
-
|
|
35
|
-
`Window`는 시스템 창과 OpenGL 컨텍스트를 제공합니다. 2D 그리기에는 보통 Window와 RenderTarget의 기능을 함께 갖춘 `RenderWindow`를 사용합니다.
|
|
36
|
-
|
|
37
|
-
이벤트는 `pollEvent()`, `handleEvents()`, 동기식 `waitEvent()`로 가져올 수 있습니다. 키보드, 마우스, 조이스틱, 센서에는 실시간 조회 기능도 있습니다. `Clipboard`, `Cursor`, `Context`, `Vulkan`은 시스템 통합 기능을 담당합니다.
|
|
38
|
-
|
|
39
|
-
자세한 내용은 [Window](window.ko.md)를 참고하세요.
|
|
40
|
-
|
|
41
|
-
## Graphics
|
|
42
|
-
|
|
43
|
-
Image는 CPU 측 픽셀을, Texture는 GPU 텍스처를 저장하며, Sprite는 텍스처를 참조해 그립니다. Shape는 원, 사각형, 볼록 다각형, 사용자 정의 볼록 도형을 제공합니다. Font와 Text는 폰트 로딩, 텍스트 레이아웃, 편집 가능한 정점을 제공합니다.
|
|
44
|
-
|
|
45
|
-
RenderTarget은 창과 오프스크린 대상의 그리기 인터페이스를 통일합니다. View는 카메라와 뷰포트를 제어하고, RenderStates는 변환, 블렌딩, 스텐실, 텍스처, Shader를 제어합니다. 정점 배열과 GPU 정점 버퍼로 지오메트리를 직접 구성할 수 있습니다.
|
|
46
|
-
|
|
47
|
-
자세한 내용은 [Graphics](graphics.ko.md)와 [그리기 스냅샷](concepts.ko.md#draw-snapshots)을 참고하세요.
|
|
48
|
-
|
|
49
|
-
## Audio
|
|
50
|
-
|
|
51
|
-
짧은 효과음에는 SoundBuffer + Sound를, 긴 오디오에는 Music을 사용합니다. SoundSource는 볼륨, 패닝, 공간 오디오 속성을 제공합니다. SoundStream, SoundRecorder, EffectProcessor는 Worker 콜백으로 사용자 정의 데이터를 처리합니다.
|
|
52
|
-
|
|
53
|
-
자세한 내용은 [Audio](audio.ko.md)를 참고하세요. 특히 샘플 수, 채널 배치, 버퍼의 유효 기간에 주의해야 합니다.
|
|
54
|
-
|
|
55
|
-
## Network
|
|
56
|
-
|
|
57
|
-
Network는 Node.js 전송 계층으로 SFML 스타일 API를 구현합니다. 실제 서비스 코드는 SFML C++ Network를 호출하지 않습니다. Packet은 SFML 인코딩 규칙을 유지하며, TCP, UDP, DNS, TLS, HTTP, FTP, SFTP의 I/O는 Promise를 사용합니다.
|
|
58
|
-
|
|
59
|
-
상태 반환, 부분 전송, 프로토콜 제한, 종료 방법을 포함한 자세한 내용은 [Network](network.ko.md)를 참고하세요.
|
|
60
|
-
|
|
61
|
-
## 호환 범위
|
|
62
|
-
|
|
63
|
-
| 항목 | 현재 동작 |
|
|
64
|
-
| --- | --- |
|
|
65
|
-
| C++ 포인터, 참조 출력 매개변수 | 객체, 뷰, 반환 객체로 표현 |
|
|
66
|
-
| C++ 템플릿 및 연산자 | 명시적인 스칼라 태그, 클래스, 이름 있는 함수로 표현 |
|
|
67
|
-
| 파일 로딩 | Promise 사용, 구체적인 실패 상태는 각 인터페이스의 규칙을 유지 |
|
|
68
|
-
| 소멸 | 네이티브 소유권과 JS 참조를 함께 사용하며, 닫기 인터페이스가 있는 리소스는 명시적으로 닫아야 함 |
|
|
69
|
-
| `drawAsync()`/`displayAsync()` | 제공하지 않으며, 이전 예제에서 명시적으로 미지원으로 보고 |
|
|
70
|
-
| Android SuspendAwareClock | 조건부 컴파일 인터페이스가 있으며, 현재 다운로드 절차는 데스크톱 대상 |
|
|
71
|
-
| Vulkan | 조회 인터페이스가 내보내지며, 사용 가능 여부는 SFML 플랫폼 백엔드에 따라 결정됨. macOS 백엔드에서는 사용 불가 |
|
|
72
|
-
|
|
73
|
-
플랫폼별 빌드와 테스트 범위는 [개발 가이드](development.ko.md#testing)를 참고하세요.
|
|
74
|
-
|
|
75
|
-
<a id="sfml-cpp-reference"></a>
|
|
76
|
-
## SFML C++ 레퍼런스
|
|
77
|
-
|
|
78
|
-
[SFML 3.1.0 공식 문서 색인](https://www.sfml-dev.org/documentation/3.1.0/)은 C++ API의 개념을 확인하는 기준입니다. JavaScript 시그니처와 타입 제약은 [TypeDoc](https://sfml.js.org/ko/reference/)을 기준으로 하세요. 각 모듈의 관련 원본 클래스와 JS 차이는 아래에서 확인할 수 있습니다.
|
|
79
|
-
|
|
80
|
-
- [System C++ 레퍼런스](system.ko.md#sfml-cpp-reference)
|
|
81
|
-
- [Window C++ 레퍼런스](window.ko.md#sfml-cpp-reference)
|
|
82
|
-
- [Graphics C++ 레퍼런스](graphics.ko.md#sfml-cpp-reference)
|
|
83
|
-
- [Audio C++ 레퍼런스](audio.ko.md#sfml-cpp-reference)
|
|
84
|
-
- [Network C++ 레퍼런스](network.ko.md#sfml-cpp-reference)
|