Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/finanalyst/gtk-simple
Simplistic GTK bindings for Rakudo
https://github.com/finanalyst/gtk-simple
raku
Last synced: 3 months ago
JSON representation
Simplistic GTK bindings for Rakudo
- Host: GitHub
- URL: https://github.com/finanalyst/gtk-simple
- Owner: finanalyst
- License: artistic-2.0
- Created: 2014-04-25T14:45:27.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2023-02-25T10:23:22.000Z (almost 2 years ago)
- Last Synced: 2024-10-10T20:41:41.991Z (3 months ago)
- Topics: raku
- Language: Raku
- Homepage:
- Size: 265 KB
- Stars: 49
- Watchers: 125
- Forks: 26
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
## GTK::Simple
GTK::Simple is a set of simple [GTK 3](http://www.gtk.org/) bindings using
NativeCall. Only some GTK widgets are currently implemented. However, these are
enough to create a reasonable interactive GUI for an idiomatic Raku program.
The GTK Widgets in this distribution include the following:
Widget | Description
----------------- | -------------------------------------------------------------------
ActionBar | Group multiple buttons and arrange in 'left', 'middle', and 'right'
Button | A simple button with a label and a callback
Calendar | A calendar for selecting a date
CheckButton | A check button with a label
CheckMenuItem | A checkable menu item
ComboBoxText | A simple combo box
DrawingArea | A drawing area (requires the 'Cairo' module)
Entry | Allows for text to be provided by the user
FileChooserButton | A button that opens a file chooser dialog
Frame | A bin with a decorative frame and optional label
Grid | A table-like container for widgets for window design
Label | Adds a line of text
LevelBar | A bar that can used as a level indicator
LinkButton | Create buttons bound to a URL
ListBox | A vertical listbox where each row is selectable
MarkUpLabel | Adds text with GTK mark up (e.g. color and font manipulation)
Menu | A simple menu with a menu item label
MenuBar | A simple menu bar that contain one or more menus
MenuItem | A simple menu item that can have a sub menu
MenuToolButton | A menu tool button with a label or an icon
PlacesSidebar | Sidebar that displays frequently-used places in the file system
ProgressBar | Show progress via a filling bar
Scale | Allows for a number to be provided by the user
ScrolledWindow | Container for widgets needing scrolling, eg., multiline texts
RadioButton | A choice from multiple radio buttons
Spinner | Showing that something is happening
TextView | Adds multiple lines of text
ToggleButton | A toggle-able button
Toolbar | A tool bar that can contain one or more menu tool buttons
VBox, HBox | Widget containers which enable window layout design
## Example
```raku
use GTK::Simple;
my $app = GTK::Simple::App.new( title => "Hello GTK!" );
$app.set-content(
GTK::Simple::VBox.new(
my $button = GTK::Simple::Button.new(label => "Hello World!"),
my $second = GTK::Simple::Button.new(label => "Goodbye!")
)
);
$app.border-width = 20;
$second.sensitive = False;
$button.clicked.tap({ .sensitive = False; $second.sensitive = True });
$second.clicked.tap({ $app.exit; });
$app.run;
```
### Using :subs option
Another approach is to specify `:subs` on import. This provides subroutine aliases for the constructors
of all of the available `GTK::Simple` widgets, converted from CamelCase to kebab-case.
`GTK::Simple::MenuToolButton` becomes `menu-tool-button`, `GTK::Simple::ProgressBar` becomes `progress-bar`, etc.
The above example can be equivalently written as:
```raku
use GTK::Simple :subs;
my $app = app(title => "Hello GTK!");
$app.set-content(
v-box(
my $button1 = button(label => "Hello World"),
my $button2 = button(label => "Goodbye!")
)
);
# ...
```
### Further examples
The first four examples were written as mini tutorials to show how the
system works:
- [Hello world](https://github.com/finanalyst/GTK-Simple/blob/master/examples/01-hello-world.raku)
- [Toggles](https://github.com/finanalyst/GTK-Simple/blob/master/examples/02-toggles.raku)
- [A simple grid](https://github.com/finanalyst/GTK-Simple/blob/master/examples/03-grid.raku)
- [Marked Scales](https://github.com/finanalyst/GTK-Simple/blob/master/examples/04-marked-scale.raku)
For more examples, please see the [examples/](https://github.com/finanalyst/GTK-Simple/blob/master/examples) folder.
## Limitations
The full functionality of [GTK 3](http://www.gtk.org/) is not available in
this module.
## Prerequisites
This module requires the GTK3 library to be installed. Please follow the
instructions below based on your platform:
### Debian Linux
```
sudo apt-get install libgtk-3-dev
```
### Mac OS X
```
brew update
brew install gtk+3
```
## Windows
The GTK team describes how to do this for Windows at
[Setting up GTK for Window](https://www.gtk.org/docs/installations/windows/)
## Installation and sanity tests
Use the zef package manager
```
$ zef install GTK::Simple
```
## Author
Jonathan Worthington, jnthn on #raku, https://github.com/jnthn/
## Contributors
The Raku team
## License
The Artistic License 2.0