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,726 @@
1
+ import type { ImVec2Like, ImFont, ImFontAtlas, ImFontAtlasCustomRect, ImFontConfig } from '../types';
2
+ /**
3
+ * Register a configured font source for the next atlas build.
4
+ *
5
+ * @zh 注册配置好的字体源,供下一次图集构建使用。
6
+ * @ja 次のアトラス構築に向けて、設定済みのフォントソースを登録します。
7
+ * @ko 다음 아틀라스 빌드를 위해 설정된 글꼴 소스를 등록합니다.
8
+ *
9
+ * @param self - ImFontAtlas handle on which this method operates.
10
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
11
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
12
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
13
+ *
14
+ * @param font_cfg - Font-loading configuration; optional variants accept null
15
+ * for defaults. Ownership and merge settings affect how font data is retained.
16
+ * @zh font_cfg - 字体加载配置;可选版本接受 null 使用默认值,所有权和合并设置会影响字体数据的保留方式。
17
+ * @ja font_cfg - フォント読み込み設定です。任意指定の版では null で既定値を使い、所有権やマージ設定がデータ保持に影響します。
18
+ * @ko font_cfg - 글꼴 로딩 설정입니다. 선택적인 경우 null은 기본값이며 소유권과 병합 설정이 데이터 유지 방식에 영향을
19
+ * 줍니다.
20
+ *
21
+ * @returns Atlas-owned font handle (the destination font in merge mode). Glyphs
22
+ * become available after atlas building; invalid input may trigger native
23
+ * assertions.
24
+ * @zh 图集拥有的字体句柄,合并模式下为目标字体。图集构建后字形才可用;无效输入可能触发原生断言。
25
+ * @ja アトラス所有のフォント(マージ時は対象フォント)です。グリフは構築後に利用でき、不正入力はアサートを起こし得ます。
26
+ * @ko 아틀라스 소유 글꼴 핸들입니다. 병합 모드에서는 대상 글꼴입니다. 글리프는 빌드 후 사용할 수 있으며 잘못된 입력은 어설션을 유발할
27
+ * 수 있습니다.
28
+ */
29
+ export declare function ImFontAtlas_AddFont(self: ImFontAtlas, font_cfg: ImFontConfig): ImFont | null;
30
+ /**
31
+ * Add the embedded default font to the atlas.
32
+ *
33
+ * @zh 向图集添加内嵌的默认字体。
34
+ * @ja 内蔵の既定フォントをアトラスに追加します。
35
+ * @ko 아틀라스에 내장 기본 글꼴을 추가합니다.
36
+ *
37
+ * @param self - ImFontAtlas handle on which this method operates.
38
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
39
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
40
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
41
+ *
42
+ * @param font_cfg - Font-loading configuration; optional variants accept null
43
+ * for defaults. Ownership and merge settings affect how font data is retained.
44
+ * @zh font_cfg - 字体加载配置;可选版本接受 null 使用默认值,所有权和合并设置会影响字体数据的保留方式。
45
+ * @ja font_cfg - フォント読み込み設定です。任意指定の版では null で既定値を使い、所有権やマージ設定がデータ保持に影響します。
46
+ * @ko font_cfg - 글꼴 로딩 설정입니다. 선택적인 경우 null은 기본값이며 소유권과 병합 설정이 데이터 유지 방식에 영향을
47
+ * 줍니다.
48
+ *
49
+ * @returns Atlas-owned font handle (the destination font in merge mode). Glyphs
50
+ * become available after atlas building; invalid input may trigger native
51
+ * assertions.
52
+ * @zh 图集拥有的字体句柄,合并模式下为目标字体。图集构建后字形才可用;无效输入可能触发原生断言。
53
+ * @ja アトラス所有のフォント(マージ時は対象フォント)です。グリフは構築後に利用でき、不正入力はアサートを起こし得ます。
54
+ * @ko 아틀라스 소유 글꼴 핸들입니다. 병합 모드에서는 대상 글꼴입니다. 글리프는 빌드 후 사용할 수 있으며 잘못된 입력은 어설션을 유발할
55
+ * 수 있습니다.
56
+ */
57
+ export declare function ImFontAtlas_AddFontDefault(self: ImFontAtlas, font_cfg?: ImFontConfig | null): ImFont | null;
58
+ /**
59
+ * Load a TTF or OTF font file and register it for atlas building.
60
+ *
61
+ * @zh 加载 TTF 或 OTF 字体文件,并注册供图集构建使用。
62
+ * @ja TTF または OTF フォントファイルを読み込み、アトラス構築用に登録します。
63
+ * @ko TTF 또는 OTF 글꼴 파일을 읽고 아틀라스 빌드를 위해 등록합니다.
64
+ *
65
+ * @param self - ImFontAtlas handle on which this method operates.
66
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
67
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
68
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
69
+ *
70
+ * @param filename - Filesystem path of the TTF/OTF font file.
71
+ * @zh filename - TTF/OTF 字体文件的路径。
72
+ * @ja filename - TTF/OTF フォントファイルのパスです。
73
+ * @ko filename - TTF/OTF 글꼴 파일 경로입니다。
74
+ *
75
+ * @param size_pixels - Requested font height in pixels.
76
+ * @zh size_pixels - 请求的字体像素高度。
77
+ * @ja size_pixels - 要求するフォントのピクセル高さです。
78
+ * @ko size_pixels - 요청하는 글꼴 픽셀 높이입니다.
79
+ *
80
+ * @param font_cfg - Font-loading configuration; optional variants accept null
81
+ * for defaults. Ownership and merge settings affect how font data is retained.
82
+ * @zh font_cfg - 字体加载配置;可选版本接受 null 使用默认值,所有权和合并设置会影响字体数据的保留方式。
83
+ * @ja font_cfg - フォント読み込み設定です。任意指定の版では null で既定値を使い、所有権やマージ設定がデータ保持に影響します。
84
+ * @ko font_cfg - 글꼴 로딩 설정입니다. 선택적인 경우 null은 기본값이며 소유권과 병합 설정이 데이터 유지 방식에 영향을
85
+ * 줍니다.
86
+ *
87
+ * @param glyph_ranges - Uint16Array of inclusive [first, last] pairs followed
88
+ * by 0.
89
+ * getGlyphRanges* helpers omit that terminator: append it explicitly with
90
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])`.
91
+ * Keep this input alive until atlas build; null selects default ranges.
92
+ * @zh glyph_ranges - 包含首尾的 [first, last] 范围对 Uint16Array,末尾须加 0。getGlyphRanges*
93
+ * 不含终止零值,
94
+ * 须用 `new Uint16Array([...getGlyphRangesDefault(atlas), 0])` 显式补上。
95
+ * 图集构建前须保持输入有效;null 选择默认范围。
96
+ * @ja glyph_ranges - 両端を含む [first, last] ペアを 0 で終端した Uint16Array
97
+ * です。getGlyphRanges* は終端 0 を含まないため、
98
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])` で明示的に追加します。
99
+ * アトラス構築まで保持します。null は既定範囲を使います。
100
+ * @ko glyph_ranges - 양 끝을 포함하는 [first, last] 쌍과 끝의 0으로 구성된 Uint16Array입니다.
101
+ * getGlyphRanges*는 종료 0을 제외하므로
102
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])`으로 명시적으로 추가하세요.
103
+ * 아틀라스 빌드까지 유지하세요. null은 기본 범위를 선택합니다.
104
+ *
105
+ * @returns Atlas-owned font handle, or null if the font file cannot be loaded.
106
+ * Glyphs become available after atlas building.
107
+ * @zh 图集拥有的字体句柄;字体文件无法加载时为 null。图集构建后字形才可用。
108
+ * @ja アトラス所有のフォントです。ファイルを読み込めなければ null です。グリフは構築後に利用できます。
109
+ * @ko 아틀라스 소유 글꼴 핸들입니다. 파일을 읽을 수 없으면 null입니다. 글리프는 빌드 후 사용할 수 있습니다.
110
+ */
111
+ export declare function ImFontAtlas_AddFontFromFileTTF(self: ImFontAtlas, filename: string | Uint8Array, size_pixels: number, font_cfg?: ImFontConfig | null, glyph_ranges?: Uint16Array | null): ImFont | null;
112
+ /**
113
+ * Add a font from uncompressed TrueType data in memory.
114
+ *
115
+ * @zh 从内存中的未压缩 TrueType 数据添加字体。
116
+ * @ja メモリ上の非圧縮 TrueType データからフォントを追加します。
117
+ * @ko 메모리의 압축되지 않은 TrueType 데이터에서 글꼴을 추가합니다.
118
+ *
119
+ * @remarks
120
+ * Note: Transfer ownership of 'ttf_data' to ImFontAtlas!
121
+ *
122
+ * Will be deleted after destruction of the atlas.
123
+ *
124
+ * Set font_cfg->FontDataOwnedByAtlas=false to keep ownership of your data and
125
+ * it won't be freed.
126
+ * @zh
127
+ * 注意:将 'ttf_data' 所有权转移给 ImFontAtlas!
128
+ *
129
+ * 图集销毁后会删除该数据。
130
+ *
131
+ * 设置 font_cfg->FontDataOwnedByAtlas=false 可保留数据所有权,避免数据被释放。
132
+ * @ja
133
+ * 注意:'ttf_data' の所有権は ImFontAtlas に移ります!
134
+ *
135
+ * アトラスの破棄後に削除されます。
136
+ *
137
+ * font_cfg->FontDataOwnedByAtlas=false にすると所有権を保持し、データは解放されません。
138
+ * @ko
139
+ * 참고: 'ttf_data'의 소유권을 ImFontAtlas로 이전합니다!
140
+ *
141
+ * 아틀라스 소멸 후 삭제됩니다.
142
+ *
143
+ * font_cfg->FontDataOwnedByAtlas=false로 설정하면 데이터 소유권을 유지하며 데이터가 해제되지 않습니다.
144
+ *
145
+ * @param self - ImFontAtlas handle on which this method operates.
146
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
147
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
148
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
149
+ *
150
+ * @param font_data - Address of TTF/OTF bytes. By default the atlas takes
151
+ * ownership and frees them; set FontDataOwnedByAtlas=false to retain ownership
152
+ * and keep the memory alive.
153
+ * @zh font_data - TTF/OTF 字节地址。图集默认取得所有权并释放它们;设 FontDataOwnedByAtlas=false
154
+ * 可保留所有权,但须保持内存有效。
155
+ * @ja font_data - TTF/OTF
156
+ * バイトのアドレスです。既定ではアトラスが所有・解放します。FontDataOwnedByAtlas=false なら呼び出し側で寿命を管理します。
157
+ * @ko font_data - TTF/OTF 바이트 주소입니다. 기본적으로 아틀라스가 소유하고 해제합니다.
158
+ * FontDataOwnedByAtlas=false이면 호출자가 소유권과 메모리 수명을 관리합니다.
159
+ *
160
+ * @param font_data_size - Byte length of the supplied font data.
161
+ * @zh font_data_size - 所提供字体数据的字节长度。
162
+ * @ja font_data_size - 渡すフォントデータのバイト長です。
163
+ * @ko font_data_size - 제공한 글꼴 데이터의 바이트 길이입니다.
164
+ *
165
+ * @param size_pixels - Requested font height in pixels.
166
+ * @zh size_pixels - 请求的字体像素高度。
167
+ * @ja size_pixels - 要求するフォントのピクセル高さです。
168
+ * @ko size_pixels - 요청하는 글꼴 픽셀 높이입니다.
169
+ *
170
+ * @param font_cfg - Font-loading configuration; optional variants accept null
171
+ * for defaults. Ownership and merge settings affect how font data is retained.
172
+ * @zh font_cfg - 字体加载配置;可选版本接受 null 使用默认值,所有权和合并设置会影响字体数据的保留方式。
173
+ * @ja font_cfg - フォント読み込み設定です。任意指定の版では null で既定値を使い、所有権やマージ設定がデータ保持に影響します。
174
+ * @ko font_cfg - 글꼴 로딩 설정입니다. 선택적인 경우 null은 기본값이며 소유권과 병합 설정이 데이터 유지 방식에 영향을
175
+ * 줍니다.
176
+ *
177
+ * @param glyph_ranges - Uint16Array of inclusive [first, last] pairs followed
178
+ * by 0.
179
+ * getGlyphRanges* helpers omit that terminator: append it explicitly with
180
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])`.
181
+ * Keep this input alive until atlas build; null selects default ranges.
182
+ * @zh glyph_ranges - 包含首尾的 [first, last] 范围对 Uint16Array,末尾须加 0。getGlyphRanges*
183
+ * 不含终止零值,
184
+ * 须用 `new Uint16Array([...getGlyphRangesDefault(atlas), 0])` 显式补上。
185
+ * 图集构建前须保持输入有效;null 选择默认范围。
186
+ * @ja glyph_ranges - 両端を含む [first, last] ペアを 0 で終端した Uint16Array
187
+ * です。getGlyphRanges* は終端 0 を含まないため、
188
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])` で明示的に追加します。
189
+ * アトラス構築まで保持します。null は既定範囲を使います。
190
+ * @ko glyph_ranges - 양 끝을 포함하는 [first, last] 쌍과 끝의 0으로 구성된 Uint16Array입니다.
191
+ * getGlyphRanges*는 종료 0을 제외하므로
192
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])`으로 명시적으로 추가하세요.
193
+ * 아틀라스 빌드까지 유지하세요. null은 기본 범위를 선택합니다.
194
+ *
195
+ * @returns Atlas-owned font handle (the destination font in merge mode). Glyphs
196
+ * become available after atlas building; invalid input may trigger native
197
+ * assertions.
198
+ * @zh 图集拥有的字体句柄,合并模式下为目标字体。图集构建后字形才可用;无效输入可能触发原生断言。
199
+ * @ja アトラス所有のフォント(マージ時は対象フォント)です。グリフは構築後に利用でき、不正入力はアサートを起こし得ます。
200
+ * @ko 아틀라스 소유 글꼴 핸들입니다. 병합 모드에서는 대상 글꼴입니다. 글리프는 빌드 후 사용할 수 있으며 잘못된 입력은 어설션을 유발할
201
+ * 수 있습니다.
202
+ */
203
+ export declare function ImFontAtlas_AddFontFromMemoryTTF(self: ImFontAtlas, font_data: bigint | null, font_data_size: number, size_pixels: number, font_cfg?: ImFontConfig | null, glyph_ranges?: Uint16Array | null): ImFont | null;
204
+ /**
205
+ * Add a font from compressed TrueType data in memory.
206
+ *
207
+ * @zh 从内存中的压缩 TrueType 数据添加字体。
208
+ * @ja メモリ上の圧縮 TrueType データからフォントを追加します。
209
+ * @ko 메모리의 압축된 TrueType 데이터에서 글꼴을 추가합니다.
210
+ *
211
+ * @remarks
212
+ * 'compressed_font_data' still owned by caller.
213
+ *
214
+ * Compress with binary_to_compressed_c.cpp.
215
+ * @zh
216
+ * 'compressed_font_data' 仍由调用方持有。
217
+ *
218
+ * 使用 binary_to_compressed_c.cpp 压缩。
219
+ * @ja
220
+ * 'compressed_font_data' の所有権は呼び出し元に残ります。
221
+ *
222
+ * binary_to_compressed_c.cpp で圧縮します。
223
+ * @ko
224
+ * 'compressed_font_data'는 계속 호출자가 소유합니다.
225
+ *
226
+ * binary_to_compressed_c.cpp로 압축합니다.
227
+ *
228
+ * @param self - ImFontAtlas handle on which this method operates.
229
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
230
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
231
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
232
+ *
233
+ * @param compressed_font_data - Address of stb-compressed font bytes; these
234
+ * compressed input bytes are not transferred to atlas ownership.
235
+ * @zh compressed_font_data - stb 压缩字体字节地址;这些压缩输入字节不会转移给图集所有。
236
+ * @ja compressed_font_data - stb 圧縮フォントのアドレスです。圧縮入力の所有権はアトラスへ移りません。
237
+ * @ko compressed_font_data - stb 압축 글꼴 바이트 주소입니다. 압축 입력의 소유권은 아틀라스로 이전되지 않습니다.
238
+ *
239
+ * @param compressed_font_data_size - Byte length of the supplied font data.
240
+ * @zh compressed_font_data_size - 所提供字体数据的字节长度。
241
+ * @ja compressed_font_data_size - 渡すフォントデータのバイト長です。
242
+ * @ko compressed_font_data_size - 제공한 글꼴 데이터의 바이트 길이입니다.
243
+ *
244
+ * @param size_pixels - Requested font height in pixels.
245
+ * @zh size_pixels - 请求的字体像素高度。
246
+ * @ja size_pixels - 要求するフォントのピクセル高さです。
247
+ * @ko size_pixels - 요청하는 글꼴 픽셀 높이입니다.
248
+ *
249
+ * @param font_cfg - Font-loading configuration; optional variants accept null
250
+ * for defaults. Ownership and merge settings affect how font data is retained.
251
+ * @zh font_cfg - 字体加载配置;可选版本接受 null 使用默认值,所有权和合并设置会影响字体数据的保留方式。
252
+ * @ja font_cfg - フォント読み込み設定です。任意指定の版では null で既定値を使い、所有権やマージ設定がデータ保持に影響します。
253
+ * @ko font_cfg - 글꼴 로딩 설정입니다. 선택적인 경우 null은 기본값이며 소유권과 병합 설정이 데이터 유지 방식에 영향을
254
+ * 줍니다.
255
+ *
256
+ * @param glyph_ranges - Uint16Array of inclusive [first, last] pairs followed
257
+ * by 0.
258
+ * getGlyphRanges* helpers omit that terminator: append it explicitly with
259
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])`.
260
+ * Keep this input alive until atlas build; null selects default ranges.
261
+ * @zh glyph_ranges - 包含首尾的 [first, last] 范围对 Uint16Array,末尾须加 0。getGlyphRanges*
262
+ * 不含终止零值,
263
+ * 须用 `new Uint16Array([...getGlyphRangesDefault(atlas), 0])` 显式补上。
264
+ * 图集构建前须保持输入有效;null 选择默认范围。
265
+ * @ja glyph_ranges - 両端を含む [first, last] ペアを 0 で終端した Uint16Array
266
+ * です。getGlyphRanges* は終端 0 を含まないため、
267
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])` で明示的に追加します。
268
+ * アトラス構築まで保持します。null は既定範囲を使います。
269
+ * @ko glyph_ranges - 양 끝을 포함하는 [first, last] 쌍과 끝의 0으로 구성된 Uint16Array입니다.
270
+ * getGlyphRanges*는 종료 0을 제외하므로
271
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])`으로 명시적으로 추가하세요.
272
+ * 아틀라스 빌드까지 유지하세요. null은 기본 범위를 선택합니다.
273
+ *
274
+ * @returns Atlas-owned font handle (the destination font in merge mode). Glyphs
275
+ * become available after atlas building; invalid input may trigger native
276
+ * assertions.
277
+ * @zh 图集拥有的字体句柄,合并模式下为目标字体。图集构建后字形才可用;无效输入可能触发原生断言。
278
+ * @ja アトラス所有のフォント(マージ時は対象フォント)です。グリフは構築後に利用でき、不正入力はアサートを起こし得ます。
279
+ * @ko 아틀라스 소유 글꼴 핸들입니다. 병합 모드에서는 대상 글꼴입니다. 글리프는 빌드 후 사용할 수 있으며 잘못된 입력은 어설션을 유발할
280
+ * 수 있습니다.
281
+ */
282
+ export declare function ImFontAtlas_AddFontFromMemoryCompressedTTF(self: ImFontAtlas, compressed_font_data: bigint | null, compressed_font_data_size: number, size_pixels: number, font_cfg?: ImFontConfig | null, glyph_ranges?: Uint16Array | null): ImFont | null;
283
+ /**
284
+ * Add a font from Base85-encoded compressed TrueType data.
285
+ *
286
+ * @zh 从 Base85 编码的压缩 TrueType 数据添加字体。
287
+ * @ja Base85 エンコードされた圧縮 TrueType データからフォントを追加します。
288
+ * @ko Base85로 인코딩된 압축 TrueType 데이터에서 글꼴을 추가합니다.
289
+ *
290
+ * @remarks
291
+ * 'compressed_font_data_base85' still owned by caller.
292
+ *
293
+ * Compress with binary_to_compressed_c.cpp with -base85 parameter.
294
+ * @zh
295
+ * 'compressed_font_data_base85' 仍由调用方持有。
296
+ *
297
+ * 使用 binary_to_compressed_c.cpp 并传入 -base85 参数压缩。
298
+ * @ja
299
+ * 'compressed_font_data_base85' の所有権は呼び出し元に残ります。
300
+ *
301
+ * binary_to_compressed_c.cpp に -base85 引数を指定して圧縮します。
302
+ * @ko
303
+ * 'compressed_font_data_base85'는 계속 호출자가 소유합니다.
304
+ *
305
+ * binary_to_compressed_c.cpp에 -base85 인수를 전달하여 압축합니다.
306
+ *
307
+ * @param self - ImFontAtlas handle on which this method operates.
308
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
309
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
310
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
311
+ *
312
+ * @param compressed_font_data_base85 - NUL-terminated Base85 text encoding
313
+ * stb-compressed font data.
314
+ * @zh compressed_font_data_base85 - 以 NUL 结尾、编码 stb 压缩字体数据的 Base85 文本。
315
+ * @ja compressed_font_data_base85 - stb 圧縮フォントを Base85 で表す NUL 終端テキストです。
316
+ * @ko compressed_font_data_base85 - stb 압축 글꼴 데이터를 Base85로 인코딩한 NUL 종료 텍스트입니다.
317
+ *
318
+ * @param size_pixels - Requested font height in pixels.
319
+ * @zh size_pixels - 请求的字体像素高度。
320
+ * @ja size_pixels - 要求するフォントのピクセル高さです。
321
+ * @ko size_pixels - 요청하는 글꼴 픽셀 높이입니다.
322
+ *
323
+ * @param font_cfg - Font-loading configuration; optional variants accept null
324
+ * for defaults. Ownership and merge settings affect how font data is retained.
325
+ * @zh font_cfg - 字体加载配置;可选版本接受 null 使用默认值,所有权和合并设置会影响字体数据的保留方式。
326
+ * @ja font_cfg - フォント読み込み設定です。任意指定の版では null で既定値を使い、所有権やマージ設定がデータ保持に影響します。
327
+ * @ko font_cfg - 글꼴 로딩 설정입니다. 선택적인 경우 null은 기본값이며 소유권과 병합 설정이 데이터 유지 방식에 영향을
328
+ * 줍니다.
329
+ *
330
+ * @param glyph_ranges - Uint16Array of inclusive [first, last] pairs followed
331
+ * by 0.
332
+ * getGlyphRanges* helpers omit that terminator: append it explicitly with
333
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])`.
334
+ * Keep this input alive until atlas build; null selects default ranges.
335
+ * @zh glyph_ranges - 包含首尾的 [first, last] 范围对 Uint16Array,末尾须加 0。getGlyphRanges*
336
+ * 不含终止零值,
337
+ * 须用 `new Uint16Array([...getGlyphRangesDefault(atlas), 0])` 显式补上。
338
+ * 图集构建前须保持输入有效;null 选择默认范围。
339
+ * @ja glyph_ranges - 両端を含む [first, last] ペアを 0 で終端した Uint16Array
340
+ * です。getGlyphRanges* は終端 0 を含まないため、
341
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])` で明示的に追加します。
342
+ * アトラス構築まで保持します。null は既定範囲を使います。
343
+ * @ko glyph_ranges - 양 끝을 포함하는 [first, last] 쌍과 끝의 0으로 구성된 Uint16Array입니다.
344
+ * getGlyphRanges*는 종료 0을 제외하므로
345
+ * `new Uint16Array([...getGlyphRangesDefault(atlas), 0])`으로 명시적으로 추가하세요.
346
+ * 아틀라스 빌드까지 유지하세요. null은 기본 범위를 선택합니다.
347
+ *
348
+ * @returns Atlas-owned font handle (the destination font in merge mode). Glyphs
349
+ * become available after atlas building; invalid input may trigger native
350
+ * assertions.
351
+ * @zh 图集拥有的字体句柄,合并模式下为目标字体。图集构建后字形才可用;无效输入可能触发原生断言。
352
+ * @ja アトラス所有のフォント(マージ時は対象フォント)です。グリフは構築後に利用でき、不正入力はアサートを起こし得ます。
353
+ * @ko 아틀라스 소유 글꼴 핸들입니다. 병합 모드에서는 대상 글꼴입니다. 글리프는 빌드 후 사용할 수 있으며 잘못된 입력은 어설션을 유발할
354
+ * 수 있습니다.
355
+ */
356
+ export declare function ImFontAtlas_AddFontFromMemoryCompressedBase85TTF(self: ImFontAtlas, compressed_font_data_base85: string | Uint8Array, size_pixels: number, font_cfg?: ImFontConfig | null, glyph_ranges?: Uint16Array | null): ImFont | null;
357
+ /**
358
+ * Clear the font atlas input data.
359
+ *
360
+ * @zh 清空字体图集的输入数据。
361
+ * @ja フォントアトラスの入力データを消去します。
362
+ * @ko 글꼴 아틀라스 입력 데이터를 비웁니다.
363
+ *
364
+ * @remarks
365
+ * Clear input data (all ImFontConfig structures including sizes, TTF data,
366
+ * glyph ranges, etc.) = all the data used to build the texture and fonts.
367
+ * @zh
368
+ * 清除输入数据(所有 ImFontConfig 结构,包括尺寸、TTF 数据、字形范围等),即构建纹理和字体所用的全部数据。
369
+ * @ja
370
+ * 入力データ(サイズ、TTF データ、グリフ範囲などを含むすべての ImFontConfig
371
+ * 構造体)、つまりテクスチャとフォントの構築に使う全データを消去します。
372
+ * @ko
373
+ * 입력 데이터(크기, TTF 데이터, 글리프 범위 등을 포함한 모든 ImFontConfig 구조체), 즉 텍스처와 폰트 구축에 쓰인 모든
374
+ * 데이터를 지웁니다.
375
+ *
376
+ * @param self - ImFontAtlas handle on which this method operates.
377
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
378
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
379
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
380
+ */
381
+ export declare function ImFontAtlas_ClearInputData(self: ImFontAtlas): void;
382
+ /**
383
+ * Clear input and output font data.
384
+ *
385
+ * @zh 清空字体的输入和输出数据。
386
+ * @ja フォントの入力および出力データを消去します。
387
+ * @ko 글꼴 입력 및 출력 데이터를 비웁니다.
388
+ *
389
+ * @remarks
390
+ * Clear input and output font data (same as ImFontAtlas_ClearInputData(self)
391
+ * plus glyph storage and UV
392
+ * coordinates).
393
+ * @zh
394
+ * 清除字体输入和输出数据(等同于 ImFontAtlas_ClearInputData(self),再加上字形存储和 UV 坐标)。
395
+ * @ja
396
+ * フォントの入力と出力データを消去します(ImFontAtlas_ClearInputData(self) とグリフのストレージ、UV 座標の消去に相当)。
397
+ * @ko
398
+ * 폰트 입력 및 출력 데이터를 지웁니다(ImFontAtlas_ClearInputData(self)와 글리프 저장소, UV 좌표 삭제에
399
+ * 해당).
400
+ *
401
+ * @param self - ImFontAtlas handle on which this method operates.
402
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
403
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
404
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
405
+ */
406
+ export declare function ImFontAtlas_ClearFonts(self: ImFontAtlas): void;
407
+ /**
408
+ * Clear output texture data (CPU side).
409
+ *
410
+ * @zh 清除输出纹理数据(CPU 侧)。
411
+ * @ja 出力テクスチャデータ(CPU 側)を消去します。
412
+ * @ko 출력 텍스처 데이터(CPU 측)를 지웁니다.
413
+ *
414
+ * @remarks
415
+ * Saves RAM once the texture has been copied to graphics memory.
416
+ * @zh
417
+ * 在纹理复制到显存后可节省 RAM。
418
+ * @ja
419
+ * テクスチャをグラフィックスメモリに転送した後に RAM を節約できます。
420
+ * @ko
421
+ * 텍스처를 그래픽 메모리로 복사한 후 RAM을 절약합니다.
422
+ *
423
+ * @param self - ImFontAtlas handle on which this method operates.
424
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
425
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
426
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
427
+ */
428
+ export declare function ImFontAtlas_ClearTexData(self: ImFontAtlas): void;
429
+ /**
430
+ * Clear all input and output.
431
+ *
432
+ * @zh 清除全部输入和输出。
433
+ * @ja すべての入力と出力を消去します。
434
+ * @ko 모든 입력과 출력을 지웁니다.
435
+ *
436
+ * @param self - ImFontAtlas handle on which this method operates.
437
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
438
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
439
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
440
+ */
441
+ export declare function ImFontAtlas_Clear(self: ImFontAtlas): void;
442
+ /**
443
+ * Build the font atlas and its texture data.
444
+ *
445
+ * @zh 构建字体图集及其纹理数据。
446
+ * @ja フォントアトラスとテクスチャデータを構築します。
447
+ * @ko 글꼴 아틀라스와 텍스처 데이터를 빌드합니다.
448
+ *
449
+ * @remarks
450
+ * Builds the atlas pixel data. FontAtlas_GetTexDataAsAlpha8(self) and
451
+ * FontAtlas_GetTexDataAsRGBA32(self) call this automatically when needed.
452
+ *
453
+ * - Upload the pixels to graphics memory, then store the texture handle with
454
+ * `ImFontAtlas_SetTexID(self, textureId)`.
455
+ * - Row pitch is `Width * BytesPerPixel`; supported output formats use 1 or 4
456
+ * bytes per pixel.
457
+ * - RGBA32 is provided for compatibility and convenience. Unless custom colored
458
+ * data is written, such as through the custom-rectangle API, its RGB channels
459
+ * are white and account for roughly 75% of the memory and bandwidth.
460
+ * @zh
461
+ * 构建图集像素数据。FontAtlas_GetTexDataAsAlpha8(self) 和
462
+ * FontAtlas_GetTexDataAsRGBA32(self)
463
+ * 会在需要时自动调用此函数。
464
+ *
465
+ * - 将像素上传到显存,再使用 `ImFontAtlas_SetTexID(self, textureId)` 保存纹理标识符。
466
+ * - 行跨度为 `Width * BytesPerPixel`,支持的输出格式每像素使用 1 或 4 字节。
467
+ * - RGBA32 用于兼容和便利。除非通过自定义矩形等接口写入彩色数据,否则 RGB 通道均为白色,约占 75% 的内存和带宽。
468
+ * @ja
469
+ * アトラスのピクセルデータを構築します。FontAtlas_GetTexDataAsAlpha8(self) と
470
+ * FontAtlas_GetTexDataAsRGBA32(self)
471
+ * は必要に応じて自動的に呼び出します。
472
+ *
473
+ * - ピクセルをグラフィックスメモリに転送し、`ImFontAtlas_SetTexID(self, textureId)` でテクスチャ ID
474
+ * を保存します。
475
+ * - 行ピッチは `Width * BytesPerPixel` です。対応する出力形式は 1 ピクセルあたり 1 または 4 バイトを使います。
476
+ * - RGBA32 は互換性と利便性のために用意されています。カスタム矩形 API などで色データを書き込まない限り RGB
477
+ * チャンネルは白く、メモリと帯域の約 75% を占めます。
478
+ * @ko
479
+ * 아틀라스 픽셀 데이터를 빌드합니다. FontAtlas_GetTexDataAsAlpha8(self)과
480
+ * FontAtlas_GetTexDataAsRGBA32(self)가
481
+ * 필요할 때 자동으로 호출합니다.
482
+ *
483
+ * - 픽셀을 그래픽 메모리에 업로드한 뒤 `ImFontAtlas_SetTexID(self, textureId)`로 텍스처 ID를 저장합니다.
484
+ * - 행 피치는 `Width * BytesPerPixel`이며 지원하는 출력 형식은 픽셀당 1 또는 4바이트를 사용합니다.
485
+ * - RGBA32는 호환성과 편의를 위해 제공됩니다. 사용자 정의 사각형 API 등으로 색상 데이터를 쓰지 않으면 RGB 채널은 흰색이며
486
+ * 메모리와 대역폭의 약 75%를 차지합니다.
487
+ *
488
+ * @param self - ImFontAtlas handle on which this method operates.
489
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
490
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
491
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
492
+ *
493
+ * @returns True if the font atlas was built successfully; false reports a build
494
+ * failure.
495
+ * @zh 字体图集成功构建时为 true,构建失败时为 false。
496
+ * @ja フォントアトラスの構築に成功すれば true、失敗なら false です。
497
+ * @ko 글꼴 아틀라스 빌드에 성공하면 true, 실패하면 false입니다.
498
+ */
499
+ export declare function ImFontAtlas_Build(self: ImFontAtlas): boolean;
500
+ /**
501
+ * Test whether the font atlas has been built.
502
+ *
503
+ * @zh 判断字体图集是否已构建。
504
+ * @ja フォントアトラスが構築済みかを調べます。
505
+ * @ko 글꼴 아틀라스가 빌드되었는지 확인합니다.
506
+ *
507
+ * @remarks
508
+ * Bit ambiguous: used to detect when user didn't build texture but effectively
509
+ * we should check TexID != 0 except that would be backend dependent...
510
+ * @zh
511
+ * 语义略有歧义:用于检测用户未构建纹理的情况,但实际上应检查 TexID != 0,只是这样会依赖后端……
512
+ * @ja
513
+ * やや曖昧です。
514
+ *
515
+ * ユーザーがテクスチャを構築していないことの検出に使いますが、実際には TexID != 0 を確認すべきで、ただしそれはバックエンドに依存します。
516
+ * @ko
517
+ * 다소 모호합니다.
518
+ *
519
+ * 사용자가 텍스처를 구축하지 않았는지 감지하는 용도이지만 실제로는 TexID != 0을 검사해야 하며, 그렇게 하면 백엔드에 의존하게
520
+ * 됩니다.
521
+ *
522
+ * @param self - ImFontAtlas handle on which this method operates.
523
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
524
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
525
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
526
+ *
527
+ * @returns True if the atlas has fonts and its texture data is ready.
528
+ * @zh 图集包含字体且纹理数据已就绪时为 true。
529
+ * @ja アトラスにフォントがありテクスチャデータが準備済みなら true です。
530
+ * @ko 아틀라스에 글꼴이 있고 텍스처 데이터가 준비되었으면 true입니다.
531
+ */
532
+ export declare function ImFontAtlas_IsBuilt(self: ImFontAtlas): boolean;
533
+ /**
534
+ * Associate the atlas with its uploaded renderer texture identifier.
535
+ *
536
+ * @zh 将图集与上传后的渲染器纹理标识符关联。
537
+ * @ja アトラスをアップロード済みのレンダラー用テクスチャ識別子に関連付けます。
538
+ * @ko 아틀라스를 업로드된 렌더러 텍스처 식별자와 연결합니다.
539
+ *
540
+ * @param self - ImFontAtlas handle on which this method operates.
541
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
542
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
543
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
544
+ *
545
+ * @param id - Renderer texture identifier (ImTextureID bigint), not an SFML
546
+ * texture object.
547
+ * @zh id - 渲染器纹理标识符(ImTextureID bigint),不是 SFML 纹理对象。
548
+ * @ja id - レンダラーのテクスチャ識別子(ImTextureID の bigint)です。SFML テクスチャオブジェクトではありません。
549
+ * @ko id - 렌더러 텍스처 식별자(ImTextureID bigint)이며 SFML 텍스처 객체가 아닙니다.
550
+ */
551
+ export declare function ImFontAtlas_SetTexID(self: ImFontAtlas, id: bigint): void;
552
+ /**
553
+ * Reserve a custom rectangle in the font atlas.
554
+ *
555
+ * @zh 在字体图集中预留自定义矩形。
556
+ * @ja フォントアトラスに独自の矩形領域を確保します。
557
+ * @ko 글꼴 아틀라스에 사용자 정의 사각형을 예약합니다.
558
+ *
559
+ * @remarks
560
+ * You can request arbitrary rectangles to be packed into the atlas, for your
561
+ * own purposes.
562
+ *
563
+ * - After calling ImFontAtlas_Build(self), you can query the rectangle position
564
+ * and render your
565
+ * pixels.
566
+ *
567
+ * - For colored output, native backends may use the atlas's TexPixelsUseColors
568
+ * flag to choose a texture format. This flag is not exposed by the JS atlas
569
+ * view.
570
+ *
571
+ * - You can also request your rectangles to be mapped as font glyph (given a
572
+ * font + Unicode point), so you can render e.g. custom colorful icons and use
573
+ * them as regular glyphs.
574
+ *
575
+ * - Read docs/FONTS.md for more details about using colorful icons.
576
+ *
577
+ * - Note: this API may be redesigned later in order to support multi-monitor
578
+ * varying DPI settings.
579
+ * @zh
580
+ * 可请求将任意矩形打包进图集,供自定义用途。
581
+ *
582
+ * - 调用 ImFontAtlas_Build(self) 后可查询矩形位置并绘制自己的像素。
583
+ *
584
+ * - 对于彩色输出,原生后端可能参考图集的 TexPixelsUseColors 标志来选择纹理格式。JS 图集视图未暴露此标志。
585
+ *
586
+ * - 也可将矩形映射为字体字形(指定字体 + Unicode 码点),从而绘制自定义彩色图标等,并像普通字形一样使用。
587
+ *
588
+ * - 使用彩色图标的详情见 docs/FONTS.md。
589
+ *
590
+ * - 注意:此 API 未来可能重新设计,以支持多显示器不同 DPI 设置。
591
+ * @ja
592
+ * 独自の用途で任意の矩形をアトラスに詰め込むよう要求できます。
593
+ *
594
+ * - ImFontAtlas_Build(self) の後に矩形位置を調べ、自分のピクセルを描画できます。
595
+ *
596
+ * - カラー出力では、ネイティブのバックエンドがアトラスの TexPixelsUseColors フラグを参照して
597
+ * テクスチャ形式を選ぶ場合があります。このフラグは JS のアトラスビューでは公開されていません。
598
+ *
599
+ * - フォントと Unicode コードポイントを指定して矩形をグリフに対応付けることもでき、独自のカラーアイコンなどを通常のグリフとして描画できます。
600
+ *
601
+ * - カラーアイコンの詳細は docs/FONTS.md を読んでください。
602
+ *
603
+ * - 注意:複数モニターで異なる DPI 設定に対応するため、後で API を再設計する可能性があります。
604
+ * @ko
605
+ * 사용자 용도로 임의의 사각형을 아틀라스에 패킹하도록 요청할 수 있습니다.
606
+ *
607
+ * - ImFontAtlas_Build(self) 호출 후 사각형 위치를 조회하고 자체 픽셀을 그릴 수 있습니다.
608
+ *
609
+ * - 컬러 출력에서는 네이티브 백엔드가 아틀라스의 TexPixelsUseColors 플래그를 참조해 텍스처 형식을 선택할 수 있습니다.
610
+ * JS 아틀라스 뷰는 이 플래그를 노출하지 않습니다.
611
+ *
612
+ * - 폰트와 Unicode 코드 포인트를 지정하여 사각형을 글리프에 매핑할 수도 있으므로 사용자 정의 컬러 아이콘 등을 일반 글리프처럼
613
+ * 렌더링하고 사용할 수 있습니다.
614
+ *
615
+ * - 컬러 아이콘 사용에 관한 자세한 내용은 docs/FONTS.md를 읽으세요.
616
+ *
617
+ * - 참고: 다중 모니터의 서로 다른 DPI 설정을 지원하기 위해 나중에 이 API가 재설계될 수 있습니다.
618
+ *
619
+ * @param self - ImFontAtlas handle on which this method operates.
620
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
621
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
622
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
623
+ *
624
+ * @param width - Width of the custom atlas rectangle in pixels.
625
+ * @zh width - 自定义图集矩形的像素宽度。
626
+ * @ja width - アトラスのカスタム矩形のピクセル幅です。
627
+ * @ko width - 사용자 정의 아틀라스 사각형의 픽셀 너비입니다。
628
+ *
629
+ * @param height - Height of the custom atlas rectangle in pixels.
630
+ * @zh height - 自定义图集矩形的像素高度。
631
+ * @ja height - アトラスのカスタム矩形のピクセル高さです。
632
+ * @ko height - 사용자 정의 아틀라스 사각형의 픽셀 높이입니다.
633
+ *
634
+ * @returns Zero-based custom-rectangle index for
635
+ * ImFontAtlas_GetCustomRectByIndex(self, index);
636
+ * packing coordinates become available after atlas building.
637
+ * @zh 供 ImFontAtlas_GetCustomRectByIndex(self, index)
638
+ * 使用的零基自定义矩形索引;图集构建后才能获得打包坐标。
639
+ * @ja ImFontAtlas_GetCustomRectByIndex(self, index) 用の 0
640
+ * 始まりの矩形番号です。配置座標はアトラス構築後に利用できます。
641
+ * @ko ImFontAtlas_GetCustomRectByIndex(self, index)용 0 기반 사각형 인덱스입니다. 패킹 좌표는
642
+ * 아틀라스 빌드 후 사용할 수 있습니다.
643
+ */
644
+ export declare function ImFontAtlas_AddCustomRectRegular(self: ImFontAtlas, width: number, height: number): number;
645
+ /**
646
+ * Reserve an atlas rectangle and map it to a custom glyph in a font.
647
+ *
648
+ * @zh 预留图集矩形,并将其映射为字体中的自定义字形。
649
+ * @ja アトラス内に矩形を予約し、フォントのカスタムグリフに対応付けます。
650
+ * @ko 아틀라스 사각형을 예약하고 글꼴의 사용자 정의 글리프에 연결합니다.
651
+ *
652
+ * @param self - ImFontAtlas handle on which this method operates.
653
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
654
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
655
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
656
+ *
657
+ * @param font - Font handle used for text drawing or for registering the custom
658
+ * glyph; text drawing accepts null for the current font.
659
+ * @zh font - 用于绘制文字或注册自定义字形的字体句柄;绘制文字时 null 使用当前字体。
660
+ * @ja font - 文字描画やカスタムグリフ登録に使うフォントです。文字描画時の null は現在のフォントを使います。
661
+ * @ko font - 텍스트 그리기 또는 사용자 정의 글리프 등록에 쓸 글꼴 핸들입니다. 텍스트의 null은 현재 글꼴입니다.
662
+ *
663
+ * @param id - Unicode code point to query or add, within the range supported by
664
+ * this ImWchar build.
665
+ * @zh id - 要查询或加入的 Unicode 码点,须在此 ImWchar 构建支持的范围内。
666
+ * @ja id - 検索または追加する Unicode コードポイントです。この ImWchar ビルドの対応範囲内で指定します。
667
+ * @ko id - 조회하거나 추가할 유니코드 코드 포인트이며 이 ImWchar 빌드가 지원하는 범위여야 합니다.
668
+ *
669
+ * @param width - Width of the custom atlas rectangle in pixels.
670
+ * @zh width - 自定义图集矩形的像素宽度。
671
+ * @ja width - アトラスのカスタム矩形のピクセル幅です。
672
+ * @ko width - 사용자 정의 아틀라스 사각형의 픽셀 너비입니다。
673
+ *
674
+ * @param height - Height of the custom atlas rectangle in pixels.
675
+ * @zh height - 自定义图集矩形的像素高度。
676
+ * @ja height - アトラスのカスタム矩形のピクセル高さです。
677
+ * @ko height - 사용자 정의 아틀라스 사각형의 픽셀 높이입니다.
678
+ *
679
+ * @param advance_x - Horizontal pen advance in pixels after drawing the custom
680
+ * glyph.
681
+ * @zh advance_x - 绘制自定义字形后笔位置的水平像素前进量。
682
+ * @ja advance_x - カスタムグリフ描画後にペンを進める水平ピクセル数です。
683
+ * @ko advance_x - 사용자 정의 글리프를 그린 후 가로 펜 이동량(픽셀)입니다.
684
+ *
685
+ * @param offset - Glyph drawing offset in pixels relative to the pen position.
686
+ * @zh offset - 字形绘制位置相对笔位置的像素偏移。
687
+ * @ja offset - ペン位置からのグリフ描画位置のピクセル差分です。
688
+ * @ko offset - 펜 위치 기준 글리프 그리기 픽셀 오프셋입니다。
689
+ *
690
+ * @returns Zero-based custom-rectangle index for
691
+ * ImFontAtlas_GetCustomRectByIndex(self, index);
692
+ * packing coordinates become available after atlas building.
693
+ * @zh 供 ImFontAtlas_GetCustomRectByIndex(self, index)
694
+ * 使用的零基自定义矩形索引;图集构建后才能获得打包坐标。
695
+ * @ja ImFontAtlas_GetCustomRectByIndex(self, index) 用の 0
696
+ * 始まりの矩形番号です。配置座標はアトラス構築後に利用できます。
697
+ * @ko ImFontAtlas_GetCustomRectByIndex(self, index)용 0 기반 사각형 인덱스입니다. 패킹 좌표는
698
+ * 아틀라스 빌드 후 사용할 수 있습니다.
699
+ */
700
+ export declare function ImFontAtlas_AddCustomRectFontGlyph(self: ImFontAtlas, font: ImFont, id: number, width: number, height: number, advance_x: number, offset?: ImVec2Like): number;
701
+ /**
702
+ * Access a registered custom atlas rectangle by its index.
703
+ *
704
+ * @zh 按索引访问已注册的图集自定义矩形。
705
+ * @ja インデックスで登録済みのカスタムアトラス矩形にアクセスします。
706
+ * @ko 인덱스로 등록된 사용자 정의 아틀라스 사각형에 접근합니다.
707
+ *
708
+ * @param self - ImFontAtlas handle on which this method operates.
709
+ * @zh self - 此方法操作的 ImFontAtlas 句柄。
710
+ * @ja self - このメソッドの操作対象となる ImFontAtlas ハンドルです。
711
+ * @ko self - 이 메서드가 조작할 ImFontAtlas 핸들입니다.
712
+ *
713
+ * @param index - Valid zero-based custom rectangle index returned by
714
+ * AddCustomRect; invalid indices are not a nullable lookup.
715
+ * @zh index - AddCustomRect 返回的有效零基自定义矩形索引;无效索引不是可返回 null 的查询。
716
+ * @ja index - AddCustomRect が返した有効な 0 始まりの矩形番号です。不正な番号を null として扱う検索ではありません。
717
+ * @ko index - AddCustomRect가 반환한 유효한 0 기반 사각형 인덱스입니다. 잘못된 인덱스를 null로 처리하는 조회가
718
+ * 아닙니다.
719
+ *
720
+ * @returns Borrowed atlas rectangle handle for a valid index; an invalid index
721
+ * is an error, not a null sentinel.
722
+ * @zh 有效索引对应的图集矩形借用句柄;无效索引是错误,不以 null 表示。
723
+ * @ja 有効な番号のアトラス矩形の借用ハンドルです。不正な番号はエラーで、null を返す規約ではありません。
724
+ * @ko 유효한 인덱스의 아틀라스 사각형 빌린 핸들입니다. 잘못된 인덱스는 오류이며 null 표시가 아닙니다.
725
+ */
726
+ export declare function ImFontAtlas_GetCustomRectByIndex(self: ImFontAtlas, index: number): ImFontAtlasCustomRect | null;