libui_paradise 0.1.49

data/doc/SNIPPETS.md

@@ -0,0 +1,221 @@
+# How to require libui:
+
+  require 'libui'
+
+# How to instantiate libui:
+
+  UI = LibUI
+  init = UI.init
+
+# How to add a new main window:
+                                             # width, height, hasMenubar
+  main_window = UI.new_window('hello world', 300, 200, 1)
+
+  Source code:
+
+    https://raw.githubusercontent.com/andlabs/libui/master/unix/window.c
+
+# How to add a libui-widget to the main window / Designate a child widget:
+
+  UI.window_set_child(main_window, button)
+
+# Act on closing-event (on quit tag):
+
+  UI.window_on_closing(main_window) {
+    puts 'Bye Bye'
+    UI.control_destroy(main_window)
+    UI.quit
+    0
+  }
+  # Or simpler:
+  close_properly(main_window)
+
+# How to properly close via LibuiExtensions:
+
+  main_window = UI.window('Notepad', 500, 300, 1)
+  UI.close_properly(main_window)
+  # Or simpler:
+  close_properly(main_window)
+
+# Add the window to the main UI:
+
+  UI.control_show(main_window)
+  main_window.show_the_controls # Or use this one here.
+
+# Set the padding on a grid:
+
+  UI.grid_set_padded(grid, 25)
+
+# Attach a new widget onto the grid:
+
+  UI.grid_append(grid, text('Yo2'), 1, 0, 1, 1, 0, 0, 1, 0)
+
+# How to add a click-action to the button:
+
+  UI.button_on_clicked(button) {
+    UI.msg_box(main_window, 'Information', 'You clicked the button')
+    0
+  }
+
+# How to add a margin:
+
+  UI.window_set_margined(MAIN_WINDOW, 1)
+
+# How to exit easily:
+
+  UI.window_on_closing(main_window) {
+    UI.exit_from(main_window)
+  }
+
+# Create an attributed String:
+
+  string = UI.new_attributed_string
+  attributes = UI.new_family_attribute("Courier New 30")
+  attribute = UI.new_color_attribute(0.75, 0.25, 0.5, 0.75)
+  UI.append_with_attribute("text color", attribute, nil)
+
+# How to set a padded box:
+
+  UI.box_set_padded(box, 1) # The value is either 0 or 1.
+
+  Alignment may be:
+    0: Fill
+    1: Start
+    2: Center
+    3: End
+ Positioning:
+    0: Left
+    1: Top
+    2: Right
+
+# Create a message-box and an error message box:
+
+  UI.msg_box(main_window, 'Information', 'You clicked the button')
+  UI.msg_box_error(main_window, 'Information', 'You clicked the button')
+
+# Add a checkbox (checkbox tag, checkbutton)
+
+  checkbox = UI.new_checkbox('Checkbox') # or ui_checkbox
+  checkbox_toggle_callback = proc { |pointer|
+    checked = UI.checkbox_checked(pointer) == 1
+    UI.window_set_title(MAIN_WINDOW, "Checkbox is #{checked}")
+    UI.checkbox_set_text(pointer, "I am the checkbox (#{checked})")
+    0
+  }
+  UI.checkbox_on_toggled(checkbox, checkbox_toggle_callback, nil)
+  UI.box_append(inner, checkbox, 0)
+
+  To set it checked:
+
+  checkbox.set_checked(1)
+
+  To query its state:
+
+    checked = UI.checkbox_checked(pointer) == 1
+
+# And the control:
+
+  UI.control_show(main_window)
+
+# Using a text-entry (ui entry tag):
+
+  text_entry = UI.new_entry
+  UI.entry_set_text(text_entry, 'Please enter your feelings')
+  UI.entry_on_changed(text_entry, text_changed_callback, nil)
+
+  # To set this on a "multiline entry", aka spanning several
+  # rows, do use:
+  UI.multiline_entry_set_text(entry1, 'Yo there')
+  ui_text_view # an alias used in libui_paradise
+
+  text1 = UI.entry_text(entry1) # Obtain text. You may have to call .to_s on it, to guarantee the String.
+  UI.multiline_entry_text # Obtain the text from a multiline entry.
+
+# Create a textview:
+
+  UI.new_non_wrapping_multiline_entry
+
+# Putting the text-entry into a hbox:
+
+  UI.box_append(hbox1, text_entry, 1)
+
+# Create a combobox (combo tag, combobox tag):
+
+  combobox_selected_callback = proc { |ptr|
+    puts "New combobox selection: #{UI.combobox_selected(ptr)}"
+  }
+  cbox = UI.new_combobox
+  UI.combobox_append(cbox, 'combobox Item 1')
+  UI.combobox_append(cbox, 'combobox Item 2')
+  UI.combobox_append(cbox, 'combobox Item 3')
+  UI.box_append(inner, cbox, 0)
+  UI.combobox_on_selected(cbox, combobox_selected_callback, nil)
+
+  # Or more concise:
+  combo_box = UI.combobox {
+    ['combobox Item 1', 'combobox Item 2', 'combobox Item 3']
+  }
+
+  # Select the first entry:
+
+  UI.combobox_set_selected(combobox, 0) # The first one will be active too.
+
+# Create a new tabbed notebook:
+
+  ui_tabs
+  ui_notebook
+
+# Add content to an editable combox:
+
+  UI.append() # .append() adds the named item to the end of the EditableCombobox.
+
+# How to run the main loop:
+
+  UI.main
+
+# How to quit:
+
+  UI.quit
+
+# How to build a menu-interface (menu tag):
+
+  help_menu = UI.new_menu('Help')
+  version_item = UI.menu_append_item(help_menu, 'Version')
+
+# Create a new image:
+
+  image = UI.new_image(width, height)
+
+# Fonts and LibUI:
+
+  font_descriptor = UI::FFI::FontDescriptor.malloc
+  p 'Font family: '+font_descriptor.Family.to_s+
+    'Font size: '+font_descriptor.Size+
+    'Font weight: '+font_descriptor.Weight+
+    'Font italic: '+font_descriptor.Italic+
+    'Font stretch: '+font_descriptor.Stretch
+
+# Available widgets in libUI:
+
+  Button                 A button with a label
+  Checkbox               A checkbox with a label
+  Combobox               A simple combobox
+  ColorButton            A button for selecting a color
+  EditableCombobox       A combobox that can be edited.
+  Entry                  Text input, can be disabled.
+  FontButton             A button for selecting a font (Incomplete: Cannot set programmatically)
+  Form                   A container that takes labels for its contents
+  Grid                   A container that aligns widgets for window design
+  Group                  A container that provides a title for a set of items
+  Label                  Displays a single line of text
+  Menu                   Creates a single column of an application menu
+  MultilineEntry         An entry that allows multiple lines.
+  Time and Date Pickers  Allows choosing of a date and/or time.
+  ProgressBar            Displays a progress bar
+  RadioButton            A set of radio buttons
+  Separator              A simple vertical or horizontal separator
+  Slider                 A draggable slider for choosing a value in a range
+  Spinbox                A numerical input with a minimum and maximum range
+  Tab                    A set named tabs for placing items in
+  Window                 Contains any other widget, cannot be embedded in a container
+  VBox, HBox             A vertical or horizontal box for grouping items

data/doc/TODO.md

@@ -0,0 +1,14 @@
+- Make sure that each component has a screenshot. It's ok to
+  re-use existing screenshots from other projects.
+
+- Make sure the project is API compatible to glimmer-libui.
+
+- Rewrite the project from the get-go. Also integrate 
+  @main_window into the main hash, rather than have it
+  standalone.
+
+- Re-organize the examples, perhaps starting with another
+  one.
+
+- Check for image and font support again. Something isn't
+  working!

data/lib/libui_paradise/autoinclude.rb

@@ -0,0 +1,9 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'libui_paradise/autoinclude.rb'
+# =========================================================================== #
+require 'libui_paradise/requires/require_the_libui_paradise_project.rb'
+
+include LibuiParadise::Extensions

data/lib/libui_paradise/domain_specific_language/README.md

@@ -0,0 +1,5 @@
+The directory here is an attempt to simplify the bindings in
+libui_paradise even more.
+
+For instance, the user should be able to parse widgets that
+are described in pure yaml.

data/lib/libui_paradise/domain_specific_language/button.yml

@@ -0,0 +1,7 @@
+button:
+ id:               button1
+ text: 'This is a button.'
+ width:                120
+ height:                80
+ on_clicked:
+  do_call_this_method

data/lib/libui_paradise/examples/001_basic_button_example.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+main_window = main_window('hello world', 300, 200, 0)
+
+button = button('Button')
+button.on_clicked {|widget| # is a <Fiddle::Pointer:0x00005590774f1ca0 ptr=0x0000559077484c90 size=0 free=0x0000000000000000>
+  e 'The main button was clicked.'
+  ui_msg_box(main_window, 'Information', 'You clicked the button')
+  0
+}
+
+main_window.child = button
+main_window.intelligent_exit

data/lib/libui_paradise/examples/002_basic_table_image.rb

@@ -0,0 +1,92 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This example displays images that can be freely downloaded from the
+# Studio Ghibli website.
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+require 'chunky_png'
+require 'open-uri'
+
+N_TIMES = 10
+# =========================================================================== #
+# === REMOTE_URL
+# =========================================================================== #
+REMOTE_URL = 'https://www.ghibli.jp/gallery/thumb-redturtle%03d.png'
+
+main_window = ui_main_window('The Red Turtle', 310, 350, 0)
+
+hbox = ui_padded_hbox
+main_window.simple_exit
+main_window.child = hbox
+
+# =========================================================================== #
+# === IMAGES
+# =========================================================================== #
+IMAGES = []
+
+N_TIMES.times do |i|
+  url = format(REMOTE_URL, (i + 1))
+  this_file = URI.open(url)
+  # Use ChunkyPNG::Canvas to get information about the image at hand.
+  canvas = ChunkyPNG::Canvas.from_io(this_file)
+  this_file.close
+  data = canvas.to_rgba_stream
+  width = canvas.width
+  height = canvas.height
+  # ========================================================================= #
+  # Add a new image here:
+  # ========================================================================= #
+  image = UI.new_image(width, height)
+  UI.image_append(image, data, width, height, width * 4)
+  IMAGES << image # Store all images in the following area.
+rescue StandardError => error
+  warn url, error.message
+end
+
+# =========================================================================== #
+# Protects BlockCaller objects from garbage collection.
+# =========================================================================== #
+@blockcaller = []
+# =========================================================================== #
+# === rbcallback
+# =========================================================================== #
+def rbcallback(*args, &block)
+  args << [0] if args.size == 1 # Argument types are ommited
+  blockcaller = Fiddle::Closure::BlockCaller.new(*args, &block)
+  @blockcaller << blockcaller
+  blockcaller
+end
+
+model_handler = UI::FFI::TableModelHandler.malloc
+model_handler.NumColumns   = rbcallback(4) { 1 }
+model_handler.ColumnType   = rbcallback(4) { 1 } # Image
+model_handler.NumRows      = rbcallback(4) { IMAGES.size }
+model_handler.CellValue    = rbcallback(1, [1, 1, 4, 4]) do |_, _, row, _column|
+  UI.new_table_value_image(IMAGES[row])
+end
+model_handler.SetCellValue = rbcallback(0, [0]) {}
+
+model = UI.new_table_model(model_handler)
+
+table_params = UI::FFI::TableParams.malloc
+table_params.Model = model
+table_params.RowBackgroundColorModelColumn = -1
+
+table = ui_table(table_params)
+UI.table_append_image_column(table, 'www.ghibli.jp/works/red-turtle', -1)
+hbox.maximal(table)
+
+main_window.show_the_controls
+
+UI.window_on_closing(main_window) {
+  e 'Bye Bye'
+  UI.control_destroy(main_window)
+  UI.free_table_model(model)
+  IMAGES.each { |i| UI.free_image(i) }
+  UI.quit
+  0
+}
+
+UI.main_then_quit

data/lib/libui_paradise/examples/003_font_button.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+main_window = UI.window('hello world', 300, 200, 1)
+
+font_button = UI.font_button
+# =========================================================================== #
+# === font_descriptor
+#
+# The font_descriptor will contain all the important information about the
+# font at hand. It will be updated via UI.font_button_font().
+# =========================================================================== #
+font_descriptor = UI::FFI::FontDescriptor.malloc
+UI.font_button_on_changed(font_button) {
+  UI.font_button_font(font_button, font_descriptor)
+  # ========================================================================= #
+  # The following line will output something like:
+  #
+  #   {:family=>"Georgia", :size=>12.0, :weight=>700, :italic=>0, :stretch=>4}
+  #
+  # ========================================================================= #
+  p family:  font_descriptor.Family.to_s,
+    size:    font_descriptor.Size,
+    weight:  font_descriptor.Weight,
+    italic:  font_descriptor.Italic,
+    stretch: font_descriptor.Stretch
+}
+main_window.close_properly
+main_window.child = font_button
+main_window.control_show
+UI.main_then_quit

data/lib/libui_paradise/examples/004_date_time_picker.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+vbox = UI.vbox
+
+date_time_picker = UI.new_date_time_picker
+
+time = UI::FFI::TM.malloc
+
+UI.date_time_picker_on_changed(date_time_picker) do
+  UI.date_time_picker_time(date_time_picker, time)
+  p sec: time.tm_sec,
+    min: time.tm_min,
+    hour: time.tm_hour,
+    mday: time.tm_mday,
+    mon: time.tm_mon,
+    year: time.tm_year,
+    wday: time.tm_wday,
+    yday: time.tm_yday,
+    isdst: time.tm_isdst
+end
+vbox.add(date_time_picker, 1)
+
+main_window = UI.window('Date Time Pickers', 300, 200, 1)
+main_window.close_properly
+main_window.child = vbox
+main_window.show_the_controls
+UI.main_then_quit

data/lib/libui_paradise/examples/005_msg_box_error.rb

@@ -0,0 +1,25 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+TITLE = 'msg box error'
+main_window = UI.window(TITLE, 300, 200, 1)
+
+button1 = UI.button('Text (click me)')
+button1.on_clicked {
+  UI.msg_box_error(
+    main_window,
+    'Error',
+    "You clicked \nthe button"
+  )
+  0
+}
+
+hbox = UI.hbox
+hbox.append(button1, 1)
+main_window.close_properly
+main_window.child = hbox
+main_window.control_show
+UI.main_then_quit

data/lib/libui_paradise/examples/006_histogram.rb

@@ -0,0 +1,193 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# https://github.com/jamescook/libui-ruby/blob/master/example/histogram.rb
+# =========================================================================== #
+require 'libui_paradise'
+
+X_OFF_LEFT   = 20
+Y_OFF_TOP    = 20
+X_OFF_RIGHT  = 20
+Y_OFF_BOTTOM = 20
+POINT_RADIUS =  5
+
+init         = UI.init
+handler      = UI.area_handler
+histogram    = UI.new_area(handler)
+brush        = UI::FFI::DrawBrush.malloc
+color_button = UI.new_color_button
+datapoints   = []
+
+def graph_size(area_width, area_height)
+  graph_width = area_width - X_OFF_LEFT - X_OFF_RIGHT
+  graph_height = area_height - Y_OFF_TOP - Y_OFF_BOTTOM
+  [graph_width, graph_height]
+end
+
+matrix = UI::FFI::DrawMatrix.malloc
+
+# === point_locations
+def point_locations(datapoints, width, height)
+  xincr = width / 9.0 # 10 - 1 to make the last point be at the end
+  yincr = height / 100.0
+
+  data = []
+  datapoints.each_with_index do |dp, i|
+    val = 100 - UI.spinbox_value(dp)
+    data << [xincr * i, yincr * val]
+    i += 1
+  end
+
+  data
+end
+
+# === construct_graph
+def construct_graph(datapoints, width, height, should_extend)
+  locations = point_locations(datapoints, width, height)
+  path = UI.draw_new_path(0) # winding
+  first_location = locations[0] # x and y
+  UI.draw_path_new_figure(path, first_location[0], first_location[1])
+  locations.each do |loc|
+    UI.draw_path_line_to(path, loc[0], loc[1])
+  end
+
+  if should_extend
+    UI.draw_path_line_to(path, width, height)
+    UI.draw_path_line_to(path, 0, height)
+    UI.draw_path_close_figure(path)
+  end
+
+  UI.draw_path_end(path)
+
+  path
+end
+
+handler_draw_event = Fiddle::Closure::BlockCaller.new(
+  0, [1, 1, 1]
+) do |_area_handler, _area, area_draw_params|
+  area_draw_params = UI::FFI::AreaDrawParams.new(area_draw_params)
+  path = UI.draw_new_path(0) # winding
+  UI.draw_path_add_rectangle(path, 0, 0, area_draw_params.AreaWidth, area_draw_params.AreaHeight)
+  UI.draw_path_end(path)
+  set_solid_brush(brush, 0xFFFFFF, 1.0) # white
+  UI.draw_fill(area_draw_params.Context, path, brush.to_ptr)
+  UI.draw_free_path(path)
+  dsp = UI::FFI::DrawStrokeParams.malloc
+  dsp.Cap = 0 # flat
+  dsp.Join = 0 # miter
+  dsp.Thickness = 2
+  dsp.MiterLimit = 10 # DEFAULT_MITER_LIMIT
+  dashes = Fiddle::Pointer.malloc(8)
+  dsp.Dashes = dashes
+  dsp.NumDashes = 0
+  dsp.DashPhase = 0
+
+  # draw axes
+  set_solid_brush(brush, 0x000000, 1.0) # black
+  graph_width, graph_height = *graph_size(area_draw_params.AreaWidth, area_draw_params.AreaHeight)
+
+  path = UI.draw_new_path(0) # winding
+  UI.draw_path_new_figure(path, X_OFF_LEFT, Y_OFF_TOP)
+  UI.draw_path_line_to(path, X_OFF_LEFT, Y_OFF_TOP + graph_height)
+  UI.draw_path_line_to(path, X_OFF_LEFT + graph_width, Y_OFF_TOP + graph_height)
+  UI.draw_path_end(path)
+  UI.draw_stroke(area_draw_params.Context, path, brush, dsp)
+  UI.draw_free_path(path)
+
+  # now transform the coordinate space so (0, 0) is the top-left corner of the graph
+  UI.draw_matrix_set_identity(matrix)
+  UI.draw_matrix_translate(matrix, X_OFF_LEFT, Y_OFF_TOP)
+  UI.draw_transform(area_draw_params.Context, matrix)
+
+  # now get the color for the graph itself and set up the brush
+  #	uiColorButtonColor(colorButton, &graphR, &graphG, &graphB, &graphA)
+  graph_r = Fiddle::Pointer.malloc(8) # double
+  graph_g = Fiddle::Pointer.malloc(8) # double
+  graph_b = Fiddle::Pointer.malloc(8) # double
+  graph_a = Fiddle::Pointer.malloc(8) # double
+
+  UI.color_button_color(color_button, graph_r, graph_g, graph_b, graph_a)
+  brush.Type = 0 # solid
+  brush.R = graph_r[0, 8].unpack1('d')
+  brush.G = graph_g[0, 8].unpack1('d')
+  brush.B = graph_b[0, 8].unpack1('d')
+
+  # now create the fill for the graph below the graph line
+  path = construct_graph(datapoints, graph_width, graph_height, true)
+  brush.A = graph_a[0, 8].unpack1('d') / 2.0
+  UI.draw_fill(area_draw_params.Context, path, brush)
+  UI.draw_free_path(path)
+
+  # now draw the histogram line
+  path = construct_graph(datapoints, graph_width, graph_height, false)
+  brush.A = graph_a[0, 8].unpack1('d')
+  UI.draw_stroke(area_draw_params.Context, path, brush, dsp)
+  UI.draw_free_path(path)
+end
+
+handler.Draw         = handler_draw_event
+
+# Assigning to local variables
+# This is intended to protect Fiddle::Closure from garbage collection.
+# See https://github.com/kojix2/LibUI/issues/8
+handler.MouseEvent   = (c1 = Fiddle::Closure::BlockCaller.new(0, [0]) {})
+handler.MouseCrossed = (c2 = Fiddle::Closure::BlockCaller.new(0, [0]) {})
+handler.DragBroken   = (c3 = Fiddle::Closure::BlockCaller.new(0, [0]) {})
+handler.KeyEvent     = (c4 = Fiddle::Closure::BlockCaller.new(1, [0]) { 0 })
+
+UI.freeInitError(init) unless init.nil?
+
+hbox = UI.hbox
+UI.box_set_padded(hbox, 1)
+
+vbox = UI.vbox
+UI.box_set_padded(vbox, 1)
+hbox.add(vbox, 0)
+hbox.add(histogram, 1)
+
+datapoints = Array.new(10) {
+  UI.new_spinbox(0, 100).tap { |datapoint|
+    UI.spinbox_set_value(datapoint, Random.new.rand(90))
+    UI.spinbox_on_changed(datapoint) {
+      UI.area_queue_redraw_all(histogram)
+    }
+    UI.box_append(vbox, datapoint, 0)
+  }
+}
+
+# =========================================================================== #
+# === set_solid_brush
+# =========================================================================== #
+def set_solid_brush(brush, color = 0xFFFFFF, alpha = 1.0)
+  brush.Type = 0 # solid
+  brush.R = ((color >> 16) & 0xFF) / 255.0
+  brush.G = ((color >> 8) & 0xFF) / 255.0
+  brush.B = (color & 0xFF) / 255.0
+  brush.A = alpha
+  brush
+end
+
+set_solid_brush(brush, LibuiParadise::Extensions::COLOUR_BLUE, 1.0)
+UI.color_button_set_color(color_button, brush.R, brush.G, brush.B, brush.A)
+
+UI.color_button_on_changed(color_button) {
+  UI.area_queue_redraw_all(histogram)
+}
+
+vbox.add(color_button, 0)
+
+MAIN_WINDOW = UI.new_window('histogram example', 640, 480, 1)
+UI.window_set_margined(MAIN_WINDOW, 1)
+UI.window_set_child(MAIN_WINDOW, hbox)
+
+should_quit = proc { |_ptr|
+  UI.control_destroy(MAIN_WINDOW)
+  UI.quit
+  0
+}
+
+UI.window_on_closing(MAIN_WINDOW, should_quit)
+UI.on_should_quit(should_quit)
+MAIN_WINDOW.control_show
+UI.main_then_quit

data/lib/libui_paradise/examples/007_combo_box_example.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+TITLE  = 'Combo Box Example'
+WIDTH  = 500
+HEIGHT = 250
+main_window = ui_main_window(TITLE, WIDTH, HEIGHT, 0)
+
+@entry = ui_entry
+
+@combo_box = ui_combobox(
+  [
+    'combobox Item 1',
+    'combobox Item 2',
+    'combobox Item 3'
+  ]
+)
+
+# =========================================================================== #
+# The next code used to be in place until September 2021. I will retain it
+# here in the event that we need to use it again one day.
+# =========================================================================== #
+    
+# combobox_selected_callback = proc { |pointer|
+#   e "New combobox selection: #{UI.combobox_selected(pointer)}"
+#   @entry.set_text(selected?(pointer))
+# }
+# 
+# UI.combobox_on_selected(@combo_box, combobox_selected_callback, nil)
+
+ui_sync_connect(@combo_box, @entry)
+
+box = padded_vbox
+box.minimal(@combo_box)
+box.minimal(@entry)
+
+main_window.child = box
+main_window.intelligent_exit