Prima::VB::CfgMaint - maintains visual builder widget palette configuration.
The module is used by the Visual Builder and prima-cfgmaint programs, to maintain the Visual Builder widget palette. The installed widgets are displayed in main panel of the Visual Builder, and can be maintained by prima-cfgmaint.
prima-cfgmaint
The Visual Builder widget palette configuration is contained in two files - the system-wide Prima::VB::Config and the user ~/.prima/vbconfig. The user config file take the precedence when loaded by the Visual Builder. The module can select either configuration by assigning $systemWide boolean property.
Prima::VB::Config
~/.prima/vbconfig
$systemWide
The widgets are grouped in pages, which are accessible by names.
New widgets can be added to the palette by calling add_module method, which accepts a perl module file as its first parameter. The module must conform to the VB-loadable format.
add_module
This section describes format of a module with VB-loadable widgets.
The module must define a package with same name as the module. In the package, class sub must be declared, that returns an array or paired scalars, where each first item in a pair corresponds to the widget class and the second to a hash, that contains the class loading information, and must contain the following keys:
class
Name of the VB-representation class, which represents the original widget class in the Visual Builder. This is usually a lightweight class, which does not contain all functionality of the original class, but is capable of visually reflecting changes to the class properties.
Sets an image file, where the class icon is contained. PATH provides an extended syntax for indicating a frame index, if the image file is multiframed: the frame index is appended to the path name with : character prefix, for example: "NewWidget::icons.gif:2".
:
"NewWidget::icons.gif:2"
Sets the module name, that contains class.
Sets the default palette page where the widget is to be put. The current implementation of the Visual Builder provides four pages: General,Additional,Sliders,Abstract. If the page is not present, new page is automatically created when the widget class is registered.
General,Additional,Sliders,Abstract
Sets the module name, that contains the original class.
The reader is urged to explore Prima::VB::examples::Widgety file, which contains an example class Prima::SampleWidget, its VB-representation, and a property lineRoundStyle definition example.
Prima::SampleWidget
lineRoundStyle
Reads FILE module and loads all VB-loadable widgets from it.
Returns string declaration of all registered classes in format of classes registration procedure ( see "FORMAT" ).
classes
Loads class and pages information from either a system-wide or a user configuration file. If succeeds, the information is stored in @pages and %classes variables ( the old information is lost ) and returns 1. If fails, returns 0 and string with the error explanation; @pages and %classes content is undefined.
@pages
%classes
Returns array of page names
Reads information from both system-wide and user configuration files, and merges the information. If succeeds, returns 1. If fails, returns 0 and string with the error explanation.
Erases all information about pages and classes.
Writes either the system-wide or the user configuration file. If $backup flag is set to 1, the old file renamed with .bak extension. If succeeds, returns 1. If fails, returns 0 and string with the error explanation.
$backup
.bak
Prima::VB::Config.pm, ~/.prima/vbconfig.
Dmitry Karasik, <dmitry@karasik.eu.org>.
VB, prima-cfgmaint, Prima::VB::examples::Widgety.
To install Prima, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Prima
CPAN shell
perl -MCPAN -e shell install Prima
For more information on module installation, please visit the detailed CPAN module installation guide.