Raku IUP 
Raku interface to the IUP toolkit for building GUI's.
| Operating System | Build Status |
|---|---|
| Linux | None |
Description
IUP is a multi-platform toolkit for building graphical user interfaces. IUP's purpose is to allow a program source code to be compiled in different systems without any modification. Its main advantages are:
- It offers a simple API.
- High performance, due to the fact that it uses native interface elements.
- Fast learning by the user, due to the simplicity of its API.
Installation
Get the below IUP library, or later, and install it:
mkdir libiup
cd libiup
curl -L https://sourceforge.net/projects/iup/files/3.25/Linux%20Libraries/iup-3.25_Linux44_64_lib.tar.gz > libiup.tar.gz
tar xvzf libiup.tar.gz
sudo bash install
sudo bash install_dev
cd ..
Install the Raku module with Zef:
zef update
zef install IUP
Synopsis
For convenience a IUP/Colors.rakumod file exists with 140 common colors named by their standard English names . Which standard is the standard is a standard problem.
WARNING: This module is in its early stages and should be considered a Work in Progress. The interface is not final and may change in the future.
Some of these methods also have longer names or names with underscores instead of hyphens.
| Method | Description |
|---|---|
| destroy | Destroy self |
| detach | NYI |
| append | Append control to child-list |
| insert | Insert control after child |
| get-child | Get child by position in list |
| get-child-pos | NYI |
| get-child-count | NYI |
| get-next-child | Get next child from list |
| get-brother | NYI |
| get-parent | Get parent of self |
| get-dialog | Get the dialog (top-level) of self |
| get-dialog-child | I don't remember this one |
| reparent | NYI |
| popup | Popup self at x,y |
| show | Show widget, optionally at x,y |
| hide | Hide self |
| map | Map self into the display layout |
| unmap | NYI Unmap self out of the display layout |
| set-attr | Workhorse to set attribute(s) by ref or by :copy and etc |
| get-attr | Get attribute by name |
| get-attrs | Get attributes of self |
| get-int | Get integer attribute by name |
| set-global | Set global by key (name) and value |
| set-str-global | Set string global by key (name) and value |
| get-global | Get named global's value |
| set-focus | Set focus on self |
| get-focus | Get widget that has focus |
| set-callback | Set a callback for a widget |
| set-callbacks | Set callbacks with key value pairs |
| get-handle | Get named widget by name |
| set-handle | Set a name for self |
| set-attr-handle | Name a referenced widget |
| fill | Fill space in layout |
| radio | Create a radio button widget |
| vbox | Create a vertical box with 1..N child widgets |
| zbox | Create a zbox with 1..N child widgets. |
| hbox | Create a horizontal box with 1..N child widgets. |
| sbox | Create a sbox (split box) |
| gridbox | Create a grid box |
| multibox | Create a multibox |
| expander | Create an expander |
| backgroundbox | Create a backgroundbox |
| frame | Create a frame |
| image | Create an image by dimensions and pixel list |
| item | Create an item |
| submenu | Create a titled submenu |
| separator | Create a separator in a menu |
| menu | Create a menu with 0..N members |
| button | Create a button with label and action |
| canvas | Create a canvas NOT WORKING |
| dialog | Create a dialog Perhaps the top-level or a nodal |
| user | Create a user widget |
| label | Create a label |
| list | Create a list with a string |
| text | Create a text widget |
| multiline | Create a multiline widget Text & multiline are same |
| toggle | Create a toggle switch |
| val | Create a Val (aka slider or scale) for choosing a value |
| dial | Create a dial widget |
| file-dlg | File choice dialog |
| message-dlg | Message displaying dialog |
| color-dlg | Color choice dialog |
| font-dlg | Font choice dialog |
| progress-dlg | Progress displaying dialog |
| get-file | Get file by name |
| message | Display message with title |
| alarm | Display message and title with three user choices |
| list-dialog | List choices for one or more selection, opt w/ defaults |
| open | Create the IUP system |
| close | Shutdown the IUP system |
| image-lib-open | Open the widget library |
| main-loop | Start an event loop on user inputs |
| set-language | Set the language to English, Portuguese or Spanish |
| get-language | Get the language |
| version | Get the IUP library version |
| get-version | Get the IUP library version |
| get-version-date | Return version's date |
| get-version-number | Get version number |
Sample GUI:
Sample code:
use IUP; # initialize iup my $iup = IUP.new; $iup.image-lib-open; $iup.open; # create widgets and set their attributes my $btn = $iup.button("&Ok", ""); $btn.set-callback("ACTION", &exit_callback); $btn.set-attr("IMAGE", "IUP_ActionOk"); $btn.set-attr("EXPAND", "YES"); $btn.set-attr("TIP", "Exit button"); my $lbl = $iup.label("Hello, world!"); my $vb = $iup.vbox($lbl, $btn); $vb.set-attr("MARGIN", "10x10"); $vb.set-attr("GAP", "10"); $vb.set-attribute("ALIGNMENT", "ACENTER"); my $dlg = $iup.dialog($vb); $dlg.set_attribute("TITLE", "Hello"); # Map widgets and show dialog $dlg.show; # Wait for user interaction $iup.main-loop; # Clean up $dlg.destroy; $iup.close; exit; sub exit-callback( --> Int) { return IUP_CLOSE; }
Authors and Contributors
- Henrique Dias mrhdias@gmail.com
- Naoum Hankache naoum88@gmail.com
- Tobias Leich email@froggs.de
- Zoffix Znet cpan@zoffix.com
- David Warring david.warring@gmail.com
- Robert Ransbottom rirans@comcast.net
Blame
Robert Ransbottom, as I have messed with most of the code.
See Also
License
This library is free software; you can redistribute it and/or modify it under the same terms as Raku itself.