Image::ButtonMaker - Button generator.
#Create Image::ButtonMaker object
$bmaker = Image::ButtonMaker->new();
# Add directory with some truetype fonts in it
$bmaker->add_font_dir('./happyfonts');
# Add directory with icons to be used inside buttons
$bmaker->add_image_dir('./happyfaces');
#This is where the output will go
$bmaker->set_target_dir('/httpd/happybuttons');
# Read the list of classes
$bmaker->read_classfile('happyclasses.pl');
# Read the list of buttons to be generated
$bmaker->read_buttonfile('buttonlist.pl');
# Generate buttons
$bmaker->generate;
Image::ButtonMaker is a helper module for people who need to generate vast amounts of button images. The module supports dividing your buttons into classes, who inherit appearance from each other and overriding needed parameters on class level or on single button level.
Image::ButtonMaker was developed as a part of a large scale web application with multiple language support, themes and products.
Image::ButtonMaker requires Image::Magick with TrueType Font support to run.
Each button has a set of different attributes, which determine the appearance of the button. The button can belong to a class which acts as a template for the button. The class can be a member of a class tree, where attributes are inherited from parent class to child class.
The class tree can be stored in one or multiple files. The Image::ButtonMaker object method read_classfile will read those files and build the class tree.
With the class tree in place it is time for the button definition.
Class file contains a list of classes written in Perl syntax as a list of lists:
## Button class list
[
[
classname => 'basicbutton',
properties => {
FileType => 'png',
HeightMin => 17,
HeightMax => 17,
WidthMin => 90,
CanvasType => 'pixmap',
CanvasTemplateImg => 'rounded_button_template.png',
CanvasCutRight => 1,
CanvasCutLeft => 1,
CanvasCutTop => 1,
CanvasCutBottom => 1,
ArtWorkType => 'text',
ArtWorkHAlign => 'center',
ArtWorkVAlign => 'baseline',
TextColor => '#606060',
TextSize => 11,
TextFont => 'verdana.ttf',
TextAntiAlias => 'yes',
MarginLeft => 6,
MarginRight => 6,
MarginTop => 3,
MarginBottom => 4,
}
],
[
classname => 'basicbutton_with_arrow',
parent => 'basicbutton',
properties => {
ArtWorkType => 'icon+text',
ArtWorkHAlign => 'left',
IconName => 'smallarrow.gif',
IconSpace => 3,
IconVerticalAdjust => 0,
WidthMin => 100,
WidthMax => 100,
}
],
[
classname => 'errorbutton',
parent => 'basicbutton',
properties => {
TextColor => '#f00000',
}
],
]
Every class definition has two or three attributes:
The name of the class. Should be something unique for every class.
Specify the class to inherit from.
A list of properties for the button. Properties can be inherited or defined for each class, depending on presence of a parent.
The properties will be passed to the Image::ButtonMaker::Button module and are listed in this modules man page.
The button list file syntax is very similar to the class list syntax. A list of buttons is defined. Every button belongs to a class and has a list of properties that can override class defaults:
### Button list
[
[
name => 'submitForm',
classname => 'basicbutton',
properties => {
Text => 'Submit Data',
}
],
[
name => 'goBack',
classname => 'basicbutton_with_arrow',
properties => {
Text => 'Back to Main',
}
],
[
name => 'showAlert',
classname => 'errorbutton',
properties => {
Text => 'Important Info',
}
],
]
Each button definition has three attributes:
Button name. Will eventually become the name of the generated file (with suffix matching FileType attribute)
Class that this button calls home.
Hash of properties with name similar to properties in the class files and the attributes of the Image::ButtonMaker::Button package.
The constructor. Returns the Image::ButtonMaker object.
Read the class file and add it to the class tree.
Read button list and add found buttons to the list of buttons to be generated with the generate method.
Empty the button list.
Add a path to the list of paths, where the ButtonMaker looks for images.
Return list of paths.
Add a path to the list of paths, where the ButtonMaker looks for fonts.
Return list of font paths.
Set the directory for the ButtonMaker to use for output files.
Return the directory for output paths.
Get current language ID (for use with the undocumented Lexicon)
Set current language ID (for use with the undocumented Lexicon)
Generate buttons.
Piotr Czarny <picz@sifira.dk> wrote this module and this crappy documentation.
