/ 
LibUI-0.02
River stage zero No dependents
/ LibUI

NAME

LibUI - Simple, Portable, Native GUI Library

SYNOPSIS

use LibUI ':all';
use LibUI::Window;
use LibUI::Label;
Init( ) && die;
my $window = LibUI::Window->new( 'Hi', 320, 100, 0 );
$window->setMargined( 1 );
$window->setChild( LibUI::Label->new('Hello, World!') );
$window->onClosing(
    sub {
        Quit();
        return 1;
    },
    undef
);
$window->show;
Main();

Screenshots

Linux

Linux

MacOS

MacOS

Windows

Windows

DESCRIPTION

LibUI is a simple and portable (but not inflexible) GUI library in C that uses the native GUI technologies of each platform it supports.

This distribution is under construction. It works but is incomplete.

Container controls

LibUI::Window - a top-level window
LibUI::HBox - a horizontally aligned, boxlike container that holds a group of controls
LibUI::VBox - a vertically aligned, boxlike container that holds a group of controls
LibUI::Tab - a multi-page control interface that displays one page at a time
LibUI::Group - a container that adds a label to the child
LibUI::Form - a container to organize controls as labeled fields
LibUI::Grid - a container to arrange controls in a grid

Data entry controls

LibUI::Button - a button control that triggers a callback when clicked
LibUI::Checkbox - a user checkable box accompanied by a text label
LibUI::Entry - a single line text entry field
LibUI::PasswordEntry - a single line, obscured text entry field
LibUI::SearchEntry - a single line search query field
LibUI::Spinbox - display and modify integer values via a text field or +/- buttons
LibUI::Slider - display and modify integer values via a draggable slider
LibUI::Combobox - a drop down menu to select one of a predefined list of items
LibUI::EditableCombobox - a drop down menu to select one of a predefined list of items or enter you own
LibUI::RadioButtons - a multiple choice control of check buttons from which only one can be selected at a time
LibUI::DateTimePicker - a control to enter a date and/or time
LibUI::DatePicker - a control to enter a date
LibUI::TimePicker - a control to enter a time
LibUI::MultilineEntry - a multi line entry that visually wraps text when lines overflow
LibUI::NonWrappingMultilineEntry - a multi line entry that scrolls text horizontally when lines overflow
LibUI::FontButton - a control that opens a font picker when clicked

Static controls

LibUI::Label - a control to display non-interactive text
LibUI::ProgressBar - a control that visualizes the progress of a task via the fill level of a horizontal bar
LibUI::HSeparator - a control to visually separate controls horizontally
LibUI::VSeparator - a control to visually separate controls vertically

Dialog windows

openFile( ) - File chooser to select a single file
openFolder( ) - File chooser to select a single folder
saveFile( ) - Save file dialog
msgBox( ... ) - Message box dialog
msgBoxError( ... ) - Error message box dialog

See "Dialog windows" in LibUI::Window for more.

LibUI::Menu - application-level menu bar
LibUI::MenuItem - menu items used in conjunction with LibUI::Menu

Tables

The upstream API is a mess so I'm still plotting around this.

GUI Functions

Some basics you gotta use just to keep a modern GUI running.

This is incomplete but... well, I'm working on it.

Init( [...] )

Init( );

Ask LibUI to do all the platform specific work to get up and running. If LibUI fails to initialize itself, this will return a true value. Weird upstream choice, I know...

You must call this before creating widgets.

Main( ... )

Main( );

Let LibUI's event loop run until interrupted.

Uninit( ... )

Uninit( );

Ask LibUI to break everything down before quitting.

Quit( ... )

Quit( );

Quit.

Timer( ... )

Timer( 1000, sub { die 'do not do this here' }, undef);

Timer(
    1000,
    sub {
        my $data = shift;
        return 1 unless ++$data->{ticks} == 5;
        0;
    },
    { ticks => 0 }
);

Expected parameters include:

$time

Time in milliseconds.

$func

CodeRef that will be triggered when $time runs out.

Return a true value from your $func to make your timer repeating.

$data

Any userdata you feel like passing. It'll be handed off to your function.

Requirements

See Alien::libui

See Also

eg/demo.pl - Very basic example

eg/widgets.pl - Demo of basic controls

LICENSE

Copyright (C) Sanko Robinson.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Sanko Robinson <sanko@cpan.org>