====================Documentation for StopMenu====================== =============================SHAREWARE============================== TABLE OF CONTENTS 1. Program information 2. Author 3. Distribution 4. How to register? 5. Using StopMenu 6. Using Prefs 7. How to create menus file? 8. Others ==================================================================== ====================== 1. Program information ====================== StopMenu is invisible after start. If you want to see him you must place your mouse pointer on the bottom of your screen. You will see window with buttons and clock. Using this buttons you can: -easy start yours programs -control commodities -easy start programs from SYS:Prefs/ drawer -control screens and save they as IFF files -control windows on workbench ========= 2. Author ========= I'm 16 years old and I weekly speak english. I'm developing programs for 2 years (using C language). This is my first SHAREWARE program. It's also my best program (IMHO). My e-mail address: tmsn@polbox.com =============== 3. Distribution =============== StopMenu is SHAREWARE, so you can use unregistred version 3 weeks. After this time you MUST register (see chapter 4) or delete it. If you register, you will get a special KeyFile. You must put it in StopMenu: directory. It will disable shareware requests. You can't copy and distribute it (IT ISN'T LEGAL), but you can freely distribute unregistred version. =================== 4. How to register? =================== If you want to register you have to run "register" program (it's in StopMenu:Extras/) or press "Register now" button in Prefs. After language selection you have to input ALL needed informations about you (full name, e-mail, street/house, city/zip, country) and select way to transfer KeyFile (e-mail or normal (snail) mail). Now print (or view and manually rewrite) order form and put it into envelope. Don't forget include cash !!! (5 USD (or 8 USD if you want get KeyFile via snail-mail)). If you want get Key via snail-mail include a blank 3.5" floppy disk. Now, send order to: Tomasz Wójcik ul. Grabowa 2 27-200 Starachowice POLAND When I get your order, I will send you KeyFile. Thank you for supporting SHAREWARE. ================= 5. Using StopMenu ================= When you move your mouse pointer to bottom of screen you will see a nice bar containing 5 buttons. Using this buttons you can open some menus. -Menu 1: Stop This menu containing your favorite programs. You can edit content of this menu editing file StopMenu:StopMenu.menus using any text editor (for example: Ed, Ced, GoldEd, ...). See chapter 7. -Menu 2: Commodities Using this menu you can kill, activate, deactivate, show and hide any commodity in your system. -Menu 3: Preferences It is to easy and fast run programs from SYS:Prefs/ -Menu 4: Screens Using this menu you can move to front or back, remove or save as IFF any opened screen. WARNING: Removing screens can be dangerous ! -Menu 5: WBWindows Using this menu you can move to front or back, remove, close or activate any window on workbench. WARNING: Removing windows can be dangerous ! ============== 6. Using Prefs ============== If you run Prefs program, you will see the window. On left side of this window you can select the group of options, which will be displayed in right side of window. -Group 1: Info Here is displayed information about StopMenu. You can also run registration program from this group. -Group 2: Colors Here you can define some colors: -MenuBack (background color for menus) -BarBack (background color for bar) -Selected (color for selected item in menu) -Shine (color of shine text) -Shadow (color of shadow text) To change this colors you must input hexadecimal values of colors ( in this format: RRGGBB, where RR is hex value of red (form 0 (00) to 255 (ff)), GG - green, BB - blue ). Some examples: White - ffffff Red - ff0000 Dark green - 006b00 Grey - 939393 Black - 000000 Azure - 00ffff Yellow - ffff00 Violet - dd00dd Best (IMHO) values: -MenuBack afafaf -BarBack 9f9f9f -Selected 1626b6 -Shine ffffff -Shadow 000000 In this group you can also change the type of text in menu. -Group 3: On/Off Here you can switch On/Off some program functions. -Group 4: Hotkeys Here you can set some hotkeys: -Exit from program -Run Prefs -Restart program and a priority for process (best values are 0 and 1). -Groups 5,6,7,8: SkipLists (Commodities, Preferences, Screens, WBWindows) Here you can define names of objests to be skipped. ============================ 7. How to create menus file? ============================ Configuration of menu stop must be defined in file StopMenu.menus between and lines. Example: MENU 1 ITEM Submenu 1,,1,MENU,2 ITEM Submenu 2,,1,MENU,3 ITEM Submenu 3,,1,MENU,4 BAR ITEM Prefs,RUNPREFS,18,COMMAND ITEM Quit,QUIT,6,COMMAND MENU 2 ITEM Submenu 4,,1,MENU,5 ITEM Some item,path:program,2,CLI ITEM Other item,disk:directory/program,2,WB MENU 3 ITEM Program 1,disk:directory/program,2,WB ITEM Program 2,disk:directory/program,2,WB ITEM Program 3,disk:directory/program,2,WB ITEM Program 4,disk:directory/program,2,WB ITEM Program 5,disk:directory/program,2,WB ITEM Program 6,disk:directory/program,2,WB MENU 4 ITEM CLI Proram,path:program,2,CLI ITEM WB Proram,path:program,2,WB ITEM AmigaDOS Script,path:script,2,SCRIPT SPACE ITEM Restart,RESTART,6,COMMAND MENU 5 ITEM Next submenu,,1,MENU,6 MENU 6 ITEM Blah blah blah,,2,CLI ITEM Blah blah blah,,2,CLI ITEM Blah blah blah,,2,CLI As you see, it isn't very difficult. After line you must write MENU line (in this line you can also write somethin else, for example number of menu, but only for your information, it is completly ignored by program). MENU line is used for mark begin of menu description. Then you can place some items. There are 3 types of items: -ITEM (normal item used to run programs or open submenus) -BAR (a nice horizontal bar) -SPACE (space between items) After item you have to write: Name,File,Icon number,Type of item,Submenu to open where name is a text which will be displayed in menu, file is a file name to run (or execute) (WARNING: if type of item is COMMAND file must be one of following: QUIT (quit program), RUNPREFS (run Prefs program), RESTART (restart StopMenu), REBOOT (reboots amiga)). Icon number is a number of icon which will be displayed in menu, Type of item is one of following: -CLI (run cli program) -WB (run workbench program) -SCRIPT (execute AmigaDOS script) -MENU (open submenu) -COMMAN (execute internal command) Submenu to open is ONLY if type of item is MENU. Is's used to specify number of menu, which will be linked to this item. ========= 8. Others ========= How to create custom icons? --------------------------- You can add your custom icons (to directory StopMenu:Icons/), but you have to remember: icons must be named successive (for example: 47.info, 48.info, 49.info, ...). To create new icons run InjectBrush (StopMenu:Extras/). For example: 1. Draw 1 or 2 brushes (dimensions max. 18x22 pixels) and save as ram:1.bsh ram:2.bsh 2. Copy StopMenu:icons/program/std.info to ram: 3. InjectBrush ram:std.info ram:1.bsh FORCE (or if 2 brushes): InjectBrush ram:std.info ram:1.bsh ram:2.bsh FORCE 4. Copy ram:std.info to StopMenu:icons/51.info If you create 2 brushes, second will be displayed when item is selected. How to get updates? ------------------- At the moment, only from AMINET. Maybe in future registred users may get the newest versions via e-mail. My suggestions: --------------- 1. Run program on 64 or more colors screen. 2. Keep StopMenuStarter.info in SYS:WBStartup/ Future (version 2) ------------------ -Editor for menu "Stop" -Plug-ins -Font change -and many others... ==================================================================== Tom "Th0m$0n" Wójcik ====================================================================