sfml.js-imgui 0.0.0-stage → 1.2.1

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.
Files changed (270) hide show
  1. package/README.ja.md +113 -0
  2. package/README.ko.md +113 -0
  3. package/README.md +112 -2
  4. package/README.zh-CN.md +113 -0
  5. package/binding.gyp +125 -0
  6. package/dist/callbacks.d.ts +368 -0
  7. package/dist/callbacks.js +310 -0
  8. package/dist/enums/colors.d.ts +779 -0
  9. package/dist/enums/colors.js +766 -0
  10. package/dist/enums/drawing.d.ts +286 -0
  11. package/dist/enums/drawing.js +257 -0
  12. package/dist/enums/input.d.ts +792 -0
  13. package/dist/enums/input.js +731 -0
  14. package/dist/enums/keys.d.ts +1389 -0
  15. package/dist/enums/keys.js +1384 -0
  16. package/dist/enums/selection.d.ts +195 -0
  17. package/dist/enums/selection.js +182 -0
  18. package/dist/enums/style.d.ts +362 -0
  19. package/dist/enums/style.js +349 -0
  20. package/dist/enums/tables.d.ts +681 -0
  21. package/dist/enums/tables.js +644 -0
  22. package/dist/enums/text.d.ts +411 -0
  23. package/dist/enums/text.js +390 -0
  24. package/dist/enums/widgets.d.ts +861 -0
  25. package/dist/enums/widgets.js +800 -0
  26. package/dist/enums/windows.d.ts +487 -0
  27. package/dist/enums/windows.js +458 -0
  28. package/dist/enums.d.ts +10 -0
  29. package/dist/enums.js +26 -0
  30. package/dist/font.d.ts +249 -0
  31. package/dist/font.js +285 -0
  32. package/dist/formatted.d.ts +301 -0
  33. package/dist/formatted.js +342 -0
  34. package/dist/imgui/color.d.ts +493 -0
  35. package/dist/imgui/color.js +532 -0
  36. package/dist/imgui/columns.d.ts +242 -0
  37. package/dist/imgui/columns.js +273 -0
  38. package/dist/imgui/combo.d.ts +322 -0
  39. package/dist/imgui/combo.js +344 -0
  40. package/dist/imgui/context.d.ts +240 -0
  41. package/dist/imgui/context.js +270 -0
  42. package/dist/imgui/debug.d.ts +478 -0
  43. package/dist/imgui/debug.js +526 -0
  44. package/dist/imgui/drag-drop.d.ts +378 -0
  45. package/dist/imgui/drag-drop.js +414 -0
  46. package/dist/imgui/drag.d.ts +1371 -0
  47. package/dist/imgui/drag.js +1447 -0
  48. package/dist/imgui/draw-data.d.ts +139 -0
  49. package/dist/imgui/draw-data.js +154 -0
  50. package/dist/imgui/draw-list-images.d.ts +306 -0
  51. package/dist/imgui/draw-list-images.js +324 -0
  52. package/dist/imgui/draw-list-internals.d.ts +223 -0
  53. package/dist/imgui/draw-list-internals.js +259 -0
  54. package/dist/imgui/draw-list-path.d.ts +451 -0
  55. package/dist/imgui/draw-list-path.js +493 -0
  56. package/dist/imgui/draw-list-primitives.d.ts +297 -0
  57. package/dist/imgui/draw-list-primitives.js +324 -0
  58. package/dist/imgui/draw-list-shapes.d.ts +1258 -0
  59. package/dist/imgui/draw-list-shapes.js +1345 -0
  60. package/dist/imgui/draw-list-state.d.ts +458 -0
  61. package/dist/imgui/draw-list-state.js +515 -0
  62. package/dist/imgui/draw-list-text.d.ts +367 -0
  63. package/dist/imgui/draw-list-text.js +247 -0
  64. package/dist/imgui/drawing.d.ts +151 -0
  65. package/dist/imgui/drawing.js +169 -0
  66. package/dist/imgui/font-atlas.d.ts +726 -0
  67. package/dist/imgui/font-atlas.js +777 -0
  68. package/dist/imgui/font-glyph-ranges.d.ts +260 -0
  69. package/dist/imgui/font-glyph-ranges.js +230 -0
  70. package/dist/imgui/fonts.d.ts +114 -0
  71. package/dist/imgui/fonts.js +132 -0
  72. package/dist/imgui/id-stack.d.ts +363 -0
  73. package/dist/imgui/id-stack.js +309 -0
  74. package/dist/imgui/images.d.ts +310 -0
  75. package/dist/imgui/images.js +331 -0
  76. package/dist/imgui/index.d.ts +57 -0
  77. package/dist/imgui/index.js +73 -0
  78. package/dist/imgui/input-text-callback.d.ts +176 -0
  79. package/dist/imgui/input-text-callback.js +144 -0
  80. package/dist/imgui/inputs.d.ts +1086 -0
  81. package/dist/imgui/inputs.js +1159 -0
  82. package/dist/imgui/io.d.ts +546 -0
  83. package/dist/imgui/io.js +600 -0
  84. package/dist/imgui/item-state.d.ts +766 -0
  85. package/dist/imgui/item-state.js +850 -0
  86. package/dist/imgui/keyboard.d.ts +547 -0
  87. package/dist/imgui/keyboard.js +584 -0
  88. package/dist/imgui/layout.d.ts +927 -0
  89. package/dist/imgui/layout.js +1029 -0
  90. package/dist/imgui/legacy.d.ts +413 -0
  91. package/dist/imgui/legacy.js +461 -0
  92. package/dist/imgui/list-clipper.d.ts +282 -0
  93. package/dist/imgui/list-clipper.js +309 -0
  94. package/dist/imgui/logging.d.ts +113 -0
  95. package/dist/imgui/logging.js +135 -0
  96. package/dist/imgui/memory.d.ts +35 -0
  97. package/dist/imgui/memory.js +45 -0
  98. package/dist/imgui/menus.d.ts +373 -0
  99. package/dist/imgui/menus.js +407 -0
  100. package/dist/imgui/mouse.d.ts +740 -0
  101. package/dist/imgui/mouse.js +803 -0
  102. package/dist/imgui/plots.d.ts +252 -0
  103. package/dist/imgui/plots.js +267 -0
  104. package/dist/imgui/popups.d.ts +711 -0
  105. package/dist/imgui/popups.js +757 -0
  106. package/dist/imgui/scrolling.d.ts +341 -0
  107. package/dist/imgui/scrolling.js +375 -0
  108. package/dist/imgui/selection.d.ts +785 -0
  109. package/dist/imgui/selection.js +845 -0
  110. package/dist/imgui/settings.d.ts +194 -0
  111. package/dist/imgui/settings.js +216 -0
  112. package/dist/imgui/sliders.d.ts +1664 -0
  113. package/dist/imgui/sliders.js +1751 -0
  114. package/dist/imgui/storage.d.ts +344 -0
  115. package/dist/imgui/storage.js +386 -0
  116. package/dist/imgui/style.d.ts +680 -0
  117. package/dist/imgui/style.js +770 -0
  118. package/dist/imgui/tables.d.ts +762 -0
  119. package/dist/imgui/tables.js +831 -0
  120. package/dist/imgui/tabs.d.ts +228 -0
  121. package/dist/imgui/tabs.js +250 -0
  122. package/dist/imgui/text-buffer.d.ts +251 -0
  123. package/dist/imgui/text-buffer.js +239 -0
  124. package/dist/imgui/text-filter.d.ts +181 -0
  125. package/dist/imgui/text-filter.js +151 -0
  126. package/dist/imgui/text.d.ts +506 -0
  127. package/dist/imgui/text.js +425 -0
  128. package/dist/imgui/tooltips.d.ts +202 -0
  129. package/dist/imgui/tooltips.js +221 -0
  130. package/dist/imgui/trees.d.ts +516 -0
  131. package/dist/imgui/trees.js +562 -0
  132. package/dist/imgui/viewport.d.ts +93 -0
  133. package/dist/imgui/viewport.js +105 -0
  134. package/dist/imgui/widgets.d.ts +524 -0
  135. package/dist/imgui/widgets.js +572 -0
  136. package/dist/imgui/windows.d.ts +1210 -0
  137. package/dist/imgui/windows.js +1309 -0
  138. package/dist/index.d.ts +4 -0
  139. package/dist/index.js +19 -0
  140. package/dist/internal/imgui-binding.d.ts +40 -0
  141. package/dist/internal/imgui-binding.js +2 -0
  142. package/dist/internal/native.d.ts +67 -0
  143. package/dist/internal/native.js +7 -0
  144. package/dist/internal/sfml-interop.d.ts +45 -0
  145. package/dist/internal/sfml-interop.js +102 -0
  146. package/dist/references.d.ts +393 -0
  147. package/dist/references.js +372 -0
  148. package/dist/sfml.d.ts +223 -0
  149. package/dist/sfml.js +320 -0
  150. package/dist/struct-views.d.ts +3056 -0
  151. package/dist/struct-views.js +418 -0
  152. package/dist/types.d.ts +508 -0
  153. package/dist/types.js +2 -0
  154. package/native/addon.cc +68 -0
  155. package/native/cimgui.h +12 -0
  156. package/native/imgui-args.h +492 -0
  157. package/native/imgui-bindings.h +35 -0
  158. package/native/imgui-callbacks.cc +376 -0
  159. package/native/imgui-context.cc +117 -0
  160. package/native/imgui-debug.cc +171 -0
  161. package/native/imgui-drag-drop.cc +120 -0
  162. package/native/imgui-drag-widgets.cc +473 -0
  163. package/native/imgui-draw-callbacks.cc +210 -0
  164. package/native/imgui-draw-callbacks.h +25 -0
  165. package/native/imgui-draw-paths.cc +413 -0
  166. package/native/imgui-draw-primitives.cc +317 -0
  167. package/native/imgui-drawing.cc +963 -0
  168. package/native/imgui-font-ranges.cc +73 -0
  169. package/native/imgui-font.cc +488 -0
  170. package/native/imgui-formatted.cc +388 -0
  171. package/native/imgui-frame.cc +56 -0
  172. package/native/imgui-glyph-fields.cc +87 -0
  173. package/native/imgui-glyph-fields.h +12 -0
  174. package/native/imgui-input-widgets.cc +447 -0
  175. package/native/imgui-input.cc +277 -0
  176. package/native/imgui-integration.cc +442 -0
  177. package/native/imgui-io.cc +255 -0
  178. package/native/imgui-items.cc +290 -0
  179. package/native/imgui-layout.cc +349 -0
  180. package/native/imgui-popups.cc +331 -0
  181. package/native/imgui-references.cc +230 -0
  182. package/native/imgui-selection.cc +394 -0
  183. package/native/imgui-slider-widgets.cc +550 -0
  184. package/native/imgui-storage.cc +177 -0
  185. package/native/imgui-struct-views.cc +626 -0
  186. package/native/imgui-style.cc +283 -0
  187. package/native/imgui-tables.cc +267 -0
  188. package/native/imgui-text.cc +291 -0
  189. package/native/imgui-utilities.cc +127 -0
  190. package/native/imgui-values.cc +66 -0
  191. package/native/imgui-widgets.cc +570 -0
  192. package/native/imgui-windows.cc +436 -0
  193. package/native/interop.h +19 -0
  194. package/package.json +72 -3
  195. package/src/callbacks.ts +447 -0
  196. package/src/enums/colors.ts +782 -0
  197. package/src/enums/drawing.ts +293 -0
  198. package/src/enums/input.ts +807 -0
  199. package/src/enums/keys.ts +1390 -0
  200. package/src/enums/selection.ts +198 -0
  201. package/src/enums/style.ts +365 -0
  202. package/src/enums/tables.ts +690 -0
  203. package/src/enums/text.ts +416 -0
  204. package/src/enums/widgets.ts +876 -0
  205. package/src/enums/windows.ts +494 -0
  206. package/src/enums.ts +10 -0
  207. package/src/font.ts +287 -0
  208. package/src/formatted.ts +386 -0
  209. package/src/imgui/color.ts +575 -0
  210. package/src/imgui/columns.ts +274 -0
  211. package/src/imgui/combo.ts +376 -0
  212. package/src/imgui/context.ts +268 -0
  213. package/src/imgui/debug.ts +542 -0
  214. package/src/imgui/drag-drop.ts +423 -0
  215. package/src/imgui/drag.ts +1615 -0
  216. package/src/imgui/draw-data.ts +158 -0
  217. package/src/imgui/draw-list-images.ts +394 -0
  218. package/src/imgui/draw-list-internals.ts +291 -0
  219. package/src/imgui/draw-list-path.ts +568 -0
  220. package/src/imgui/draw-list-primitives.ts +363 -0
  221. package/src/imgui/draw-list-shapes.ts +1593 -0
  222. package/src/imgui/draw-list-state.ts +551 -0
  223. package/src/imgui/draw-list-text.ts +594 -0
  224. package/src/imgui/drawing.ts +170 -0
  225. package/src/imgui/font-atlas.ts +862 -0
  226. package/src/imgui/font-glyph-ranges.ts +357 -0
  227. package/src/imgui/fonts.ts +133 -0
  228. package/src/imgui/id-stack.ts +496 -0
  229. package/src/imgui/images.ts +364 -0
  230. package/src/imgui/index.ts +57 -0
  231. package/src/imgui/input-text-callback.ts +268 -0
  232. package/src/imgui/inputs.ts +1292 -0
  233. package/src/imgui/io.ts +638 -0
  234. package/src/imgui/item-state.ts +856 -0
  235. package/src/imgui/keyboard.ts +590 -0
  236. package/src/imgui/layout.ts +1030 -0
  237. package/src/imgui/legacy.ts +477 -0
  238. package/src/imgui/list-clipper.ts +329 -0
  239. package/src/imgui/logging.ts +135 -0
  240. package/src/imgui/memory.ts +42 -0
  241. package/src/imgui/menus.ts +417 -0
  242. package/src/imgui/mouse.ts +824 -0
  243. package/src/imgui/plots.ts +313 -0
  244. package/src/imgui/popups.ts +779 -0
  245. package/src/imgui/scrolling.ts +378 -0
  246. package/src/imgui/selection.ts +904 -0
  247. package/src/imgui/settings.ts +220 -0
  248. package/src/imgui/sliders.ts +1969 -0
  249. package/src/imgui/storage.ts +415 -0
  250. package/src/imgui/style.ts +781 -0
  251. package/src/imgui/tables.ts +854 -0
  252. package/src/imgui/tabs.ts +259 -0
  253. package/src/imgui/text-buffer.ts +337 -0
  254. package/src/imgui/text-filter.ts +262 -0
  255. package/src/imgui/text.ts +688 -0
  256. package/src/imgui/tooltips.ts +218 -0
  257. package/src/imgui/trees.ts +583 -0
  258. package/src/imgui/viewport.ts +103 -0
  259. package/src/imgui/widgets.ts +599 -0
  260. package/src/imgui/windows.ts +1350 -0
  261. package/src/index.ts +21 -0
  262. package/src/internal/imgui-binding.ts +142 -0
  263. package/src/internal/native.ts +163 -0
  264. package/src/internal/sfml-interop.ts +171 -0
  265. package/src/references.ts +464 -0
  266. package/src/sfml.ts +412 -0
  267. package/src/struct-views.ts +3194 -0
  268. package/src/types.ts +539 -0
  269. package/tools/deps_downloader.cjs +213 -0
  270. package/tsconfig.json +15 -0
@@ -0,0 +1,194 @@
1
+ /**
2
+ * Get text from the operating-system clipboard.
3
+ *
4
+ * @zh 获取操作系统剪贴板中的文本。
5
+ * @ja OS のクリップボードからテキストを取得します。
6
+ * @ko 운영체제 클립보드에서 텍스트를 가져옵니다.
7
+ *
8
+ * @remarks
9
+ * - Also see the LogToClipboard() function to capture GUI into clipboard, or
10
+ * easily output text data to the clipboard.
11
+ * @zh
12
+ * 剪贴板工具。
13
+ *
14
+ * - 另见 LogToClipboard(),可将 GUI 捕获到剪贴板,或便捷地将文本数据输出到剪贴板。
15
+ * @ja
16
+ * クリップボードユーティリティ。
17
+ *
18
+ * - GUI をクリップボードに取り込んだり、テキストデータを手軽に出力したりするには LogToClipboard() も参照してください。
19
+ * @ko
20
+ * 클립보드 유틸리티.
21
+ *
22
+ * - GUI를 클립보드로 캡처하거나 텍스트 데이터를 쉽게 출력하려면 LogToClipboard()도 참조하세요.
23
+ *
24
+ * @returns Clipboard text copied to a JS string, or null when the native
25
+ * clipboard getter returns no text.
26
+ * @zh 复制为 JS 字符串的剪贴板文字;原生剪贴板获取器没有返回文字时为 null。
27
+ * @ja JS 文字列へコピーしたクリップボード内容です。ネイティブが文字列を返さなければ null です。
28
+ * @ko JS 문자열로 복사한 클립보드 텍스트입니다. 네이티브 getter가 텍스트를 반환하지 않으면 null입니다.
29
+ */
30
+ export declare function GetClipboardText(): string | null;
31
+ /**
32
+ * Replace the clipboard text through the configured platform clipboard handler.
33
+ *
34
+ * @zh 通过已配置的平台剪贴板处理器替换剪贴板文本。
35
+ * @ja 設定済みのプラットフォーム用クリップボード処理でクリップボードのテキストを置き換えます。
36
+ * @ko 설정된 플랫폼 클립보드 처리기를 통해 클립보드 텍스트를 바꿉니다.
37
+ *
38
+ * @param text - UTF-8 text to read. JS strings are encoded for this call; a
39
+ * nonempty Uint8Array ending in NUL is passed directly, otherwise its bytes are
40
+ * copied and NUL-terminated.
41
+ * @zh text - 要读取的 UTF-8 文本。JS 字符串为本次调用编码;非空且以 NUL 结束的 Uint8Array 直接传入,否则复制字节并补上
42
+ * NUL。
43
+ * @ja text - 読む UTF-8 テキストです。JS 文字列は変換し、空でない NUL 終端の Uint8Array
44
+ * は直接渡し、それ以外はコピーして NUL を付けます。
45
+ * @ko text - 읽을 UTF-8 텍스트입니다. JS 문자열은 인코딩됩니다. 비어 있지 않은 NUL 종료 Uint8Array는 직접
46
+ * 전달하며 나머지는 복사 후 NUL을 붙입니다.
47
+ */
48
+ export declare function SetClipboardText(text: string | Uint8Array): void;
49
+ /**
50
+ * Load interface settings from an INI file.
51
+ *
52
+ * @zh 从 INI 文件加载界面设置。
53
+ * @ja INI ファイルからインターフェイス設定を読み込みます。
54
+ * @ko INI 파일에서 인터페이스 설정을 불러옵니다.
55
+ *
56
+ * @remarks
57
+ * Call after SFML.Init(window) succeeds and before the first SFML.Update(...)
58
+ * to load settings from your chosen file.
59
+ *
60
+ * Native automatic persistence defaults to "imgui.ini", relative to the
61
+ * current working directory. This binding does not expose its filename
62
+ * configuration or a way to disable automatic saving. Loading a file here
63
+ * does not change the automatic save destination.
64
+ * @zh
65
+ * 在 SFML.Init(window) 成功之后、首次 SFML.Update(...) 之前调用,从指定文件加载设置。
66
+ *
67
+ * 原生自动持久化默认使用相对于当前工作目录的 "imgui.ini"。此绑定未暴露自动持久化的文件名配置,
68
+ * 也未提供禁用自动保存的方法。此处加载的文件不会改变自动保存的目标路径。
69
+ * @ja
70
+ * SFML.Init(window) が成功した後、最初の SFML.Update(...) より前に呼び、指定したファイルから設定を読み込みます。
71
+ *
72
+ * ネイティブの自動保存・読み込みは、作業ディレクトリからの相対パス "imgui.ini" を既定で使います。
73
+ * このバインディングには、そのファイル名の設定や自動保存を無効にする API はありません。
74
+ * ここで別のファイルを読み込んでも、自動保存先は変わりません。
75
+ * @ko
76
+ * SFML.Init(window)가 성공한 후 첫 SFML.Update(...) 전에 호출하여 지정한 파일에서 설정을 불러옵니다.
77
+ *
78
+ * 네이티브 자동 저장 및 불러오기는 현재 작업 디렉터리 기준 "imgui.ini"를 기본값으로 사용합니다.
79
+ * 이 바인딩은 해당 파일명 설정이나 자동 저장을 끄는 API를 노출하지 않습니다.
80
+ * 여기서 다른 파일을 불러와도 자동 저장 경로는 바뀌지 않습니다.
81
+ *
82
+ * @param ini_filename - Filesystem path of the ImGui settings file to load or
83
+ * save.
84
+ * @zh ini_filename - 要加载或保存的 ImGui 配置文件路径。
85
+ * @ja ini_filename - 読み込みまたは保存する ImGui 設定ファイルのパスです。
86
+ * @ko ini_filename - 읽거나 저장할 ImGui 설정 파일의 경로입니다.
87
+ */
88
+ export declare function LoadIniSettingsFromDisk(ini_filename: string | Uint8Array): void;
89
+ /**
90
+ * Load interface settings from INI text in memory.
91
+ *
92
+ * @zh 从内存中的 INI 文本加载界面设置。
93
+ * @ja メモリ上の INI テキストからインターフェイス設定を読み込みます。
94
+ * @ko 메모리의 INI 텍스트에서 인터페이스 설정을 불러옵니다.
95
+ *
96
+ * @remarks
97
+ * Call after SFML.Init(window) succeeds and before the first SFML.Update(...)
98
+ * to provide INI data from your own data source.
99
+ * @zh
100
+ * 在 SFML.Init(window) 成功之后、首次 SFML.Update(...) 之前调用,以从自己的数据源提供 INI 数据。
101
+ * @ja
102
+ * 独自の INI データを渡すには、SFML.Init(window) の成功後、最初の SFML.Update(...) より前に呼びます。
103
+ * @ko
104
+ * 자체 INI 데이터를 제공하려면 SFML.Init(window)가 성공한 후 첫 SFML.Update(...) 전에 호출합니다.
105
+ *
106
+ * @param ini_data - UTF-8 serialized ImGui settings to load from memory.
107
+ * @zh ini_data - 要从内存加载的 UTF-8 序列化 ImGui 配置。
108
+ * @ja ini_data - メモリーから読み込む UTF-8 の ImGui 設定データです。
109
+ * @ko ini_data - 메모리에서 읽을 UTF-8 직렬화 ImGui 설정입니다.
110
+ *
111
+ * @param ini_size - Length of ini_data in bytes; 0 reads through its NUL
112
+ * terminator.
113
+ * @zh ini_size - ini_data 的字节长度;0 读取至 NUL 终止符。
114
+ * @ja ini_size - ini_data のバイト長です。0 は NUL 終端まで読みます。
115
+ * @ko ini_size - ini_data의 바이트 길이입니다. 0은 NUL 종료까지 읽습니다.
116
+ */
117
+ export declare function LoadIniSettingsFromMemory(ini_data: string | Uint8Array, ini_size?: number): void;
118
+ /**
119
+ * Save interface settings to an INI file.
120
+ *
121
+ * @zh 将界面设置保存到 INI 文件。
122
+ * @ja インターフェイス設定を INI ファイルに保存します。
123
+ * @ko 인터페이스 설정을 INI 파일에 저장합니다.
124
+ *
125
+ * @remarks
126
+ * Save explicitly to the supplied path. Native automatic saving is separate:
127
+ * it saves to "imgui.ini" by default after settings change and when the context
128
+ * is destroyed. Its filename and disable switch are not exposed by this
129
+ * binding.
130
+ * @zh
131
+ * 显式保存到指定路径。原生自动保存独立进行,默认在设置变化后及上下文销毁时保存到 "imgui.ini"。
132
+ * 此绑定未暴露自动保存的文件名配置或禁用开关。
133
+ * @ja
134
+ * 指定したパスに明示的に保存します。ネイティブの自動保存は別に行われ、既定では設定変更後と
135
+ * コンテキスト破棄時に "imgui.ini" へ保存します。そのファイル名の設定や無効化はこのバインディングでは公開されていません。
136
+ * @ko
137
+ * 지정한 경로에 명시적으로 저장합니다. 네이티브 자동 저장은 별도로 동작하며, 기본적으로 설정 변경 후와
138
+ * 컨텍스트가 파괴될 때 "imgui.ini"에 저장합니다. 이 바인딩은 자동 저장 파일명 설정이나 비활성화 옵션을 노출하지 않습니다.
139
+ *
140
+ * @param ini_filename - Filesystem path of the ImGui settings file to load or
141
+ * save.
142
+ * @zh ini_filename - 要加载或保存的 ImGui 配置文件路径。
143
+ * @ja ini_filename - 読み込みまたは保存する ImGui 設定ファイルのパスです。
144
+ * @ko ini_filename - 읽거나 저장할 ImGui 설정 파일의 경로입니다.
145
+ */
146
+ export declare function SaveIniSettingsToDisk(ini_filename: string | Uint8Array): void;
147
+ /**
148
+ * Serialize interface settings as INI text.
149
+ *
150
+ * @zh 将界面设置序列化为 INI 文本。
151
+ * @ja インターフェイス設定を INI テキストに変換します。
152
+ * @ko 인터페이스 설정을 INI 텍스트로 직렬화합니다.
153
+ *
154
+ * @remarks
155
+ * Return INI data copied to a JS string without the native terminating NUL.
156
+ * Save the returned text using your own storage.
157
+ *
158
+ * If WantSaveIniSettings is set on the IO field view from
159
+ * ImGui.viewImGuiIO(ioHandle),
160
+ * save the data and clear that flag. This binding does not expose the native
161
+ * configuration needed to disable automatic file saving and use that workflow.
162
+ * @zh
163
+ * 返回复制为 JS 字符串的 INI 数据,不含原生末尾的 NUL。可自行保存返回的文本。
164
+ *
165
+ * 若 ImGui.viewImGuiIO(ioHandle) 返回的 IO 字段视图中 WantSaveIniSettings 已设置,
166
+ * 应保存数据并清除此标志。此绑定未暴露禁用自动文件保存、启用这一流程所需的原生配置。
167
+ * @ja
168
+ * INI データを JS 文字列にコピーして返します。ネイティブの終端 NUL は含みません。返されたテキストを独自に保存できます。
169
+ *
170
+ * ImGui.viewImGuiIO(ioHandle) の IO フィールドビューで WantSaveIniSettings が立っている場合は、
171
+ * 保存後にそのフラグを解除します。ただし、自動ファイル保存を無効化してこの方式を使うためのネイティブ設定は公開されていません。
172
+ * @ko
173
+ * INI 데이터를 JS 문자열로 복사해 반환하며 네이티브 끝 NUL은 포함하지 않습니다. 반환된 텍스트는 직접 저장할 수 있습니다.
174
+ *
175
+ * ImGui.viewImGuiIO(ioHandle)의 IO 필드 뷰에서 WantSaveIniSettings가 설정되어 있다면
176
+ * 데이터를 저장하고 해당 플래그를 해제하세요. 다만 자동 파일 저장을 끄고 이 방식을 사용하는 데 필요한 네이티브 설정은 노출되지 않습니다.
177
+ *
178
+ * @param out_ini_size - Optional BigUint64Array[0] output receiving the
179
+ * serialized byte length, excluding the NUL terminator. Pass BigUint64Array
180
+ * storage, not a JS scalar; native access uses the supplied backing memory.
181
+ * @zh out_ini_size - 可选的 BigUint64Array[0] 输出,接收不含 NUL 终止符的序列化字节长度。 请传入
182
+ * BigUint64Array 存储而非 JS 标量;原生代码直接访问所提供的底层内存。
183
+ * @ja out_ini_size - NUL を除く出力バイト長を書き込む任意の BigUint64Array[0] です。 JS スカラーではなく
184
+ * BigUint64Array を渡します。ネイティブ処理は渡された領域を直接使います。
185
+ * @ko out_ini_size - NUL 종료를 제외한 직렬화 바이트 길이를 받는 선택적 BigUint64Array[0] 출력입니다. JS
186
+ * 스칼라가 아닌 BigUint64Array 저장소를 전달합니다. 네이티브 코드는 제공된 메모리를 직접 사용합니다。
187
+ *
188
+ * @returns Serialized ImGui settings copied to a JS string; out_ini_size
189
+ * optionally receives the UTF-8 byte length.
190
+ * @zh 复制为 JS 字符串的序列化 ImGui 配置;out_ini_size 可接收 UTF-8 字节长度。
191
+ * @ja JS 文字列にコピーした ImGui 設定です。out_ini_size で UTF-8 バイト長も受け取れます。
192
+ * @ko JS 문자열로 복사한 직렬화 ImGui 설정입니다. out_ini_size는 선택적으로 UTF-8 바이트 길이를 받습니다.
193
+ */
194
+ export declare function SaveIniSettingsToMemory(out_ini_size?: BigUint64Array | null): string | null;
@@ -0,0 +1,216 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SaveIniSettingsToMemory = exports.SaveIniSettingsToDisk = exports.LoadIniSettingsFromMemory = exports.LoadIniSettingsFromDisk = exports.SetClipboardText = exports.GetClipboardText = void 0;
4
+ const native_1 = require("../internal/native");
5
+ /**
6
+ * Get text from the operating-system clipboard.
7
+ *
8
+ * @zh 获取操作系统剪贴板中的文本。
9
+ * @ja OS のクリップボードからテキストを取得します。
10
+ * @ko 운영체제 클립보드에서 텍스트를 가져옵니다.
11
+ *
12
+ * @remarks
13
+ * - Also see the LogToClipboard() function to capture GUI into clipboard, or
14
+ * easily output text data to the clipboard.
15
+ * @zh
16
+ * 剪贴板工具。
17
+ *
18
+ * - 另见 LogToClipboard(),可将 GUI 捕获到剪贴板,或便捷地将文本数据输出到剪贴板。
19
+ * @ja
20
+ * クリップボードユーティリティ。
21
+ *
22
+ * - GUI をクリップボードに取り込んだり、テキストデータを手軽に出力したりするには LogToClipboard() も参照してください。
23
+ * @ko
24
+ * 클립보드 유틸리티.
25
+ *
26
+ * - GUI를 클립보드로 캡처하거나 텍스트 데이터를 쉽게 출력하려면 LogToClipboard()도 참조하세요.
27
+ *
28
+ * @returns Clipboard text copied to a JS string, or null when the native
29
+ * clipboard getter returns no text.
30
+ * @zh 复制为 JS 字符串的剪贴板文字;原生剪贴板获取器没有返回文字时为 null。
31
+ * @ja JS 文字列へコピーしたクリップボード内容です。ネイティブが文字列を返さなければ null です。
32
+ * @ko JS 문자열로 복사한 클립보드 텍스트입니다. 네이티브 getter가 텍스트를 반환하지 않으면 null입니다.
33
+ */
34
+ function GetClipboardText() {
35
+ return native_1.native.GetClipboardText();
36
+ }
37
+ exports.GetClipboardText = GetClipboardText;
38
+ /**
39
+ * Replace the clipboard text through the configured platform clipboard handler.
40
+ *
41
+ * @zh 通过已配置的平台剪贴板处理器替换剪贴板文本。
42
+ * @ja 設定済みのプラットフォーム用クリップボード処理でクリップボードのテキストを置き換えます。
43
+ * @ko 설정된 플랫폼 클립보드 처리기를 통해 클립보드 텍스트를 바꿉니다.
44
+ *
45
+ * @param text - UTF-8 text to read. JS strings are encoded for this call; a
46
+ * nonempty Uint8Array ending in NUL is passed directly, otherwise its bytes are
47
+ * copied and NUL-terminated.
48
+ * @zh text - 要读取的 UTF-8 文本。JS 字符串为本次调用编码;非空且以 NUL 结束的 Uint8Array 直接传入,否则复制字节并补上
49
+ * NUL。
50
+ * @ja text - 読む UTF-8 テキストです。JS 文字列は変換し、空でない NUL 終端の Uint8Array
51
+ * は直接渡し、それ以外はコピーして NUL を付けます。
52
+ * @ko text - 읽을 UTF-8 텍스트입니다. JS 문자열은 인코딩됩니다. 비어 있지 않은 NUL 종료 Uint8Array는 직접
53
+ * 전달하며 나머지는 복사 후 NUL을 붙입니다.
54
+ */
55
+ function SetClipboardText(text) {
56
+ native_1.native.SetClipboardText(text);
57
+ }
58
+ exports.SetClipboardText = SetClipboardText;
59
+ /**
60
+ * Load interface settings from an INI file.
61
+ *
62
+ * @zh 从 INI 文件加载界面设置。
63
+ * @ja INI ファイルからインターフェイス設定を読み込みます。
64
+ * @ko INI 파일에서 인터페이스 설정을 불러옵니다.
65
+ *
66
+ * @remarks
67
+ * Call after SFML.Init(window) succeeds and before the first SFML.Update(...)
68
+ * to load settings from your chosen file.
69
+ *
70
+ * Native automatic persistence defaults to "imgui.ini", relative to the
71
+ * current working directory. This binding does not expose its filename
72
+ * configuration or a way to disable automatic saving. Loading a file here
73
+ * does not change the automatic save destination.
74
+ * @zh
75
+ * 在 SFML.Init(window) 成功之后、首次 SFML.Update(...) 之前调用,从指定文件加载设置。
76
+ *
77
+ * 原生自动持久化默认使用相对于当前工作目录的 "imgui.ini"。此绑定未暴露自动持久化的文件名配置,
78
+ * 也未提供禁用自动保存的方法。此处加载的文件不会改变自动保存的目标路径。
79
+ * @ja
80
+ * SFML.Init(window) が成功した後、最初の SFML.Update(...) より前に呼び、指定したファイルから設定を読み込みます。
81
+ *
82
+ * ネイティブの自動保存・読み込みは、作業ディレクトリからの相対パス "imgui.ini" を既定で使います。
83
+ * このバインディングには、そのファイル名の設定や自動保存を無効にする API はありません。
84
+ * ここで別のファイルを読み込んでも、自動保存先は変わりません。
85
+ * @ko
86
+ * SFML.Init(window)가 성공한 후 첫 SFML.Update(...) 전에 호출하여 지정한 파일에서 설정을 불러옵니다.
87
+ *
88
+ * 네이티브 자동 저장 및 불러오기는 현재 작업 디렉터리 기준 "imgui.ini"를 기본값으로 사용합니다.
89
+ * 이 바인딩은 해당 파일명 설정이나 자동 저장을 끄는 API를 노출하지 않습니다.
90
+ * 여기서 다른 파일을 불러와도 자동 저장 경로는 바뀌지 않습니다.
91
+ *
92
+ * @param ini_filename - Filesystem path of the ImGui settings file to load or
93
+ * save.
94
+ * @zh ini_filename - 要加载或保存的 ImGui 配置文件路径。
95
+ * @ja ini_filename - 読み込みまたは保存する ImGui 設定ファイルのパスです。
96
+ * @ko ini_filename - 읽거나 저장할 ImGui 설정 파일의 경로입니다.
97
+ */
98
+ function LoadIniSettingsFromDisk(ini_filename) {
99
+ native_1.native.LoadIniSettingsFromDisk(ini_filename);
100
+ }
101
+ exports.LoadIniSettingsFromDisk = LoadIniSettingsFromDisk;
102
+ /**
103
+ * Load interface settings from INI text in memory.
104
+ *
105
+ * @zh 从内存中的 INI 文本加载界面设置。
106
+ * @ja メモリ上の INI テキストからインターフェイス設定を読み込みます。
107
+ * @ko 메모리의 INI 텍스트에서 인터페이스 설정을 불러옵니다.
108
+ *
109
+ * @remarks
110
+ * Call after SFML.Init(window) succeeds and before the first SFML.Update(...)
111
+ * to provide INI data from your own data source.
112
+ * @zh
113
+ * 在 SFML.Init(window) 成功之后、首次 SFML.Update(...) 之前调用,以从自己的数据源提供 INI 数据。
114
+ * @ja
115
+ * 独自の INI データを渡すには、SFML.Init(window) の成功後、最初の SFML.Update(...) より前に呼びます。
116
+ * @ko
117
+ * 자체 INI 데이터를 제공하려면 SFML.Init(window)가 성공한 후 첫 SFML.Update(...) 전에 호출합니다.
118
+ *
119
+ * @param ini_data - UTF-8 serialized ImGui settings to load from memory.
120
+ * @zh ini_data - 要从内存加载的 UTF-8 序列化 ImGui 配置。
121
+ * @ja ini_data - メモリーから読み込む UTF-8 の ImGui 設定データです。
122
+ * @ko ini_data - 메모리에서 읽을 UTF-8 직렬화 ImGui 설정입니다.
123
+ *
124
+ * @param ini_size - Length of ini_data in bytes; 0 reads through its NUL
125
+ * terminator.
126
+ * @zh ini_size - ini_data 的字节长度;0 读取至 NUL 终止符。
127
+ * @ja ini_size - ini_data のバイト長です。0 は NUL 終端まで読みます。
128
+ * @ko ini_size - ini_data의 바이트 길이입니다. 0은 NUL 종료까지 읽습니다.
129
+ */
130
+ function LoadIniSettingsFromMemory(ini_data, ini_size = 0) {
131
+ native_1.native.LoadIniSettingsFromMemory(ini_data, ini_size);
132
+ }
133
+ exports.LoadIniSettingsFromMemory = LoadIniSettingsFromMemory;
134
+ /**
135
+ * Save interface settings to an INI file.
136
+ *
137
+ * @zh 将界面设置保存到 INI 文件。
138
+ * @ja インターフェイス設定を INI ファイルに保存します。
139
+ * @ko 인터페이스 설정을 INI 파일에 저장합니다.
140
+ *
141
+ * @remarks
142
+ * Save explicitly to the supplied path. Native automatic saving is separate:
143
+ * it saves to "imgui.ini" by default after settings change and when the context
144
+ * is destroyed. Its filename and disable switch are not exposed by this
145
+ * binding.
146
+ * @zh
147
+ * 显式保存到指定路径。原生自动保存独立进行,默认在设置变化后及上下文销毁时保存到 "imgui.ini"。
148
+ * 此绑定未暴露自动保存的文件名配置或禁用开关。
149
+ * @ja
150
+ * 指定したパスに明示的に保存します。ネイティブの自動保存は別に行われ、既定では設定変更後と
151
+ * コンテキスト破棄時に "imgui.ini" へ保存します。そのファイル名の設定や無効化はこのバインディングでは公開されていません。
152
+ * @ko
153
+ * 지정한 경로에 명시적으로 저장합니다. 네이티브 자동 저장은 별도로 동작하며, 기본적으로 설정 변경 후와
154
+ * 컨텍스트가 파괴될 때 "imgui.ini"에 저장합니다. 이 바인딩은 자동 저장 파일명 설정이나 비활성화 옵션을 노출하지 않습니다.
155
+ *
156
+ * @param ini_filename - Filesystem path of the ImGui settings file to load or
157
+ * save.
158
+ * @zh ini_filename - 要加载或保存的 ImGui 配置文件路径。
159
+ * @ja ini_filename - 読み込みまたは保存する ImGui 設定ファイルのパスです。
160
+ * @ko ini_filename - 읽거나 저장할 ImGui 설정 파일의 경로입니다.
161
+ */
162
+ function SaveIniSettingsToDisk(ini_filename) {
163
+ native_1.native.SaveIniSettingsToDisk(ini_filename);
164
+ }
165
+ exports.SaveIniSettingsToDisk = SaveIniSettingsToDisk;
166
+ /**
167
+ * Serialize interface settings as INI text.
168
+ *
169
+ * @zh 将界面设置序列化为 INI 文本。
170
+ * @ja インターフェイス設定を INI テキストに変換します。
171
+ * @ko 인터페이스 설정을 INI 텍스트로 직렬화합니다.
172
+ *
173
+ * @remarks
174
+ * Return INI data copied to a JS string without the native terminating NUL.
175
+ * Save the returned text using your own storage.
176
+ *
177
+ * If WantSaveIniSettings is set on the IO field view from
178
+ * ImGui.viewImGuiIO(ioHandle),
179
+ * save the data and clear that flag. This binding does not expose the native
180
+ * configuration needed to disable automatic file saving and use that workflow.
181
+ * @zh
182
+ * 返回复制为 JS 字符串的 INI 数据,不含原生末尾的 NUL。可自行保存返回的文本。
183
+ *
184
+ * 若 ImGui.viewImGuiIO(ioHandle) 返回的 IO 字段视图中 WantSaveIniSettings 已设置,
185
+ * 应保存数据并清除此标志。此绑定未暴露禁用自动文件保存、启用这一流程所需的原生配置。
186
+ * @ja
187
+ * INI データを JS 文字列にコピーして返します。ネイティブの終端 NUL は含みません。返されたテキストを独自に保存できます。
188
+ *
189
+ * ImGui.viewImGuiIO(ioHandle) の IO フィールドビューで WantSaveIniSettings が立っている場合は、
190
+ * 保存後にそのフラグを解除します。ただし、自動ファイル保存を無効化してこの方式を使うためのネイティブ設定は公開されていません。
191
+ * @ko
192
+ * INI 데이터를 JS 문자열로 복사해 반환하며 네이티브 끝 NUL은 포함하지 않습니다. 반환된 텍스트는 직접 저장할 수 있습니다.
193
+ *
194
+ * ImGui.viewImGuiIO(ioHandle)의 IO 필드 뷰에서 WantSaveIniSettings가 설정되어 있다면
195
+ * 데이터를 저장하고 해당 플래그를 해제하세요. 다만 자동 파일 저장을 끄고 이 방식을 사용하는 데 필요한 네이티브 설정은 노출되지 않습니다.
196
+ *
197
+ * @param out_ini_size - Optional BigUint64Array[0] output receiving the
198
+ * serialized byte length, excluding the NUL terminator. Pass BigUint64Array
199
+ * storage, not a JS scalar; native access uses the supplied backing memory.
200
+ * @zh out_ini_size - 可选的 BigUint64Array[0] 输出,接收不含 NUL 终止符的序列化字节长度。 请传入
201
+ * BigUint64Array 存储而非 JS 标量;原生代码直接访问所提供的底层内存。
202
+ * @ja out_ini_size - NUL を除く出力バイト長を書き込む任意の BigUint64Array[0] です。 JS スカラーではなく
203
+ * BigUint64Array を渡します。ネイティブ処理は渡された領域を直接使います。
204
+ * @ko out_ini_size - NUL 종료를 제외한 직렬화 바이트 길이를 받는 선택적 BigUint64Array[0] 출력입니다. JS
205
+ * 스칼라가 아닌 BigUint64Array 저장소를 전달합니다. 네이티브 코드는 제공된 메모리를 직접 사용합니다。
206
+ *
207
+ * @returns Serialized ImGui settings copied to a JS string; out_ini_size
208
+ * optionally receives the UTF-8 byte length.
209
+ * @zh 复制为 JS 字符串的序列化 ImGui 配置;out_ini_size 可接收 UTF-8 字节长度。
210
+ * @ja JS 文字列にコピーした ImGui 設定です。out_ini_size で UTF-8 バイト長も受け取れます。
211
+ * @ko JS 문자열로 복사한 직렬화 ImGui 설정입니다. out_ini_size는 선택적으로 UTF-8 바이트 길이를 받습니다.
212
+ */
213
+ function SaveIniSettingsToMemory(out_ini_size = null) {
214
+ return native_1.native.SaveIniSettingsToMemory(out_ini_size);
215
+ }
216
+ exports.SaveIniSettingsToMemory = SaveIniSettingsToMemory;