Documentation of YoWB Copyright © 1995 Envolpment All Rights Reserved. --------------------------- -------------------- Document : YoWB.Doc Idea and softwares : David Scrève Doc, icons and logos : Stéphane Anquetil Version : 1.0 Revision : 2.0a Date : 29/01/95 Yo know what ? ------------ YoWb is one of these sofware which make you crazy !. Then, it is absolutely necessary. YoWb provides the ability to play sounds for every Intuition events. When you touch your mouse, a specified sound will be played directly from the disk. No ! Don't go away ! I will explain how it's wonderful... When you click on a mouse button, when you pick an item in a menu, or when you activate or move a window, etc... a sound will play. You just have to choose the right sound to the right event which make the funniest effect ! And then, you will say : "My Workbench is Yo !". Installation ------------ To install the software, just click on the Install_Yo.English icon. The software will automatically installs all required files. Some sounds will installed by default, just as an example for configuration. Let's go ! ---------- To run YoWB, just click on its icon YoWb (the boy with cap). To choose the sounds for each event, just run the preferences software called YoPrefs. YoPrefs is a standard preference software. In the text fields, you can directly enter the path for each sound file. If you have some digitized sounds, it's time to try them. You can use the file requester to choose your files : just click on the button with an File icon. You can test your sound by clicking on the speaker button. Indications ----------- YoWb is running at priority 25. It MUST have the highest priority in your system. It's priority must be higher than the input.device task, and any other task using windows. YoWb should be launch as later as possible in your startup procedure. YoWb is a commodity. You can quit it (why ?) using the Exchange software by Commodore. The "Show interface" button show a window "About...". The toggle button Active/Inactive restores silence. If you click on the YoWb icon, the preferences software will be loaded from Sys:Prefs. YoWb handled File Notification. It means that, if you change your settings using YoPrefs, YoWB will automatically take care of them. Configuration ------------- YoWb requires Release 2.0 or higher of the Operating System. The software has been tested on differents configurations listed below. YoWb doesn't need many CPU times. The main software is just about 10 KBytes and the preferences files 3348 Bytes. An hard disk, or any other fast memory support should be used for an efficient sound playing. The sounds are read directly from the disk. The software requires the User Interface Kit. Tested on : Amiga 4000/040 18 MB FAST (16 MB 32 Bits, 2 MB 16 Bits), 2 MB CHIP, OS 40.70 Amiga 2000/030 8 MB FAST, 1 MB CHIP, OS 38.38 Amiga 1200/030 4 MB FAST, 2 MB CHIP, OS 39.106 UIK --- The software and its preferences file requires the freely distributable part of the UIK package. This package is composed by a Preferences software, a shared library, a serie of objects installed in a directory assigned to UIK:. UIK is a toolbox for the programmers, which provide a full control of the User Interface by the final user, for all the software which use UIK. Programmers can purchase UIK or obtain any information about UIK by contacting its author : Jean-Michel Forgeas 16170 BORDEVILLE FRANCE Technical --------- YoPrefs has differents fields which are directly attached to Intuition events, which are taken by YoWB. French English Intuition Events ------ ------- ---------------- 1 "Boutons de souris", "Mouse Buttons", // MOUSEBUTTONS 2 "Déplacements", "Mouse Movements", // MOUSEMOVE 3 "Enfoncement", "Button Push", // GADGETDOWN 4 "Relâchement", "Button pop", // GADGETUP 5 "Début de requète", "Start Requester", // REQSET 6 "Sélection de Menu", "Menu Selection", // MENUPICK 7 "Fermeture de fenêtre", "Window Close", // CLOSEWINDOW 8 "Touche clavier", "Keyboard", // RAWKEY 9 "Fin de requête", "End Requester", // REQCLEAR 10 "Insertion de disquette", "Disk inserted", // DISKINSERTED 11 "Ejection de disquette", "Disk removed", // DISKREMOVED 12 "Activation de fenêtre", "Window activated", // ACTIVEWINDOW 13 "Modification de fenêtre", "Window changed", // CHANGEWINDOW Meaning ------- 1 Click on a button, but without any other effect (window activating, button pushing) 2 Moving the mouse, with the left button pushed, and a active gadget. 3 Pushing a button 4 Poping a button 5 Requester appearing 6 Menu Item Picking 7 Window Close 8 Keyboard 9 Closing a Requester 10 Inserting a disk in a drive 11 Removing a disk from a drive 12 Active Window 13 Modifiying a Window with position or size Each software can decide which event it wants to receive. Then, if YoWb just take the events which are send to windows, some softwares would not play sounds, even if there is a graphic change on your screen. So, some applications want to known when a window is resized. If you associate a sound to CHANGEWINDOW using YoPrefs, YoWb will be informed an a sound will be played. But, if the application doesn't want to be informed by this window change, the window will be redrawn by Intuition, and will not send any event to the application. And then, YoWb, would not be able to play any sound. The trick consists on simulating of the events which are not send by Intuition. YoWB uses this trick. But, I will not say more about this. The other, it's just a wizard trick from envolpment. Envolpment ---------- This software has been developed by the envolpment Group. Envolpment is a team formed by the developer David Scrève and Graphic Artist Stéphane Anquetil. Here is a list of some other products created by envolpment : * Décollages : The first creative software, for childrens. It's an educative software which use many ClipArts to put in your drawing. Each ClipArt is described with some text and sounds. Décollages is talking to the child in all actions, and has its own mascot : Mr. Coll. Numbers of activites are provided : points linking, flooding, sticking, puzzle. It's a commercial product published by ArtioDactyl France Informatique. For Any information : A.D.F.I Résidence les Cottages 83, rue André Theuriet F-63000 CLERMONT-FERRAND FRANCE * AnyShow : Picture viewer. Provide to redraw a drawing created using Décollages or Décollages Junior, showing how the drawing has been created. Provide capabilities to play sounds, and to create your slide-show, including loop and delay managing. Can display any other IFF picture in the Décollages Screen modes. Freely Distributable. Distribution ------------ YoWb and YoPrefs are freely Distributable. Any inclusion in a commercial package is not allowed without written agreement. This software is GiftWare : So, if you use it and you like it, we will be very happy to receive some word to encourage us, with eventually a small gift : Chocolate, Post Card, Money, disk full, computer, etc... If we have enough money and time, you will probably receive our latest production. Our Address : David Scrève 4, Rue Flaubert 59115 LEERS - FRANCE \ / YoWB 1.0 | To have to Workbench the most Yo ! Copyright © 1995 envolpment All Rights Reserved Thanks ------ We want to thanks some people which help us for this release : * Stéphane Torchy * Jean-Michel Forgeas. And all of them, which will be enjoy by our creation. History: rev.2.0a Correction of syntax errors. No more sound from other source (including E.Swartz anims...). =============================================================================== Legal notes for Installer Distribution : Installer and Installer project icon (c) Copyright 1991-93 Commodore-Amiga, Inc. All Rights Reserved. Reproduced and distributed under license from Commodore. INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE. ALL USE IS AT YOUR OWN RISK. NO LIABILITY OR RESPONSIBILITY IS ASSUMED.