< GeeXLab Reference Guide />

> Back to Reference Guide Index


gh_imgui library

Description

gh_imgui is the module that manages the ImGui library and allows to draw widgets. Available in GeeXLab 0.17+. All possible constants are defined in {GeeXLab folder}/libs/lua/imgui.lua or in {GeeXLab folder}/libs/python/imgui.py


Number of functions: 230

  1. gh_imgui.add_bezier_curve_to_drawlist ()
  2. gh_imgui.add_circle_to_drawlist ()
  3. gh_imgui.add_font_from_buffer ()
  4. gh_imgui.add_font_from_file ()
  5. gh_imgui.add_font_from_zip_file ()
  6. gh_imgui.add_line_to_drawlist ()
  7. gh_imgui.add_quad_to_drawlist ()
  8. gh_imgui.begin_child ()
  9. gh_imgui.button ()
  10. gh_imgui.button_arrow ()
  11. gh_imgui.calc_text_size ()
  12. gh_imgui.checkbox ()
  13. gh_imgui.collapsing_header ()
  14. gh_imgui.color_edit_rgba ()
  15. gh_imgui.color_edit_rgba_v2 ()
  16. gh_imgui.color_picker_rgba ()
  17. gh_imgui.color_picker_rgba_v2 ()
  18. gh_imgui.column_get_offset ()
  19. gh_imgui.column_get_width ()
  20. gh_imgui.column_next ()
  21. gh_imgui.column_set_offset ()
  22. gh_imgui.column_set_width ()
  23. gh_imgui.columns ()
  24. gh_imgui.combo_box_add_item ()
  25. gh_imgui.combo_box_create ()
  26. gh_imgui.combo_box_draw ()
  27. gh_imgui.combo_box_draw_v2 ()
  28. gh_imgui.dummy ()
  29. gh_imgui.end_child ()
  30. gh_imgui.frame_begin ()
  31. gh_imgui.frame_begin_v2 ()
  32. gh_imgui.frame_end ()
  33. gh_imgui.get_color ()
  34. gh_imgui.get_content_region_available_width ()
  35. gh_imgui.get_cur_font_display_offset ()
  36. gh_imgui.get_cursor_pos ()
  37. gh_imgui.get_cursor_screen_pos ()
  38. gh_imgui.get_cursor_start_pos ()
  39. gh_imgui.get_font_size ()
  40. gh_imgui.get_item_rect ()
  41. gh_imgui.get_scroll ()
  42. gh_imgui.get_scroll_max ()
  43. gh_imgui.get_text_line_heigh_with_spacing ()
  44. gh_imgui.get_version ()
  45. gh_imgui.get_window_pos ()
  46. gh_imgui.get_window_pos_size ()
  47. gh_imgui.get_window_size ()
  48. gh_imgui.gizmo_begin_frame ()
  49. gh_imgui.gizmo_decompose_matrix_to_components ()
  50. gh_imgui.gizmo_enable ()
  51. gh_imgui.gizmo_is_over ()
  52. gh_imgui.gizmo_is_using ()
  53. gh_imgui.gizmo_manipulate ()
  54. gh_imgui.gizmo_set_rect ()
  55. gh_imgui.group_begin ()
  56. gh_imgui.group_end ()
  57. gh_imgui.image ()
  58. gh_imgui.image_button ()
  59. gh_imgui.indent ()
  60. gh_imgui.init ()
  61. gh_imgui.input_text ()
  62. gh_imgui.is_any_item_hovered ()
  63. gh_imgui.is_any_window_hovered ()
  64. gh_imgui.is_item_clicked ()
  65. gh_imgui.is_item_hovered ()
  66. gh_imgui.is_mouse_clicked ()
  67. gh_imgui.is_window_hovered ()
  68. gh_imgui.list_box_begin ()
  69. gh_imgui.list_box_draw ()
  70. gh_imgui.list_box_draw_v2 ()
  71. gh_imgui.list_box_end ()
  72. gh_imgui.list_clipping_begin ()
  73. gh_imgui.list_clipping_end ()
  74. gh_imgui.menu_begin ()
  75. gh_imgui.menu_begin_bar ()
  76. gh_imgui.menu_begin_main_bar ()
  77. gh_imgui.menu_end ()
  78. gh_imgui.menu_end_bar ()
  79. gh_imgui.menu_end_main_bar ()
  80. gh_imgui.menu_item ()
  81. gh_imgui.plotline_create ()
  82. gh_imgui.plotline_draw ()
  83. gh_imgui.plotline_draw_v2 ()
  84. gh_imgui.plotline_get_value1f ()
  85. gh_imgui.plotline_set_value1f ()
  86. gh_imgui.pop_font ()
  87. gh_imgui.pop_item_width ()
  88. gh_imgui.pop_style_color ()
  89. gh_imgui.popup_begin ()
  90. gh_imgui.popup_begin_context ()
  91. gh_imgui.popup_end ()
  92. gh_imgui.popup_open ()
  93. gh_imgui.progress_bar ()
  94. gh_imgui.push_font ()
  95. gh_imgui.push_item_width ()
  96. gh_imgui.push_style_color ()
  97. gh_imgui.radio_button ()
  98. gh_imgui.rebuild_all_fonts ()
  99. gh_imgui.reset_default_font ()
  100. gh_imgui.same_line ()
  101. gh_imgui.select_draw_list ()
  102. gh_imgui.selectable ()
  103. gh_imgui.separator ()
  104. gh_imgui.set_color ()
  105. gh_imgui.set_cur_font_display_offset ()
  106. gh_imgui.set_default_font ()
  107. gh_imgui.set_frame_border_size ()
  108. gh_imgui.set_rounding ()
  109. gh_imgui.set_indent_spacing ()
  110. gh_imgui.set_item_default_focus ()
  111. gh_imgui.set_keyboard_focus_here ()
  112. gh_imgui.set_next_item_width ()
  113. gh_imgui.set_next_window_content_size ()
  114. gh_imgui.set_scroll ()
  115. gh_imgui.set_scroll_from_pos_y ()
  116. gh_imgui.set_scroll_here_y ()
  117. gh_imgui.set_style_colors ()
  118. gh_imgui.set_tooltip ()
  119. gh_imgui.set_window_border_size ()
  120. gh_imgui.set_window_focus ()
  121. gh_imgui.set_window_rounding ()
  122. gh_imgui.show_demo_window ()
  123. gh_imgui.show_metrics_window ()
  124. gh_imgui.show_test_window ()
  125. gh_imgui.slider_1i ()
  126. gh_imgui.slider_1i_v2 ()
  127. gh_imgui.slider_1f ()
  128. gh_imgui.slider_2f ()
  129. gh_imgui.slider_3f ()
  130. gh_imgui.slider_4f ()
  131. gh_imgui.spacing ()
  132. gh_imgui.bullet ()
  133. gh_imgui.tab_bar_begin ()
  134. gh_imgui.tab_bar_begin_v2 ()
  135. gh_imgui.tab_bar_end ()
  136. gh_imgui.tab_item_begin ()
  137. gh_imgui.tab_item_begin_v2 ()
  138. gh_imgui.tab_item_end ()
  139. gh_imgui.terminate ()
  140. gh_imgui.text ()
  141. gh_imgui.text_rgba ()
  142. gh_imgui.text_unformatted_v1 ()
  143. gh_imgui.text_unformatted_v2 ()
  144. gh_imgui.text_wrapped ()
  145. gh_imgui.tree_node ()
  146. gh_imgui.tree_node_ex ()
  147. gh_imgui.tree_node_leaf ()
  148. gh_imgui.tree_node_leaf_v2 ()
  149. gh_imgui.tree_pop ()
  150. gh_imgui.underline ()
  151. gh_imgui.unindent ()
  152. gh_imgui.url ()
  153. gh_imgui.vslider_1f ()
  154. gh_imgui.vslider_1i ()
  155. gh_imgui.vslider_1i_v2 ()
  156. gh_imgui.widget ()
  157. gh_imgui.window_begin ()
  158. gh_imgui.window_begin_v2 ()
  159. gh_imgui.window_end ()
  160. gh_imgui.imguizmoquat_gizmo3d_v1 ()
  161. gh_imgui.imguizmoquat_gizmo3d_v2 ()
  162. gh_imgui.imguizmoquat_gizmo3d_v3 ()
  163. gh_imgui.set_item_spacing ()
  164. gh_imgui.get_item_spacing ()
  165. gh_imgui.imgui_plot_create ()
  166. gh_imgui.plot_kill ()
  167. gh_imgui.plot_draw ()
  168. gh_imgui.plot_set_title ()
  169. gh_imgui.plot_set_color ()
  170. gh_imgui.plot_set_state ()
  171. gh_imgui.plot_set_axis_param_bool ()
  172. gh_imgui.plot_set_axis_param_int ()
  173. gh_imgui.plot_set_axis_param_float ()
  174. gh_imgui.plot_set_axis_label ()
  175. gh_imgui.plot_set_axis_color ()
  176. gh_imgui.plot_add_item ()
  177. gh_imgui.plot_item_set_label ()
  178. gh_imgui.plot_item_set_color ()
  179. gh_imgui.plot_item_set_type ()
  180. gh_imgui.plot_item_set_size ()
  181. gh_imgui.plot_item_set_data_begin ()
  182. gh_imgui.plot_item_add_data ()
  183. gh_imgui.plot_item_get_data_size ()
  184. gh_imgui.plot_item_clear_data ()
  185. gh_imgui.plot_item_clear_data ()
  186. gh_imgui.plot_item_set_data ()
  187. gh_imgui.plot_item_roll_point ()
  188. gh_imgui.plot_item_buffer_point ()
  189. gh_imgui.plot_axis_scroll ()
  190. gh_imgui.plot_is_hovered ()
  191. gh_imgui.plot_get_mouse_position ()
  192. gh_imgui.get_text_line_height ()
  193. gh_imgui.get_text_line_height_with_spacing ()
  194. gh_imgui.color_text_editor_create ()
  195. gh_imgui.color_text_editor_kill ()
  196. gh_imgui.color_text_editor_render ()
  197. gh_imgui.color_text_editor_get_text ()
  198. gh_imgui.color_text_editor_set_text ()
  199. gh_imgui.color_text_editor_set_language ()
  200. gh_imgui.color_text_editor_set_palette ()
  201. gh_imgui.color_text_editor_set_property_bool ()
  202. gh_imgui.color_text_editor_set_property_int ()
  203. gh_imgui.color_text_editor_get_total_lines ()
  204. gh_imgui.color_text_editor_get_selected_text ()
  205. gh_imgui.color_text_editor_get_current_line_text ()
  206. gh_imgui.color_text_editor_get_cursor_position ()
  207. gh_imgui.color_text_editor_palette_set_color ()
  208. gh_imgui.color_text_editor_palette_get_color ()
  209. gh_imgui.color_text_editor_copy_paste_cut ()
  210. gh_imgui.color_text_editor_selection ()
  211. gh_imgui.color_text_editor_is_text_changed ()
  212. gh_imgui.implot_create_dataplot ()
  213. gh_imgui.implot_kill_dataplot ()
  214. gh_imgui.implot_show_demo_window ()
  215. gh_imgui.implot_begin_plot ()
  216. gh_imgui.implot_end_plot ()
  217. gh_imgui.implot_add_data ()
  218. gh_imgui.implot_draw_plotline ()
  219. gh_imgui.implot_draw_plotscatter ()
  220. gh_imgui.implot_draw_plotshaded ()
  221. gh_imgui.implot_draw_plotbars ()
  222. gh_imgui.implot_set_next_plot_limits ()
  223. gh_imgui.implot_push_style_color ()
  224. gh_imgui.implot_pop_style_color ()
  225. gh_imgui.implot_push_style_var_1f ()
  226. gh_imgui.implot_push_style_var_1i ()
  227. gh_imgui.implot_is_hovered ()
  228. gh_imgui.implot_get_mouse_pos ()
  229. gh_imgui.implot_set_built_in_colormap ()
  230. gh_imgui.implot_plottext ()



add_bezier_curve_to_drawlist

Description

Adds a Bezier curve to the ImGui drawlist.


Syntax

gh_imgui.add_bezier_curve_to_drawlist(
 x0, y0,
 cp0x, cp0y,
 cp1x, cp1y,
 x1, y1,
 r, g, b, a
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.add_bezier_curve_to_drawlist(p0_x, p0_y, ctrl0_x, ctrl0_y, ctrl1_x, ctrl1_y, p1_x, p1_y, r, g, b, a)
			


add_circle_to_drawlist

Description

Adds a circle to the ImGui drawlist.


Syntax

gh_imgui.add_circle_to_drawlist(
 center_x, center_y,
 radius,
 r, g, b, a,
 line_thickness,
 num_segments,
 filled
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


local thickness = 2
local num_segments = 20
local filled = 1

gh_imgui.add_circle_to_drawlist(center_x, center_y, radius, r, g, b, a, thickness, num_segments, filled)
			


add_font_from_buffer

Description

Adds a new font from a memory buffer.


Syntax

font_id = gh_imgui.add_font_from_buffer(
 buff_ptr,
 buff_size,
 font_size
)

Languages


Parameters


Return Values


Code sample


filename = demo_dir .. "assets/arial.ttf"

buffer, buffer_size = gh_utils.file_buffer_create(filename)

font_id = gh_imgui.add_font_from_buffer(buffer, buffer_size, 24)

gh_utils.file_buffer_kill(buffer)
			


add_font_from_file

Description

Adds a new font to the ImGui engine.


Syntax

font_id = gh_imgui.add_font_from_file(
 font_filename,
 font_size
)

Languages


Parameters


Return Values


Code sample


font_id = gh_imgui.add_font_from_file(font_filename, 24)
			


add_font_from_zip_file

Description

Adds a new font from a zip file to the ImGui engine.


Syntax

font_id = gh_imgui.add_font_from_zip_file(
 zip_filename,
 font_filename,
 font_size
)

Languages


Parameters


Return Values


Code sample


font_id = gh_imgui.add_font_from_zip_file(zip_filename, font_filename, 24)
			


add_line_to_drawlist

Description

Adds a line to the ImGui drawlist.


Syntax

gh_imgui.add_line_to_drawlist(
 x0, y0,
 x1, y1,
 r, g, b, a
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.add_line_to_drawlist(start_x, start_y, end_x, end_y, r, g, b, a)
			


add_quad_to_drawlist

Description

Adds a quad to the ImGui drawlist.


Syntax

gh_imgui.add_quad_to_drawlist(
 ax, ay,
 bx, by,
 cx, cy,
 dx, dy,
 r, g, b, a,
 thickness,
 filled
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


local thickness = 2
local filled = 1

gh_imgui.add_quad_to_drawlist(ax, ay, bx, by, cx, cy, dx, dy, r, g, b, a, thickness, filled)
			


begin_child

Description

Begins a scrolling region.


Syntax

gh_imgui.begin_child(
 label,
 width, height,
 border,
 flags
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.begin_child(label, w, h, border, flags)
			


button

Description

Create a button.


Syntax

pressed = gh_imgui.button(
 label,
 width, height
)

Languages


Parameters


Return Values


Code sample


pressed = gh_imgui.button("Fire", 200, 20)
			


button_arrow

Description

Create a arrow shaped button.


Syntax

pressed = gh_imgui.button_arrow(
 label,
 direction
)

Languages


Parameters


Return Values


Code sample


pressed = gh_imgui.button_arrow("Fire", 1)
			


calc_text_size

Description

Returns the size (width and height) of a string.


Syntax

x, y = gh_imgui.calc_text_size(
 text
)

Languages


Parameters


Return Values


Code sample


x, y = gh_imgui.calc_text_size("Hello")
			


checkbox

Description

Create a checkbox.


Syntax

checked = gh_imgui.checkbox(
 label,
 current_state
)

Languages


Parameters


Return Values


Code sample


checked = gh_imgui.checkbox("Wireframe", checked)
			


collapsing_header

Description

Creates an header that can be opened or closed.


Syntax

opened = gh_imgui.collapsing_header(
 label,
 flags
)

Languages


Parameters


Return Values


Code sample


local flags = 0 -- default

if (gh_imgui.collapsing_header(label, flags) == 1) then
    ...
end
			


color_edit_rgba

Description

Displays a 4D slider with color picker.


Syntax

r, g, b, a = gh_imgui.color_edit_rgba(
 label,
 r0, b0, g0, a0
)

Languages


Parameters


Return Values


Code sample


r, g, b, a = gh_imgui.color_edit_rgba("coloredit01", r0, b0, g0, a0)
			


color_edit_rgba_v2

Description

Displays a 4D slider with color picker.


Syntax

r, g, b, a = gh_imgui.color_edit_rgba_v2(
 label,
 r0, b0, g0, a0,
 flags
)

Languages


Parameters


Return Values


Code sample


flags = ImGuiColorEditFlags_None

r, g, b, a = gh_imgui.color_edit_rgba_v2("coloredit01", r0, b0, g0, a0, flags)
			


color_picker_rgba

Description

Displays a color picker.


Syntax

r, g, b, a = gh_imgui.color_picker_rgba(
 label,
 r0, b0, g0, a0
)

Languages


Parameters


Return Values


Code sample


r, g, b, a = gh_imgui.color_picker_rgba("coloredit01", r0, b0, g0, a0)
			


color_picker_rgba_v2

Description

Displays a color picker.


Syntax

r, g, b, a = gh_imgui.color_picker_rgba_v2(
 label,
 r0, b0, g0, a0,
 flags
)

Languages


Parameters


Return Values


Code sample


flags = ImGuiColorEditFlags_None

r, g, b, a = gh_imgui.color_picker_rgba_v2("coloredit01", r0, b0, g0, a0, flags)
			


column_get_offset

Description

Gets the offset of a particular column.


Syntax

offset = gh_imgui.column_get_offset(
 index
)

Languages


Parameters


Return Values


Code sample


offset = gh_imgui.column_get_offset(index)
			


column_get_width

Description

Gets the width of a particular column.


Syntax

width = gh_imgui.column_get_width(
 index
)

Languages


Parameters


Return Values


Code sample


width = gh_imgui.column_get_width(index)
			


column_next

Description

Starts a new column.


Syntax

gh_imgui.column_next()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.columns(2, 1)

-- display widgets
...

-- next column
gh_imgui.column_next()

-- display widgets
...

-- reset to default layout (one column)
gh_imgui.columns(1, 0)
			


column_set_offset

Description

Sets the offset of a particular column.


Syntax

gh_imgui.column_set_offset(
 index,
 offset
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.column_set_offset(index, width)
			


column_set_width

Description

Sets the width of a particular column.


Syntax

gh_imgui.column_set_width(
 index,
 width
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.column_set_width(index, width)
			


columns

Description

Starts/ends a column layout.


Syntax

gh_imgui.columns(
 num_columns,
 border
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.columns(2, 1)

-- display widgets
...

-- next column
gh_imgui.column_next()

-- display widgets
...

-- reset to default layout (one column)
gh_imgui.columns(1, 0)
			


combo_box_add_item

Description

Adds an item to a combo box.


Syntax

gh_imgui.combo_box_add_item(
 cb_id,
 item_label
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.combo_box_add_item(cb_id, "Item1")
			


combo_box_create

Description

Creates a combo box. Must be called once (usually in an INIT script).


Syntax

cb_id = gh_imgui.combo_box_create(
 label
)

Languages


Parameters


Return Values


Code sample


cb_id = gh_imgui.combo_box_create(label)
			


combo_box_draw

Description

Draws the combo box.


Syntax

selected_item = gh_imgui.combo_box_draw(
 cb_id,
 initial_selected_item
)

Languages


Parameters


Return Values


Code sample


selected_item = gh_imgui.combo_box_draw(cb_id, 0)
			


combo_box_draw_v2

Description

Draws the combo box.


Syntax

selected_item = gh_imgui.combo_box_draw_v2(
 cb_id,
 initial_selected_item,
 height_in_items
)

Languages


Parameters


Return Values


Code sample


selected_item = gh_imgui.combo_box_draw_v2(cb_id, 0, 10)
			


dummy

Description

Places an invisible widget (box). Useful for layout management.


Syntax

gh_imgui.dummy(
 width, height
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.dummy(10, 5)
			


end_child

Description

End a scrolling region.


Syntax

gh_imgui.end_child()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.end_child()
			


frame_begin

Description

Begins ImGui rendering. This is the first function to call in a FRAME script before any other gh_imgui functions.


Syntax

gh_imgui.frame_begin(
 width, height,
 mouse_x, mouse_y,
 mouse_left_button, mouse_right_button,
 dt
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.frame_begin(winW, winH, mouse_x, mouse_y, mouse_left_button, mouse_right_button, dt)
			


frame_begin_v2

Description

Begins ImGui rendering. This is the first function to call in a FRAME script before any other gh_imgui functions.


Syntax

gh_imgui.frame_begin_v2(
 width, height,
 mouse_x, mouse_y,
 mouse_left_button, mouse_right_button,
 mouse_wheel,
 dt
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.frame_begin_v2(winW, winH, mouse_x, mouse_y, mouse_left_button, mouse_right_button, mouse_wheel, dt)
			


frame_end

Description

Ends ImGui rendering. This is the last function to call in a FRAME script after other gh_imgui functions.


Syntax

gh_imgui.frame_end()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.frame_end()
			


get_color

Description

Gets the current color value.


Syntax

r, g, b, a = gh_imgui.get_color(
 item_type
)

Languages


Parameters


Return Values


Code sample


widget_type = IMGUI_BUTTON_COLOR

r, g, b, a = gh_imgui.get_color(widget_type)
			


get_content_region_available_width

Description

Returns the available width inside a window.


Syntax

width = gh_imgui.get_content_region_available_width()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


width = gh_imgui.get_content_region_available_width()
			


get_cur_font_display_offset

Description

Gets the x and y offset of the current font.


Syntax

x, y = gh_imgui.get_cur_font_display_offset()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


x, y = gh_imgui.get_cur_font_display_offset()
			


get_cursor_pos

Description

Returns the position of the mouse cursor (cursor position in window coordinates, relative to window position).


Syntax

x, y = gh_imgui.get_cursor_pos()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


x, y = gh_imgui.get_cursor_pos()
			


get_cursor_screen_pos

Description

Returns the position of the mouse cursor (cursor position in absolute screen coordinates [0 ; DisplaySize], useful for working with DrawList API).


Syntax

x, y = gh_imgui.get_cursor_screen_pos()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


x, y = gh_imgui.get_cursor_screen_pos()
			


get_cursor_start_pos

Description

Gets the initial cursor position in window coordinates.


Syntax

x, y = gh_imgui.get_cursor_start_pos()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


x, y = gh_imgui.get_cursor_start_pos()
			


get_font_size

Description

Returns the size (height) of the font.


Syntax

size = gh_imgui.get_font_size()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


size = gh_imgui.get_font_size()
			


get_item_rect

Description

Gets the size (bounding rectangle) of the current item.


Syntax

x, y, z, w = gh_imgui.get_item_rect()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


x, y, z, w = gh_imgui.get_item_rect()
			


get_scroll

Description

Gets the scrolling amount in X and Y [0..get_scroll_max()].


Syntax

scroll_x, scroll_y = gh_imgui.get_scroll()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


scroll_x, scroll_y = gh_imgui.get_scroll()
			


get_scroll_max

Description

Gets the maximum scrolling amount in X and Y - X => ContentSize.X - WindowSize.X, Y => ContentSize.Y - WindowSize.Y


Syntax

scroll_x, scroll_y = gh_imgui.get_scroll_max()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


scroll_x, scroll_y = gh_imgui.get_scroll_max()
			


get_text_line_heigh_with_spacing

Description

Distance in pixels between 2 consecutive lines of text


Syntax

h = gh_imgui.get_text_line_heigh_with_spacing()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


h = gh_imgui.get_text_line_heigh_with_spacing()
			


get_version

Description

Returns the version of ImGui.


Syntax

version = gh_imgui.get_version()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


version_str = gh_imgui.get_version()
			


get_window_pos

Description

Returns the position of the current window.


Syntax

x, y = gh_imgui.get_window_pos()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


x, y = gh_imgui.get_window_pos()
			


get_window_pos_size

Description

Returns the position and size of the current window.


Syntax

x, y, width, height = gh_imgui.get_window_pos_size()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


x, y, width, height = gh_imgui.get_window_pos_size()
			


get_window_size

Description

Returns the size of the current window.


Syntax

width, height = gh_imgui.get_window_size()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


width, height = gh_imgui.get_window_size()
			


gizmo_begin_frame

Description

Begins the gizmo rendering. Must be called right after frame_begin().


Syntax

gh_imgui.gizmo_begin_frame()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.frame_begin(...)
gh_imgui.gizmo_begin_frame()
...
			


gizmo_decompose_matrix_to_components

Description

Gets the transformation matrix.


Syntax

tx,ty,tz, rx,ry,rz, sx,sy,sz = gh_imgui.gizmo_decompose_matrix_to_components(
 obj_id
)

Languages


Parameters


Return Values


Code sample


tx,ty,tz,  rx,ry,rz,  sx,sy,sz = gh_imgui.gizmo_decompose_matrix_to_components(obj_id)
			


gizmo_enable

Description

Enables or disables the gizmo.


Syntax

gh_imgui.gizmo_enable(
 state
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.gizmo_enable(1)
			


gizmo_is_over

Description

Is the mouse over the gizmo?


Syntax

state = gh_imgui.gizmo_is_over()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


is_over = gh_imgui.gizmo_is_over()
			


gizmo_is_using

Description

Is the mouse over the gizmo or is the gizmo in moving state?


Syntax

state = gh_imgui.gizmo_is_using()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


is_using = gh_imgui.gizmo_is_using()
			


gizmo_manipulate

Description

Applies the gizmo transformation to an object.


Syntax

gh_imgui.gizmo_manipulate(
 cam_id,
 obj_id,
 oper_type,
 trans_mode
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.gizmo_manipulate(cam_id, obj_id, "rotate", "local")
			


gizmo_set_rect

Description

Defines the gizmo viewport.


Syntax

gh_imgui.gizmo_set_rect(
 x, y, width, height
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.gizmo_set_rect(0, 0, winW, winH)
			


group_begin

Description

Starts a new group. All widgets in a group are seen as a single widget.


Syntax

gh_imgui.group_begin()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.group_begin()

-- display widgets
...

gh_imgui.group_end()
			


group_end

Description

Ends a group.


Syntax

gh_imgui.group_end()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.group_begin()

-- display widgets
...

gh_imgui.group_end()
			


image

Description

Display a texture. Currently, this fonction works in OpenGL only.


Syntax

gh_imgui.image(
 tex_id,
 width, height
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.image(tex0, 200, 200)
			


image_button

Description

Display a button with a texture. Currently, this fonction works in OpenGL only.


Syntax

gh_imgui.image_button(
 tex_id,
 width, height,
 frame_padding
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.image_button(tex0, 200, 200, 1)
			


indent

Description

Sets indent spacing.


Syntax

gh_imgui.indent(
 indent_w
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


indent_w = 10.0
gh_imgui.indent(indent_w)
			


init

Description

Initialize the ImGui library. Must be called once in the INIT script.


Syntax

error = gh_imgui.init()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


ret = gh_imgui.init()
			


input_text

Description

Allows to type a text.


Syntax

state, text = gh_imgui.input_text(
 label,
 max_text_len,
 initial_text,
 flags
)

Languages


Parameters


Return Values


Code sample


flags = ImGuiInputTextFlags_None

text, state = gh_imgui.input_text("User name", 128, "", flags)
			


is_any_item_hovered

Description

Check if any item has been hovered by mouse.


Syntax

hovered = gh_imgui.is_any_item_hovered()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


hovered = gh_imgui.is_any_item_hovered()
			


is_any_window_hovered

Description

Check if any window has been hovered by mouse.


Syntax

hovered = gh_imgui.is_any_window_hovered()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


hovered = gh_imgui.is_any_window_hovered()
			


is_item_clicked

Description

Check if the current item has been clicked.


Syntax

clicked = gh_imgui.is_item_clicked(
 mouse_button
)

Languages


Parameters


Return Values


Code sample


clicked = gh_imgui.is_item_clicked(0)
			


is_item_hovered

Description

Check if the current item has been hovered by mouse.


Syntax

hovered = gh_imgui.is_item_hovered()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


hovered = gh_imgui.is_item_hovered()
			


is_mouse_clicked

Description

Check if any window has been hovered by mouse.


Syntax

state = gh_imgui.is_mouse_clicked(
 button
)

Languages


Parameters


Return Values


Code sample


state = gh_imgui.is_mouse_clicked(button)
			


is_window_hovered

Description

Check if the current window has been hovered by mouse.


Syntax

hovered = gh_imgui.is_window_hovered()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


hovered = gh_imgui.is_window_hovered()
			


list_box_begin

Description

Defines a list box header.


Syntax

ret = gh_imgui.list_box_begin(
 cb_index,
 w, h
)

Languages


Parameters


Return Values


Code sample


ret = gh_imgui.list_box_begin(cb_index, 0)
			


list_box_draw

Description

Draws a combo box as a list box.


Syntax

selected_item = gh_imgui.list_box_draw(
 cb_id,
 initial_selected_item
)

Languages


Parameters


Return Values


Code sample


selected_item = gh_imgui.list_box_draw(cb_id, 0)
			


list_box_draw_v2

Description

Draws a combo box as a list box.


Syntax

selected_item = gh_imgui.list_box_draw_v2(
 cb_id,
 initial_selected_item,
 height_in_items
)

Languages


Parameters


Return Values


Code sample


selected_item = gh_imgui.list_box_draw_v2(cb_id, 0, 20)
			


list_box_end

Description

Ends a list box header.


Syntax

gh_imgui.list_box_end()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.list_box_end()
			


list_clipping_begin

Description

Starts the list clipping. Allows to speed up rendering of very big lists.


Syntax

start_item, end_item = gh_imgui.list_clipping_begin(
 num_items
)

Languages


Parameters


Return Values


Code sample


start_item, end_item = gh_imgui.list_clipping_begin(num_items)
			


list_clipping_end

Description

Ends the list clipping.


Syntax

gh_imgui.list_clipping_end(
 num_items,
 start_item, end_item
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.list_clipping_end(num_items, start_item, end_item)
			


menu_begin

Description

Begins a window menu.


Syntax

state = gh_imgui.menu_begin(
 label,
 enabled
)

Languages


Parameters


Return Values


Code sample


gh_imgui.menu_begin("File", 1)
			


menu_begin_bar

Description

Begins a window menu bar.


Syntax

state = gh_imgui.menu_begin_bar()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


gh_imgui.menu_begin_bar()
			


menu_begin_main_bar

Description

Begins the main menu bar (fullscreen menu bar).


Syntax

state = gh_imgui.menu_begin_main_bar()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


gh_imgui.menu_begin_main_bar()
			


menu_end

Description

Ends a window menu.


Syntax

gh_imgui.menu_end()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.menu_end()
			


menu_end_bar

Description

Ends a window menu bar.


Syntax

gh_imgui.menu_end_bar()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.menu_end_bar()
			


menu_end_main_bar

Description

Ends the main menu bar.


Syntax

gh_imgui.menu_end_main_bar()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.menu_end_main_bar()
			


menu_item

Description

Adds an item to the current menu. Must be used between menu_begin() and menu_end().


Syntax

state = gh_imgui.menu_item(
 label,
 shortcut,
 selected,
 enabled
)

Languages


Parameters


Return Values


Code sample


enabled = 1

gh_imgui.menu_item("Load a file", "", 0, enabled)
			


plotline_create

Description

Creates a plotline.


Syntax

index = gh_imgui.plotline_create(
 label,
 num_points
)

Languages


Parameters


Return Values


Code sample


plotline_index = gh_imgui.plotline_create("Curve", 1000)
			


plotline_draw

Description

Draws a plotline.


Syntax

gh_imgui.plotline_draw(
 index,
 type,
 overlay,
 values_offset,
 scale_min, scale_max,
 graph_size_x, graph_size_y
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


values_offset = 0
scale_min = 0
scale_max = 100
graph_size_x = 400
graph_size_y = 200

gh_imgui.plotline_draw(plotline_index, type, "overlay!", values_offset, scale_min, scale_max, graph_size_x, graph_size_y)
			


plotline_draw_v2

Description

Draws a plotline.


Syntax

gh_imgui.plotline_draw_v2(
 index,
 type,
 overlay,
 num_values,
 values_offset,
 scale_min, scale_max,
 graph_size_x, graph_size_y
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


values_offset = 0
values_count = 1000
scale_min = 0
scale_max = 100
graph_size_x = 400
graph_size_y = 200

gh_imgui.plotline_draw_v2(plotline_index, type, "overlay!", values_count, values_offset, scale_min, scale_max, graph_size_x, graph_size_y)
			


plotline_get_value1f

Description

Gets a value from the plotline.


Syntax

x = gh_imgui.plotline_get_value1f(
 index,
 value_index
)

Languages


Parameters


Return Values


Code sample


x = gh_imgui.plotline_get_value1f(plotline_index, value_index)
			


plotline_set_value1f

Description

Sets a value in the plotline.


Syntax

gh_imgui.plotline_set_value1f(
 index,
 value_index,
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plotline_set_value1f(plotline_index, value_index, x)
			


pop_font

Description

Restores the font saved by push_font().


Syntax

gh_imgui.pop_font()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.pop_font()
			


pop_item_width

Description

Restore the width that has been changed by push_item_width().


Syntax

gh_imgui.pop_item_width()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


local width = gh_imgui.get_content_region_available_width()

gh_imgui.push_item_width(width * 0.8)
...
gh_imgui.pop_item_width()
			


pop_style_color

Description

Restores a color saved with push_style_color().


Syntax

gh_imgui.pop_style_color()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.pop_style_color()
			


popup_begin

Description

Begins a popup window. Click outside the popup to close it.


Syntax

ret = gh_imgui.popup_begin(
 label
)

Languages


Parameters


Return Values


Code sample


ret = gh_imgui.popup_begin("blabla")
			


popup_begin_context

Description

Begins a popup window.


Syntax

ret = gh_imgui.popup_begin_context(
 label
)

Languages


Parameters


Return Values


Code sample


ret = gh_imgui.popup_begin_context("blabla")
			


popup_end

Description

Ends a popup window. Call this function only if popup_begin_xxx() return 1 (the popup is opened).


Syntax

gh_imgui.popup_end()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.popup_end()
			


popup_open

Description

Call to mark popup as open (don't call every frame!)


Syntax

gh_imgui.popup_open(
 label
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.popup_open("blabla")
			


progress_bar

Description

Displays a progress bar.


Syntax

gh_imgui.progress_bar(
 fraction,
 width, height,
 overlay
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.progress_bar(0.45, width, height, overlay_str)
			


push_font

Description

Saves the current font and makes a new font the current active font for next text rendering calls.


Syntax

gh_imgui.push_font(
 font_id
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.push_font(font_id)
			


push_item_width

Description

Sets the width of next items. This width is valid until a call to pop_item_width().


Syntax

gh_imgui.push_item_width(
 width
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


local width = gh_imgui.get_content_region_available_width()

gh_imgui.push_item_width(width * 0.8)
...
gh_imgui.pop_item_width()
			


push_style_color

Description

Sets a new color to a particular color element.


Syntax

gh_imgui.push_style_color(
 item_type,
 r, g, b, a
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


element_type = IMGUI_WINDOW_BG_COLOR

gh_imgui.push_style_color(element_type, r, g, b, a)
			


radio_button

Description

Display a radio button.


Syntax

gh_imgui.radio_button(
 name,
 active
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.radio_button("radio button 1", 0)
gh_imgui.radio_button("radio button 2", 1)
gh_imgui.radio_button("radio button 3", 0)
			


rebuild_all_fonts

Description

Rebuild all fonts. Call this function once you have loaded some fonts with add_font_xxx().


Syntax

gh_imgui.rebuild_all_fonts()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.rebuild_all_fonts()
			


reset_default_font

Description

Resets the default font used by ImGui.


Syntax

gh_imgui.reset_default_font()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.reset_default_font()
			


same_line

Description

Allows to group items horizontally.


Syntax

gh_imgui.same_line(
 local_pos_x,
 spacing_w
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.same_line(local_pos_x, spacing_w)
			


select_draw_list

Description

Select the draw list that will receive all draw commands. Default is DRAWLIST_WINDOW.


Syntax

gh_imgui.select_draw_list(
 draw_list
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


IMGUI_DRAWLIST_WINDOW = 0
IMGUI_DRAWLIST_BACKGROUND = 1
IMGUI_DRAWLIST_FOREGROUND = 2

draw_list = IMGUI_DRAWLIST_WINDOW

gh_imgui.select_draw_list(draw_list)
			


selectable

Description

Allows to select texts in list / widgets.


Syntax

ret = gh_imgui.selectable(
 text,
 selected,
 flags
)

Languages


Parameters


Return Values


Code sample


-- Possible flags
ImGuiSelectableFlags_None = 0
ImGuiSelectableFlags_DontClosePopups = 1 -- // Clicking this don't close parent popup window
ImGuiSelectableFlags_SpanAllColumns = 2 -- Selectable frame can span all columns (text will still fit in current column)
ImGuiSelectableFlags_AllowDoubleClick = 4 -- Generate press events on double clicks too
ImGuiSelectableFlags_Disabled = 8 -- Cannot be selected, display greyed out text

selected = 0
flags = ImGuiSelectableFlags_SpanAllColumns

ret = gh_imgui.selectable(text, selected, flags)
			


separator

Description

Adds an horizontal line (separator).


Syntax

gh_imgui.separator()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.separator()
			


set_color

Description

Sets the color of the next widget.


Syntax

gh_imgui.set_color(
 item_type,
 r, g, b, a
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


IMGUI_WINDOW_BG_COLOR = 1
IMGUI_TITLE_BG_COLOR = 2
IMGUI_PLOTLINES_COLOR = 3
IMGUI_FRAME_BG_COLOR = 4
IMGUI_TITLE_BG_ACTIVE_COLOR = 5
IMGUI_TITLE_BG_COLLAPSED_COLOR = 6
IMGUI_PLOTHISTOGRAM_COLOR = 7
IMGUI_COMBO_BG_COLOR = 8
IMGUI_BUTTON_COLOR = 9
IMGUI_SEPARATOR_COLOR = 10
IMGUI_RESIZE_GRIP_COLOR = 11
IMGUI_PLOTLINE_HOVERED_COLOR = 12
IMGUI_PLOTHISTOGRAM_HOVERED_COLOR = 13
IMGUI_BUTTON_HOVERED_COLOR = 14
IMGUI_SEPARATOR_HOVERED_COLOR = 15
IMGUI_RESIZE_GRIP_HOVERED_COLOR = 16
IMGUI_HEADER_COLOR = 17
IMGUI_HEADER_HOVERED_COLOR = 18
IMGUI_SLIDER_GRAB_COLOR = 19
IMGUI_CHECK_MARK_COLOR = 20
IMGUI_SCROLLBAR_BG_COLOR = 21
IMGUI_SCROLLBAR_GRAB_COLOR = 22
IMGUI_SCROLLBAR_GRAB_HOVERED_COLOR = 23
IMGUI_TEXT_COLOR = 24
IMGUI_POPUP_BG_COLOR = 25
IMGUI_TEXT_DISABLED_COLOR = 26
IMGUI_CHILD_BG_COLOR = 27
IMGUI_BORDER_COLOR = 28
IMGUI_BORDER_SHADOW_COLOR = 29
IMGUI_FRAME_BG_HOVERED_COLOR = 30
IMGUI_FRAME_BG_ACTIVE_COLOR = 31
IMGUI_MENU_BAR_BG_COLOR = 32
IMGUI_SCROLLBAR_GRAB_ACTIVE_COLOR = 33
IMGUI_SLIDER_GRAB_ACTIVE_COLOR = 34
IMGUI_BUTTON_ACTIVE_COLOR = 35
IMGUI_HEADER_ACTIVE_COLOR = 36
IMGUI_SEPARATOR_ACTIVE_COLOR = 37
IMGUI_RESIZE_GRIP_ACTIVE_COLOR = 38
IMGUI_CLOSE_BUTTON_COLOR = 39
IMGUI_CLOSE_BUTTON_HOVERED_COLOR = 40
IMGUI_CLOSE_BUTTON_ACTIVE_COLOR = 41
IMGUI_PLOTLINES_HOVERED_COLOR = 42
IMGUI_TEXT_SELECTED_BG_COLOR = 43
IMGUI_MODAL_WINDOW_DARKENING_COLOR = 44
IMGUI_DRAG_DROP_TARGET_COLOR = 45
IMGUI_NAV_HIGHLIGHT_COLOR = 46
IMGUI_NAV_WINDOW_IN_HIGHLIGHT_COLOR = 47
IMGUI_MODAL_WINDOW_DIM_BG_COLOR = 48
IMGUI_TAB_COLOR = 49
IMGUI_TAB_HOVERED_COLOR = 50
IMGUI_TAB_ACTIVE_COLOR = 51
IMGUI_TAB_UNFOCUSED_COLOR = 52
IMGUI_TAB_UNFOCUSED_ACTIVE_COLOR = 53

widget_type = IMGUI_BUTTON_COLOR

gh_imgui.set_color(widget_type, r, g, b, a)
			


set_cur_font_display_offset

Description

Sets the x and y offset of the current font. Useful to adjust the vertical alignment of a text.


Syntax

gh_imgui.set_cur_font_display_offset(
 x, y
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_cur_font_display_offset(x, y)
			


set_default_font

Description

Sets the default font.


Syntax

gh_imgui.set_default_font(
 font_id
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_default_font(font_id)
			


set_frame_border_size

Description

Sets the size of the frame border.


Syntax

gh_imgui.set_frame_border_size(
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_frame_border_size(x)
			


set_rounding

Description

Sets the rounding of a particular element. A value of 0 means a squared corner.


Syntax

gh_imgui.set_rounding(
 what,
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_rounding("frame", x)
			


set_indent_spacing

Description

Sets the indent size.


Syntax

gh_imgui.set_indent_spacing(
 spacing
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_indent_spacing(spacing)
			


set_item_default_focus

Description

Makes last item the default focused item of a window.


Syntax

gh_imgui.set_item_default_focus()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_item_default_focus()
			


set_keyboard_focus_here

Description

Focuses keyboard on the next widget. Use positive offset to access sub components of a multiple component widget. Use -1 to access previous widget.


Syntax

gh_imgui.set_keyboard_focus_here(
 offset
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_keyboard_focus_here(offset)
			


set_next_item_width

Description

Sets the size of the next item.


Syntax

gh_imgui.set_next_item_width(
 width
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_next_item_width(width)
			


set_next_window_content_size

Description

Sets the size of the window content.


Syntax

gh_imgui.set_next_window_content_size(
 width, height
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_next_window_content_size(width, height)
			


set_scroll

Description

Sets the scrolling amount in X and Y [0..get_scroll_max()].


Syntax

gh_imgui.set_scroll(
 scroll_x, scroll_y
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_scroll(scroll_x, scroll_y)
			


set_scroll_from_pos_y

Description

Adjusts scrolling amount to make given position visible. Generally get_cursor_start_pos() + offset to compute a valid position.


Syntax

gh_imgui.set_scroll_from_pos_y(
 local_y,
 center_y_ratio
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_scroll_from_pos_y(local_y, center_y_ratio)
			


set_scroll_here_y

Description

Adjusts scrolling amount to make current cursor position visible. center_y_ratio=0.0: top, 0.5: center, 1.0: bottom. When using to make a default/current item visible, consider using set_item_default_focus() instead.


Syntax

gh_imgui.set_scroll_here_y(
 center_y_ratio
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_scroll_here_y(center_y_ratio)
			


set_style_colors

Description

Sets a built-in color style.


Syntax

gh_imgui.set_style_colors(
 style
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


-- Available sytles:
"classic"
"dark"
"light"
"krosoft"
"maya"
"rayteak"
"fromhue"
"cherry"
"dark2"
"corporate_grey"

style_name = "classic"
gh_imgui.set_style_colors(style_name)
			


set_tooltip

Description

Sets a tooltip.


Syntax

gh_imgui.set_tooltip(
 caption
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_tooltip("This is a tooltip!")
			


set_window_border_size

Description

Sets the size of the window border.


Syntax

gh_imgui.set_window_border_size(
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_window_border_size(x)
			


set_window_focus

Description

Sets named window to be focused (front-most).


Syntax

gh_imgui.set_window_focus(
 name
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_window_focus(name)
			


set_window_rounding

Description

Sets the window corner rounding.


Syntax

gh_imgui.set_window_rounding(
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_window_rounding(x)
			


show_demo_window

Description

Renders the ImGui demo window.


Syntax

gh_imgui.show_demo_window()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.show_demo_window()
			


show_metrics_window

Description

Display an ImGui built-in window that shows statistics about all windows. Call this function between frame_begin() and frame_end().


Syntax

gh_imgui.show_metrics_window()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.show_metrics_window()
			


show_test_window

Description

Shows ImGui test window.


Syntax

gh_imgui.show_test_window()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.frame_begin(winW, winH, mouse_x, mouse_y, mouse_left_button, mouse_right_button)

gh_imgui.show_test_window()

gh_imgui.frame_end()
			


slider_1i

Description

Displays a 1D slider with integer values.


Syntax

value = gh_imgui.slider_1i(
 label,
 initial_value,
 v_min, v_max
)

Languages


Parameters


Return Values


Code sample


v = gh_imgui.slider_1i("slider01", initial_value, v_min, v_max)
			


slider_1i_v2

Description

Displays a 1D slider with integer values.


Syntax

value = gh_imgui.slider_1i_v2(
 label,
 initial_value,
 v_min, v_max,
 flags
)

Languages


Parameters


Return Values


Code sample


ImGuiSliderFlags_None                   = 0
ImGuiSliderFlags_ClampOnInput           = 16
ImGuiSliderFlags_Logarithmic            = 32
ImGuiSliderFlags_NoRoundToFormat        = 64
ImGuiSliderFlags_NoInput                = 12
v = gh_imgui.slider_1i_v2("slider01", initial_value, v_min, v_max, ImGuiSliderFlags_None)
			


slider_1f

Description

Displays a 1D slider.


Syntax

value = gh_imgui.slider_1f(
 label,
 initial_value,
 v_min, v_max,
 power
)

Languages


Parameters


Return Values


Code sample


v = gh_imgui.slider_1f("slider01", initial_value, v_min, v_max, 1.0)
			


slider_2f

Description

Displays a 2D slider.


Syntax

x, y = gh_imgui.slider_2f(
 label,
 x0, y0,
 v_min, v_max,
 power
)

Languages


Parameters


Return Values


Code sample


x, y = gh_imgui.slider_2f("slider04", x0, y0, v_min, v_max, 1.0)
			


slider_3f

Description

Displays a 3D slider.


Syntax

x, y, z = gh_imgui.slider_3f(
 label,
 x0, y0, z0,
 v_min, v_max,
 power
)

Languages


Parameters


Return Values


Code sample


x, y, z = gh_imgui.slider_3f("slider03", x0, y0, z0, v_min, v_max, 1.0)
			


slider_4f

Description

Displays a 4D slider.


Syntax

x, y, z, w = gh_imgui.slider_4f(
 label,
 x0, y0, z0, w0,
 v_min, v_max,
 power
)

Languages


Parameters


Return Values


Code sample


x, y, z, w = gh_imgui.slider_4f("slider02", x0, y0, z0, w0, v_min, v_max, 1.0)
			


spacing

Description

Adds a vertical space.


Syntax

gh_imgui.spacing()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.spacing()
			


bullet

Description

Adds a bullet (for lists).


Syntax

gh_imgui.bullet()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.bullet()
			


tab_bar_begin

Description

Begins a tab bar.


Syntax

is_opened = gh_imgui.tab_bar_begin(
 label
)

Languages


Parameters


Return Values


Code sample


ret = gh_imgui.tab_bar_begin("tabbar01")
			


tab_bar_begin_v2

Description

Begins a tab bar.


Syntax

is_opened = gh_imgui.tab_bar_begin_v2(
 label,
 flags
)

Languages


Parameters


Return Values


Code sample


ImGuiTabBarFlags_None = 0,
ImGuiTabBarFlags_Reorderable = 1
ImGuiTabBarFlags_AutoSelectNewTabs = 2
ImGuiTabBarFlags_NoCloseWithMiddleMouseButton = 4
ImGuiTabBarFlags_NoTabListPopupButton = 8
ImGuiTabBarFlags_NoTabListScrollingButtons = 16
ImGuiTabBarFlags_NoTooltip = 32
ImGuiTabBarFlags_FittingPolicyResizeDown = 64
ImGuiTabBarFlags_FittingPolicyScroll = 128

ret = gh_imgui.tab_bar_begin_v2("tabbar01", ImGuiTabBarFlags_Reorderable)
			


tab_bar_end

Description

Ends a tab bar.


Syntax

gh_imgui.tab_bar_end()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


ImGuiTabBarFlags_Reorderable = 1

if (gh_imgui.tab_bar_begin_v2("tabbar01", ImGuiTabBarFlags_Reorderable) == 1) then
    ...
    gh_imgui.tab_bar_end()
end
			


tab_item_begin

Description

Begins a tab bar item.


Syntax

is_opened = gh_imgui.tab_item_begin(
 label,
 show_tab,
 flags
)

Languages


Parameters


Return Values


Code sample


flags = ImGuiTabItemFlags_None -- 0
show_tab = 1
if (gh_imgui.tab_bar_begin("tabbar01", show_tab, flags) == 1) then
    flags = 0

    if (gh_imgui.tab_item_begin("TAB1", 1, flags) == 1) then
        gh_imgui.text("This is the TAB1")
        gh_imgui.tab_item_end()
    end

    if (gh_imgui.tab_item_begin("TAB2", 0, flags) == 1) then
        gh_imgui.text("This is the TAB2")
        gh_imgui.tab_item_end()
    end

    gh_imgui.tab_bar_end()
end
			


tab_item_begin_v2

Description

Begins a tab bar item.


Syntax

is_opened = gh_imgui.tab_item_begin_v2(
 label,
 flags
)

Languages


Parameters


Return Values


Code sample


if (gh_imgui.tab_bar_begin_v2("tabbar01", flags) == 1) then
    flags = 0

    if (gh_imgui.tab_item_begin("TAB1", 1, flags) == 1) then
        gh_imgui.text("This is the TAB1")
        gh_imgui.tab_item_end()
    end

    if (gh_imgui.tab_item_begin("TAB2", 1, flags) == 1) then
        gh_imgui.text("This is the TAB2")
        gh_imgui.tab_item_end()
    end

    gh_imgui.tab_bar_end()
end
			


tab_item_end

Description

Ends a tab bar item.


Syntax

gh_imgui.tab_item_end()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


flags = 0

if (gh_imgui.tab_bar_begin_v2("tabbar01", flags) == 1) then
    flags = 0

    if (gh_imgui.tab_item_begin("TAB1", 1, flags) == 1) then
        gh_imgui.text("This is the TAB1")
        gh_imgui.tab_item_end()
    end

    if (gh_imgui.tab_item_begin("TAB2", 1, flags) == 1) then
        gh_imgui.text("This is the TAB2")
        gh_imgui.tab_item_end()
    end

    gh_imgui.tab_bar_end()
end
			


terminate

Description

Terminates the ImGui library. Must be called once in the TERMINATE script.


Syntax

gh_imgui.terminate()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.terminate()
			


text

Description

Displays a simple text.


Syntax

gh_imgui.text(
 text
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.text("GeeXLab is powerful!")
			


text_rgba

Description

Displays a colored text.


Syntax

gh_imgui.text_rgba(
 text,
 r, g, b, a
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.text_rgba("GeeXLab is powerful!", 1.0, 1.0, 0.0, 1.0)
			


text_unformatted_v1

Description

Displays a raw text without formatting. Recommended for long chunks of text.


Syntax

gh_imgui.text_unformatted_v1(
 text
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.text_unformatted_v1("GeeXLab is powerful!")
			


text_unformatted_v2

Description

Displays a raw text without formatting. Recommended for long chunks of text.


Syntax

gh_imgui.text_unformatted_v2(
 text,
 text_end
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.text_unformatted_v2("GeeXLab is powerful!")
			


text_wrapped

Description

Displays a wrapped text.


Syntax

gh_imgui.text_wrapped(
 text
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.text_wrapped("GeeXLab is powerful!")
			


tree_node

Description

Starts a tree.


Syntax

state = gh_imgui.tree_node(
 label
)

Languages


Parameters


Return Values


Code sample


node_open = gh_imgui.tree_node("Root")
if (node_open == 1) then
    gh_imgui.tree_node_leaf("Child 1")
    if (gh_imgui.is_item_clicked(mouse_button_left) == 1) then
        tree_selected_node_name = "Child 1"
    end
    gh_imgui.tree_pop()
end
			


tree_node_ex

Description

Starts a tree.


Syntax

state = gh_imgui.tree_node_ex(
 label,
 flags
)

Languages


Parameters


Return Values


Code sample


flags = ImGuiTreeNodeFlags_Selected
node_open = gh_imgui.tree_node_ex("Root", flags)
if (node_open == 1) then
    gh_imgui.tree_node_leaf("Child 1")
    if (gh_imgui.is_item_clicked(mouse_button_left) == 1) then
        tree_selected_node_name = "Child 1"
    end
    gh_imgui.tree_pop()
end
			


tree_node_leaf

Description

Display a tree leaf.


Syntax

gh_imgui.tree_node_leaf(
 label
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


node_open = gh_imgui.tree_node("Root")

if (node_open == 1) then
    gh_imgui.tree_node_leaf("Child 1")

    if (gh_imgui.is_item_clicked(mouse_button_left) == 1) then
        tree_selected_node_name = "Child 1"
    end

    gh_imgui.tree_pop()
end
			


tree_node_leaf_v2

Description

Display a tree leaf.


Syntax

gh_imgui.tree_node_leaf_v2(
 label,
 flags
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


node_open = gh_imgui.tree_node("Root")

if (node_open == 1) then
    local ImGuiTreeNodeFlags_Bullet = 512

    gh_imgui.tree_node_leaf_v2("Child 1", ImGuiTreeNodeFlags_Bullet)

    if (gh_imgui.is_item_clicked(mouse_button_left) == 1) then
        tree_selected_node_name = "Child 1"
    end

    gh_imgui.tree_pop()
end
			


tree_pop

Description

Ends a tree.


Syntax

gh_imgui.tree_pop()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


node_open = gh_imgui.tree_node("Root")

if (node_open == 1) then
    gh_imgui.tree_node_leaf("Child 1")

    if (gh_imgui.is_item_clicked(mouse_button_left) == 1) then
        tree_selected_node_name = "Child 1"
    end

    gh_imgui.tree_pop()
end
			


underline

Description

Draw a colored line under the current item.


Syntax

gh_imgui.underline(
 r, g, b, a
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.underline(r, g, b, a)
			


unindent

Description

Sets unindent spacing.


Syntax

gh_imgui.unindent(
 indent_w
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.unindent(indent_w)
			


url

Description

Draw a clickable url.


Syntax

clicked = gh_imgui.url(
 link_caption,
 link_url,
 tooltip_text
)

Languages


Parameters


Return Values


Code sample


clicked = gh_imgui.url(link_caption, link_url, tooltip_text)
			


vslider_1f

Description

Displays a 1D vertical slider.


Syntax

value = gh_imgui.vslider_1f(
 label,
 width, height,
 initial_value,
 v_min, v_max,
 power
)

Languages


Parameters


Return Values


Code sample


v = gh_imgui.vslider_1f("vslider01", 20, 100, initial_value, v_min, v_max, 1.0)
			


vslider_1i

Description

Displays a 1D vertical slider with integer values.


Syntax

value = gh_imgui.vslider_1i(
 label,
 width, height,
 initial_value,
 v_min, v_max
)

Languages


Parameters


Return Values


Code sample


v = gh_imgui.vslider_1i("slider01", 20, 100, initial_value, v_min, v_max)
			


vslider_1i_v2

Description

Displays a 1D vertical slider with integer values.


Syntax

value = gh_imgui.vslider_1i_v2(
 label,
 width, height,
 initial_value,
 v_min, v_max,
 flags
)

Languages


Parameters


Return Values


Code sample


ImGuiSliderFlags_None                   = 0
ImGuiSliderFlags_ClampOnInput           = 16
ImGuiSliderFlags_Logarithmic            = 32
ImGuiSliderFlags_NoRoundToFormat        = 64
ImGuiSliderFlags_NoInput                = 128
v = gh_imgui.vslider_1i_v2("slider01", 20, 100, initial_value, v_min, v_max, ImGuiSliderFlags_None)
			


widget

Description

Adds a widget.


Syntax

gh_imgui.widget(
 widget_type
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


IMGUI_WIDGET_SEPARATOR = 1
IMGUI_WIDGET_SAME_LINE = 2
IMGUI_WIDGET_BULLET = 3
IMGUI_WIDGET_VERTICAL_SPACING = 4
IMGUI_WIDGET_NEW_LINE = 5

gh_imgui.widget(IMGUI_WIDGET_SEPARATOR)
			


window_begin

Description

Starts the rendering of a window.


Syntax

is_open = gh_imgui.window_begin(
 name,
 width, height,
 pos_x, pos_y,
 win_flags,
 pos_flags,
 size_flags
)

Languages


Parameters


Return Values


Code sample


-- Window options
local window_default = 0
local window_no_resize = 2
local window_no_move = 4
local window_no_collapse = 32
local window_show_border = 128
local window_no_save_settings = 256

-- Position or size options
local pos_size_flag_always = 1 -- Always set the pos and/or size
local pos_size_flag_once = 2 -- Set the pos and/or size once per runtime session (only the first call with succeed)
local pos_size_flag_first_use_ever = 4 -- Set the pos and/or size if the window has no saved data (if doesn't exist in the .ini file)
local pos_size_flag_appearing = 8 -- Set the pos and/or size if the window is appearing after being hidden/inactive (or the first time)

-- window_flags = window_no_move | window_no_save_settings
window_flags = 0
pos_flags = pos_size_flag_first_use_ever
size_flags = pos_size_flag_first_use_ever

is_open = gh_imgui.window_begin("GeeXLab ImGui demo", 300, 200, 20, 20, window_flags, pos_flags, size_flags)
if (is_open == 1) then
    gh_imgui.text("GeeXLab is powerful!")
end

gh_imgui.window_end()
			


window_begin_v2

Description

Starts the rendering of a window. This window has a close button.


Syntax

is_open, show_window = gh_imgui.window_begin_v2(
 name,
 width, height,
 pos_x, pos_y,
 win_flags,
 pos_flags,
 size_flags,
 show_window
)

Languages


Parameters


Return Values


Code sample


-- Window options
local window_default = 0
local window_no_resize = 2
local window_no_move = 4
local window_no_collapse = 32
local window_show_border = 128
local window_no_save_settings = 256

-- Position or size options
local pos_size_flag_always = 1 -- Always set the pos and/or size
local pos_size_flag_once = 2 -- Set the pos and/or size once per runtime session (only the first call with succeed)
local pos_size_flag_first_use_ever = 4 -- Set the pos and/or size if the window has no saved data (if doesn't exist in the .ini file)
local pos_size_flag_appearing = 8 -- Set the pos and/or size if the window is appearing after being hidden/inactive (or the first time)

-- window_flags = window_no_move | window_no_save_settings
window_flags = 0
pos_flags = pos_size_flag_first_use_ever
size_flags = pos_size_flag_first_use_ever

if (show_window == 1) then
    window_flags = 0
    show = show_window

    is_open, show_window = gh_imgui.window_begin_v2("GeeXLab information", 300, 200, 20, 20, window_flags, pos_flags, size_flags, show)
    if (is_open == 1) then
        gh_imgui.text("GeeXLab is powerful!")
    end

    gh_imgui.window_end()
end
			


window_end

Description

Stops the rendering of a window.


Syntax

gh_imgui.window_end()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


window_flags = 0
gh_imgui.window_begin("GeeXLab information", 300, 200, 20, 20, window_flags)
gh_imgui.text("GeeXLab is powerful!")
gh_imgui.window_end()
			


imguizmoquat_gizmo3d_v1

Description

Rotates an object using a virtual trackball.


Syntax

gh_imgui.imguizmoquat_gizmo3d_v1(
 label,
 size,
 mode,
 object_id
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


local mode3Axes = 1
local modeDirection = 2
local modeDirPlane = 4
local modeDual = 8
local modeMask = 15
local cubeAtOrigin = 16
local sphereAtOrigin = 32
local noSolidAtOrigin = 64
local modeFullAxes = 128
local axesModeMask = 240
gh_imgui.imguizmoquat_gizmo3d_v1("##gizmo01", 100.0, modeDirection + cubeAtOrigin, torus)
			


imguizmoquat_gizmo3d_v2

Description

Rotates a virtual trackball and returns the orientation quaternion.


Syntax

qx, qy, qz, qw = gh_imgui.imguizmoquat_gizmo3d_v2(
 label,
 size,
 mode,
 q0x, q0y, q0z, q0w
)

Languages


Parameters


Return Values


Code sample


local mode3Axes = 1
local modeDirection = 2
local modeDirPlane = 4
local modeDual = 8
local modeMask = 15
local cubeAtOrigin = 16
local sphereAtOrigin = 32
local noSolidAtOrigin = 64
local modeFullAxes = 128
local axesModeMask = 240

q0 = {x=0, y=0, z=0, w=0}
qr = {x=0, y=0, z=0, w=0}

qr.x, qr.w, qr.z, qr.w = gh_imgui.imguizmoquat_gizmo3d_v2("##gizmo01", 100.0, modeDirection + cubeAtOrigin, q0.x, q0.y, q0.z, q0.w)
			


imguizmoquat_gizmo3d_v3

Description

Rotates a virtual trackball and returns the 4x4 orientation matrix.


Syntax

m0,m1,m2,m3,m4,m5,m6,m7,m8,m9,m10,m11,m12,m13,m14,m15 = gh_imgui.imguizmoquat_gizmo3d_v3(
 label,
 size,
 mode,
 q0x, q0y, q0z, q0w
)

Languages


Parameters


Return Values


Code sample


local mode3Axes = 1
local modeDirection = 2
local modeDirPlane = 4
local modeDual = 8
local modeMask = 15
local cubeAtOrigin = 16
local sphereAtOrigin = 32
local noSolidAtOrigin = 64
local modeFullAxes = 128
local axesModeMask = 240

q0 = {x=0, y=0, z=0, w=0}

m0,m1,m2,m3,m4,m5,m6,m7,m8,m9,m10,m11,m12,m13,m14,m15 = gh_imgui.imguizmoquat_gizmo3d_v3("##gizmo01", 100.0, modeDirection + cubeAtOrigin, q0.x, q0.y, q0.z, q0.w)
			


set_item_spacing

Description

Sets the spacing between items.


Syntax

gh_imgui.set_item_spacing(
 x, y
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.set_item_spacing(x, y)
			


get_item_spacing

Description

Gets the spacing between items.


Syntax

x, y = gh_imgui.get_item_spacing()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


x, y = gh_imgui.get_item_spacing()
			


imgui_plot_create

Description

Creates a plotline.


Syntax

plot_id = gh_imgui.imgui_plot_create(
 label
)

Languages


Parameters


Return Values


Code sample


plot_id = gh_imgui.imgui_plot_create("myPlotline")
			


plot_kill

Description

Destroys a plotline.


Syntax

gh_imgui.plot_kill(
 plot_id
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_kill(plot_id)
			


plot_draw

Description

Draws a plotline.


Syntax

gh_imgui.plot_draw(
 plot_id,
 label,
 num_items,
 size_x, size_y
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_draw(plot_id, label, num_items, size_x, size_y)
			


plot_set_title

Description

Sets the title a plotline.


Syntax

gh_imgui.plot_set_title(
 plot_id,
 title
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_set_title(plot_id, title)
			


plot_set_color

Description

Sets the color a of particular element of a plotline.


Syntax

gh_imgui.plot_set_color(
 plot_id,
 what,
 r, g, b, a
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_set_color(plot_id, "background", 0.4, 0.4, 0.4, 0.85)
			


plot_set_state

Description

Sets the state a of particular element of a plotline.


Syntax

gh_imgui.plot_set_state(
 plot_id,
 what,
 state
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_set_state(plot_id, "show_crosshairs", state)
			


plot_set_axis_param_bool

Description

Sets the state a of particular element of an axis.


Syntax

gh_imgui.plot_set_axis_param_bool(
 plot_id,
 axis,
 what,
 state
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


axis_x = 0			
axis_y = 1			
state = 1
gh_imgui.plot_set_axis_param_bool(plot_id, axis_x, "show_grid", state)
gh_imgui.plot_set_axis_param_bool(plot_id, axis_y, "show_grid", state)
			


plot_set_axis_param_int

Description

Sets the value a of particular element of an axis.


Syntax

gh_imgui.plot_set_axis_param_int(
 plot_id,
 axis,
 what,
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


axis_x = 0			
gh_imgui.plot_set_axis_param_int(plot_id, axis_x, "divisions", 10)
gh_imgui.plot_set_axis_param_int(plot_id, axis_x, "subdivisions", 4)
			


plot_set_axis_param_float

Description

Sets the value a of particular element of an axis.


Syntax

gh_imgui.plot_set_axis_param_float(
 plot_id,
 axis,
 what,
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


axis_y = 1			
gh_imgui.plot_set_axis_param_float(plot_id, axis_y, "minimum", -10.0)
gh_imgui.plot_set_axis_param_bool(plot_id, axis_y, "minimum", 10.0)
			


plot_set_axis_label

Description

Sets the label of an axis.


Syntax

gh_imgui.plot_set_axis_label(
 plot_id,
 axis,
 label
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


axis_y = 1			
gh_imgui.plot_set_axis_label(plot_id, axis_y, "Y axis")
			


plot_set_axis_color

Description

Sets the color of an axis.


Syntax

gh_imgui.plot_set_axis_color(
 plot_id,
 axis,
 r, g, b, a
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


axis_y = 1			
gh_imgui.plot_set_axis_color(plot_id, axis_y, r, g, b, a)
			


plot_add_item

Description

Adds a new item (a line) to an existing plotline.


Syntax

item_index = gh_imgui.plot_add_item(
 plot_id,
 label,
 type
)

Languages


Parameters


Return Values


Code sample


type_line = 0
type_scatter = 1
type_xbar = 2
type_ybar = 3
item_index = gh_imgui.plot_add_item(plot_id, "myNewItem", type_line)
			


plot_item_set_label

Description

Sets a label of an item.


Syntax

gh_imgui.plot_item_set_label(
 plot_id,
 item_index,
 label
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_add_item(plot_id, item_index, "myItem")
			


plot_item_set_color

Description

Sets the color of an item.


Syntax

gh_imgui.plot_item_set_color(
 plot_id,
 item_index,
 r, g, b, a
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_item_set_color(plot_id, item_index, r, g, b, a)
			


plot_item_set_type

Description

Sets the type of an item.


Syntax

gh_imgui.plot_item_set_type(
 plot_id,
 item_index,
 type
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_item_set_type(plot_id, item_index, type)
			


plot_item_set_size

Description

Sets the size (or tickness) of an item.


Syntax

gh_imgui.plot_item_set_size(
 plot_id,
 item_index,
 size
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_item_set_size(plot_id, item_index, 2.0)
			


plot_item_set_data_begin

Description

Sets the start offset.


Syntax

gh_imgui.plot_item_set_data_begin(
 plot_id,
 item_index,
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_item_set_data_begin(plot_id, item_index, 0)
			


plot_item_add_data

Description

Adds data to an item.


Syntax

gh_imgui.plot_item_add_data(
 plot_id,
 item_index,
 x, y
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_item_add_data(plot_id, item_index, x, y)
			


plot_item_get_data_size

Description

Gets the data size of an item.


Syntax

n = gh_imgui.plot_item_get_data_size(
 plot_id,
 item_index
)

Languages


Parameters


Return Values


Code sample


n = gh_imgui.plot_item_get_data_size(plot_id, item_index)
			


plot_item_clear_data

Description

Clears all data of an item.


Syntax

gh_imgui.plot_item_clear_data(
 plot_id,
 item_index
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_item_clear_data(plot_id, item_index)
			


plot_item_clear_data

Description

Resize data of an item.


Syntax

gh_imgui.plot_item_clear_data(
 plot_id,
 item_index,
 n
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_item_resize_data(plot_id, item_index, n)
			


plot_item_set_data

Description

Sets data of an item.


Syntax

gh_imgui.plot_item_set_data(
 plot_id,
 item_index,
 data_index,
 x, y
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_item_set_data(plot_id, item_index, , data_index, x, y)
			


plot_item_roll_point

Description

Adds a point to an item data set, clearing it every span seconds.


Syntax

gh_imgui.plot_item_roll_point(
 plot_id,
 item_index,
 x, y,
 span
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_item_roll_point(plot_id, item_index, x, y, span)
			


plot_item_buffer_point

Description

Pushes a point into an item data set as if it were a circular buffer of #max_points size.


Syntax

gh_imgui.plot_item_buffer_point(
 plot_id,
 item_index,
 x, y,
 max_points
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_item_buffer_point(plot_id, item_index, x, y, max_points)
			


plot_axis_scroll

Description

Call before rendering a plot to scroll the axis in time, displaying history seconds.


Syntax

gh_imgui.plot_axis_scroll(
 plot_id,
 axis,
 current_time,
 history
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.plot_axis_scroll(plot_id, axis, current_time, history)
			


plot_is_hovered

Description

Checks if a plotline is hovered by the mouse.


Syntax

state = gh_imgui.plot_is_hovered()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


state = gh_imgui.plot_is_hovered()
			


plot_get_mouse_position

Description

Gets the mouse position related to the plotline.


Syntax

x, y = gh_imgui.plot_get_mouse_position()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


x, y = gh_imgui.plot_get_mouse_position()
			


get_text_line_height

Description

Gets the current line height (font size).


Syntax

h = gh_imgui.get_text_line_height()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


h = gh_imgui.get_text_line_height()
			


get_text_line_height_with_spacing

Description

Gets the distance in pixels between 2 consecutive lines of text.


Syntax

h = gh_imgui.get_text_line_height_with_spacing()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


h = gh_imgui.get_text_line_height_with_spacing()
			


color_text_editor_create

Description

Creates a new text editor widget.


Syntax

te_id = gh_imgui.color_text_editor_create()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


te_id = gh_imgui.color_text_editor_create()
			


color_text_editor_kill

Description

Destroys a text editor.


Syntax

gh_imgui.color_text_editor_kill(
 te_id
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.color_text_editor_kill(te_id)
			


color_text_editor_render

Description

Draws a text editor.


Syntax

gh_imgui.color_text_editor_render(
 te_id,
 title,
 size_x, size_y,
 border
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.color_text_editor_render(te_id, "Lua Editor", 400, 600, 0)
			


color_text_editor_get_text

Description

Gets the text of the editor.


Syntax

text = gh_imgui.color_text_editor_get_text(
 te_id
)

Languages


Parameters


Return Values


Code sample


text = gh_imgui.color_text_editor_get_text(te_id)
			


color_text_editor_set_text

Description

Sets the text of the editor.


Syntax

gh_imgui.color_text_editor_set_text(
 te_id,
 text
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.color_text_editor_set_text(te_id, text)
			


color_text_editor_set_language

Description

Sets a built-in language support.


Syntax

gh_imgui.color_text_editor_set_language(
 te_id,
 lang
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.color_text_editor_set_language(te_id, "lua")
			


color_text_editor_set_palette

Description

Sets a color palette. Colors can also be modified with color_text_editor_palette_set_color().


Syntax

gh_imgui.color_text_editor_set_palette(
 te_id,
 pal
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.color_text_editor_set_palette(te_id, "dark")
			


color_text_editor_set_property_bool

Description

Sets a property boolean value.


Syntax

gh_imgui.color_text_editor_set_property_bool(
 te_id,
 what,
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.color_text_editor_set_property_bool(te_id, "whitespaces", 1)
			


color_text_editor_set_property_int

Description

Sets a property integer value.


Syntax

gh_imgui.color_text_editor_set_property_int(
 te_id,
 what,
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.color_text_editor_set_property_int(te_id, "tabsize", 2)
			


color_text_editor_get_total_lines

Description

Gets the current number of lines.


Syntax

n = gh_imgui.color_text_editor_get_total_lines(
 te_id
)

Languages


Parameters


Return Values


Code sample


n = gh_imgui.color_text_editor_get_total_lines(te_id)
			


color_text_editor_get_selected_text

Description

Gets the selected text.


Syntax

text = gh_imgui.color_text_editor_get_selected_text(
 te_id
)

Languages


Parameters


Return Values


Code sample


text = gh_imgui.color_text_editor_get_selected_text(te_id)
			


color_text_editor_get_current_line_text

Description

Gets the current line.


Syntax

line = gh_imgui.color_text_editor_get_current_line_text(
 te_id
)

Languages


Parameters


Return Values


Code sample


line = gh_imgui.color_text_editor_get_current_line_text(te_id)
			


color_text_editor_get_cursor_position

Description

Gets the cursor position.


Syntax

x, y = gh_imgui.color_text_editor_get_cursor_position(
 te_id
)

Languages


Parameters


Return Values


Code sample


x, y = gh_imgui.color_text_editor_get_cursor_position(te_id)
			


color_text_editor_palette_set_color

Description

Sets the color of a particular element.


Syntax

gh_imgui.color_text_editor_palette_set_color(
 te_id,
 what,
 r, g, b, a
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.color_text_editor_palette_set_color(te_id, "Background", r, g, b, a)
gh_imgui.color_text_editor_palette_set_color(te_id, "XT95Line", 0.2, 0.2, 0.2, 0.8)
			


color_text_editor_palette_get_color

Description

Gets the color of a particular element.


Syntax

r, g, b, a = gh_imgui.color_text_editor_palette_get_color(
 te_id,
 what
)

Languages


Parameters


Return Values


Code sample


r, g, b, a = gh_imgui.color_text_editor_palette_get_color(te_id, "Background")
			


color_text_editor_copy_paste_cut

Description

Performs a copy, paste or cut operation.


Syntax

gh_imgui.color_text_editor_copy_paste_cut(
 te_id,
 what
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.color_text_editor_copy_paste_cut(te_id, "copy")
			


color_text_editor_selection

Description

Starts or ends text selection.


Syntax

gh_imgui.color_text_editor_selection(
 te_id,
 what
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.color_text_editor_selection(te_id, "start")
			


color_text_editor_is_text_changed

Description

Allows to know the if text has changed.


Syntax

x = gh_imgui.color_text_editor_is_text_changed(
 te_id
)

Languages


Parameters


Return Values


Code sample


x = gh_imgui.color_text_editor_is_text_changed(te_id)
			


implot_create_dataplot

Description

Creates a plot data set. This data set will be used with implot_begin_plot() and implot_end_plot() to draw a plot.


Syntax

plotid = gh_imgui.implot_create_dataplot(
 max_points
)

Languages


Parameters


Return Values


Code sample


plotid = gh_imgui.implot_create_dataplot(max_points)
			


implot_kill_dataplot

Description

Destroy a plot data set.


Syntax

gh_imgui.implot_kill_dataplot(
 plotid
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.implot_kill_dataplot(plotid)
			


implot_show_demo_window

Description

Displays the official ImPlot demo.


Syntax

gh_imgui.implot_show_demo_window(
 show_window
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.implot_show_demo_window(show_window)
			


implot_begin_plot

Description

Begins the rendering of one or several plots.


Syntax

gh_imgui.implot_begin_plot(
 label,
 x_label,
 y_label,
 label,
 x, y,
 flags,
 x_flags,
 y_flags,
 y2_flags,
 y3_flags
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.implot_begin_plot(label, x_label, y_label, x_size, y_size, flags, x_flags, y_flags, y2_flags, y3_flags)

gh_imguiimplot_draw_plotline(plotid0, ...)
gh_imguiimplot_draw_plotline(plotid1, ...)

gh_imgui.implot_end_plot()
			


implot_end_plot

Description

Ends plot rendering.


Syntax

gh_imgui.implot_end_plot()

Languages


Parameters

This function has no input parameter(s).


Return Values

This function has no return value(s).


Code sample


gh_imgui.implot_end_plot()
			


implot_add_data

Description

Adds data to a plot. If the plot has been created with max_points greater than zero, data is stored in a circular buffer otherwise in a regular (endless) buffer.


Syntax

gh_imgui.implot_add_data(
 plotid,
 x, y
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.implot_add_data(plotid, x, y)
			


implot_draw_plotline

Description

Draws a plot data set.


Syntax

gh_imgui.implot_draw_plotline(
 plotid,
 label,
 count,
 offset
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.implot_draw_plotline(plotid, label, count, offset)
			


implot_draw_plotscatter

Description

Draws a plot data set.


Syntax

gh_imgui.implot_draw_plotscatter(
 plotid,
 label,
 count,
 offset
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.implot_draw_plotscatter(plotid, label, count, offset)
			


implot_draw_plotshaded

Description

Draws a plot data set.


Syntax

gh_imgui.implot_draw_plotshaded(
 plotid,
 label,
 count,
 offset
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.implot_draw_plotshaded(plotid, label, count, offset)
			


implot_draw_plotbars

Description

Draws a plot data set.


Syntax

gh_imgui.implot_draw_plotbars(
 plotid,
 label,
 count,
 offset,
 size,
 vertical
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.implot_draw_plotbars(plotid, label, count, offset, size, vertical)
			


implot_set_next_plot_limits

Description

Sets the limits (X and Y axis) of the next plot.


Syntax

gh_imgui.implot_set_next_plot_limits(
 x_min,
 x_max,
 y_min,
 y_max,
 cond
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


ImGuiCond_None          = 0
ImGuiCond_Always        = 1
ImGuiCond_Once          = 2
ImGuiCond_FirstUseEver  = 4
ImGuiCond_Appearing     = 8

gh_imgui.implot_set_next_plot_limits(x-10, x, -10, 30, ImGuiCond_Always)
			


implot_push_style_color

Description

Saves the current color and pushes a new color.


Syntax

gh_imgui.implot_push_style_color(
 color_index,
 r, g, b, a
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


ImPlotCol_Line = 0
ImPlotCol_Fill = 1
ImPlotCol_MarkerOutline = 2
ImPlotCol_MarkerFill = 3
ImPlotCol_ErrorBar = 4
ImPlotCol_FrameBg = 5
ImPlotCol_PlotBg = 6
ImPlotCol_PlotBorder = 7
ImPlotCol_XAxis = 8
ImPlotCol_YAxis = 9
ImPlotCol_YAxis2 = 10
ImPlotCol_YAxis3 = 11
ImPlotCol_Selection = 12
ImPlotCol_Query = 13

gh_imgui.implot_push_style_color(ImPlotCol_Line, r, g, b, a)
gh_imgui.implot_draw_plotline(plotid1, "MouseX", max_size, offset)
gh_imgui.implot_pop_style_color(1)
			


implot_pop_style_color

Description

Restores a color


Syntax

gh_imgui.implot_pop_style_color(
 count
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.implot_push_style_color(ImPlotCol_Line, r, g, b, a)
gh_imgui.implot_draw_plotline(plotid1, "MouseX", max_size, offset)
gh_imgui.implot_pop_style_color(1)
			


implot_push_style_var_1f

Description

Saves a property and pushes a new one


Syntax

gh_imgui.implot_push_style_var_1f(
 var_id,
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


ImPlotStyleVar_LineWeight = 0
ImPlotStyleVar_Marker = 1
ImPlotStyleVar_MarkerSize = 2
ImPlotStyleVar_MarkerWeight = 3
ImPlotStyleVar_FillAlpha = 4
ImPlotStyleVar_ErrorBarSize = 5
ImPlotStyleVar_ErrorBarWeight = 6
ImPlotStyleVar_DigitalBitHeight = 7
ImPlotStyleVar_DigitalBitGap = 8

gh_imgui.implot_push_style_var_1i(ImPlotStyleVar_FillAlpha, 0.5)
gh_imgui.implot_draw_plotline(plotid1, "MouseX", max_size, offset)
gh_imgui.implot_pop_style_var(1)
			


implot_push_style_var_1i

Description

Saves a property and pushes a new one


Syntax

gh_imgui.implot_push_style_var_1i(
 var_id,
 x
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


ImPlotStyleVar_LineWeight = 0
ImPlotStyleVar_Marker = 1
ImPlotStyleVar_MarkerSize = 2
ImPlotStyleVar_MarkerWeight = 3
ImPlotStyleVar_FillAlpha = 4
ImPlotStyleVar_ErrorBarSize = 5
ImPlotStyleVar_ErrorBarWeight = 6
ImPlotStyleVar_DigitalBitHeight = 7
ImPlotStyleVar_DigitalBitGap = 8

ImPlotMarker_None        = 1
ImPlotMarker_Circle      = 2
ImPlotMarker_Square      = 4
ImPlotMarker_Diamond     = 8
ImPlotMarker_Up          = 16
ImPlotMarker_Down        = 32
ImPlotMarker_Left        = 64
ImPlotMarker_Right       = 128
ImPlotMarker_Cross       = 256
ImPlotMarker_Plus        = 512
ImPlotMarker_Asterisk    = 1024

gh_imgui.implot_push_style_var_1i(ImPlotStyleVar_Marker, ImPlotMarker_Circle)
gh_imgui.implot_draw_plotline(plotid1, "MouseX", max_size, offset)
gh_imgui.implot_pop_style_var(1)
			


implot_is_hovered

Description

Checks if mouse is over the plot


Syntax

state = gh_imgui.implot_is_hovered()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


is_hovered = gh_imgui.implot_is_hovered()
			


implot_get_mouse_pos

Description

Gets mouse position


Syntax

x, y = gh_imgui.implot_get_mouse_pos()

Languages


Parameters

This function has no input parameter(s).


Return Values


Code sample


x, y = gh_imgui.implot_get_mouse_pos()
			


implot_set_built_in_colormap

Description

Sets a built-in colormap


Syntax

gh_imgui.implot_set_built_in_colormap(
 colormap_index,
 samples
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


ImPlotColormap_Default  = 0
ImPlotColormap_Dark     = 1
ImPlotColormap_Pastel   = 2
ImPlotColormap_Paired   = 3
ImPlotColormap_Viridis  = 4
ImPlotColormap_Plasma   = 5
ImPlotColormap_Hot      = 6
ImPlotColormap_Cool     = 7
ImPlotColormap_Pink     = 8
ImPlotColormap_Jet      = 9

gh_imgui.implot_set_built_in_colormap(ImPlotColormap_Hot, 5)
...
gh_imgui.implot_set_built_in_colormap(ImPlotColormap_Default, 0)
			


implot_plottext

Description

Draw a text on a plot at position x, y


Syntax

gh_imgui.implot_plottext(
 text,
 x, y,
 vertical,
 offset_x, offset_y
)

Languages


Parameters


Return Values

This function has no return value(s).


Code sample


gh_imgui.implot_plottext(text, x, y, vertical, offset_x, offset_y)
			






GeeXLab Rootard Guide | Downloads | Contact | Newsletter