@DATABASE "WBWelcome.guide" @AUTHOR "Alex Furmanski" @NODE main "Welcome to WBWelcome" @{b} @{u}WBWelcome v0.1 by Alex Furmanski@{ub}@{uu} @{"Introduction" link intro} The Programs: @{"WBWelcome" link wbwel} @{"WBWelcomePrefs" link wbprefs} @{"History" link history} @{"Know Bugs" link bugs} @{"Copyright" link copy} @{"About MUI" link mui} @{"Information about the authour can be found here. Have a look, if you wish." link author} Some example sound files can be found in the samples dir. You might like to try them out. @ENDNODE @NODE intro "What IS WBWelcome?" Put simply, all WBWelcome does is play IFF samples. The package comes in two parts: @{"WBWelcome" link wbwel} which plays the samples @{"WBWelcomePrefs" link wbprefs}, the preferences program. What is special about it, is that it will play a sample from its sample list at random. It is designed to act as a welcome message giver (hence its name) when your Workbench opens up. Using the preferences program, you can configure your sample list and then you put WBWelcome in your WBStartup drawer and you will be greeted with a random message each time. @ENDNODE @NODE wbwel "The WBWelcome program" This file should be placed in your WBStartup drawer and will play a random sample upon execution. Of course, you could use it to play samples at random any time, just double-click on it! It will only play IFF 8SVX samples less than 128k long though. An error will be generated if a sample cannot be played. The config file, "Env:wbstartup.prefs" must be available. @ENDNODE @NODE wbprefs "The WBWelcomePrefs program" @{b}WBWelcomePrefs uses @{"MUI" link mui}.@{ub} This is the main part of the program and can be installed anywhere on your system, although the Prefs dir seems sensible. Using this program you can create your sample list, for WBWelcome to use. @{b}Explanation of controls@{ub} @{"WBWelcome v0.1 by Alex Furmanski " link tit} | @{"New sample " link list} @{"New sample " link nam} | | @{" " link list} | | @{" " link list} @{"Scream!.8svx" link fil} | | @{" " link list} | | @{" " link list} @{"Pick sample file" link pick} | | @{" Add " link add} @{" Del " link del} @{"Save" link sve} @{"Cancel" link can} | ----------------------------------------- @ENDNODE @NODE tit "The title bar" This is the title bar. I thought this was obvious. You disappoint me. @ENDNODE @NODE list "The listview" This is a listview containing the names of the samples in the playlist. Click on a name to see more information about the sample. The scroll bar and arrow gadgets may be used if there are a lot of samples, although the program limits you to 20 samples by default. @ENDNODE @NODE nam "The sample name gadget" This string gadget contains the name associated with the currently selected sample. This is the name that appears in the listview. It serves no other purpose. @ENDNODE @NODE fil "The sound file name gadget" This read-only gadget show the filename of the currently selected sample. It can be changed by clicking the @{"Pick sample file" link pick} button. @ENDNODE @NODE pick "The sound file selection gadget" Clicking this button opens a ASL file requester from which you should select an IFF 8SVX sound sample. If the file you select is not in the correct format, you will be informed and asked to reselect. @ENDNODE @NODE add "The add button" Use this button to create a new sample in the sample list. A sample named "New Sample" and with no associated sound file will be added to the list. These values may be edited using the gadgets. @ENDNODE @NODE del "The delete button" Clicking this button will delete the currently selected sample from the sample list. IT IS NOT POSSIBLE TO UNDELETE. @ENDNODE @NODE sve "The save button" Use this button to save the sample list to the configuration file and exit from the program. If the program does not exit, it means that the config file "Env:wbwelcome.prefs" could not be copied to EnvArc:. @ENDNODE @NODE can "The cancel button" This button allows you to exit from the program without saving any changes you have made to the sample list. @ENDNODE @NODE history "" v0.01 - 28/12/98 First version GadTools GUI v0.02 - 31/12/98 Fixed delete button bug Tweaked prefs file v0.10 - 5/12/98 WBWelcome Daemon now calculates sample play time Optimised code exes: Daemon - 18436 Prefs - 53128 v1.01 - 23/1/98 Re-wrote prefs program to use MUI Tweaked prefs file Fixed "numsams" bug exes: Daemon - 19124 Prefs - 61692 v1.02 - 7/3/98 Fixed sample duration error - my fault exes: Daemon - 19116 Prefs - 61792 @ENDNODE @NODE bugs "Erk!" Firstly, some bug-like features which are actually forced upon me: 1: Samples must be in IFF 8SVX format 2: Samples must be no more than 128k long There have been initial reports of the Listview not updating. If you get this, let @{"me" link author} know and ignore it for now. Save your config and reload the prefs program, and the Listview will update. If you find any bugs, in either program, the let @{"me" link author} know. @ENDNODE @NODE copy "Copyright details" WBWelcome is Copyright (C)1998-99 Alex Furmanski. @{"MUI is Copyright (C)1992-97 Stefan Stunz" link mui} Attemps to breach this copyright will be dealt with by an implausibly large aubergene and the offending party - so there. This program is freely distributable and no money is asked for its use, just a little gift or even a letter to let me know you (dis)like it. Ta. My thanks go to Curt Esser, whose code for calculating sample duration worked like a dream. @ENDNODE @NODE author "About me" WBWelcome was written by Alex Furmanski, a prolific programmer who seems to spend most of his time glued to his computer chair (a nasty accident - don't ask). At the age of 16 (years), he is taking A-Levels in Computing, Electronics, Maths and Chemistry. Hands full, then. He has been programming for several years, since he started on his ZX Spectrum in the (very) early nineties. Over this period, he has knocked up a few small programs and a couple of major ones which were published on an AFCD. You probably know the name from the excellent Civ Hack (plug plug) Should you wish to contact him, write to: Alex Furmanski 1 Heywood Drive Luton Beds LU2 7LW or try e-mailing: a.furmanski@virgin.net It really would make his day. @ENDNODE @NODE mui "About the MagicUserInterface system" This application uses MUI - MagicUserInterface (c) Copyright 1992-97 by Stefan Stuntz MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called "muiXXusr.lha" (XX means the latest version number) on your local bulletin boards or on public domain disks. If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY Support and online registration is available at http://www.sasg.com/ @ENDNODE