************************************************************************** S P A C E I I Copyright (C)1991 Edgar M. Vigdal ************************************************************************** This program is a sharware program, so if you use this program, or have it in your collection of public-domain, you MUST send $20 to : EDGAR M. VIGDAL, Skipsbygger Hærems vei 5, 4085 HUNDVÅG, NORWAY You will then become a registered user and receive new versions and other utilities that I have made. ************************************************************************** ========================================================================== -------------------------------------------------------------------------- SPACE II -------------------------------------------------------------------------- ========================================================================== The Space Screen Blanking Utility. This program started out as a simple screen blanking program, but now in it's latest version (v2.0) it has over 30 utilities built in to only 43 Kbytes of pure assembler code. The program is a resident utilitiy that will be placed in the background, and will be activated with keypresses. It has been tryed to be keept as small as possibel, so that the small memory it occupies can be justified by the usefullness of the many utilities it provides. The program uses a inputhandler for linking into the stream of input events, and is almost invisible for other programs. The time I have used it, no interference with other program has occured, but if you discover some bugs than please let me know !!!. If you have ideas for more short utilities that you would have liked to see inside it, then send me a description of the utility and I will try to work it out. List of current utilities: (No spesific order) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Screen blanker. 2. Mouse blanker. 3. Text viewer. ALT/SHIFT/CTRL READ 4. Hex dump of files. ALT/SHIFT/CTRL READ 5. IFF-picture viewer. ALT/SHIFT/CTRL VIEW IFF 6. Sound player. ALT/SHIFT/CTRL SOUND 7. Make new directory. ALT/SHIFT/CTRL MAKEDIR 8. Rename files. ALT/SHIFT/CTRL RENAME 9. Move files. ALT/SHIFT/CTRL MOVE 10. Copy files. ALT/SHIFT/CTRL COPY 11. Delete files. ALT/SHIFT/CTRL DELETE 12. Set protection flags. ALT/SHIFT/CTRL 13. Directory to printer. ALT/SHIFT/CTRL DIR > PRT 14. Program runner. ALT/SHIFT/CTRL RUN 15. Text printer. ALT/SHIFT/CTRL READ Shift P 16. Directory lister. ALT/SHIFT/CTRL 17. Device info. ALT/CTRL F1 18. Memory info. ALT/CTRL F2 19. Palette. ALT/CTRL F3 20. Calculator. ALT/CTRL F5 21. Mouse Blanker OFF. ALT/CTRL F6 22. Mouse Blanker ON. ALT/CTRL F7 23. Screen dumper. ALT/CTRL F8 24. Alarm. ALT/CTRL F9 25. Save screens as IFF-pictures. ALT/CTRL F10 26. Audio filter On/Off. ALT/CTRL * (Keypad) 27. 50/60Hz Switch. ALT/CTRL / (Keypad) 28. Text rescue. ALT/CTRL ENTER (Keypad) 29. Display boot-block on disks in DF0:. ALT/CTRL 4 (Keypad) 30. Install disk in DF0. ALT/CTRL 5 (Keypad) 31. UnInstall disks in DF0:. ALT/CTRL 6 (Keypad) 32. Two blanking mode. Spacetrip and Dimmer. ALT/CTRL . (Keypad) 33. Disable/Enable virus checker ALT/CTRL 9 (Keypad) 34. Virus checker. 35. Screen shuffler with activate. ALT/CTRL CRSR UP 36. Screen shuffler without activate. ALT/CTRL CRSR DOWN 37. Window shuffler, Front to back. ALT/CTRL CRSR LEFT 38. Window shuffler, Back to Front. ALT/CTRL CRSR RIGHT 39. Exec Vectors display. ALT/CTRL BACKSPACE in 40764 bytes. ........................................................................... This document will surely look like shit to a person with good knowledge to the right syntax of the english language, but please have mercy with a norwegian the do not care about the syntax as long as the deep meaning of the text can be understood. If somebody feel the need to fix some misspelling, then for heavens sake do it, BUT leave my address intact in the document or else I will add it for you!!!! ........................................................................... FILE REQUESTER ALT/SHIFT/CTRL ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ With this very good file requester you could do a list of a directory by pressing 3 keys and than use the mouse and click around in a disk directory. By selecting a file a new window will open and many new options will be displayed. The gadgets provides the following: RUN This will try to start up a selected program and run it as a new task. MAKEDIR This will prompt for a name of the new directory and create the directory. DELETE This will delete the selected file. (Be carefull!) RENAME This will prompt for a new name and than rename the selected file. DIR This will bring up the filerequester and a new file can be selected. DIR > PRT This will send a selected directory to the printer, or a file that you choose. COPY This will prompt you for a new filename and than make a copy of the old file. MOVE This will prompt for a name and than move the file. READ This will read a ascii text or a PowerPacked document and display it. You can also use it to read programs, text or any files in hex dump. Press to enter hex mode. (Press HELP for instructions on the text-viewer.) VIEW IFF This will load and display a IFF-picture. SOUND This will load and play IFF/RAW samples. HELP This will load the help text (This text.) There are some hidden gadgets under the letters that shows the protection bits . By clicking on the letters you can set the protection for the selected file. H Hidden S Script P Pure A Archived R Read W Write E Edit D Delete When the requester is open you can close it by selecting 'Forget it' or the close gadget in the left upper corner. IFF VIEWER ALT/CTRL F1 VIEW IFF ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When you are viewing a picture, you adjust the palette for the picture by pressing F3 or you can dump the picture to the printer. You must of course have a printer connected and a printer driver selected. The screendump is achieved by pressing F8 and then clicking the OK gadget. FILE RUNNER ALT/CTRL F1 RUN ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ After you have double clicked or selected a filename and than select the run gadget, a new task will be created and the selected program will start running. This may not work with every program. * * If anybody have a source that shows how you can run a program in a * good way, I would really want to see it. * * It must be something like this: * * o LoadSegment. * o CreateProcess. * o kickStart the new task(process). Make it actually run. * This is the tricky bit. * * The problem is that if you use the execute command in dos.library to * run a program, and than closes the CLI, from where you started Space II, * the program runned will not know where to send it's output. * If you see what I meen. ? * TEXT VIEWER ALT/SHIFT/CTRL READ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will load a text and display it in a window. The text viewer has some advanced options. It has very fast text scrolling and very fast searching after text in the document. (It scans thru ca. 120000 chars pr. second). It can also load PowerPacked docs. The text viewer can also be used as a hex dump viewer, any files can be loaded and viewed. More help on the TextViewer will be displayed when you press HELP when you are viewing a document. (Try it now !) You can also open a new file by pressing ALT/SHIFT/CTRL. If you have allready opened a text, the Text Viewer window will be closed and the file requester will be displayed. If the Text Viewer window is covered by other windows and you click in the Text Viewer window, it will be brought to the front and activated. NB ** You must have the 'powerpacker.library' in the Libs: directory for loading power packed docs/texts/files. DEVICE INFO ALT/CTRL F1 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will show what devices(disks,harddisks,ramdisks) that are in the system. The disks total size, how much has been used of it and how much is free on it will be displayed. MEMORY INFO ALT/CTRL F2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will display the amount of random access memory (RAM) in you system. It will show both Chip-RAM and Fast-RAM, and the locations for both. The greatest blocks of free continues memory is also displayed. PALETTE ALT/CTRL F3 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will bring up a palette, so you may adjust the colours on the current screen. FILE COPY ALT/CTRL F4 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is a simple file copying utility. You use the filerequester to choose the file to copy and click on the 'OK' gadget and then select/write the name of the new file and confirm the copy. CALCULATOR ALT/CTRL F5 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ How many times have you needed a calculator and looked all over for it. Well now it's just a keypress away. It is a bit simple, but it has bin,oct,hex and decimal and the answer can be transferred into your editor or another program as if you had typed it in yourself. You could use the key pad for entering numbers and F1-F3 for selecting bin-decimal. CRSR RIGHT is transfer and [ is CLEAR ALL. ESC for quit. POINTER BLANKER OFF ALT/CTRL F6 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will disable the pointer blanking and restore the pointer. The pointer blanker will remove the pointer from the screen when a key is pressed and display it again when the mouse is moved. POINTER BLANKER ON ALT/CTRL F7 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will enable the pointer blanking. SCREEN DUMP ALT/CTRL F8 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will dump the current screen to the printer. It uses the preferences, so the density and color/gray scale will depend on the selections made in the preferences. The screen dump may take some time to perform, so be patient. ALARM ALT/CTRL and F9 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will prompt for a time (Minutes) and a message that shall be displayed when the time has passed. The message can be up to 80 characters long. The message can be displayed as many lines, by using CTRL + J as linefeed in the string. The alarm can be switched OFF by entering 0 as the time. IFF-PICTURE SAVER ALT/CTRL and F10 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will save the first screen as an IFF-picture. It will first prompt you for a filename and than save it. The picture will not be crunched, so if you want to crunch it you must load it in to Deluxe Paint or another paint program and save it from there. AUDIO FILTER ON/OFF ALT/CTRL and * (keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will toggle the amiga's audio filter on and off. The power led will indicate the the state of the filter. Bright light for ON and dimmed light for OFF. 50/60Hz ON/OFF ALT/CTRL and / (keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will toggle the screen from 50 to 60Hz. This only works on Amigas with the 'Super Fat Agnus' installed. SCREEN SHUFFLER ALT/CTRL and CRSR UP ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will send the first screen to the back, and activate the first window on the screen that will become the first. SCREEN SHUFFLER ALT/CTRL and CRSR DOWN ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will send the first screen to the back. No activating will be done, so you will have to activate a window yourself by clicking in the window to activate with the mouse. WINDOW SHUFFLER ALT/CTRL and CRSR RIGHT ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you have more than one window on a screen, you can move the one at the back into the front and the other back to the back. Back to front. This will work from with in other Space II utilities, so you can get back windows that have come behind other windows (maybe windows without depth-gadgets) WINDOW SHUFFLER ALT/CTRL and CRSR LEFT ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you have more than one window on a screen, you can move the one at the back into the front and the other back to the back. Front to back. This will work from with in other Space II utilities, so you can get back windows that have come behind other windows (maybe windows without depth-gadgets) TEXT RESCUER ALT/CTRL and ENTER (keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you have had a crash when you have been working with a text editor, program editor, Seka xxx, AsmOne or something that uses ascii text, you can use this utility to scan the memory and save the text. The only thing you must do is to include the following text in your texts. In the start of every sources,docs or texts you add the following: #RESCUE# This can be commented away like this: ;#RESCUE# Assembler (*#RESCUE#*) or {#RESCUE#} Pascal /*#RESCUE#*/ C If you include this in your sources, there is a chance that it can survive a GURU or some other kind of crashes. If you know what the first and last chars in your text are, you can also search after those. Example: *MyStart* . . . . . . *MyEnd* (If some texteditors don't use ASCII 10 (Linefeed) as line separators, (AsmOne) you can find the start and the end of the text, and than convert ASCII 0 to ASCII 10.) When you activate the rescue option, the screen will flash to show you that something is going on, and when the text is found a requester will be displayed. You can no select a end-of-text marker and see if the size of the text found is the right size. If the size is right, you can now save the text found and than continue, or you can break the search. You can also interrupt the search by pressing the left mousebutton. SWITCH BLANKER MODE ALT/CTRL and . (Keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will toggle the blanking mode. The screen will flash to indicate the switch. The colour dimmer is a more prossesor time friendly, it will use allmost no prossesor time. This mode can be used when other task requier as much of the 68000 as possible (Raytracers...) DISPLAY EXEC VECTORS ALT/CTRL and BACKSPACE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will display six of the vectors in the ExecBase. The six vectors are used by some viruses to link them self into memory and survive a varm reset. You can reset the vectors if you want to. The Vectors will also be checked each minute, and if they are non-zero the requester will be displayed. This can discover viruses that has been started from a program and linked it self into the vectors. DISPLAY BOOT-BLOCK ALT/CTRL and 4 (Keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will display the boot-block on the disk in DF0 as a ASCII-dump. You could use this to check disks for bootblock viruses and to view the boot-block. INSTALL BOOT-BLOCK ALT/CTRL and 5 (Keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will install a standard bootable boot-block on the disk in DF0. This is the same boot-block as the one you get by using the DOS command Install. UNINSTALL BOOT-BLOCK ALT/CTRL and 6 (Keypad) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will make the disk in DF0: unable to boot. -------------------------------------------------------------------------------- All of the functions should work one any legally opened intuition screen. Not on custom screens made by hacking with copperlists. All functions will make popup windows on the window you are currently working on. You need the 'req.library' in the Libs: directory on your startup-disk for using this program. The 'req.library' was written by Colin Fox (of Pyramyd Designs) and Bruce Dawson (of CygnusSoft Software). Req.library is a freely distributable library that may be used in commercial products without paying any royalties. The requester library must be distributed with the documentation file (req.doc), and the three include files req.h, reqbase.h and reqbase.i. (** BUG REPORT I have discovered a small bug in the filerequester. If you set the numbers of lines in the requester to more than ca. 26, some memory will not be freed up after exiting the requester, a PurgeFiles call will not help either.) The 'powerpacker.library' was written by Nico François (PowerPeak). (** BUG REPORT I believe I have found a bug in the load routine of the PP.lib. If you have mounted the VDK: device two times, it sometimes refuse to load data from the VDK: into memory.) I will send my greetings to these great amiga programmers !!!. Keep up the exellent work. --------------------------------------------------------------------------------