**************************************************************************** * * * ReqMes & ReqPal V1.0 (28-Mar-93) * * Copyright (c) 1991-1993 PLL Developments * * All rights reserved * * A TimeZone Release * * * * YOU NEED REQ.LIBRARY TO MAKE USE OF THESE PROGRAMS * * * **************************************************************************** 1 CONTENTS ============ This LhA Archive contains the following files: Directory ReqMes - Programs ReqMes & ReqPal + Documents ReqMes 5032 - ReqMes V1.0 ReqPal 5344 - ReqPal V1.0 ReqPal.info 380 - Icon for ReqPal V1.0 ReqPalMes.doc 6949 - ReqPal & ReqMes Documents V1.0 ReqPalMes.doc.info 766 - Icon for ReqPalMes Docs Directory libs - Requester Library req.library 18436 - Fox & Dawson Requester Library V2.7 2 INTRODUCTION ================ ReqMes brings up a requester (actually a window) containing a message to the user and wait for the user to acknowledge it. The window automagically sizes to fit the text and it will appear immediately under the mouse. If it is impossible to position the window exactly where requested (if the mouse pointer is too close to the edge of the screen) then ReqMes will position the window as close as possible to the correct location. ReqPal is a full-fledged colour requester. It is intelligent enough to open with the right number of colours in the palette automatically. It shows you both the colour you are working with, and the numerical RGB value of that colour. It has Spread, Undo, Ok and Cancel functions and it will appear immediately under the mouse. 3 INSTALLATION ================ ReqPal & ReqMes will run on any Amiga system with any KickStart and isn't limited to be just a WB1.3 or WB2.0 tool. ReqMes & ReqPal requires the req.library (written by Colin Fox of Pyramyd Designs and Bruce Dawson of CygnusSoft Software) to be present in your libs: directory. In fact, you can copy ReqMes and ReqPal in any directory you like, but I recommend to copy them into c: for the best operation. 4 THE ARGUMENTS ================= REQMES ------ You can get ReqMes command template by typing from CLI: ReqMes The following text is displayed on screen: Usage: ReqMes [message] [-f file] Watch the syntax! Everything between [] is optional. You could either use [message] which is any ASCII text, or [-f file] which is a predefined ASCII text stored on (hard)disk. This text can be easily edited with your favourite text-editor or word-processor. As soon as you have typed the correct number of arguments, the ReqMes requester pops up with the appropriate message to the user and is waiting for you to select the Resume gadget (or to press the q r y l v b n m or Esc key). So, you could easily use ReqMes to display a message to the user in script (batch) files to inform the user about something special (as a replacement for c:Echo) or use ReqMes to display your predefined text from (hard)disk (as a replacement for c:Type). Alternatively you can use ReqMes to display your own menu systems (a disk compiler's dream) or to display your ANSI's (like the PLL logo below) in a neat window on screen (well actually ASCII's, since ReqMes doesn't know about ANSI codes). [message] --------- This argument let you specify the text in the ReqMes window, currently only one line supported. Note that you can use quotes to center your text or to use spaces. Example: ReqMes "This program allocates approximately 2 GigaBytes of memory!" or ReqMes " Red Limbo Squad " [-f file] --------- Let you specify an ASCII text stored on (hard)disk. The space between -f and file is essential. Note that you can't specify files larger than 5000 bytes. If you do however, an appropriate error message will be generated. If ReqMes can't find the file specified after the -f option, again, an appropriate error message will be generated. Hey, you can't open a requester (text) that is larger than your current screen, if you do, things will get very ugly. Example: ReqMes -f s:startup-sequence or ReqMes -f df0:s/Menu REQPAL ------ You can start ReqPal by typing from CLI: ReqPal From WorkBench just click on the appropriate icon. There are no optional arguments. ReqPal is a replacement for the palette utility located on your WorkBench Extras disk. With ReqPal you can easily change the colours of the WorkBench screen. The cursor keys move the colour-cursor around the palette, RETURN selects the current colour and ESC cancels out. The programs ReqMes & ReqPal also work fine with ReqChange from Magnus Holmgren, so if you have ReqChange installed, ReqMes & ReqPal will pop up with the ReqTools requesters from Nico François (confusing isn't it?). 5 ACKNOWLEDGEMENTS ==================== Thanks to Colin Fox of Pyramyd Designs and Bruce Dawson of CygnusSoft Software for the wonderful req.library. They did it all. Personal regards to RLS for such a talented musician, Turbo-Ties for his many disk-swaps & software distribution, Mega-Byte (or is it Giga-Byte?) for his A4000 (Giga) MegaBytes, ThC for the nice chat, and EuroSoft for his new CC. 6 REVISION HISTORY ==================== ReqMes V1.0 12-Feb-91 Internal ReqPal V1.0 29-Oct-91 Internal - Initial Release ______________ __________ ____ _________________ / \ \ \________/ / /\ __________________ \_______________/ /_________ /\ \ ______ /. / / \________________/ _____________ \__/ /_/ ./ / \ \____/ // / / ______________ \___________/ / // /\ \ / / / \____________/ _________ / ______/ /\ \. \____/__ /_/_______ __________ \_______/ / /\_____\/ \ \\ \ /\ \________/ _____ /___/ / \ \__________\_______/ / ______ \___/ \___\/ \/__________/_______\/ \____/ _______ ______ _____ __ __________ ______ _________ _____ \__/\_ \ \____/\ /\\___/\/ / \____/\__ \ /\ \____/\/\/ __ _ /\\_ / / / \ \___ / / / /__ / / / __ / /_ \ \/\/ \ ___ / / \/ / / \/ /__\/ / / / / _/ \/\/ / _/ \/ / / / / / /_/ / /\ \/ _/ \/ /\ \/ / \/__ \ / /__/ / /_/\ \ / /_/\/ /_/\/ /_/ / / \_/ /\/ \ \/_/\/ / \ \/_______/ / \/ \__/\____/ \/\____/\____/\____/\/ \/ \____/\/ /\__________/ \/ Of /\_ __ /\_ /\ /\___ _/\__ __/\___/\ /\_ __/\___ _/\ / \Y \\ \/ Y\/ \ Y \ Y \___// \Y \ \ Y \ / : / \ :/ _· / | _/___/ : / · / / _/ · / / .\_ \___/ :__/ Y / \ / \____/ \_/ \ . / / / \ \/ ·\/ : / \_/ ___/_ __ / \ \ / \ \ / . \ Y\ \/ Y / / \ / / \ \ ·/ ·/ \ ______/\ __/\______ /\_____/\______\___ /\____ / -==========\/========\/==========\/===================\/=->F&A\/===============- For Updates And BUG reports Contact Mystical Places At: +31-10-4779507 (16k8 DuAl) sysop: ThC Or Call To The Other JuStiCe Boards: CASTLE ROCK [WHQ] +41-31-879-0966 MOZART'S MANSION [USA] +1-904-765-0360 -=============================================================================-