Desktop version 2.0 ~~~~~~~~~~~~~~~~~~~ Table of Contents ----------------- Part 1 - Introduction Part 2 - What's New Part 3 - Installation Part 4 - Step.rc Commands a) SetDesktopArea b) SDALeft c) SDARight d) SDATop e) SDABottom f) AutoPlay g) EmulateMiddleButton h) RightSingleClick i) LeftSingleClick j) MiddleSingleClick k) RightDoubleClick l) LeftDoubleClick m) MiddleDoubleClick Part 5 - Usage Part 6 - Problems/Incompatibilities Part 7 - Bug Reports/Suggestions Part 8 - Version History Part 9 - Future Plans Part 10 - Credits/Thanks Part 1 - Introduction What is this? It's a port of a core LiteStep module that I wrote as the desktop modules released with LiteStep have a basic incompatibility with DarkStep. That is not to say that third-party LS desktop modules like jugg's excellent jDesk don't work with DarkStep as jugg assures me that his current dev build works fine with DarkStep but as he hasn't released it yet, I am doing this quick-and-dirty port of the LS Desktop.dll in native DarkStep format. In doing this module, I decided to strip out functionality that I believed should be better handled by a separate module such as Systray and Taskbar as some people use them while others might prefer a different option. The resulting Desktop.dll is a lean module though it doesn't do much except to allow you to right-click on your desktop to activate the popup, turn on (or turn off) autoplaying of CDs and set your available desktop area. If you want lots of functionality, you are probably better off using jugg's jDesk, if it works with your DarkStep set up. Part 2 - What's New + Added the binding of !bang commands to mouse single and double clicks + Added middle mouse button emulation for !bang binding if you press both mouse keys together + Added the creation of a shortcut in the desktop folder for any file(s) dragged to the deskop Part 3 - Installation a) Copy desktop.dll to your DarkStep directory. b) Add the line LoadModule C:\DarkStep\Desktop.dll to the [Startup] section of your step.rc file. C:\DarkStep\ being your DarkStep directory. c) Add a [Desktop] section to your Step.Rc and add any settings you desire as described in Part 4. d) Recycle DarkStep with the !Recycle bang command. Part 4 - Step.rc commands In order to configure how Desktop works on your system, you have to add a [Desktop] section to your DarkStep Step.Rc. These are the valid settings for Desktop: a) SetDesktopArea [on/off] Specifies whether to set the available desktop area or not. This is a boolean setting and you have to specify 1 or on to enable the setting or 0 or off to disable it. You MUST have this variable set to on or 1 to use the SDA* commands listed below. Default: off ex: SetDesktopArea on b) SDALeft n Specifies the upper left X coordinate for your desktop work area where n is the number: Default: 0 ex: SDALeft 15 c) SDARight n Specifies the bottom X coordinate for your desktop work area where n is the number. If you specify 0, the whole width of the screen will be taken and if you specify a negative value, it subtracts the amount specified by the value from the rightmost edge. Default: 600 ex: SDARight 590 d) SDATop n Specifies the upper left Y coordinate for your desktop work area where n is the number. Default: 0 ex: SDATop 10 e) SDABottom n Specifies the bottom Y coordinate for your desktop work area where n is the number. If you specify 0, the whole height of the screen is assumed and if you specify a negative value, that amount is subtracted from the screen height. Default: 450 ex: SDABottom 500 f) AutoPlay [on/off] This is a boolean value which specifies whether to turn auto-playing of CD's on or off. You have to use on or 1 after AutoPlay to turn it on and off or 0 to turn it off. Default: off. ex: AutoPlay off g) EmulateMiddleButton [on/off] This is a boolean setting which specifies whether to take a simultaneous clicking of both the right and left buttons to mean a middle-button click for those people who don't posess a three button mouse. Default: off. ex: EmulateMiddleButton on h) RightSingleClick This setting is used to bind a single !bang command or an executable or a mixed series of !bang commands and executables separated by ^ (but with no spaces before or after the ^) to a single right mouse click. Default: nothing. ex: RightSingleClick !about^!banglist i) LeftSingleClick This setting is used to bind a single !bang command or an executable or a mixed series of !bang commands and executables separated by ^ (but with no spaces before or after the ^) to a single left mouse click. Default: nothing. ex: LeftSingleClick "C:\Program Files\Utility\Program.Exe" j) MiddleSingleClick This setting is used to bind a single !bang command or an executable or a mixed series of !bang commands and executables separated by ^ (but with no spaces before or after the ^) to a single middle mouse click. Default: nothing. ex: MiddleSingleClick !about^"C:\Program Files\UltraEdit\UEdit32.exe" C:\DarkStep\Step.Rc k) RightDoubleClick This setting is used to bind a single !bang command or an executable or a mixed series of !bang commands and executables separated by ^ (but with no spaces before or after the ^) to a double right mouse click. Default: !popup ex: RightDoubleClick !about^!banglist l) LeftDoubleClick This setting is used to bind a single !bang command or an executable or a mixed series of !bang commands and executables separated by ^ (but with no spaces before or after the ^) to a double left mouse click. Default: nothing. ex: LeftDoubleClick !about^!banglist m) MiddleDoubleClick This setting is used to bind a single !bang command or an executable or a mixed series of !bang commands and executables separated by ^ (but with no spaces before or after the ^) to a double middle mouse click. Default: nothing. ex: MiddleDoubleClick !about^!banglist Part 5 - Usage Aside from handling desktop area and the autoplaying of CDs, desktop.dll also handles any mouse clicks on the desktop. Initially, desktop.dll does nothing with regards to mouse clicks as you have to define what actions are to be performed for each type of mouse click. Currently single or double clicking of right, left and middle buttons can be bound to a !bang command or executable (or a series of !bang commands and executables separated by ^ with no spaces in between). For those of you who don't have a middle mouse button (like me ) you can enable middle-button emulation by setting EmulateMiddleButton=on in the Step.Rc and then when you click both left and right buttons simultaneously, it is taken to be equal to a middle-button click. Note that you cannot bind a middle-button double-click when you use middle-button emulation. Part 6 - Problems/Incompatibilities - You cannot bind middle-button double-clicking when using middle-button emulation - You cannot drag and drop to the desktop to create a Windows shortcut when the LiteStep shortcut.dll (or EasyCuts) is loaded as that creates an LS shortcut. Part 7 - Bug Reports/Suggestions There are several ways to get support or to offer suggestions: - You can stop in #ds_help on any EFNet IRC server and ask one of the ops - You can join the support@darkstep.com (http://darkstep.com/mailman/listinfo/support) or darkstep@darkstep.com (http://darkstep.com/mailman/listinfo/darkstep) mailing lists - You can use the web board at www.darkstep.com - You can e-mail me at FahimF@email.com Part 8 - Version History 2.0 (10 Nov 1999) + Added the binding of !bang commands to mouse single and double clicks + Added middle mouse button emulation for !bang binding if you press both mouse keys together + Added the creation of a shortcut in the desktop folder for any file(s) dragged to the deskop 1.0 (25 Nov 1999) - This is brand new port and so we are starting with version 1.0 :-) * Converted all the API calls to use the DSAPI instead of LSAPI Part 9 - Future Plans No further plans at the moment but may want to add the ability to drag and drop URLs on to the desktop :-) Part 10 - Credits/Thanks - demigod, Bob Wells, TinOmen, Dethnite and all the other beta testers who've always been so helpful Fahim (FahimF@email.com) Desktop documentation rewritten and formatted by demigod for Fahim Farook. contact: demigod@darkstep.com last updated: 12/1/99 9:57AM