%ARoller is a dice rolling program and more, it features massive expandability through its plugin system, it comes with the Magic Lives Counter as standard, but many more can be added to add power to the engine and make use of both the user interface and dice rolling facilities of the program.
GARollers file management is exactly the same as any other EPOC32 program, the file menu allows access to loading and saving files, and also allows the creation of new files, Roller files can be loaded from the System screen by tapping on their icons like any other EPOC32 application. Below is a list of File Management options
%ATo create a new file simply select Create New from the File Menu, this will present you with a file
creation dialog, enter the name and folder for the file and select Okay to create it. The file will contain default setting for Dice and a default roll to get you started, this may be deleted.
AYou can save the current set of rolls to a new file, without replacing the previously loaded set, this can be used to build similar sets of rolls for different uses, Save As presents you with a Save file dialog allowing you to chose which file to save to, the file will be saved here.
Table1
title
"keywords
Arial
Times New Roman
"ADie Management allows the creation of new dice and the editing of existing dice, due to the way that rolls are generated deletion of dice is currently not available, this may be added at a later date but requires a lot of extra work. The main areas of Die management are Adding and Editing
ATo add a dice to the already set of available dice simply select Add Dice from the Dice menu, this will present you with a simple dialog which allows you to enter the name of the dice, what type it is (either Dice, Percentile or Number, more can be added by plugin modules) the number of sides
(for both dice in a percentile) and any flags (currently only used with percentiles, see Die types)
AThis allows the user to edit information about a particular die, the user selects a die from the list of available dice, and is then presented with a menu similar the the one presented when creating a dice, the name, the type, the number of sides and flags can be changed here.
ERoll management allows for the creation and editing of new roll types, these are done using a series of dialogs, there is little difference between the two and so they will be covered here in one, with differences noted as appropriate.
Select New Roll or Edit Roll from the Rolls Menu (if you select Edit roll you will be presented with a list of rolls to choose from) you will then be presented with the roll editing dialog (if you chose new roll it will be for Die 1 otherwise it will be for the last die of the selected roll) you can enter the die to use here and the number of them, plus an operation to be performed on the previous result and this roll (i.e. Add/Subtract etc, see Operations for more details) Once you've entered the details you can either add another Die, Finish or Cancel (you can cancel without incident at any point and nothing will change) If you've already added a dice and it's incorrect you can go back and change it using the < Prev button, you can use > More to add more dice or move forward again after editing, once you've added all the dice you must move forward to the last die in the roll and select finish which will move you to a second dialog, which allows you to enter a name for the roll and select the flags for the roll, the flags are Diagnose Checks (this shows additional information for conditional operations) and Allow negatives
(allows numbers to go below zero).
?BPlugins is where roller gets its real power from, the core roller program allows the creation of plugins that use their own windows, handles the passing of pen taps and key presses to the plugin (to the extent that the menu key can be trapped and plugins can have there own menus), whilst still allowing roller to act as a fully functioning program at the same time. In future Plugins will also be able to manage their own IO events and run asyncronously allowing features such as link-up via IrDA and Serial. the plugins are handled by the Generic Plugin Manger version 2.0
AThe plugin manager creates the plugin menu this contains sub menus for each plugin module and the manager, the manager presents a menu of available plugins and allows the addition of new modules and the removal of plugins no longer used. Adding a new module presents you with a list of available modules from the Plugin folder in the Application folder, you cannot add the same plugin twice.
Roller version 1.0=Roller Dice Rolling plugin Magic Lives user interface program
Using Roller7Using Roller File
dice Roll Plugin Management functions
Roller provides a number of dice rolling functions, these can be divided up into four areas, File handling, Dice Management, Roll Management and Plugin Management
Management>File Management Load Save Create EPOC32 System Menu Icon Icons
Create New File+Create New File Dialog creation Folder File
Open
File"Open File Dialog Roller files Load
Selecting open file will present you with a file open dialog where you can select from the available Roller files and by selecting Okay will allow you to load and use that file.
Save File
Save File Menu Dice Rolls
Selecting Save File from the File
Menu will allow you to save the current Dice and Rolls to the current file name, if no file name exists then you will be prompted for one.
Save As"Save
As File Dialog Rolls Die Dice
Exit
Exit\Exits roller and returns you the the application you where running when you started Roller.
Die Management)Die
Management Dice Rolls Add Edit Change
Adding Dice@Adding dice die menu dialog percentile number plugin sides flags
Edit Dice*Edit Dice Die name sides flags type dialog
Roll ManagementMRoll Management Add Edit Roll Dice Die dialog diagnose checks allow negatives
Delete Roll(Delete Roll Dialog selected backdrop Yes
Delete Roll allows you to delete the currently selected roll (as highlighted on the backdrop of the program) you will be asked if you are sure, simply tap Yes to delete the roll.
View RollUView
Roll information selected roll dice string allow negatives diagnose checks flags
View roll shows information about the currently selected roll, this shows the roll name, the roll dice string and also the allow negatives and diagnose checks flags for the roll.
Plugin Management3Plugin Management windows pen taps key presses menu
Generic Plugin ManagerCPlugin Menu sub menus manager config addition removal module folder
AThere are three die types built in:
Die - A normal die (i.e. D4,D6,D8,D10,D20) you can add as many die of different sizes as you wish to the program.
Percentile - Created by rolling two dice, one for the tens and one for units, the flags field affects the roll type as follows:
0 - The largest value counts as a zero, 00 counts as 100.
1 - The largest value counts as the largest value.
2 - The largest value counts as zero, 00 counts as 0.
Number - a whole number value.
MAThe operations are broken into two groups, arithmetic (Add,Subtract, Multiply and Divide) and conditional (less than, greater than, equal to). A third operation type also exists called
New this simply displays and discards the current result and starts a new one (As used in the AD&D Dice roll to create the second percentile value)
Appendix A: Die Types&Appendix A die Types percentile number
Appendix B: OperationsVOperations add subtract multiply divide less than greater equal AD&D percentile result
ARoller provides a number of dice rolling functions, these can be divided up into four areas, File handling, Dice Management, Roll Management and Plugin Management.
The backdrop acts as a repositiory for user generated rolls, using the pen or the cursor keys you can select a roll, tapping a selected roll will roll it, so will pressing enter, pressing backspace will delete the roll (after confirmation).
Roller version 1.0=Roller Dice Rolling plugin Magic Lives user interface program
Using Roller7Using Roller File
dice Roll Plugin Management functions
Management>File Management Load Save Create EPOC32 System Menu Icon Icons
Create New File+Create New File Dialog creation Folder File
Open
File"Open File Dialog Roller files Load
Selecting open file will present you with a file open dialog where you can select from the available Roller files and by selecting Okay will allow you to load and use that file.
Save File
Save File Menu Dice Rolls
Selecting Save File from the File
Menu will allow you to save the current Dice and Rolls to the current file name, if no file name exists then you will be prompted for one.
Save As"Save
As File Dialog Rolls Die Dice
Exit
Exit\Exits roller and returns you the the application you where running when you started Roller.
Die Management)Die
Management Dice Rolls Add Edit Change
Adding Dice@Adding dice die menu dialog percentile number plugin sides flags
Edit Dice*Edit Dice Die name sides flags type dialog
Roll ManagementMRoll Management Add Edit Roll Dice Die dialog diagnose checks allow negatives
Delete Roll(Delete Roll Dialog selected backdrop Yes
Delete Roll allows you to delete the currently selected roll (as highlighted on the backdrop of the program) you will be asked if you are sure, simply tap Yes to delete the roll.
View RollUView
Roll information selected roll dice string allow negatives diagnose checks flags
View roll shows information about the currently selected roll, this shows the roll name, the roll dice string and also the allow negatives and diagnose checks flags for the roll.
Plugin Management3Plugin Management windows pen taps key presses menu
Generic Plugin ManagerCPlugin Menu sub menus manager config addition removal module folder
(.txt)