NAME
Prima - a perl graphic toolkit
SYNOPSIS
use Prima qw(Application Buttons);
new Prima::MainWindow(
text => 'Hello world!',
size => [ 200, 200],
)-> insert( Button =>
centered => 1,
text => 'Hello world!',
onClick => sub { $::application-> close },
);
run Prima;
DESCRIPTION
The toolkit is combined from two basic set of classes - core and
external. The core classes are coded in C and form a base line for
every Prima object written in perl. The usage of C is possible together
with the toolkit; however, its full power is revealed in the perl
domain. The external classes present easily expandable set of widgets,
written completely in perl and communicating with the system using
Prima library calls.
The core classes form an hierarchy, which is displayed below:
Prima::Object
Prima::Component
Prima::AbstractMenu
Prima::AccelTable
Prima::Menu
Prima::Popup
Prima::Clipboard
Prima::Drawable
Prima::DeviceBitmap
Prima::Printer
Prima::Image
Prima::Icon
Prima::File
Prima::Timer
Prima::Widget
Prima::Application
Prima::Window
The external classes are derived from these; the list of widget classes
can be found below in "SEE ALSO".
BASIC PROGRAM
The very basic code shown in "SYNOPSIS" is explained here. The code
creates a window with ’Hello, world’ title and a centered button with
the same text. The program terminates after the button is pressed.
A basic construct for a program written with Prima obviously requires
use Prima;
code; however, the effective programming requires usage of the other
modules, for example, "Prima::Buttons", which contains set of button
widgets. "Prima.pm" module can be invoked with a list of such modules,
which makes the construction
use Prima;
use Prima::Application;
use Prima::Buttons;
shorter by using the following scheme:
use Prima qw(Application Buttons);
Another basic issue is the event loop, which is called by
run Prima;
sentence and requires a "Prima::Application" object to be created
beforehand. Invoking "Prima::Application" standard module is one of
the possible ways to create an application object. The program usually
terminates after the event loop is finished.
The window is created by invoking
new Prima::Window();
or
Prima::Window-> create()
code with the additional parameters. Actually, all Prima objects are
created by such a scheme. The class name is passed as the first
parameter, and a custom set of parameters is passed afterwards. These
parameters are usually represented in a hash syntax, although actually
passed as an array. The hash syntax is preferred for the code
readability:
$new_object = new Class(
parameter => value,
parameter => value,
...
);
Here, parameters are the class properties names, and differ from class
to class. Classes often have common properties, primarily due to the
object inheritance.
In the example, the following properties are set :
Window::text
Window::size
Button::text
Button::centered
Button::onClick
Property values can be of any type, given that they are scalar. As
depicted here, "::text" property accepts a string, "::size" - an
anonymous array of two integers and "onClick" - a sub.
onXxxx are special properties that form a class of events, which share
the "new"/"create" syntax, and are additive when the regular properties
are substitutive (read more in Prima::Object). Events are called in
the object context when a specific condition occurs. The "onClick"
event here, for example, is called when the user presses (or otherwise
activates) the button.
API
This section describes miscellaneous methods, registered in "Prima::"
namespace.
message TEXT
Displays a system message box with TEXT.
run Enters the program event loop. The loop is ended when
"Prima::Application"’s "destroy" or "close" method is called.
parse_argv @ARGS
Parses prima options from @ARGS, returns unparsed arguments.
OPTIONS
Prima applications do not have a portable set of arguments; it depends
on the particular platform. Run
perl -e '$ARGV[0]=q(--help); require Prima'
or any Prima program with "--help" argument to get the list of
supported arguments. Programmaticaly, setting and obtaining these
options can be done by using "Prima::options" routine.
In cases where Prima argument parsing conflicts with application
options, use Prima::noARGV to disable automatic parsing; also see
parse_argv. Alternatively, the construct
BEGIN { local @ARGV; require Prima; }
will also do.
SEE ALSO
The toolkit documentation is divided by several subjects, and the
information can be found in the following files:
Tutorials
Prima::tutorial - introductory tutorial
Core toolkit classes
Prima::Object - basic object concepts, properties, events
Prima::Classes - binder module for the core classes
Prima::Drawable - 2-D graphic interface
Prima::Image - bitmap routines
Prima::image-load - image subsystem and file operations
Prima::Widget - window management
· Prima::Widget::pack - Tk::pack geometry manager
· Prima::Widget::place - Tk::place geometry manager
Prima::Window - top-level window management
Prima::Clipboard - GUI interprocess data exchange
Prima::Menu - pull-down and pop-up menu objects
Prima::Timer - programmable periodical events
Prima::Application - root of widget objects hierarchy
Prima::Printer - system printing services
Prima::File - asynchronous stream I/O
Widget library
Prima::Buttons - buttons and button grouping widgets
Prima::Calendar - calendar widget
Prima::ComboBox - combo box widget
Prima::DetailedList - multi-column list viewer with controlling
header widget
Prima::DetailedOutline - a multi-column outline viewer with
controlling header widget
Prima::DockManager - advanced dockable widgets
Prima::Docks - dockable widgets
Prima::Edit - text editor widget
Prima::ExtLists - listbox with checkboxes
Prima::FrameSet - frameset widget class
Prima::Grids - grid widgets
Prima::Header - a multi-tabbed header widget
Prima::HelpViewer - the built-in POD file browser
Prima::Image::TransparencyControl - standard dialog for transparent
color index selection
Prima::ImageViewer - bitmap viewer
Prima::InputLine - input line widget
Prima::KeySelector - key combination widget and routines
Prima::Label - static text widget
Prima::Lists - user-selectable item list widgets
Prima::MDI - top-level windows emulation classes
Prima::Notebooks - multipage widgets
Prima::Outlines - tree view widgets
Prima::PodView - POD browser widget
Prima::ScrollBar - scroll bars
Prima::ScrollWidget - scrollable generic document widget
Prima::Sliders - sliding bars, spin buttons and input lines, dial
widget etc.
Prima::StartupWindow - a simplistic startup banner window
Prima::TextView - rich text browser widget
Prima::Themes - widget themes manager
Standard dialogs
Prima::ColorDialog - color selection facilities
Prima::EditDialog - find and replace dialogs
Prima::FileDialog - file system related widgets and dialogs
Prima::FontDialog - font dialog
Prima::ImageDialog - image file open and save dialogs
Prima::MsgBox - message and input dialog boxes
Prima::PrintDialog - standard printer setup dialog
Prima::StdDlg - wrapper module to the toolkit standard dialogs
Visual Builder
VB - Visual Builder for the Prima toolkit
Prima::VB::VBLoader - Visual Builder file loader
cfgmaint - configuration tool for Visual Builder
Prima::VB::CfgMaint - maintains visual builder widget palette
configuration
PostScript printer interface
Prima::PS::Drawable - PostScript interface to "Prima::Drawable"
Prima::PS::Encodings - latin-based encodings
Prima::PS::Fonts - PostScript device fonts metrics
Prima::PS::Printer - PostScript interface to "Prima::Printer"
C interface to the toolkit
Prima::internals - Internal architecture
Prima::codecs - Step-by-step image codec creation
gencls - "gencls", a class compiler tool.
Miscellaneous
Prima::faq - frequently asked questions
Prima::Const - predefined toolkit constants
Prima::EventHook - event filtering
Prima::Image::AnimateGIF - animate gif files
Prima::IniFile - support of Windows-like initialization files
Prima::IntUtils - internal functions
Prima::StdBitmap - shared access to the standard toolkit bitmaps
Prima::Stress - stress test module
Prima::Tie - tie widget properties to scalars or arrays
Prima::Utils - miscellaneous routines
Prima::Widgets - miscellaneous widget classes
Prima::gp-problems - Graphic subsystem portability issues
Prima::X11 - usage guide for X11 environment
Class information
The Prima manual pages often provide information for more than one
Prima class. To quickly find out the manual page of a desired
class, as well as display the inheritance information, use
"p-class" command. The command can produce output in text and pod
formats; the latter feature is used by the standard Prima
documentation viewer "podview" ( see File/Run/p-class ).
COPYRIGHT
Copyright 1997, 2003 The Protein Laboratory, University of Copenhagen.
All rights reserved.
Copyright 2004 Dmitry Karasik. All rights reserved.
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
AUTHORS
Dmitry Karasik <dmitry@karasik.eu.org>, Anton Berezin
<tobez@tobez.org>, Vadim Belman <voland@lflat.org>,