Raffeli

ABOUT
-----

 Raffeli is a simple MUI program to raffle things. Use it to raffle prizes at
 events or for anything else that needs random results from custom lists, or
 to shuffle lists into a random order.


FEATURES
--------

 - Individual or several winners can be raffled each round
 - Can show different pictures that depend on the raffle's final result
 - Raffling sound effects
 - Text files can be imported and appended to the entry list
 - Entry/result lists can be exported as text files
 - The entry list can be sorted by results
 - The entry list can be shuffled into a random order


INSTALLATION
------------

 - Copy the whole directory anywhere you prefer and just launch the program
 - If the program fails to start, copy muiroyale.hwp to LIBS:Hollywood/


SETTINGS
--------

 Settings are found in the program's drop-down menu.

 Sound effects . . . . - Enables sound effects
 Remember list . . . . - Remembers the previous entry list at program startup
 Sort automatically  . - Moves winners to the top of the list automatically
 Confirm remove  . . . - Requests confirmation if entry removal attempted
 Show pictures . . . . - Shows pictures next to the entry list
 Select picture dir  . - Asks for a picture directory that should contain
                         files named as 0.* (default pic), 1.*, 2.*, etc.
                         For example, when a winner is raffled, 1.png would be
                         shown, etc..
 Cycles  . . . . . . . - Sets how many times the list is looped before the
                         indicator stops at the winning position


COMMAND LINE OPTIONS AND ICON TOOLTYPES
---------------------------------------

 Raffeli uses non-standard command line arguments. Arguments must be given
 in the form of (note the "-" prefix): -argument parameter

 Allowed arguments:
 -file <file>  . . . . - Imports a text file at startup
 -defdir <dir> . . . . - Sets the initial directory to open files
 -picdir <dir> . . . . - Sets the picture directory
 -args . . . . . . . . - Shows the allowed arguments

 Example:
 Raffeli -file "Work:entrants.txt"


 The same arguments can be used as icon tooltypes, but by omitting the
 "-" prefix.

 Examples:
 DEFDIR=Work:
 FILE=Work:entrants.txt
 PICDIR=Pictures2


WEB
---

 - Please visit http://jpv.wmhost.com/jpv_software/ for screenshots, support,
   donations, and other software
 - This program is made with Hollywood: http://www.hollywood-mal.com/


THANKS TO
---------

 - Neil Pearson for proof-reading


DISCLAIMER
----------

 This software is made available to you as Freeware and you may use this
 software in whichever way you prefer, but the author accepts no liability for
 any damage caused to your system or other connected peripherals by using
 this software.