@DATABASE PowerWindows @WIDTH 76 @AUTHOR Georg Steger @TOC "Main" @NODE "Main" "PowerWindows V1.2 (C) Copyright 1997 by Georg Steger" @{B} ################## @{" made in South-Tyrol " LINK "Images/SouthTyrol.png/main"} ################### #### ## # # ## # ##### ### ## # #### ### ## ## ## ### ## ## ## ## ## ## ## ## #### ## ## ## ## ###### ## ## ## ## ## ## ## ### ########### ## ## ## ## ## ### ## ## ## ## ## ## ## ## ########### ###### ## ## ## ##### ### ###### #### #### ### ####### ## ## ####### #### ### ######## ### ### ### ### ####### ### ### ### ### ### ####### ####### ### ### ### ### ## ### ### ### ### ######## ### ### ### ### ### ### ### ####### ######### ###### ### V 1.2 @{UB} @{" Introduction " LINK "Introduction"} @{" First Aid/FAQ " LINK "FirstAidFAQ"} @{" Requirements " LINK "Requirements"} @{" History " LINK "History" 285} @{" Legal Stuff " LINK "LegalStuff"} @{" Future " LINK "Future"} @{" Installation " LINK "Installation"} @{" Features/Usage " LINK "Features"} @{" Author " LINK "Author"} @{" Configuration " LINK "Configuration"} @{" Credits " LINK "Credits"} @{" Technical/Bugs " LINK "TechnicalInfo"} @{" Other Stuff " LINK "OtherStuff"} Read @{" Important " LINK "Important.txt/main"} first! @ENDNODE @NODE "Introduction" "Introduction" @TOC "Main" - @{I}Some thought it is impossible to do ...@{UI} That's wrong, it @{B}WAS@{UB} impossible to do! - @{I}Some dreamt of it ...@{UI} Most did not even do that! - @{I}It was the most wanted utility of the Amiga-World ...@{UI} and here it is! Let's get ready for @{B}PowerWindows V 1.2@{UB} @{B}ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{UB} @{U}@{FG SHINE} @{UU}@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ PowerWindows is a little utility, that allows you to move windows out of the Screen. With this program that patches some System-Functions you will finally know where to move your windows when you have opened a lot of them. PowerWindows is especially useful for those of us who don't have a GFX- Board (like me). With the Screen-Resolutions the ECS/AGA-Chipset offers, after having opened two or three Windows you already have to start sizing and moving the windows to get to the desired one. Well, that's over now. With PowerWindows you simply move the windows you actually don't need out of the Screen. You also get another incredible Feature: You can iconify ALL your Windows , 100 % compatible, hundreds of Configuration-Options, very few Memory Usage!! @{FG SHINE}@{B}Read the documentation VERY carefully because PowerWindows installs some very dangerous Patches and you have to configure it correctly before using!@{UB}@{FG TEXT} My English is terrible. Hope you have a lot of fun with it. @{B}PowerWindows is SHAREWARRE!@{UB} The preferences program uses @{" MUI " LINK "ReadMe.mui/Main"} which is copyrighted by Stefan Stuntz! @ENDNODE @NODE "Requirements" "Requirements" @TOC "Main" PowerWindows should run on any machine with Amiga OS 2 or higher. It has been reported to be compatible with GFX-Boards. @{FG SHINE}@{U}PowerWindows was developped on:@{UU}@{FG TEXT} AMIGA 1200 Kickstart 3.0 Workbench 3.0 CPU 68030-50 FPU 68882-50 (Blizzard 1230/IV) 2 MB CHIP / 8 MB FAST WESTERN DIGITAL 540 MB HD HITACHI CDR 7930 8x SPEED CD-ROM ELSA MICROLINK 33.6TQV MODEM @{FG SHINE}@{U}PowerWindows was created using the following Software:@{UU}@{FG TEXT} MaxonCPP Pro 4.0 Hispeed Pascal @ENDNODE @NODE "LegalStuff" "Legal Stuff" @TOC "Main" @{B}@{U}PowerWindows is Freeware!!!@{UB}@{UU} @{U}Copyright@{UU} PowerWindows is written and copyright İ 1997 by Georg Steger. No parts of this program may be altered by any means (this includes editing, reprogramming, crunching, resourceing etc.), except archiving. @{U}Disclaimer@{UU} The author is in no way liable for any changes made to any part of the program, or consequences thereof as he is in no way liable for damages or loss of data directly or indirectly caused by this software. @{U}Distribution@{UU} Neither fees may be charged nor profits may be made by distributing this piece of software. Only a nominal fee for costs of magnetic media may be accepted, the amount of US $5 shouldn't be exceeded for a disk containing PowerWindows. CD Manufactures are specifically granted the right to include this program on CD collections, as long as they are for the Public Domain. I would be very nice if they sent me a copy of the CD. The preferences program uses @{" MUI " LINK "ReadMe.mui/Main"} which is copyrighted by Stefan Stuntz! @ENDNODE @NODE "Installation" "Installation" @TOC "Main" PowerWindows installs some very critical Patches so it has to be started at the right time. Before installing it you should try whether it works on you configuration. To do this simply launch it from the Workbench or Shell. - As a first test, open a window and move it out of the Screen at the right. @{B}Important:@{UB} You can move the Windows out of the Screen only at the @{B}right@{UB} or at the @{B}bottom@{UB}. This is because the Operating System doesn't seem to like negative Coordinates. - Check whether at the left side of the Screens the part of the Window which should be out of the Screen appears in false Colors. If it doesn't you are O.K.! - Open another Window and move it out of the Screen as well. Check again whether there is no graphical trash at the left side of the Screen. - Now move the Windows to front and to back, close them and always repeat the check. - If the display is trashed remove all patches installed on your System and try again. @{B}Note:@{UB} - It is less dangerous to move Windows out of the Screen at the right be- cause the only thing that can happen is a destroyed display at the left side. (Exception: If the Window's TopEdge+Height=Screenheight then it is also possible that foreign memory is trashed!) - Moving Windows out of the Screen at the bottom is more dangerous. - If you don't see trashes when you move Windows out of the Screen at the right then moving it out of the Screen at the bottom will work, too. - Make a lot of tests before installing it (with ALL your programs). I must repeat, this is a very dangerous program. - In order to move the Windows out of the Screen, PowerWindows has to change the Screen's Width and Height for a short period of time to 16383. This period is the most critical. @{FG SHINE}- @{" Configure " LINK "Configuration"} PowerWindows to avoid Programs that draw to the Screen-Rastport directly (like Deluxe Paint IV). Such programs will al- most certainly cause Crashes.@{FG TEXT} - Again, do a lot of tests and watch out for Crashes. Moving Windows out of the Screen at the bottom WILL NOT trash the Screen but MAY overwrite foreign memory! - Remember. This is only Version 1.2!!! Expect some bugs and crashes! - Don't force the Workbench-Screen to be closed/opened in critical si- tuations, this is when a program is going to close/open a Window on it. - It is possible to quit Powerwindows by sending it a CTRL_C (in non- critical situations). @{U}Anyway you should not quit it.@{UU} @{B}Installing it:@{UB} For now you have to install it by hand. You can start it in the Startup- Sequence, in the User-Startup or even in the WBStartup. It @{B}must be started very lately@{UB} in order to be the last program to patch layers.library, al- though it depends on the patches and programs you have installed on your Computer. You have to try it out. If you want to start it in the User- Startup or Startup-Sequence use: run <>NIL: PowerWindows HOMEDIR @{I}{PowerWindows-Directory on HD}@{UI} {PowerWindows-Directory on HD} of course must be replaced with the Home-Directory of PowerWindows. For example if you have copied the PowerWindows-Drawer to "Work:" you will have to start it this way: run <>NIL: Work:PowerWindows/PowerWindows HOMEDIR Work:PowerWindows You can also specify which Configuration-File to use. It must be specified with "CONFIGFILE". Example: run <>NIL: TOOLS:PowerWindows/PowerWindows HOMEDIR TOOLS:PowerWindows CONFIGFILE s:MyPowerWindows.config If you move it in the WBStartUp-Drawer set the Icon-Tooltype "HOMEDIR" to where the PowerWindows-Directory is. @{U}You must not use Quotation Marks@{UU}, if you do, the File will not be found! You can force PowerWindows to be started very lately by changing the Tooltype "STARTPRI". It's a standard Workbench-Tooltype accepting values from -128 to 127. The lower the value the later it will be started. It's also possible to specify a File which will be used as Configuration-File. You must specify it with the Tooltype "CONFIGFILE". It's further possible to create Project-Icons, set their Default Tool to "PowerWindows" and set in each one a different Config-File . To start PowerWindows with a certain Config-File simply double-click the right Project-Icon. - PowerWindows MUST be started AFTER programs that @{U}replace@{UU} Layer-Functions completely in order to speed up things. - If you have installed a Opaque Move Commodity (which allows you to move Windows with their full Contents) it will not be possible to drag Windows out of Screen. Solution: You could set @{" NORMALQUALIFIER " LINK "WDO"} to LALT+CONTROL, give PowerWindwow's Input-Handler a higher @{" Priority " LINK "GO"} than Commodities' one and would this way be allowed to drag Windows out of Screen when holding down "LALT+CONTROL" while clicking on the Dragbar and when you don't hold down these Keys you would get Opaque moving Windows. - Starting with V 1.0 PowerWindows has it's own Opaque Mover. It allows you to opaque move Windows out of Screen. Read the @{" Opaque Options " LINK "OMO"} Chapter before using it. There are some very important things you have to know! @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ If the computer crashes during Boot (because of PowerWindows) you can force PowerWindows not to be started by holding down @{FG SHINE}LEFT ALT@{FG TEXT} + @{FG SHINE}LEFT SHIFT@{FG TEXT} + @{FG SHINE}LEFT MOUSE-BUTTON@{FG TEXT} during Boot. You must hold down these keys until booting is completely finished (and not release them as soon as you see the Workbench- Screen) because PowerWindows usually starts very lately. @ENDNODE @NODE "Features" "Features and usage of PowerWindows" @TOC "Main" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ P O W E R W I N D O W S ' F E A T U R E S @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @{FG SHINE}o Possibility to drag windows out of Screen:@{FG TEXT} It's possible to define qualifiers that must be pressed to allow out of Screen draggings. It can be done using any of the mouse buttons. Three button mices are supported, too. You can also use a special qualifier (default: LALT+LSHIFT) that allows you to drag the window even if you don't click on the title-bar but anywhere in the window. You can use a Hotkey to bring all or the active window being out of screen back to the standard area of the screen. @{FG SHINE}o Possibility to iconify windows:@{FG TEXT} PowerWindows lets you choose from several Iconify-Gadget looks. It's also possible to use an external routine that does the Icon-Gadget ren- dering. The icons can be positioned in various ways and can either be always in front of everything or opened in the back or front (then the icons will get a Depth-Gadget). It's also possible to add a Close-Gadget to the icons which will close the parent window when used. If you don't like the standard look of the icons you can also use one of the external Icon Renderers. With a special option it's possible to de-iconify WB- Windows by double clicking the WB-Icon. If you want, de-iconified windows are automatically brought to front. If you don't like that you can also force single de-iconified windows to be brought to front by holding down shift during De-Iconifying. Someone might also prefer de-iconifying win- dows with a single click (which of course leads to undraggable icons). @{FG SHINE}o Opaque moving of windows:@{FG TEXT} PowerWindows allows you to move windows with their full content (= solid window moving). If you used another program for that you have to de- activate it (or the option) and use PowerWindows for that. Otherwise you won't be able to opaque move windows out of screen. @{FG SHINE}o Possiblity to iconify/de-iconify more windows all at once:@{FG TEXT} This feature is called MULTI Action Mode. By pressing some special qualifiers (default: LALT + CONTROL) you can activate this mode. When moving around with the mouse (while holding down the mouse-button) all windows/icons you touch will get a scrolling frame and after releasing the mouse-button these windows/icons will be iconified/de-iconified all at once. This feature can also be very comfortable for iconifying or de-iconifying a single window, too, because you don't need to hit the Iconify-Gadget (just click anywhere in the window) in order to iconify a window and de-iconifying of a window is possible without having to doubleclick on the icon. @{FG SHINE}o Hotkeys:@{FG TEXT} You can define Hotkeys for several useful operations, such as iconifying the actual window, de-iconifying all windows of the active screen, bring- ing all windows that are out of screen back to the standard limits of the screen etc. You can also define Hotkeys for patching or unpatching the active screen. Only on patched screens iconifying and moving windows out of screen is possible. @{FG SHINE}o Possibility to deactivate PowerWindows features for certain tasks:@{FG TEXT} For example you can tell PowerWindows that you don't want that the screens opened by the program "#?visage#?" get patched (= allow out of Screen movings and iconifying). You could also tell PowerWindows not to add Iconify-Gadgets to the windows opened by the program "multiview". Even if you tell PowerWindows to patch a certain screen you can undo this while PW is running with a hotkey. This also applies to unpatched screens which can be patched with a hotkey. @{FG SHINE}o Commodities Interface@{FG TEXT} Some of PowerWindows' features can be disactivated temporary by using the Disable/Enable button in Exchange. This features are: - Out of screen dragging - Patching of screens (out of screen dragging and iconifying is only possible on patched screens) that will open later. Iconifying will still be possible! It is also possible to quit Power- Windows by clicking on the Remove button in Exchange. @{FG SHINE}o Tons of options for the features mentioned above:@{FG TEXT} Nothing to explain 8<) @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Have a look at @{" Configuration " LINK "Configuration"} to see all the options and features of PowerWindows. @ENDNODE @NODE "Configuration" "Configuration" @TOC "Main" To configure PowerWindows you have to edit @{FG SHINE}PowerWindows.config@{FG TEXT}. PowerWindows will look for this file in "S:" and in it's HOMEDIR (see @{" Installation " LINK "Installation"})! If you have used CONFIGFILE (Cli-Argument/WB-Tooltype) to use another Configuration-File, of course that one will be used by PowerWindows. If you have AmigaOS 3.0 and MUI you can also use the program @{" PW_Prefs " LINK "PWPrefs"}. @{B}Note:@{UB} - Lines starting with ";", "*" or Blanks/Tabulators are comments - You can have blank lines - Space-Characters are ignored (but don't add them at the start of a line, otherwise the line will be considered as a comment!) - Syntax : @{FG SHINE}KEYWORD=VALUE@{FG TEXT} for "Specify-Keywords" @{FG SHINE}KEYWORD@{FG TEXT} for "Activate-Keywords" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @{" General Options " LINK "GO"} @{FG SHINE}@{" SCANSCREENS " LINK "GO" 8} @{FG TEXT}Patch Screens that are already open @{FG SHINE}@{" INPUTPRI " LINK "GO" 19} @{FG TEXT}Priority of PowerWindow's Input-Handler @{FG SHINE}@{" SAFEMOVEWINDOW " LINK "GO" 28} @{FG TEXT}Slows down Window-Movings. Might be more safe! @{FG SHINE}@{" SAFELOCKLAYER " LINK "GO" 44} @{FG TEXT}Probably a safer way to lock Layers while dragging @{FG SHINE}@{" NOMOUSEFREEZE " LINK "GO" 58} @{FG TEXT}Don't freeze Mouse while moving the Windows @{FG SHINE}@{" MOUSEFACTOR " LINK "GO" 71} @{FG TEXT}Might have to be adjusted if using NOMOUSEFREEZE @{FG SHINE}@{" MAXSPPERIOD " LINK "GO" 85} @{FG TEXT}Windows are tried to be moved within this period @{FG SHINE}@{" NO_OUTOFSCREEN " LINK "GO" 103} @{FG TEXT}No Out-Of-Screen Movings. Iconify still possible! @{FG SHINE}@{" NOREQPATCH " LINK "GO" 118} @{FG TEXT}Don't patch EasyRequestArgs() and AutoRequest() @{FG SHINE}@{" NODGPATCH " LINK "GO" 134} @{FG TEXT}Don't patch Depth Gadgets @{FG SHINE}@{" NOREFRESHKILL " LINK "GO" 158} @{FG TEXT}Don't clear LAYERREFRESH Bit in SIMPLEREFRESH Layers @{FG SHINE}@{" SMARTWIN " LINK "GO" 169} @{FG TEXT}Force Windows to SMARTREFRESH @{" Window-Drag Options " LINK "WDO"} @{FG SHINE}@{" NORMALBUTTON " LINK "WDO" 9} @{FG TEXT}Mouse-Button used for Normal-Draggings (Dragbar) @{FG SHINE}@{" NORMALQUALIFIER " LINK "WDO" 17} @{FG TEXT}Qualifier (Keys) to be pressed together with NB @{FG SHINE}@{" FORCEBUTTON " LINK "WDO" 36} @{FG TEXT}Mouse-Button used for Force-Draggings (anywhere) @{FG SHINE}@{" FORCEQUALIFIER " LINK "WDO" 44} @{FG TEXT}Qualifier (Keys) to be pressed together with FB @{FG SHINE}@{" AVOIDDOUBLECLICKS " LINK "WDO" 65} @{FG TEXT}Avoids Screen-Trashing @{FG SHINE}@{" MARKER " LINK "WDO" 74} @{FG TEXT}Look of the Marker (when you drag a Window) @{FG SHINE}@{" ALLPLANES " LINK "WDO" 92} @{FG TEXT}Draw Marker in all Planes @{" Screen-Patch Options " LINK "SPO"} @{FG SHINE}@{" TASK " LINK "SPO" 9} @{FG TEXT}Tasks whose Screens shall (not) be patched @{FG SHINE}@{" TASKSONLY " LINK "SPO" 30} @{FG TEXT}Only Programs specified with TASK will be patched @{FG SHINE}@{" CASESENSITIVE " LINK "SPO" 39} @{FG TEXT}Do Checks casesensitive. @{" Iconify Options " LINK "IO"} @{FG SHINE}@{" ICONIFYGADGET " LINK "IO" 9} @{FG TEXT}Adds Iconify-Gadget to the Windows @{FG SHINE}@{" NOICONS " LINK "IO" 27} @{FG TEXT}There will not be an Icon for iconified Windows @{FG SHINE}@{" IGLOOK " LINK "IO" 35} @{FG TEXT}Look of the Iconify-Gadget @{FG SHINE}@{" ICONIFYTASK " LINK "IO" 54} @{FG TEXT}Tasks whose Windows shall (not) get an Icfy-Gadget @{FG SHINE}@{" ICONIFYTASKSONLY " LINK "IO" 74} @{FG TEXT}Only Programs specified with ICONIFYTASK will ... @{FG SHINE}@{" ICONIFYCASESENSITIVE" LINK "IO" 83} @{FG TEXT}Do Checks casesensitive @{FG SHINE}@{" DONTICONIFYWB " LINK "IO" 94} @{FG TEXT}Workbench-Windows will not get an Iconify-Gadget @{FG SHINE}@{" ICONIFYOFFSET " LINK "IO" 101} @{FG TEXT}Iconified Wins are moved to SCREENWIDTH - ICONIFYOF @{FG SHINE}@{" ICONWIDTH " LINK "IO" 112} @{FG TEXT}Width of the Icons @{FG SHINE}@{" MINICONWIDTH " LINK "IO" 151} @{FG TEXT}Minimal Width of the Icons @{FG SHINE}@{" ICONPOS " LINK "IO" 159} @{FG TEXT}Position of the Icons @{FG SHINE}@{" ICONPOS_OFFY " LINK "IO" 248} @{FG TEXT}Offset-X to add to Position obtained via ICONPOS @{FG SHINE}@{" ICONPOS_OFFX " LINK "IO" 258} @{FG TEXT}Offset-Y to add to Position obtianed via ICONPOS @{FG SHINE}@{" ICONPOS_SPACEX " LINK "IO" 264} @{FG TEXT}X-Space between Icons (AUTO_?? only) @{FG SHINE}@{" ICONPOS_SPACEY " LINK "IO" 270} @{FG TEXT}Y-Space between Icons (AUTO_?? only) @{FG SHINE}@{" MINWINWIDTH " LINK "IO" 276} @{FG TEXT}Windows smaller than this don't get Iconify-Gadget @{FG SHINE}@{" ICONDEPTH " LINK "IO" 284} @{FG TEXT}Icons always in Front or like normal Windows @{FG SHINE}@{" ICONCLOSEGAD " LINK "IO" 298} @{FG TEXT}Icons get a Close-Gadget @{FG SHINE}@{" WBICONPOPUP " LINK "IO" 306} @{FG TEXT}Pop up Workbench-Drawers by double-clicking WB-Icon @{FG SHINE}@{" ICONACTIVATE " LINK "IO" 320} @{FG TEXT}Activate iconified Window by clicking on it's Icon @{FG SHINE}@{" POPTOFRONT " LINK "IO" 333} @{FG TEXT}Bring de-iconified Windows automatically to Front. @{FG SHINE}@{" ICONFONT " LINK "IO" 343} @{FG TEXT}Font for Icons' Title-Text @{FG SHINE}@{" REFRESHIT " LINK "IO" 360} @{FG TEXT}Refresh Icon-Title when title of parent Win changes @{FG SHINE}@{" NOICONDRAG " LINK "IO" 369} @{FG TEXT}Undraggable icons but single-click de-iconifying @{" Opaque Moving Options " LINK "OMO"} @{FG SHINE}@{" OPAQUEMOVE " LINK "OMO" 49} @{FG TEXT}Activate opaque moving @{FG SHINE}@{" SAFEOPAQUE " LINK "OMO" 57} @{FG TEXT}Don't call MoveWindow() from Input-Handler @{FG SHINE}@{" OPAQUE_SPEED " LINK "OMO" 67} @{FG TEXT}Speed. The higher the slower - 1 is fastest @{FG SHINE}@{" OPAQUE_MAXDEPTH " LINK "OMO" 82} @{FG TEXT}Screen with more Bitplanes than this have no opaque @{FG SHINE}@{" OPAQUE_MAXPIXELS " LINK "OMO" 91} @{FG TEXT}No opaque for Windows whose Width x Height is greater @{FG SHINE}@{" OPAQUE_MAXBYTES " LINK "OMO" 98} @{FG TEXT}No o. for Wins whose Width x Height x Bytes per Pixel @{FG SHINE}@{" OPAQUE_NOSIMPLE " LINK "OMO" 105} @{FG TEXT}No opaque for SIMPLEREFRESH Windows @{FG SHINE}@{" OPAQUE_NOSMART " LINK "OMO" 111} @{FG TEXT}No opaque for SMARTREFRESH Windows @{FG SHINE}@{" OPAQUE_NOSUPER " LINK "OMO" 117} @{FG TEXT}No opaque for SUPERREFRESH Windows @{" Deadlock-Hunting Options " LINK "DHO"} @{FG SHINE}@{" DEADLOCK_SEC " LINK "DHO" 9} @{FG TEXT}Every DEADLOCK_SEC secs + DEADLOCK_MIC mics ... @{FG SHINE}@{" DEADLOCK_MIC " LINK "DHO" 16} @{FG TEXT}... PowerWindows checks if Deadlocks have occured @{FG SHINE}@{" DEADLOCK_PRI " LINK "DHO" 24} @{FG TEXT}Priority of Deadlock-Hunter (it's a separat Task!) @{" External Routines " LINK "ERO"} @{FG SHINE}@{" EXT_WINDOWCHECKER " LINK "ERO" 9} @{FG TEXT}Ext. R. telling PW if Window shall get an I-Gadget @{FG SHINE}@{" EXT_SCREENCHECKER " LINK "ERO" 28} @{FG TEXT}Ext. R. that tells PW if Screen shall be patched @{FG SHINE}@{" EXT_ICONRENDERER " LINK "ERO" 36} @{FG TEXT}Ext. Routine that renders the Icons. @{" Hotkeys " LINK "HO"} @{FG SHINE}@{" HOT_ICONIFY " LINK "HO" 35} @{FG TEXT}Hotkey to iconify active Window @{FG SHINE}@{" HOT_ICONSTOFRONT " LINK "HO" 42} @{FG TEXT}Hotkey to bring Icons to Front @{FG SHINE}@{" HOT_ICONSTOBACK " LINK "HO" 49} @{FG TEXT}Hotkey to bring Icons to Back @{FG SHINE}@{" HOT_DEICONIFYALL " LINK "HO" 56} @{FG TEXT}Hotkey to deiconify all Windows @{FG SHINE}@{" HOT_WINDOWIN " LINK "HO" 62} @{FG TEXT}Hotkey to bring Window back into std. Area of Screen @{FG SHINE}@{" HOT_ALLWINDOWSIN " LINK "HO" 71} @{FG TEXT}Hotkey to bring all Wins back into std. Area of Scr @{FG SHINE}@{" HOT_PATCHSCREEN " LINK "HO" 78} @{FG TEXT}Hotkey to patch active Screen @{FG SHINE}@{" HOT_UNPATCHSCREEN " LINK "HO" 88} @{FG TEXT}Hotkey to unpatch active Screen @{" MULTI Actions " LINK "MAO"} @{FG SHINE}@{" MULTIBUTTON " LINK "MAO" 30} @{FG TEXT}Mouse-Button used for MULTI Actions @{FG SHINE}@{" MULTIQUALIFIER " LINK "MAO" 38} @{FG TEXT}Qualifier (Keys) to be pressed together with MB @{" Workarounds & misc Options " LINK "WMO"} @{FG SHINE}@{" MAGICMENU_SH " LINK "WMO" 8} @{FG TEXT}Fixes problem with Magic Menu's Shadow @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @{B}P.S.:@{UB} o PowerWindows does not patch Tasks, it patches Screens! o "Trashing/Destroying the Screen" means that PowerWindows causes graphical Trash (Errors/remaining Lines from the Marker). This can not lead to a Crash!! Only the display is trashed, innocent (foreign) Memory is not! @ENDNODE @NODE "PWPrefs" "Preferences program for PowerWindows" @TOC "Configuration" The preferences program can be configured with the following tooltypes/ CLI-Arguments. @{FG SHINE}GUIFILE@{FG TEXT} : Name of the GUI-File. Don't change this. @{FG SHINE}PIOFILE@{FG TEXT} : Name of the PIO-File. Don't change this. @{FG SHINE}PIOARGS@{FG TEXT} : Arguments for the PIO-File. Don't change this. @{FG SHINE}LOGO@{FG TEXT} : Logo-Brush shown in the window. @{FG SHINE}SLEEPICON@{FG TEXT} : Icon to be used when you iconify the program. @{FG SHINE}NOIMAGES@{FG TEXT} : If you don't want to have Image-Buttons. You can also change the Brushes with a paint program. They are loaded from the "Images"-Directory. @{FG SHINE}NOGROUPIMAGES@{FG TEXT} : If you don't want to have the Images in the Group- Listview @{FG SHINE}NOPOOLS@{FG TEXT} : Forces the program not to use Memory Pools for memory allocation. @{FG SHINE}HELPLINES@{FG TEXT} : Number of text lines in Help-Box. Doesn't work?? :( :( @{FG SHINE}BUBBLEHELP@{FG TEXT} : Help will not be displayed in a Help-Box. You will get Bubble-Help, instead. Window will be smaller. @{FG SHINE}BUBBLEBREAK@{FG TEXT} : Number of chars after which a line break ('\n') will be inserted in the Help-Text. @ENDNODE @NODE "GO" "General Options" @TOC "Configuration" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ G E N E R A L O P T I O N S @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @REM LINE_SCANSCREENS @{FG SHINE}SCANSCREENS@{FG TEXT} : () Default: OFF @{I}Scan Screens@{UI} If active PowerWindows scans ALL already opened Screens and patches them to allow Out-Of-Screen Movings. @{U}The Tasks@{UU} @{U}(well, its Screens) you don't want to be patched (the ones@{UU} @{U}you have specified with @{FG SHINE}TASK@{FG TEXT}) will be patched, too.@{UU} This is because PowerWindows does not know who's the owner of the already open Screens. @REM LINE_INPUTPRI @{FG SHINE}INPUTPRI@{FG TEXT} : (-128 .. 127) Default: 51 @{I}InputHandler Priority@{UI} This Keyword allows you to specify the Priority of the Input-Handler created by PowerWindows. It should be higher than the Priority of Intuition's Input-Handler which is 50! @REM LINE_SAFEMOVEWINDOW @{FG SHINE}SAFEMOVEWINDOW@{FG TEXT} : () Default: OFF @{I}Safe MoveWindow()@{UI} By default, PowerWindows calls MoveWindow() in it's Input- Handler. One should not do that (call Intuition-Functions in an Input-Handler) usually. But as MoveWindow() seems only sending a Request to Intuition, it should not be that critical. Anyway if you get a lot of Deadlocks or even Crashes you can try specifying @{FG SHINE}SAFEMOVEWINDOW@{FG TEXT}. If active, PowerWindow's Input-Handler sends a Message to the PowerWindow's Task asking it to move the Window for it. The Window will be moved only after a short delay which might be annoying. @REM LINE_SAFELOCKLAYER @{FG SHINE}SAFELOCKLAYER@{FG TEXT} : () Default: OFF @{I}Safe LockLayers()@{UI} As there is no AttemptLockLayers(), PowerWindows' Input- Handler before locking the Layers has to check if the LockLayers-Call will succeed, otherwise there might be a DeadLock. This can actually be done in two ways, but both are not really System-conform as they rely on System-private Structure-Fields. @{FG SHINE}SAFELOCKLAYER @{FG TEXT}uses the better way (at least I think so). If you get a lot of Deadlocks when trying to move a Window try specifying this. @REM LINE_NOMOUSEFREEZE @{FG SHINE}NOMOUSEFREEZE@{FG TEXT} : () Default: Off @{I}Don't freeze Mouse@{UI} By default, PowerWindows kills MouseMove-Events while moving a Window. If you don't want that specify this option. If @{FG SHINE}NOMOUSEFREEZE@{FG TEXT} is ON it might happen that the Screen scrolls out of it's limits (because of PowerWindows changing it's Size while moving a Window). In such a case you will see appearing the left part of the Screen in False Colors. If this happens increase @{FG SHINE}MOUSEFACTOR@{FG TEXT}! @REM LINE_MOUSEFACTOR @{FG SHINE}MOUSEFACTOR@{FG TEXT} : (1..100) Default: 4 @{I}Mouse Speed-Factor@{UI} If @{FG SHINE}NOMOUSEFREEZE@{FG TEXT} is ON PowerWindows does not freeze Mouse- Movements while moving a Window, but tries to not let the Mouse-Pointer reach any of the Screen's (visible) Borders which usually leads to Auto-Scrolling. As PowerWindows does not know what Intuition/Commodities/other Input- Handlers do with the Mouse-Events (with which factor they multiply the relative Coordinates in the Event-Structure) it might be necessary to increase the value by which PowerWindows multiplies for (checking reasons). @REM LINE_MAXSPPERIOD @{FG SHINE}MAXSPPERIOD@{FG TEXT} : (0 .. 1000) Default: 20 @{I}Max. Screen-Patch period@{UI} When moving a Window out of Screen, PowerWindows changes the Screen's Dimension to 16383 * 16383. After that it waits until the Window has really arrived at the new Position. When this has happened it resets the Width and Height-Entries of the Screen-Structure to their original values. For some reasons it might happen that the Window never arrives at the new Position, so after the @{FG SHINE}"Maximum Screen Patch Period"@{FG TEXT} PowerWindows resets the Screen's Dimension anyway. The value you specify here is in 10th of a second!! @{B}Note:@{UB} During the @{FG SHINE}"Screen Patch Period"@{FG TEXT} you cannot move the Mouse-Pointer or use the Keyboard. @REM LINE_NO_OUTOFSCREEN @{FG SHINE}NO_OUTOFSCREEN@{FG TEXT} : () Default: OFF @{I}No Out-of-Screen@{UI} This Option disables Out-Of-Screen Movings. You won't be able to drag Windows out of Screen, anymore. It is still possible to iconify Windows. Some Options (the ones that have something to do with Dragging) will have no Effect, anymore: @{FG SHINE}ALLPLANES@{FG TEXT}, @{FG SHINE}MARKER@{FG TEXT}, @{FG SHINE}SAFELOCKLAYER@{FG TEXT}, ... This Option is equivalent to setting @{FG SHINE}NORMALQUALIFIER@{FG TEXT} and @{FG SHINE}FORCEQUALIFIER@{FG TEXT} to something "impossible" such as: LALT+RALT+LSHIFT+RSHIFT+CONTROL+LCOMMAND+RCOMMAND @REM LINE_NOREQPATCH @{FG SHINE}NOREQPATCH@{FG TEXT} : () Default: OFF @{I}Don't patch Requesters@{UI} Because of PowerWindows' EasyRequestArgs() and Auto- Request() patches requester improvers/replacers and assign-wedges often do not work anymore. You can force PowerWindows not to patch EasyRequestArgs() and Auto- Request() by activating this options. You should do this only if you are using CyReq (from PowerWindows/ Tools/Shell - read the @{" ReadMe " LINK "Tools/ReadMe/main"} there) or a complete requester improver such as ARQ. If there isn't one of this programs installed on you computer and you activate this option anyway you will loose some hundred bytes with each system requester that is opened!! @REM LINE_NODGPATCH @{FG SHINE}NODGPATCH@{FG TEXT} : () Default: OFF @{I}Don't patch Depth Gadgets@{UI} In older versions of PowerWindows the Depth Gadgets of the windows did not work correctly. Windows who were partly out of screen or under a PW icon (if ICONDEPTH was set to ALWAYSFRONT) could not be brought to the back. Now PW replaces these gadgets so that the mentioned pro- blem should not exist anymore. Anyway, due to way the Depth Gadgets are replaced/patched, it might eventually happen that certain programs (for example such programs that create Depth-Gadgets themselves) cause problems or even crash the computer. So if you encounter strange pro= blems/gurus that with older versions of PW did not happen try activating this option! @{B}Note:@{UB} Only Depth-Gadgets created by a OpenWindow() or a NewObjectA() call will be patched. So some customly created Depth-Gadgest might still not work correctly. For example "TolleUhr" does not create it's Depth- Gadget with NewObjectA() but from a "self-made gadget structure". @REM LINE_NOREFRESHKILL @{FG SHINE}NOREFRESHKILL@{FG TEXT} : () Default: OFF @{I}Don't clear Refresh-Bit@{UI} In past there were some Problems with SIMPLE-REFRESH Windows. For example Multiview could cause Deadlocks (not being killed by the Deadlock-Hunter). Now Power- Windows clears the LAYERREFRESH Bit in Layer->Flags after having opened such a Window. If for some reason you don't want PowerWindows to do that use this Option! @REM LINE_SMARTWIN @{FG SHINE}SMARTWIN@{FG TEXT} : () Default: OFF @{I}Force Windows to SMART REFRESH@{UI} If you specify this Option, PowerWindows will force all Windows to get SMARTREFRESH Layers. By doing this Re- freshing Problems (@{" known Bugs " LINK "TechnicalInfo"}) should disappear. On most machines you will also get a considerable Speed-Up. The disadvantage is, that SMARTREFRESH Windows need more Memory. @ENDNODE @NODE "WDO" "Window=Drag Options" @TOC "Configuration" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ W I N D O W - D R A G O P T I O N S @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @REM LINE_NORMALBUTTON @{FG SHINE}NORMALBUTTON@{FG TEXT} : (LEFT,RIGHT,MIDDLE) Default: LEFT @{I}Normal-Drag Button@{UI} Here you can specify which Mouse-Button must be pressed together with @{FG SHINE}NORMALQUALIFIER @{FG TEXT}to allow dragging the Window out of Screen when clicking on a Drag-Gadget. @REM LINE_NORMALQUALIFIER @{FG SHINE}NORMALQUALIFIER@{FG TEXT}: (..) Default: @{I}Normal Qualifier@{UI} Qualifier that must be pressed to allow Out-Of-Screen Movings. Multiple Qualifiers must be separated by a "+". @{U}Possible Qualifiers:@{UU} LSHIFT,RSHIFT,SHIFT CAPSLOCK,CONTROL, LALT,RALT,ALT, LCOMMAND,RCOMMAND,COMMAND, You can also specify "NONE" or "OFF" which means, that no Qualifier needs to be pressed. Look at @{FG SHINE}NORMALBUTTON@{FG TEXT}. @{U}Note:@{UU} SHIFT means BOTH Shift-Keys must be pressed, ALT means BOTH Alt-Keys must be pressed, COMMAND means BOTH Command-Keys must be pressed! @REM LINE_FORCEBUTTON @{FG SHINE}FORCEBUTTON@{FG TEXT} : (LEFT,RIGHT,MIDDLE) Default: LEFT @{I}Force-Drag Button@{UI} Here you can specify which Mouse-Button must be pressed together with @{FG SHINE}FORCEQUALIFIER @{FG TEXT}to allow dragging the Window out of Screen when clicking anywhere in the Window. @REM LINE_FORCEQUALIFIER @{FG SHINE}FORCEQUALIFIER@{FG TEXT} : (..) Default: LSHIFT+LALT @{I}Force Qualifier@{UI} Qualifier that must be pressed to allow Out-Of-Screen- Movings. With this Qualifier you can click anywhere in the Window to drag it. Multiple Qualifiers must be sepa- rated by a "+". @{U}Possible Qualifiers:@{UU} LSHIFT,RSHIFT,SHIFT CAPSLOCK,CONTROL, LALT,RALT,ALT, LCOMMAND,RCOMMAND,COMMAND, You can also specify "NONE" or "OFF" which means, that no Qualifier needs to be pressed. Look at @{FG SHINE}FORCEBUTTON@{FG TEXT} @{U}Note:@{UU} SHIFT means BOTH Shift-Keys must be pressed, ALT means BOTH Alt-Keys must be pressed, COMMAND means BOTH Command-Keys must be pressed! @REM LINE_AVOIDDOUBLECLICKS @{FG SHINE}AVOIDDOUBLECLICKS@{FG TEXT}: () Default: OFF @{I}Avoid Double Clicks@{UI} If you have installed a Commodity that moves Windows to front or back when double-clicking the Mouse (for example MultiCX), you should specify this. It prevents the Screen from being trashed by PowerWindows' Marker. @REM LINE_MARKER @{FG SHINE}MARKER@{FG TEXT} : (..) Default: NORMAL @{I}Look of Marker@{UI} - OFF : No marker when dragging windows. Prevents Dead- locks. - GADGET : The marker gets the coordinates of the Drag- Gadget. - NORMAL : The marker gets the coordinates of the Window. Just like Intuition does. - EXTENDED: The marker gets the coordinates of the Window but has a different look. @{" MarkerLook.png " LINK "images/MarkerLook.png/main"} @REM LINE_ALLPLANES @{FG SHINE}ALLPLANES@{FG TEXT} : () Default: OFF @{I}Draw Marker in all Planes@{UI} If active the marker renders to all planes. By default it just renders to Plane 1 to speed things up. If you have a GFX-Board you might have to activate this! @ENDNODE @NODE "SPO" "Screen-Patch Options" @TOC "Configuration" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ S C R E E N - P A T C H O P T I O N S @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @REM LINE_TASK @{FG SHINE}TASK@{FG TEXT} : (..) Default: @{I}Screen Patch Task List@{UI} With @{FG SHINE}TASK@{FG TEXT} you can specify the Tasks whose Screens you DO want to be patched (if @{FG SHINE}TASKSONLY@{FG TEXT} is active) or the Tasks whose Screens you DO NOT want to be patched (if @{FG SHINE}TASKSONLY@{FG TEXT} is inactive). Programs that write directly to the Screen- RastPort should (it depends on when and how they do it) be stated not to be patched. @{B}Notes:@{UB} - You can specify a Pattern (For Example: #?dpaint#?) - The Workbench-Screen is opened by "Ğ IPrefs ğ" - This Keyword can be used more than once. For example: @{FG SHINE}TASK@{FG TEXT}=#?Workbench#? @{FG SHINE}TASK@{FG TEXT}=#?dpaint#? @{FG SHINE}TASK@{FG TEXT}=visage @REM LINE_TASKSONLY @{FG SHINE}TASKSONLY@{FG TEXT} : () Default: OFF @{I}Patch only specified Tasks@{UI} If active the Screens opened by Tasks specified with @{FG SHINE}TASK@{FG TEXT} will be the only ones to be patched. By default the Screens opened by Tasks specified with @{FG SHINE}TASK@{FG TEXT} are the ones NOT to be patched!! @REM LINE_CASESENSITIVE @{FG SHINE}CASESENSITIVE@{FG TEXT} : () Default: OFF @{I}Do case-sensitive Checks@{UI} If active Pattern-Matching (for checking if the actual Task that is going to open a Screen is one of those specified with @{FG SHINE}TASK@{FG TEXT}) is case sensitive. @{B}Important:@{UB} You MUST specify this if you have a DOS-Version lower than 36.147 @ENDNODE @NODE "IO" "Iconify Options" @TOC "Configuration" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ I C O N I F Y O P T I O N S @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @REM LINE_ICONIFYGADGET @{FG SHINE}ICONIFYGADGET@{FG TEXT} : () Default: OFF @{I}Add Iconify-Gadget to Windows@{UI} If you want to have an Iconify-Gadget in your Windows, specify this Keyword. Only Windows that are opened on a patched Screen will get an Iconify-Gadget. If you want certain programs not to get Iconify-Gadgets for its' Win- dows look at the Keywords: @{FG SHINE}ICONIFYTASK@{FG TEXT} @{FG SHINE}ICONIFYTASKSONLY@{FG TEXT} @{FG SHINE}ICONIFYCASESENSITIVE@{FG TEXT} By pressing the Iconify-Gadget the Window will move out of Screen and on it's Position an Icon (no real Icon, but a little Window) will appear. By clicking this Icon twice the Window will reappear on it's old Position and the Icon will disappear. @REM LINE_NOICONS @{FG SHINE}NOICONS@{FG TEXT} : () Default: OFF @{I}Don't create Icons@{UI} If you specify this, iconified Windows will NOT be re- placed by an Icon. Has only sense, if you specify a @{FG SHINE}ICONIFYOFFSET@{FG TEXT} > 0; @REM LINE_IGLOOK @{FG SHINE}IGLOOK@{FG TEXT} : (..) Default: NORMAL @{I}Look of Iconify-Gadget@{UI} The Iconify-Gadget can have different looks. The available ones are: @{I}NORMAL@{UI} : The gadget will look like the ones in MUI. @{I}NICE@{UI} : Custom-Look designed by me. (Very nice!) @{I}SYSIMUI@{UI} : SysiHack-Version of "NORMAL" (like MCP) @{I}SYSI@{UI} : My SysiHack-Version of "NORMAL" @{I}SYSINICE@{UI}: SysiHack-Version of "NICE" @{" Screenshot " LINK "Images/GadgetLook.png/main"} @REM LINE_ICONIFYTASK @{FG SHINE}ICONIFYTASK@{FG TEXT} : (..) Default: @{I}Iconify-Patch Task List@{UI} With @{FG SHINE}ICONIFYTASK@{FG TEXT} you can specify the Tasks whose Windows you want to get an Iconify-Gadget (if @{FG SHINE}ICONIFYTASKSONLY@{FG TEXT} is active) or the Tasks whose Windows you DO NOT want to get an Iconify-Gadget (if @{FG SHINE}ICONIFYTASKSONLY@{FG TEXT} is inactive). @{B}Notes:@{UB} - You can specify a Pattern (For Example: #?dpaint#?) - Only Windows that are opened on a patched Screen can get an Iconify-Gadget - This Keyword can be used more than once. For example: @{FG SHINE}ICONIFYTASK@{FG TEXT}=PPaint @{FG SHINE}ICONIFYTASK@{FG TEXT}=#?dpaint#? @{FG SHINE}ICONIFYTASK@{FG TEXT}=#?visage @REM LINE_ICONIFYTASKSONLY @{FG SHINE}ICONIFYTASKSONLY@{FG TEXT}: () Default: OFF @{I}I-Gadget for specified Tasks only@{UI} If active the Windows opened by Tasks specified with @{FG SHINE}ICONIFYTASK @{FG TEXT}will be the only ones to get an Iconify- Gadget. By default the Windows opened by Tasks specified with @{FG SHINE}ICONIFYTASK @{FG TEXT}are the ones NOT get an Iconify-Task. @REM LINE_ICONIFYCASESENSITIVE @{FG SHINE}ICONIFYCASESENSITIVE@{FG TEXT}: () Default: OFF @{I}Do case-sensitive Checks@{UI} If active Pattern-Matching (for checking if the actual Task is one of those specified with @{FG SHINE}ICONIFYTASK@{FG TEXT}) is case sensitive. @{B}Important:@{UB} You MUST specify this if you have a DOS-Version lower than 36.147 @REM LINE_DONTICONIFYWB @{FG SHINE}DONTICONIFYWB@{FG TEXT} : () Default: OFF @{I}No I-Gadget for WB-Windows@{UI} If you don't want Workbench-Windows (WFLG_WBENCHWINDOW) to get an Iconify-Gadget set this in the Config-File. @REM LINE_ICONIFYOFFSET @{FG SHINE}ICONIFYOFFSET@{FG TEXT} : (0 .. 1000) Default: 0 @{I}Iconify Offset@{UI} When you iconify a Window, PowerWindows moves it to the Position (@{FG SHINE}ScreenWidth@{FG TEXT} - @{FG SHINE}IconifyOffset@{FG TEXT},@{FG SHINE}WindowTop@{FG TEXT}). By default @{FG SHINE}ICONIFYOFFSET @{FG TEXT}is 0. In this case the Window will be completely invisible. If you specify a value > 1 you will still be able to reach (and see a part of) the Window and drag it using the @{FG SHINE}FORCEQUALIFIER@{FG TEXT}. @REM LINE_ICONWIDTH @{FG SHINE}ICONWIDTH@{FG TEXT} : (..) Default: 1/6 @{I}Width of Icons@{UI} @{FG SHINE}ICONWIDTH@{FG TEXT} sets the Width of the Icons. There are several possibilities to get the desired Dimension: - A single value indicates the Width in Pixels: ;We want the Icons'Width to be 100 Pixels! ; @{FG SHINE}ICONWIDTH@{FG TEXT} = 100 - Two values separated by a "/" means that you want the Icons' Width in some way be relative to their Screen's (visible) Width: ;If we want the Icon's Width to be half the Screen- ;Width we use: @{FG SHINE}ICONWIDTH@{FG TEXT} = 1/2 ;If we want the Icons' Width to be ScreenWidth*5/31 ;we use: @{FG SHINE}ICONWIDTH@{FG TEXT} = 5/31 - WINWIDTH means that the Icon will have the same Width as the Window. ;The Icon's Width shall be equal to the Window's ;Width: @{FG SHINE}ICONWIDTH@{FG TEXT} = WinWidth - "WINWIDTH / x" means that the Icon's Width will be Window-Width / x: ;We want the Icons' Width to be half the Width of ;their Windows: @{FG SHINE}ICONWIDTH@{FG TEXT} = WinWidth / 2 @REM LINE_MINICONWIDTH @{FG SHINE}MINICONWIDTH@{FG TEXT} : (0..2000) Default: 100 @{I}Minimal Icon Width@{UI} By default the Icons get the Width according to what is specified with @{FG SHINE}ICONWIDTH@{FG TEXT}. Nevertheless their minimum Width will always be @{FG SHINE}MINICONWIDTH@{FG TEXT}. @REM LINE_ICONPOS @{FG SHINE}ICONPOS@{FG TEXT} : (..) Default: AUTO_BOTTOMLEFT @{I}Position of Icons@{UI} With @{FG SHINE}ICONPOS@{FG TEXT} you can select on which Position you want the Icons appear. These are the possibilites: @{i}UPPERLEFT@{ui} : The Icon will appear in the upperleft edge of the Window you have iconified. @{i}UPPERRIGHT@{ui} : The Icon will appear in the upperright edge of the Window. @{i}LOWERLEFT@{ui} : The Icon will appear in the lowerleft edge of the Window. @{i}LOWERRIGHT@{ui} : The Icon will appear in the lowerright edge of the Window. @{i}CENTER@{ui} : The Icon will appear in the center of the Window. There are also some amazing Auto-Positioning-Possibilities: @{I}AUTO_BOTTOMLEFT@{UI} : +-----------------+ | | | | | | | | |@{BG SHINE}[ ]@{BG BACKGROUND} @{BG SHINE}[ ]@{BG BACKGROUND} @{BG SHINE}[ ]@{BG BACKGROUND} | +-----------------+ @{I}AUTO_BOTTOMRIGHT@{UI}: +-----------------+ | | | | | | | | | @{BG SHINE}[ ]@{BG BACKGROUND} @{BG SHINE}[ ]@{BG BACKGROUND} @{BG SHINE}[ ]@{BG BACKGROUND}| +-----------------+ @{I}AUTO_TOPLEFT@{UI} : +-----------------+ |@{BG SHINE}[ ]@{BG BACKGROUND} @{BG SHINE}[ ]@{BG BACKGROUND} @{BG SHINE}[ ]@{BG BACKGROUND} | | | | | | | | | +-----------------+ @{I}AUTO_TOPRIGHT@{UI} : +-----------------+ | @{BG SHINE}[ ]@{BG BACKGROUND} @{BG SHINE}[ ]@{BG BACKGROUND} @{BG SHINE}[ ]@{BG BACKGROUND} | | | | | | | | | +-----------------+ @{I}AUTO_LEFTTOP@{UI} : +-----------------+ |@{BG SHINE}[ ]@{BG BACKGROUND} | |@{BG SHINE}[ ]@{BG BACKGROUND} | |@{BG SHINE}[ ]@{BG BACKGROUND} | | | | | +-----------------+ @{I}AUTO_LEFTBOTTOM@{UI} : +-----------------+ | | | | |@{BG SHINE}[ ]@{BG BACKGROUND} | |@{BG SHINE}[ ]@{BG BACKGROUND} | |@{BG SHINE}[ ]@{BG BACKGROUND} | +-----------------+ @{I}AUTO_RIGHTTOP@{UI} : +-----------------+ | @{BG SHINE}[ ]@{BG BACKGROUND}| | @{BG SHINE}[ ]@{BG BACKGROUND}| | @{BG SHINE}[ ]@{BG BACKGROUND}| | | | | +-----------------+ @{I}AUTO_RIGHTBOTTOM@{UI}: +-----------------+ | | | | | @{BG SHINE}[ ]@{BG BACKGROUND}| | @{BG SHINE}[ ]@{BG BACKGROUND}| | @{BG SHINE}[ ]@{BG BACKGROUND}| +-----------------+ @REM LINE_ICONPOS_OFFY @{FG SHINE}ICONPOS_OFFY@{FG TEXT} : (-2000 .. 2000) Default: 0 @{I}Offset X-Position@{UI} If @{FG SHINE}ICONPOS@{FG TEXT} is @{FG SHINE}AUTO_???@{FG TEXT} you can set an Offset to add to the calculated Position of the Icon. For example, if you want the Icons to be placed at the bottom of the Screen, but there is also a Toolmanager-Dock there, you can set @{FG SHINE}ICONPOS_OFFY@{FG TEXT} to approximately -40! @REM LINE_ICONPOS_OFFX @{FG SHINE}ICONPOS_OFFX@{FG TEXT} : (-2000 .. 2000) Default: 0 @{I}Offset Y-Position@{UI} Just like @{FG SHINE}ICONPOS_OFFY@{FG TEXT}, but for the X-Postion. @REM LINE_ICONPOS_SPACEX @{FG SHINE}ICONPOS_SPACEX@{FG TEXT} : (0..2000) Default: 1 @{I}X-Space between Icons@{UI} X-Space in Pixels between Icons if @{FG SHINE}ICONPOS@{FG TEXT} is @{FG SHINE}AUTO_???@{FG TEXT}. @REM LINE_ICONPOS_SPACEY @{FG SHINE}ICONPOS_SPACEY@{FG TEXT} : (0..2000) Default: 1 @{I}Y-Space between Icons@{UI} Y-Space in Pixels between Icons if @{FG SHINE}ICONPOS@{FG TEXT} is @{FG SHINE}AUTO_???@{FG TEXT}. @REM LINE_MINWINWIDTH @{FG SHINE}MINWINWIDTH@{FG TEXT} : (0.. 2000) Default: 50 @{I}Minimal Window Width@{UI} In order to get an Iconify-Gadget Windows must be at least @{FG SHINE}MINWINWIDTH@{FG TEXT} Pixels wide. Windows that have a Size-Gadget are not taken into consideration by this Check. @REM LINE_ICONDEPTH @{FG SHINE}ICONDEPTH@{FG TEXT} : (ALWAYSFRONT@{FG SHINE}|@{FG TEXT}NORMAL@{FG SHINE}|@{FG TEXT} Default: ALWAYSFRONT NORMALBEHIND) @{I}Depth of Icons@{UI} By default the Icons of an iconified Window are always in Front of everything. If you prefer them to behave like a normal Window in order to be able to depth-arrange them you can set this to @{FG SHINE}NORMAL@{FG TEXT}. If you do so the Icons will get a little Depth-Gadget in the right upper corner. @{FG SHINE}NORMALBEHIND@{FG TEXT} does the same. The difference is that the Icons are opened behind all normal Windows (but in Front of all Backdrop-Windows) @REM LINE_ICONCLOSEGAD @{FG SHINE}ICONCLOSEGAD@{FG TEXT} : () Default: OFF @{I}Add Close-Gadget to Icons@{UI} With this Option Icons of Windows that have a Close-Gadget will get one, too. This allows you to close an iconified Window without having to de-iconify it first. @REM LINE_WBICONPOPUP @{FG SHINE}WBICONPOPUP@{FG TEXT} : () Default: OFF @{I}WB-Icon pop up@{UI} If you want iconified Workbench-Drawers to be de-iconified when you double-click its' WB-Icon use this Option. As to implement this I used a rather tricky way, there might still be some problems/bugs. Anyway, upto now I didn't notice any. Actually this Option doesn't work if @{FG SHINE}NOICONS@{FG TEXT} is activated. @{B}Note:@{UB} This will probably not work if you are using DOpus 5.x as a Workbench-Replacement. @REM LINE_ICONACTIVATE @{FG SHINE}ICONACTIVATE@{FG TEXT} : () Default: OFF @{I}Icons activate Window@{UI} With this Option you can force PowerWindows to activate an iconified (hidden) Window, when you click on it's Icon. This way you can use the Menus of the iconified Windows. Further the Key-Presses will be sent to the iconified Window, too. For example you could close a Window by pressing ESC (if the Program the iconfied Window belongs to, does this when you press ESC in it's Window) after having activated it's Icon. @REM LINE_POPTOFRONT @{FG SHINE}POPTOFRONT@{FG TEXT} : () Default: OFF @{I}Pop Windows to front@{UI} By default when you de-iconify a Window it will pop up in Front, behind or between other Windows, depending on where it was when you iconified the Window. If you want your Windows pop up always in Front of other Windows, use this Option. @REM LINE_ICONFONT @{FG SHINE}ICONFONT@{FG TEXT} : (..) Default: @{I}Font for Icon-Titles@{UI} By default PowerWindows uses the Screen-Font to print the Title-Text of it's Icons. If you want to use another Font use this Option. You must specify it the following way: @{FG SHINE}ICONFONT@{FG TEXT}=@{FG SHINE}FontName@{FG TEXT}/@{FG SHINE}FontSize@{FG TEXT}[/@{FG SHINE}FontStyle@{FG TEXT}] FontStyle is optional. It can be a combination of [@{FG SHINE}B@{FG TEXT}]old, [@{FG SHINE}I@{FG TEXT}]talic,[@{FG SHINE}U@{FG TEXT}]nderlined. @{B}Examples:@{UB} @{FG SHINE}ICONFONT@{FG TEXT}=topaz.font/8 @{FG SHINE}ICONFONT@{FG TEXT}=helvetica.font/13/I @{FG SHINE}ICONFONT@{FG TEXT}=courier.font/13/UIB @REM LINE_REFRESHIT @{FG SHINE}REFRESHIT@{FG TEXT} : () Default: OFF @{I}Refresh Icon-Titles@{UI} When the title of an iconified Window gets changed PW will change (update) the title of the Icon, too. You should use this option only if you have a fast machine. Windows whose titles are changing a lot will slow down the computer. @REM LINE_NOICONDRAG @{FG SHINE}NOICONDRAG@{FG TEXT} : () Default: OFF @{I}Icons not draggable@{UI} Disables possibility to move (drag) icons. When clicking on an icon it will be de-iconified. So only one mouse click is needed to de-iconify an icon. It is possible to temporary disactivate this option by holding down control when click- ing on an icon, so the icon can be dragged anyway. @ENDNODE @NODE "OMO" "Opaque Moving Options" @TOC "Configuration" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ O P A Q U E M O V I N G O P T I O N S @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ If you want your Windows to be opaque moved (= moved with the Window's full content) you have to keep in mind the following things: o Opaque moving a Window is more dangerous than the standard method. The Screen's Width and Height must be kept changed for the whold time you move the Window around. If in the meantime another program tries to get the Size of the Screen it will get the wrong values (16384 x 16384). It might then try to open a Window somewhere in the completely invisible part of the Screen (for example if the program wants to open the Window in the center of the Screen). This will not lead to a crash! But you might not see or notice the Window. Anyway you can bring such Windows back to the visible part of the Screen using a @{" Hotkey " LINK "HO"}. o There's no need to lock the Layers when opaque moving is activated. You should not get any Deadlocks. o Maybe you prefer using another program for opaque movings. These programs won't allow you to opaque move Windows out of Screen. The Windows will stop at the Screen Bounds. Anyway with these programs the Screen's Width and Height are correct during Dragging - therefore their opaque moving is much less dangerous. So if you don't want to opaque move Windows out of Screen but prefer using a @{" Qualifier " LINK "WDO"} for moving the Windows out of Screen (with no opaque) use the program you prefer and deactivate Power- Windows' opaque moving: when you want to move a Window within the stan- dard area of the Screen you will have opaque moving - when you need to move a Window out of Screen you will have to hold down the Keys spe- cified with @{FG SHINE}NORMALQUALIFIER@{FG TEXT} or @{FG SHINE}FORCEQUALIFIER@{FG TEXT} and by doing this the Window will be dragged the standard way. o If you were using another program for opaque moving (solid window moving) deactivate that program (or the corresponding option)! o Opaque moving has not been tested very much. It's just too slow on my Amiga :-( @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @REM LINE_OPAQUEMOVE @{FG SHINE}OPAQUEMOVE@{FG TEXT} : () Default: OFF @{I}Activate opaque (solid) window moving@{UI} Activate opaque (solid) Window moving. This is very slow on standard Amigas without GFX-Board except in 1-Bitplane mode. @REM LINE_SAFEOPAQUE @{FG SHINE}SAFEOPAQUE@{FG TEXT} : () Default: OFF @{I}Safe Opaque@{UI} By default PowerWindows calls MoveWindow() from the Input- Handler. This is not legal but in some cases a little bit faster. If you activate this option MoveWindow() will be called from the main program which fixes also the delayed refresh of SIMPLE REFRESH Windows. @REM LINE_OPAQUE_SPEED @{FG SHINE}OPAQUE_SPEED@{FG TEXT} : (1..1000) Default: 1 @{I}Speed@{UI} This changes the speed of opaque moving. PowerWindows moves the Window every @{FG SHINE}OPAQUE_SPEED@{FG TEXT} mouse events. If you set this to 1, refreshing of SIMPLE REFRESH Windows is delayed while you keep moving. This happens only if @{FG SHINE}SAFEOPAQUE@{FG TEXT} is deactivated. You have to stop moving the pointer for a while to see this Windows being refreshed. Higher values slow down movings but refreshing won't be delayed. A side-effect of delayed refreshing is an in- creasing slow-down if you move the Window around for a long time without stopping. @REM LINE_OPAQUE_MAXDEPTH @{FG SHINE}OPAQUE_MAXDEPTH@{FG TEXT} : (1..32) Default: 8 @{I}Max. Screen Depth@{UI} Windows on Screens having more than @{FG SHINE}OPAQUE_MAXDEPTH@{FG TEXT} Bits per Pixel (Bitplanes) will not be opaque moved. By default this is 8 meaning all Screens having not more than 256 (2^8=256) Colors will allow opaque moving Windows. @REM LINE_OPAQUE_MAXPIXELS @{FG SHINE}OPAQUE_MAXPIXELS@{FG TEXT}: (1..2000000000) Default: 2147483647 @{I}Max. Pixels to move@{UI} Windows whose @{FG SHINE}Width@{FG TEXT} x @{FG SHINE}Height@{FG TEXT} is greater than this will not be opaque moved. @REM LINE_OPAQUE_MAXBYTES @{FG SHINE}OPAQUE_MAXBYTES@{FG TEXT} : (1..2000000000) Default: 2147483647 @{I}Max. Bytes to move@{UI} Windows whose @{FG SHINE}Width@{FG TEXT} x @{FG SHINE}Height@{FG TEXT} x @{FG SHINE}Bytes per Pixel@{FG TEXT} is greater than this will not be opaque moved. @REM LINE_OPAQUE_NOSIMPLE @{FG SHINE}OPAQUE_NOSIMPLE@{FG TEXT} : () Default: OFF @{I}No opaque for SIMPLE REFRESH Windows@{UI} No opaque moving for Windows that are simple refreshed. @REM LINE_OPAQUE_NOSMART @{FG SHINE}OPAQUE_NOSMART@{FG TEXT} : () Default: OFF @{I}No opaque for SMART REFRESH Windows@{UI} No opaque moving for Windows that are smart refreshed. @REM LINE_OPAQUE_NOSUPER @{FG SHINE}OPAQUE_NOSUPER@{FG TEXT} : () Default: OFF @{I}No opaque for SUPER REFRESH Windows@{UI} No opaque moving for Windows that are super refreshed (SuperBitMap Windows). @ENDNODE @NODE "DHO" Deadlock-Hunting Options" @TOC "Configuration" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ D E A D L O C K - H U N T I N G O P T I O N S @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @REM LINE_DEADLOCK_SEC @{FG SHINE}DEADLOCK_SEC@{FG TEXT} : (0 .. 100) Default: 1 @{I}Seconds between checks@{UI} PowerWindows' SubTask checks every @{FG SHINE}DEADLOCK_SEC @{FG TEXT}Seconds + @{FG SHINE}DEADLOCK_MIC@{FG TEXT} Micro-Seconds if a Deadlock has occured. @REM LINE_DEADLOCK_MIC @{FG SHINE}DEADLOCK_MIC@{FG TEXT} : (0 .. 1,000,000) Default: 0 @{I}Micros between checks@{UI} PowerWindows' SubTask checks every @{FG SHINE}DEADLOCK_SEC@{FG TEXT} Seconds + @{FG SHINE}DEADLOCK_MIC@{FG TEXT} Micro-Seconds if a Deadlock has occured. A Second = 1,000,000 Micro-Seconds! @REM LINE_DEADLOCK_PRI @{FG SHINE}DEADLOCK_PRI@{FG TEXT} : (-128 .. 127) Default: 0 @{I}Task-Priority of Deadlock-Hunter@{UI} Specifies the Task-Priority of PowerWindows' DeadLock- hunting Sub-Task. @ENDNODE @NODE "ERO" "External Routines" @TOC "Configuration" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ E X T E R N A L R O U T I N E S @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @REM LINE_EXT_WINDOWCHECKER @{FG SHINE}EXT_WINDOWCHECKER@{FG TEXT}: ([,Parameters]) Default: @{I}External Window-Checker@{UI} PowerWindows allows you to use external Routines that are used for several Operations. This one is for checking whether a Window shall get an Iconify-Gadget or not. A Window-Checker Routine can also do the Rendering of the Iconify-Gadget. If the Routine requires some Parameters specify them after a ','. @{B}Examples: @{UB}Ext_WindowChecker = ram:mychecker Ext_WindowChecker = ram:mychecker,COOLMODE Ext_WindowChecker = "ram:mychecker" , COOLMODE @{B}Note :@{UB} There's an example Routine in "ExtRoutines/". Check it out, the Iconify-Gadgets will get a Smiley Look! @REM LINE_EXT_SCREENCHECKER @{FG SHINE}EXT_SCREENCHECKER@{FG TEXT}: ([,Parameters]) Default: @{I}External Screen-Checker@{UI} External Routine for checking whether a Screen shall be patched or not. If the Routine requires some Parameters specify them after a ','. @REM LINE_EXT_ICONRENDERER @{FG SHINE}EXT_ICONRENDERER@{FG TEXT} : ([,Parameters]) Default: @{I}External Icon-Renderer@{UI} External Routine that is supposed to do the Rendering of the Icons (Mini-Window of an iconified Window). If the Routine requires some Parameters specify them after a ','. There are some nice IconRenderers in the "ExtRoutines"- Directory. Check them out. They take also some Parameters. Read their @{" Documentation " LINK "DemoIconRenderers"}. @ENDNODE @NODE "HO" "Hotkeys" @TOC "Configuration" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ H O T K E Y S @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ You can use Hotkeys for several useful Operations. The Hotkey-Description must follow the Commodity-Standard and @{B}must be written between quotation marks@{UB} if you are editing the Config-File yourself instead of using PW_Prefs. If your Hotkey-Description is illegal, you will get an Error when you start PowerWindows. By default all Hotkeys are disabled. They will be activated if you state them in the Configuration-File (with a legal Hotkey-Descrip- tion, of course). Examples: HOT_ICONSTOFRONT = "CTRL ALT i" HOT_ICONSTOBACK = "LSHIFT LCOMMAND u" Mouse-Button hotkeys are a little bit strange. For example if you want to use the left mouse button + right alt to iconify a window the hotkey description must be: "rawmouse lbutton ralt mouse_leftpress" @{B}Note:@{UB} There seems to be a bug in the commodities.library. Some hotkeys don't work. For example "RALT RSHIFT i" is O.K., but "RALT RSHIFT I" is not. I don't know if in OS 3.1 this has been fixed. @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @REM LINE_HOT_ICONIFY @{FG SHINE}HOT_ICONIFY@{FG TEXT} : ("Hotkey-Description") Default: @{I}Iconify@{UI} Hotkey to iconify active Window. Only works if the Window has an Iconify-Gadget! @REM LINE_HOT_ICONSTOFRONT @{FG SHINE}HOT_ICONSTOFRONT@{FG TEXT}: ("Hotkey-Description") Default: @{I}Icons to front@{UI} Hotkey to bring all Icons on the active Screen to Front. Only works if @{FG SHINE}@{" ICONDEPTH " LINK "IO"}@{FG TEXT} is not set to ALWAYSFRONT! @REM LINE_HOT_ICONSTOBACK @{FG SHINE}HOT_ICONSTOBACK@{FG TEXT} : ("Hotkey-Description") Default: @{I}Icons to back@{UI} Hotkey to bring all Icons on the active Screen to Back. Only works if @{FG SHINE}@{" ICONDEPTH " LINK "IO"}@{FG TEXT} is not set to ALWAYSFRONT! @REM LINE_HOT_DEICONIFYALL @{FG SHINE}HOT_DEICONIFYALL@{FG TEXT}: ("Hotkey-Description") Default: @{I}De-iconify all Windows@{UI} Hotkey to de-iconify all Windows on the active Screen. @REM LINE_HOT_WINDOWIN @{FG SHINE}HOT_WINDOWIN@{FG TEXT} : ("Hotkey-Description") Default: @{I}Bring active Window into view@{UI} Hotkey to move the active Window back into the Screen's "standard" Area, if the Window was partly out of it. If the Window wasn't it will be moved to Front and centered on the Screen. @REM LINE_HOT_ALLWINDOWSIN @{FG SHINE}HOT_ALLWINDOWSIN@{FG TEXT}: ("Hotkey-Description") Default: @{I}Bring all Windows into view@{UI} Hotkey to move @{B}all@{UB} Windows of the active Screen back into the Screen's "standard" Area. @REM LINE_HOT_PATCHSCREEN @{FG SHINE}HOT_PATCHSCREEN@{FG TEXT} : ("Hotkey-Description") Default: @{I}Patch active screen@{UI} Hotkey to patch the active Screen, that is, allow Out-Of- Screen draggings and Iconifying. The open windows on the screen will automatically get an Iconify-Gadget. This hot- key makes of course only sense if the active screen is not yet patched. @REM LINE_HOT_UNPATCHSCREEN @{FG SHINE}HOT_UNPATCHSCREEN@{FG TEXT}: ("Hotkey-Description") Default: @{I}Unpatch active screen@{UI} Hotkey to unpatch the active Screen. Dragging windows out of Screen and Iconifying will not be possible, anymore. Windows that were out of Screen will be brought back. Iconified windows will be de-iconified. The Iconify-Gadget in the windows will disappear. @ENDNODE @NODE "MAO" "MULTI Actions" @TOC "Configuration" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ M U L T I A C T I O N S @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ PowerWindows allows you to iconify and de-iconify more Windows all at once. When you click the Mouse-Button specified with @{FG SHINE}MULTIBUTTON@{FG TEXT} while holding down the Keys specified with @{FG SHINE}MULTIQUALIFIER@{FG TEXT} PowerWindows activates it's MULTI Action Mode. Depending on whether there's an Icon or a normal Window under the Mouse Pointer when doing this, you will activate MULTI Iconify Mode or MULTI De-Iconify Mode. You can move around with the Mouse and all Windows (if the Mouse-Click was over a Window) or all Icons (if the Mouse-Click was over an Icon) you touch will get a scrolling Frame. This helps you seeing which Windows/Icons will be iconified/de-iconified when you release the Mouse-Button. You can abort MULTI Action Mode by clicking another Mouse-Button. MULTI Action Mode can be very comfortable for iconifying/de-iconifying a single Window, too. You can click anywhere in the Window to iconify it and don't need double-clicking to de-iconify it again. @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @REM LINE_MULTIBUTTON @{FG SHINE}MULTIBUTTON@{FG TEXT} : (LEFT,RIGHT,MIDDLE) Default: LEFT @{I}MULTI Action Button@{UI} Here you can specify which Mouse-Button must be pressed together with @{FG SHINE}MULTIQUALIFIER @{FG TEXT}to activate MULTI Action Mode. @REM LINE_MULTIQUALIFIER @{FG SHINE}MULTIQUALIFIER@{FG TEXT} : (..) Default: LALT+CONTROL @{I}MULTI Qualifier@{UI} Qualifier that must be pressed to activate MULTI Action Mode. Multiple Qualifiers must be separated by a "+". @{U}Possible Qualifiers:@{UU} LSHIFT,RSHIFT,SHIFT CAPSLOCK,CONTROL, LALT,RALT,ALT, LCOMMAND,RCOMMAND,COMMAND, You can also specify "NONE" or "OFF" which means, that no Qualifier needs to be pressed. @{U}Note:@{UU} SHIFT means BOTH Shift-Keys must be pressed, ALT means BOTH Alt-Keys must be pressed, COMMAND means BOTH Command-Keys must be pressed! @ENDNODE @NODE "WMO" "Workarounds & misc Options" @TOC "Configuration" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ W O R K A R O U N D S & M I S C O P T I O N S @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @REM LINE_MAGICMENU_SH @{FG SHINE}MAGICMENU_SH@{FG TEXT} () Default: OFF @{I}Fix shadow-problem of MagicMenu@{UI} If you are using MagicMenu together with PowerWindows there is a problem with it's Shadow-Option. The shadow sometimes is not transparent. Set this Option to fix this. @{B}Note:@{UB} The program name of MagicMenu must be "MagicMenu", otherwise this Option does not work. So if on your computer it's called "MagicMenu_20+" or some- thing similiar rename it to "MagicMenu"! @ENDNODE @NODE "TechnicalInfo" "Technical Info/Bugs" @TOC "Main" @{U}PowerWindows patches the following System-Routines:@{UU} Layers/UpFrontLayer Layers/CreateUpFrontLayer Layers/CreateUpFrontHookLayer Layers/MoveLayerInFrontOf Intuition/OpenScreen Intuition/OpenScreenTagList Intuition/CloseScreen Intuition/OpenWorkbench Intuition/CloseWorkbench Intuition/OpenWindow Intuition/OpenWindowTagList Intuition/CloseWindow Intuition/ActivateWindow Intuition/ActivateGadget Intuition/WindowToFront Intuition/WindowToBack Intuition/FreeSysRequest Intuition/EasyRequestArgs Intuition/AutoRequest Intuition/NewObjectA @{U}How it works:@{UU} I don't want to tell you how it exactly works. Anyway here are some Hints: - It does not replace Layer-Functions. - Moving Layers out of Screen is very easy. - The most difficult thing is disabling (or fooling) Intuition's Screen Bounds Checkings. - If I had the Source-Code of the Operating System it would not take me more than some hours to implement Out-Of-Screen Draggings. @{U}Known Bugs:@{UU} - Windows that are out of Screen can't be brought to Back with the Window's Depth-Gadget: This is because Intuition always thinks it has to bring it to front be- cause such a Window is never the frontmost Layer. (PowerWindows creates some hidden Layers which are always in front of all normal Window- Layers) - The marker can trash the Screen (but not foreign memory): This is because my Input-Handler does the LockLayers() Call before drawing the Marker and Intuition's Input-Handler being the same Task is allowed to brake it. - Deadlocks can occure when you try to drag a Window while there is a lot of "Activity". Anyway PowerWindows intercepts them and after a short delay (1 second or so) you should be able to continue. - If Intuition tries to close the Workbench-Screen, PowerWindows un-patches the Screen and WILL NOT re-patch it if closing fails (because of not closed Windows or something similiar). This will be fixed soon! - Refreshing-Problems with SIMPLEREFRESH Windows. For example if you display a C-Source in Multiview (with a C-Datatype) when you try to scroll up and down, the whole Content will be refreshed. By moving the Multiview-Window to Back and then to Front again, everything works as it should. If you quit PowerWindows or try to close the Workbench-Screen (by changing it's Screenmode) and there is a SIMPLE- REFRESH WINDOW partly out of Screen, this Window will start refreshing again and again, without stopping. This can be stopped by moving such a Window to Back, too. The @{" SMARTWIN " LINK "GO"} Option might be a better solution. - Directory Opus 4.11 seems to remove all Gadgets from the Window when you resize it, free them all (including PowerWindows' Iconify-Gadget) and re-create them after that. The Iconify-Gadget will not re-appear. The Gadget and it's Image will never be disposed and therefore you lose some Memory every time you resize the Window. - If you have a Commodity that replaces the Requester popping up when you select the "About ..." (Version/Copyright) Menu of the Workbench you will get the normal Requester and not the one from the Commodity. You will get the one from the Commodity if PowerWindows is started before the Commodity, but then PowerWindows might not work (correctly). Have a look at @{" FAQ " LINK "FirstAidFAQ"}! @{U}Hints:@{UU} - Don't use Patterns with @{FG SHINE}TASK@{FG TEXT} and @{FG SHINE}ICONIFYTASK@{FG TEXT} if you know the real Names of the Programs. Pattern-Matching needs a lot of Stack and nobody knows what happens, if the Task opening the Screen/Window is too low on Stack. @{B}Note:@{UB} As a program opening a Screen/Window has/might have to scan all the Names, all the Names you specify must not have any Pattern in order to avoid this! @ENDNODE @NODE "DemoIconRenderers" "IconRenderers" @TOC "ERO" @{" IconLook.png " LINK "images/IconLook.png/main"} @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @{FG SHINE}Mac_IconRenderer@{FG TEXT} @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ The Icons will get the look of Mac windows. The Routine has the following argument template: @{I} FONTNAME=F/K,FONTSIZE=FS/K/N,FONTSTYLE/K/N,FONTYOFFSET=FY/K/N, FONTXOFFSET=FX/K/N,MINBARWIDTH=MBW/K/N,OUTERBARWIDTH=OBW/K/N, TITLEGAP=TG/K/N,PRECISION=P/N@{UI} @{B}FONTNAME@{UB} : Font to be used for the title. If not specified the Font of the Screens on which the Icon pops up will be used. @{B}FONTSIZE@{UB} : Size of the Font. Should be 13. @{B}FONTSTYLE@{UB} : Style of the Font - 1 is Underlined 2 is Bold 4 is Italic To combine two styles add their number. Example: 3 is Underlined Bold @{B}FONTYOFFSET@{UB} : Change this if the title is not centered correctly (y) @{B}FONTXOFFSET@{UB} : Change this if the title is not centered correctly (x) @{B}MINBARWIDTH@{UB} : Minimal width of the inner bars. @{B}OUTERBARWIDTH@{UB}: Width of the outer bars. @{B}TITLEGAP@{UB} : Space between title and bars. @{B}PRECISION@{UB} : Precision for ObtainBestPen - 0 is PRECISION_IMAGE 16 is PRECISION_ICON 32 is PRECISION_GUI -1 is PRECISION_EXACT (def) @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @{FG SHINE}Mac2_IconRenderer@{FG TEXT} @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ The Icons will get the look of Mac windows (the one from MacOS>7.5). The Routine has the following argument template: @{I} FONTNAME=F/K,FONTSIZE=FS/K/N,FONTSTYLE/K/N,FONTYOFFSET=FY/K/N, FONTXOFFSET=FX/K/N,DEPTHLOOK=D/N,MINBARWIDTH=MBW/K/N,GADGETGAP=GG/K/N, TITLEGAP=TG/K/N,PRECISION=P/N@{UI} @{B}FONTNAME@{UB} : Font to be used for the title. If not specified the Font of the Screens on which the Icon pops up will be used. @{B}FONTSIZE@{UB} : Size of the Font. Should be 13. @{B}FONTSTYLE@{UB} : Style of the Font - 1 is Underlined 2 is Bold 4 is Italic To combine two styles add their number. Example: 3 is Underlined Bold @{B}FONTYOFFSET@{UB} : Change this if the title is not centered correctly (y) @{B}FONTXOFFSET@{UB} : Change this if the title is not centered correctly (x) @{B}DEPTHLOOK@{UB} : Look of Depth-Gadget. 0 or 1. @{B}MINBARWIDTH@{UB} : Minimal width of the bars. @{B}GADGETGAP@{UB} : Space between Gadgets and bars. @{B}TITLEGAP@{UB} : Space between title and bars. @{B}PRECISION@{UB} : Precision for ObtainBestPen - 0 is PRECISION_IMAGE 16 is PRECISION_ICON 32 is PRECISION_GUI -1 is PRECISION_EXACT (def) @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ @{FG SHINE}Ami_IconRenderer@{FG TEXT} @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ The Icons will get the look of standard Amiga Windows. The Routine has the following argument template: @{I} FONTNAME=F/K,FONTSIZE=FS/K/N,FONTSTYLE/K/N,FONTYOFFSET=FY/K/N, FONTXOFFSET=FX/K/N,TITLEGAP=TG/K/N,BACKCOL=BC/K,TITLECOL=TC/K, GADGETSGREY=GG/S,BACKGROUNDGREY=BG/S,CENTERTITLE=CT/S,P=PRECISION/K/N@{UI} @{B}FONTNAME@{UB} : Font to be used for the title. If not specified the Font of the Screens on which the Icon pops up will be used. @{B}FONTSIZE@{UB} : Size of the Font. @{B}FONTSTYLE@{UB} : Style of the Font - 1 is Underlined 2 is Bold 4 is Italic To combine two styles add their number. Example: 3 is Underlined Bold @{B}FONTYOFFSET@{UB} : Change this if the title is not centered correctly (y) @{B}FONTXOFFSET@{UB} : Change this if the title is not centered correctly (x) @{B}TITLEGAP@{UB} : Space between title and gadgets. @{B}BACKCOL@{UB} : RGB of Color to be used for Icon background. This must be a 32-Bit value. You can (and should) state it in hex form. Example: BACKCOL=0xFFFF00 @{B}TITLECOL@{UB} : RGB of Color to be used for Icon title. This must be a 32-Bit value. You can (and should) state it in hex form. Example: BACKCOL=0xFFFF00 @{B}GADGETSGREY@{UB} : The gadgets will be grey, just like standard gadgets in inactive windows. @{B}BACKGROUNDGREY@{UB}: Color of Icon background will be grey, just like the standard border of inactive windows. @{B}CENTERTITLE@{UB} : Title of Icon will be centered. @{B}PRECISION@{UB} : Precision for ObtainBestPen - 0 is PRECISION_IMAGE 16 is PRECISION_ICON 32 is PRECISION_GUI -1 is PRECISION_EXACT (def) @ENDNODE @NODE "FirstAidFAQ" "First Aid - FAQ - Trouble Shooting" @TOC "Main" @{" With PW my Computer crashes every once and then (or with certain Progs " LINK "FAQ_GENERAL"} @{" PW doesn't work at all or only when it's not started during Boot " LINK "FAQ_NOTWORK"} @{" The Depth-Gadgets of the Screens are moved one Pixel to the left " LINK "FAQ_SDEPTH"} @{" I want Workbench Windows to pop up, when i click on it's WB-Icon " LINK "FAQ_WBPOPUP"} @{" Sometimes I can't drag Wins out of Screen. Marker stops at Scr-Bounds " LINK "FAQ_DRAGLOCK"} @{" Clicking Windows to Front/Back trashes Screen, when clicking Titlebar " LINK "FAQ_AVOIDDOUBLE"} @{" Sometimes Windows refresh again and again, without stopping " LINK "FAQ_REFRESH"} @{" I don't want the Icons to be always in Front of everything " LINK "FAQ_ICONDEPTH"} @{" I don't want the Out-Of-Screen-Feature, just the Iconify Bit " LINK "FAQ_NOOUTSCR"} @{" I want to use LMB for standard Draggings and MMB for Out-Of-Screen Dr " LINK "FAQ_BUTTONDRAG"} @{" I tried to use the TASK/ICONIFYTASK Options, but it doesn't work " LINK "FAQ_TASK"} @{" PowerWindows doesn't work with my OpaqueMove Commodity " LINK "FAQ_OPAQUE"} @{" 1 of my Commodities replaces the About-Req of WB. With PW it disappears " LINK "FAQ_WBABOUT"} @{" I use MagicMenu by Olaf Barthel. With PW MenuShadows aren't transparent " LINK "FAQ_MAGICMENU"} @{" I like Arq but with PowerWindows it doesn't work. " LINK "FAQ_ARQ"} @ENDNODE @NODE "FAQ_GENERAL" "FAQ" @TOC "FirstAidFAQ" The first thing you should do when you have problems with PW (such as seeing more crashes as usual) is to install @{FG SHINE}StackAttack@{FG TEXT}. You can find this program in the "Tools/Shell"-Directory. Have a look at the @{" ReadMe " LINK "Tools/ReadMe/main"} there. To install it simply copy it to "C:" and add the following line to your Startup-Sequence (somewhere after SetPatch - the earlier the better): run <>NIL: C:StackAttack MIN=6000 ADD=500 If you are still having problems try to increase the values. You can also try changing some of PW's options. @ENDNODE @NODE "FAQ_NOTWORK" "FAQ" @TOC "FirstAidFAQ" @{U}If it doesn't work at all:@{UU} Try removing all your Patches/Commodities one by one. It must work! @{U}If it doesn't work when you start it in the Startup-Sequence/User-Startup or WBStartup:@{UU} Probably there are one or more Programs patching Functions, PowerWindows patches too. PowerWindows doesn't seem to like that if these Programs are started after PW. Not all Programs will cause problems, but certain ones will create big Trouble. Try starting PowerWindows from WBStartup and set the Tooltype "STARTPRI" of it's Icon to a low value (-100). @ENDNODE @NODE "FAQ_SDEPTH" "FAQ" @TOC "FirstAidFAQ" This problem has been fixed with Version 1.0! No workaround for programs such as MCP is needed anymore. It was a bug in PowerWindows. I forgot to check whether the Images' LeftEdge is <> 0. If you have set SDEPTH_OFFSET to 1 remove the corresponding Line from the Configuration File! @ENDNODE @NODE "FAQ_WBPOPUP" "FAQ" @TOC "FirstAidFAQ" This can be done by specifying @{FG SHINE}@{" WBICONPOPUP " LINK "IO"}@{FG TEXT}in the Configuration-File. If you are running DOpus 5.x as a Workbench-Replacement then this might not work or create Trouble. As I don't own it, I don't know it. @ENDNODE @NODE "FAQ_DRAGLOCK" "FAQ" @TOC "FirstAidFAQ" PowerWindows, in order to prevent Deadlocks uses some Tricks to be sure, that when it does a LockLayers() in it's Input-Handlers, this call will succeed, otherwise a Deadlock would occure. If it thinks that LockLayers() will not succeed (succeed = return soon, without having to wait for another Task that is actually locking the Layers to unlock the Layers), Power- Windows' personal Drag-Routine will abort, and instead of it, Intuition's original Drag-Routine will jump in. There are several Possibilities to "fix" this: 1) Set @{FG SHINE}@{" MARKER " LINK "GO"}@{FG TEXT} to OFF. The Marker will be invisible --> no LockLayers() needed, looks ugly :-( 2) Disable @{FG SHINE}@{" SAFELOCKLAYER " LINK "GO"}@{FG TEXT}. By doing so you might get more Deadlocks!! 3) Wait for a future Release of PowerWindows. I have several ideas about how to fix this. @ENDNODE @NODE "FAQ_AVOIDDOUBLE" "FAQ" @TOC "FirstAidFAQ" Activate @{FG SHINE}@{" AVOIDDOUBLECLICKS " LINK "WDO"}@{FG TEXT}. @ENDNODE @NODE "FAQ_REFRESH" "FAQ" @TOC "FirstAidFAQ" There are some Problems with SIMPLE-REFRESH Windows. Have a look at @{" known Bugs " LINK "TechnicalInfo"}. You could also try setting the @{" SMARTWIN " LINK "GO"} Option. @ENDNODE @NODE "FAQ_ICONDEPTH" "FAQ" @TOC "FirstAidFAQ" Have a look at the @{FG SHINE}@{" ICONDEPTH " LINK "IO"}@{FG TEXT} Option. @ENDNODE @NODE "FAQ_NOOUTSCR" "FAQ" @TOC "FirstAidFAQ" Use the Option @{FG SHINE}@{" NO_OUTOFSCREEN " LINK "General Options"}@{FG TEXT}. @ENDNODE @NODE "FAQ_BUTTONDRAG" "FAQ" @TOC "FirstAidFAQ" Have a look at the @{FG SHINE}@{" Window Dragging Options " LINK "WDO"}@{FG TEXT}. @ENDNODE @NODE "FAQ_TASK" "FAQ" @TOC "FirstAidFAQ" Are you sure the Task-Name you stated is correct? There are some very nice Utilities in the "Tools"-Directory. Check them out. The @{FG SHINE}TASK@{FG TEXT} Option is meant for Programs that open a Screen. It is not possible on a patched Screen to allow some Windows to be dragged off Screen and others not. On a patched Screen all Windows can be dragged off Screen, and on a non-patched Screen no Window is allowed to do that. If you want to specify more than one Program, you can use the @{FG SHINE}TASK@{FG TEXT} Option (or @{FG SHINE}ICONIFYTASK@{FG TEXT} Option) more than once. Example Config-File: @{I} SAFELOCKLAYER SAFEMOVEWINDOW TASK = #?DPaint#? TASK = #?Visage#? TASK = DirectoryOpus WBICONPOPUP@{UI} @ENDNODE @NODE "FAQ_OPAQUE" "FAQ" @TOC "FirstAidFAQ" Have a look at @{" Installation " LINK "Installation"}! @ENDNODE @NODE "FAQ_WBABOUT" "FAQ" PowerWindows has to patch AutoRequest() and EasyRequestArgs(), because they don't call CloseWindow(). In the older Versions of PowerWindows I forgot to do this Patches and so you lost about 200 Bytes with each requester opened (if they call AutoRequest() or EasyRequestArgs()). If I did not do that, the Iconify-Gadget and it's Image would never be disposed, therefore the loss of memory. The new functions redirect AutoRequest() Calls to BuildSysRequest() and EasyRequestArgs() Calls to BuildEasyRequestArgs(), otherwise PowerWindows does not get the chance to dispose the Iconify-Gadget and it's image. The side effect is, that commodities that replace the About Requester of the Workbench don't replace it anymore. They only check EasyRequestArgs() Calls, but all EasyRequestArgs() Calls are redirected by PowerWindows to BuildEasyRequestArgs(). Therefore when you select "About ..." from the Workbench Menu the Commodity does not recognize it as the About-Requester. If the Commodity does not other tricky Patches in layers.library you can try starting the Commodity AFTER PowerWindows. You will (should) get the requester from the Commodity again, but PowerWindows might stop working correctly. You have to try it out. But @{FG SHINE}the best solution@{FG TEXT} of all is using the @{" Dont patch Requesters " LINK "GO"} option of PowerWindows. By doing this you will get the WBAbout Requester from the commodity. Anyway this option can only be used if you install CyReq (from PowerWindows/Tools/Shell - have a look at the @{" ReadMe " LINK "Tools/ReadMe/main"} there) or if you have installed a program that replaces requester-routines completely (ARQ) - otherwise you will loose some hundred bytes with each system requester that is opened!!! You don't need to (but can) install CyReq if you are using a commidty that replaces requesters completely. @ENDNODE @NODE "FAQ_MAGICMENU" "FAQ" @TOC "FirstAidFAQ" Have a look at @{" Workarounds and misc Options " LINK "WMO"}! @ENDNODE @NODE "FAQ_ARQ" "FAQ" @TOC "FirstAidFAQ" Arq works (or should work) when it's started after PowerWindows. If you start PowerWindows from WBStartup, Arq must be started there, too. First you have to create an Icon for Arq and set the following tooltypes. DONOTWAIT STARTPRI=-100 After that drag the Arq-Icon into the WBStartup-Drawer and remove it from the User-Startup/Startup-Sequence if it was there. A @{FG SHINE}better solution@{FG TEXT} is using the @{" Dont patch Requesters " LINK "GO"} option. Have a look at the @{" WB About FAQ " LINK "FAQ_WBABOUT"}. @ENDNODE @NODE "History" "History" @TOC "Main" @{B}V 0.8@{UB} @{FG SHINE}26.01.97@{FG TEXT}: - First public release - Still in development - There are still some bugs @{B}V 0.9@{UB} @{FG SHINE}25.02.97@{FG TEXT}: - Rewrote program in "C". First Version was in Pascal. - Fixed Bug that caused trashing Screens' Depth-Gadget. These gadgets are RELRIGHT by default and therefore will not be correct while PowerWindows moves a window. (PowerWindows changes the Screen's Width and Height while doing this as you should know if you have read the documentation!) - Breaking the Program had a serious Bug. The Routine that resets the Patches seems to have returned always success even if it didn't succeed. Further, if it found, that a function has been patched by another program, it re-patched this function to PowerWindows' Routine. - Windows can now be iconified. You get a nice Gadget for this, which either looks like the ones in MUI or has a new look designed by me. - Lots of Bug-Fixes that could cause the program to hang. - Now there should be very few Deadlocks (which anyway are intercepted by the Deadlock-Hunter) - Lots of new Configuration-Options - Deadlock-Hunting is now done in a Sub-Task. @{B}V 0.9.1@{UB} @{FG SHINE}31.03.97@{FG TEXT}: - Added my EMail Address to documentation! - HardDisk ceased to work on 20.03.97, the day I finally got access to Internet (Arrgh!). - Version 1.0 will be released a little later than ex- pected! (Need a new HardDisk!) @{B}V 0.9.5@{UB} @{FG SHINE}25.04.97@{FG TEXT}: - The Release-Date of V0.9 (in "History") was wrong - New HardDisk :-) 12.04.97 (-: I didn't work on PowerWindows from 20.03.97 until 13.04.97. - New Option: AVOIDDOUBLECLICKS. Prevents Screen from being trashed if you have installed some Commodity that brings Windows to Front/Back by double-clicking a Mouse- Button. - Bug-Fix: If SAFEMOVEWINDOW was active, Windows couldn't be activated by clicking at their Dragbar. - Bug-Fix: The Iconify-Gadget Render-Routines placed one white Pixel at the wrong Place. - Implemented workaround for the Screens' DepthGadget being moved 1 Pixel left if MCP is running and it's SysiHack Option is activated. - Bug-Fix: If you iconified a Window that was partly out of Screen then de-iconifying didn't work. The Icon disappeared but the Window didn't appear. Should not happen anymore, althaugh I'm not completely sure ... - Changed the way PowerWindows redirects OpenWindow() to OpenWindowTagList(), OpenScreen() to OpenScreenTagList() and CreateUpfrontLayer() to CreateUpfrontHookLayer(). The old Routines could cause Problems if other Programs patched that Functions after PowerWindows, especially if they didn't redirect them or did that the other way round. - Added CLI-Argument/Workbench-Tooltype "HOMEDIR". If you have moved PowerWindows in the WBStartup Drawer you should set the Icon-Tooltype "HOMEDIR" to where the PowerWindows-Directory is. - New Option "ICONDEPTH". If you want PowerWindows' Icons to behave like normal Windows (possibility to depth-arrange them instead of seeing them always in Front of everything) this can now be done. - MOST WANTED: New Option "WBICONPOPUP". It's now possible to de-iconify Workbench-Drawers by double- clicking its' WB-Icon. Doesn't work with "NOICONS"- Option, yet. Anyway, nobody seems to use "NOICONS". There might still be some problems/bugs with this new Feature, althaugh I didn't notice any upto now. - New Option "ICONACTIVATE". If you click on an Icon, the iconified (hidden) Window will be activated. This allows you to use it's Menu. The Key-Presses will be redirected to the hidden Window, too. For example you could close it (and it's Icon) by pressing ESC (if the Program supports this). - New Option "NO_OUTOFSCREEN". With this Option you loose the possibility to move Windows out of Screen. Iconifying will still be possible. It's equivalent to setting NORMALQUALIFIER/FORCEQUALIFIER to something "impossible" such as "LALT+RALT+LSHIFT+RSHIFT+CONTROL+ LCOMMAND+RCOMMAND". - New Option "POPTOFRONT". By default when you de-iconify a Window it will pop up behind, in Front or between other Windows, depending on where it was when you iconified it. POPTOFRONT will automatically bring to Front de-iconified Windows. - PowerWindows is now a commodity, too. Anyway the Input- Handler is not yet a CxCustom-Object. Implemented Hotkeys for several useful Operations. - After opening a SIMPLE-REFRESH Layer PowerWindows now clears the LAYERREFRESH Bit in Layer->Flags. This should fix the Refreshing/Deadlock Problems with SIMPLE-REFRESH Windows (such as Multiview). This can be deactiveted with "NOREFRESHKILL" - New Option "SMARTWIN". Forces Windows to SMARTREFRESH. - Converted the Images in the Archive to GIFs - Added Cli-Argument/Workbench-Tooltype "CONFIGFILE". It's now possible to specify what Configuration- File you want to use. It's possible to use Project- icons with Default Tool "PowerWindows". The Tool- types will be read from the Project-Icon. - Added Support for external Screen-Checker-,Window- Checker- and Icon-Render-Routines. New Options: EXT_WINDOWCHECKER, EXT_SCREENCHECKER, EXT_ICONRENDERER - BUG BUG BUG BUG: Forgot to patch FreeSysRequest()!!! Requesters are opened with OpenWindowTagList() but closed with FreeSysRequest(). The Iconify-Gadgets of Requesters were never disposed. You lost about 200 Bytes with each Requester you opened. Had to patch EasyRequestArgs() and AutoRequest(), too, because they call FreeSysRequest() directly and not through the Library Vector. - New Option "ICONCLOSEGAD". With this Option when you iconify a Window having a Close-Gadget, the Icon will get one, too, allowing you to close the Window without having to de-iconify it first. @{B}V 1.0@{UB} @{FG SHINE}31.05.97@{FG TEXT}: - Implemented Opaque Moving. Have a look at the Config- uration Chapter! - Workaround for MagicMenu's shadow sometimes not being transparent. Option "MAGICMENU_SH". - 05.05.97: Started work on Prefs-Program. - PowerWindows caused problems (deadlocks) with some old programs (such as CygnusED) which have WFLG_NW_EXTENDED set when calling OpenWindow() but only crap in what should be the TagList (enw_Extension). Added safety check as done by OS-Routines. Further enw_Extension [OpenWindow()] and ens_Exension [OpenScreen()] aren't cleared anymore. - Some new Options: "ICONFONT": Font used to print Icons' TitleText. "ICONPOS_SPACEX": Space between Icons (AUTO_?? only) "ICONPOS_SPACEY": Space between Icons (AUTO_?? only) - External Routines can now get Parameters - You can no longer iconify a Window that is already completely out of Screen (=iconified). - DEADLOCK_PRI did not work - The Task-Checking Routine called MatchPattern() (or MatchPatternNoCase() ) regardless whether the calling Task was a Process or not. Now if a Window/Screen is opened by a Task the Entries in the Task-Lists which have WildCards aren't checked at all. - The workaround for the Screens' Depth-Gadget (which was necesseray to fix the scrolling one pixel to the left thing) is no longer necessary. I must admit that it was not a bug in MCP, but in my Routine: I did not check whether the Gadgets' Image had a LeftEdge <> 0! - Created two external IconRenderers: o "Mac_IconRenderer" o "Mac2_IconRenderer" These Routines can be passed some Parameters. Read the @{" External Routines " LINK "ERO"}-Chapter! - PW's EasyRequestArgs() Patch caused an Enforcer Hit (LONG READ from 0) when idcmpflags was NULL. - Now if an opened Layer has it's LAYERREFRESH Bit set (because of PW moving it to the Front) PW clears it by calling BeginUpdate() and EndUpdate() instead of simply clearing the Bit. - Implemented @{B}MULTI-ACTIONS@{UB}. It's now possible to iconify and de-iconify more Windows all at once by moving around with the Mouse. All Windows/Icons you touch will be iconified (or de-iconified). Check this out - it's incredible!!!! @{B}V 1.1@{UB} @{FG SHINE}08.06.97@{FG TEXT}: - Made Opaque Moving faster. - Windows are opened faster - Changed the way PW kills Refreshes (when opening a Window) again. Now it's done the MCP way. - MULTI ACTION Mode rendered into Window-RastPort instead of Border-RastPort when a window was GZZ. - New Option "RefreshIT". Icon-Title will be refreshed when the title of its parent Window changes. - It's now possible to prevent PowerWindows from being started by holding down LEFT ALT + LEFT SHIFT + LEFT MOUSEBUTTON. So if the computer crashes during Boot you don't have to boot from a disk anymore. - Added some improvements/options to the preferences program. - New IconRenderer: "Ami_IconRenderer". The Icons get the standard Amiga Window Look. @{B}V 1.1.1@{UB} @{FG SHINE}??.??.??@{FG TEXT}: - Fixed a very big and stupid bug that caused strange @{I}PowerWindowsUp.lha@{UI} Screen-Effects (Mouse could be moved only in the left quarter of the screen and it was possible to vertically autoscroll the screen out of it's limits). - Now PowerWindows quits when you try to start it while it is already active. - MULTI Action Mode did not work if "No out of Screen" or some qualifier for (normal) Out-of-Screen draggings was used. - You did not get opaque moving if "No out of Screen" or some qualifier for (normal) Out-of-Screen draggins was used. - New utility: Waiter - New utility: CyReq - this program should make all the requester improvers (ARQ), Assign-Wedges and requester replacers (Workbench-Copyright) work again when PW is used. - New Option: "NOREQPATCH" - should make requester improvers/replacers and assign-wedges work again. Can only be used if CyReq (from PowerWindows/Tools/Shell) or a requester improver (ARQ) is installed on the computer. - Now at least a 68020 is required - Improved PW_Prefs (PrefsAttack) a little bit @{B}V 1.2@{UB} @{FG SHINE}??.??.??@{FG TEXT}: - PowerWindows is now much smaller because the routines that are used to scan the config-file are in a separat file which will be loaded into memory by PowerWindows when requiered and removed from memory immediately after config scanning is terminated. - Corrected some small bugs in Ami_IconRenderer - Fixed one small bug - New Option: "NOICONDRAG" - it makes the icons undragg- able but allows de-iconifying them with a single mouse click. "NOICONDRAG" can be disactivated temporary by holding down control when clicking on an icon, so the icon can be dragged anyway. - SCANSCREENS now also scans the windows. So if you start PowerWindows the already open windows will get an iconify gadget automatically - no more need to close and reopen windows - It's now possible to enable/disable Out-of-Screen draggings with the Disable/Enable Button in Exchange. Iconifying and de-iconifying is not affected by this. - If the width of the icons is specified as "/" now the real icon width will be calculated by using the visible and not the real width of the screen (important for large autoscrolling screens): Real icon width = visible screen width * a / b - Depth Gadgets should finally work correctly, again. This was rather complicated and might eventually cause some trouble with certain programs that create Depth Gadgets themselves. - New Marker Look: EXTENDED - Check it out!!! - Did some big improvements to the this guide especially to the Configuration node. - It's now possible to invert the POPTOFRONT option while PW is running. To do this hold down one of the shift keys while de-iconifying a window. For example if you have activated POPTOFRONT in your config (which means that de-iconified windows will be automatically brought to front) and hold down shift while double-clicking the icon the de-iconified window will not be brought to front. If POPTOFRONT was not activated in your config it's the other way round: holding down shift will force de-iconified windows to be brought to front. - New iconify gadget look: SYSIMUI ==> the gadget will look like the MUI iconify gadgets when MCP's SysiHack option is activated. @ENDNODE @NODE "Future" "Future" @TOC "Main" No Future. Too busy with AROS. See http://www.aros.org! @ENDNODE @NODE "Author" "Author" @TOC "Main" @{U}PowerWindows was created by:@{UU} Georg Steger Hochlercher 30 I-39030 St. Johann SOUTH TYROL - ITALY @ENDNODE @NODE "Credits" @TOC "Main" @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ T H A N K S F L Y T O @{FG SHINE}___________________________________________________________________________@{FG TEXT} ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ - All registered users - Luca Longone for correcting the icons (size, palette) - Stefan Stuntz for MUI which is used by the PowerWindows preferences pro- gram (PW_Prefs) - All people who have sent me bug reports, comments, suggestions, etc. @ENDNODE @NODE "OtherStuff" "Other Software created by Georg Steger" @TOC "Main" @ENDNODE