差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
manual:reference:package:extend:imgui:base:main_page [2021/06/30 22:46] – [控件(widget)简要] rend | manual:reference:package:extend:imgui:base:main_page [2021/07/02 17:23] (当前版本) – [应用(application)简要] rend | ||
---|---|---|---|
行 75: | 行 75: | ||
**application** 分为两种: | **application** 分为两种: | ||
- | ^**application 申明方法** ^**描述** ^ | + | ^application 申明方法 |
- | |**[application]** fullscreen_application(number monitor_id, string title) | + | |[application] **fullscreen_application**(number monitor_id, string title) |
- | |**[application]** window_application(number width, number height, string title) | + | |[application] **window_application**(number width, number height, string title) |
创建全屏应用需手动指定显示器 id。 | 创建全屏应用需手动指定显示器 id。 | ||
行 84: | 行 84: | ||
**application** 支持设置内部所有窗口(window)的主题风格: | **application** 支持设置内部所有窗口(window)的主题风格: | ||
- | ^**设置主题方法** ^**描述** ^ | + | ^设置主题方法 |
- | |void style_color_classic() | + | |void **style_color_classic**() |切换到经典主题 |
- | |void style_color_light() | + | |void **style_color_light**() |切换到亮色主题 |
- | |void style_color_dark() | + | |void **style_color_dark**() |切换到暗色主题 |
----- | ----- | ||
行 107: | 行 107: | ||
ImGui 对此保留了以上设计: | ImGui 对此保留了以上设计: | ||
- | ^**[vec2]** | + | |[vec2] **vec2**(number x, number y) |
- | |**[vec4]** vec4(number x, number y, number z, number w) |返回四维向量对象,每个分量(x、y、z、w)可访问 | + | |[vec4] **vec4**(number x, number y, number z, number w) |返回四维向量对象,每个分量(x、y、z、w)可访问 |
----- | ----- | ||
行 118: | 行 118: | ||
ImGui 为字体栈提供了以下方法: | ImGui 为字体栈提供了以下方法: | ||
- | ^**方法** ^**描述** ^ | + | ^方法 |
- | |void push_font([font]) | + | |void **push_font**([font]) |
- | |void pop_font() | + | |void **pop_font**() |弹出字体栈栈顶对象(删除当前字体 ) | |
- | |**[font]** get_font() | + | |[font] **get_font**() |获取栈顶对象(当前字体) |
ImGui 为字体提供了专用的字体包 [[: | ImGui 为字体提供了专用的字体包 [[: | ||
- | ^**[font]** add_font(string path, number size) | + | |[font] **add_font**(string path, number size) |
- | |**[font]** add_font_chinese(string path, number size) |同上,适用于中文 | + | |[font] **add_font_chinese**(string path, number size) |同上,适用于中文 |
- | |**[font]** add_font_default(number size) |加载默认字体(英文),指定字体大小,并返回字体对象 | + | |[font] **add_font_default**(number size) |加载默认字体(英文),指定字体大小,并返回字体对象 |
- | |**[font]** add_font_extend([imgui_font] data, number size) |加载 imgui_font 中的扩展字体,指定字体大小,并返回字体对象 | + | |[font] **add_font_extend**([imgui_font] data, number size) |加载 imgui_font 中的扩展字体,指定字体大小,并返回字体对象 |
- | |**[font]** add_font_extend_cn([imgui_font] data, number size) |同上,适用于中文 | + | |[font] **add_font_extend_cn**([imgui_font] data, number size) |同上,适用于中文 |
< | < | ||
行 166: | 行 166: | ||
一般来说,通过如下的方式来设置窗口 | 一般来说,通过如下的方式来设置窗口 | ||
- | ^**方法** ^**描述** ^ | + | ^方法 |
- | |void set_window_pos([vec2] pos) |设置当前窗口位置 | + | |void **set_window_pos**([vec2] pos) |设置当前窗口位置 |
- | |void set_window_size([vec2] size) |设置当前窗口大小 | + | |void **set_window_size**([vec2] size) |设置当前窗口大小 |
- | |void begin_window(string title_and_id, | + | |void **begin_window**(string title_and_id, |
- | |void end_window() | + | |void **end_window**() |结束窗口布局 |
对于以上方法做出解释。 | 对于以上方法做出解释。 | ||
行 225: | 行 225: | ||
标识符:一般用于右键菜单等,默认情况下标识符就是控件名,**但有些控件无 ID 时就要特别标示** | 标识符:一般用于右键菜单等,默认情况下标识符就是控件名,**但有些控件无 ID 时就要特别标示** | ||
- | 一般控件名可使用“title##id”的形式指定控件的标识符 | + | 一般控件名可使用'' |
- | ^**方法** ^**描述** ^ | + | ^方法 |
- | |void push_id(string title_and_id) | + | |void **push_id**(string title_and_id) |
- | |void pop_id() | + | |void **pop_id**() |结束标识符 |
----- | ----- | ||
行 236: | 行 236: | ||
===== 布局和组(group) ===== | ===== 布局和组(group) ===== | ||
- | ImGui支持使用 | + | ImGui支持使用'' |
以下改变布局的行为,仅对组内控件生效: | 以下改变布局的行为,仅对组内控件生效: | ||
- | ^**方法** ^**描述** ^ | + | ^方法 |
- | |void begin_group() | + | |void **begin_group**() |开始新组 |
- | |void end_group() | + | |void **end_group**() |结束组 |
- | |void separator() | + | |void **separator**() |横向分割线 |
- | |void same_line() | + | |void **same_line**() |设置下一个控件为同一行 |
- | |void spacing() | + | |void **spacing**() |插入空格 |
- | |void indent() | + | |void **indent**() |缩进 |
- | |void unindent() | + | |void **unindent**() |反缩进 |
另外还有树形节点,您可以理解为组(group)的树状形式: | 另外还有树形节点,您可以理解为组(group)的树状形式: | ||
- | ^**方法** ^**描述** ^ | + | ^方法 |
- | |**boolean** tree_node(string label) | + | |boolean |
- | |void tree_pop() | + | |void **tree_pop**() |结束树节点 |
< | < | ||
行 262: | 行 262: | ||
可以粗浅理解为“当前选中的窗口或控件”。大部分I/ | 可以粗浅理解为“当前选中的窗口或控件”。大部分I/ | ||
- | ^**方法** ^**描述** ^ | + | ^方法 |
- | |void set_scroll_here() | + | |void **set_scroll_here**() |将滚动条滚动到当前位置 |
- | |void set_keyboard_focus_here() | + | |void **set_keyboard_focus_here**() |设置上一个控件为键盘焦点 |
----- | ----- | ||
行 273: | 行 273: | ||
画板提供了在**窗口**内绘图的系列方法。 | 画板提供了在**窗口**内绘图的系列方法。 | ||
- | ^**方法** ^**描述** ^ | + | ^方法 |
- | |void add_line([vec2] a, [vec2] b, [vec4] color, number thickness) | + | |void **add_line**([vec2] a, [vec2] b, [vec4] color, number thickness) |
- | |void add_rect([vec2] a, [vec2] b, [vec4] color, number rounding, number thickness) | + | |void **add_rect**([vec2] a, [vec2] b, [vec4] color, number rounding, number thickness) |
- | |void add_rect_filled([vec2] a, [vec2] b, [vec4] color, number rounding) | + | |void **add_rect_filled**([vec2] a, [vec2] b, [vec4] color, number rounding) |
- | |void add_quad([vec2] a, [vec2] b, [vec2] c, [vec2] d, [vec4] color, number thickness) | + | |void **add_quad**([vec2] a, [vec2] b, [vec2] c, [vec2] d, [vec4] color, number thickness) |
- | |void add_quad_filled([vec2] a, [vec2] b, [vec2] c, [vec2] d, [vec4] color) | + | |void **add_quad_filled**([vec2] a, [vec2] b, [vec2] c, [vec2] d, [vec4] color) |
- | |void add_triangle([vec2] a, [vec2] b, [vec2] c, [vec4] color, number thickness) | + | |void **add_triangle**([vec2] a, [vec2] b, [vec2] c, [vec4] color, number thickness) |
- | |void add_triangle_filled([vec2] a, [vec2] b, [vec2] c, [vec4] color) | + | |void **add_triangle_filled**([vec2] a, [vec2] b, [vec2] c, [vec4] color) |
- | |void add_circle([vec2] centre, number radius, [vec4] color, number seg, number thickness) | + | |void **add_circle**([vec2] centre, number radius, [vec4] color, number seg, number thickness) |
- | |void add_circle_filled([vec2] centre, number radius, [vec4] color, number seg) |填充圆 | + | |void **add_circle_filled**([vec2] centre, number radius, [vec4] color, number seg) |填充圆 |
- | |void add_text([font] font,number size, [vec2] pos, [vec4] color, string text) |绘制文字 | + | |void **add_text**([font] font,number size, [vec2] pos, [vec4] color, string text) |绘制文字 |
- | |void add_image([image] image, [vec2] a, [vec2] b) |绘制图片 | + | |void **add_image**([image] image, [vec2] a, [vec2] b) |绘制图片 |