dwarf

****************************
* Dwarf.dll version 1.12   *
****************************

1. Introduction
~~~~~~~~~~~~~~~~

What is Dwarf.dll? It is a Litestep system module that allows you to run modules, 
shortcuts, folders, and folders with subfolders anywhere on your desktop.

2. Installation
~~~~~~~~~~~~~~~~

# = group number
T = always on top
H = hide window
V = vertical folder/horizontal subfolders(default is horizontal folder/vertical subfolders
D = dock dwarf to active window

Add Dwarf.dll to your step.rc:

	LoadModule C:\LITESTEP\Dwarf.dll

Add modules and shortcuts like the following:

	*Dwarf #<#TH> "name" x-position y-position bitmap width height module/program/bang-command arguments

	example:
	*Dwarf #1T "wharfpong" 64 64 .none 64 64 @C:\litestep\modules\wharfanoid.app
	*Dwarf #1H "LSWallpaper" 128 128 LSWallpaper.bmp 32 32 @C:\litestep\modules\LSWallpaper.dll
	*Dwarf #2D "Step.RC" 64 256 .none 64 32 notepad C:\LITESTEP\step.rc
	*Dwarf #2T "Shutdown Windows" -256 -256 b24_shutdown.bmp 64 64 !Shutdown

Add folders and subfolders like the following:

	*Dwarf #<#THV> "name" x-position y-position bitmap width height Folder
		*Dwarf "name" bitmap module/program/litestep-bang-command arguments
		*Dwarf "name" bitmap Folder
			*Dwarf "name" bitmap module/program/litestep-bang-command arguments
			*Dwarf "name" bitmap module/program/litestep-bang-command arguments
		*Dwarf ~Folder
		*Dwarf "name" bitmap module/program/litestep-bang-command arguments
	*Dwarf ~Folder

	example:
	*Dwarf #3V "Development" 256 256 b24_apps.bmp 32 16 Folder
		*Dwarf "Borland C++" bc5.bmp "C:\BC5\BIN\bcw.exe"
		*Dwarf "System Folder" b24_sys.bmp Folder
        		*Dwarf "Recycle" b24_recycle.bmp !Recycle
        		*Dwarf "Step.rc" b24_folder.bmp notepad C:\LITESTEP\step.rc
			*Dwarf Explorer b24_explorer.bmp explorer.exe
		*Dwarf ~Folder
		*Dwarf "Visual Basic" vb5.bmp "C:\Program Files\DevStudio\VB\vb5.exe"
		*Dwarf "Development"  b24_apps.bmp Folder
			*Dwarf "Borland C++" bc5.bmp "C:\BC5\BIN\bcw.exe"
			*Dwarf "Visual Basic" vb5.bmp "C:\Program Files\DevStudio\VB\vb5.exe"
		*Dwarf ~Folder
		*Dwarf "Visual C++" metal_visualc.bmp "C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\MSDEV.EXE"
	*Dwarf ~Folder

3. How to use
~~~~~~~~~~~~~~

When dragging is enabled, a right click on the Dwarf will then allow you to move it(make sure to give it a good 
right click-seems to be picky). To stop moving it, click the left mouse button. If the module has a right click menu,
it will appear after the left click. The new coordinates are stored in the modules.ini under section [Dwarf] with
the window name followed by the coordinates separated by a slash.(Ex. WharfPong=256/345)

step.rc options:
		
	DwarfNoAnim			;turns off folder/subfolder animations
	DwarfAnimStep ##		;sets the folder/subfolder animation step to ##(defaults to 64)
	DwarfAnimDelay ##		;sets the folder/subfolder animation time delay to ##(defaults to 10)
	DwarfNoHints			;turns off Dwarf hints
	DwarfCloseOnSwitch		;causes all folders/subfolders to close when focus switches to another window
	DwarfBackPic bitmap		;sets a default bitmap to show behind every main Dwarf
	DwarfFolderBackPic bitmap	;sets a default bitmap to show behind all folder/subfolder items
	DwarfFolderPic bitmap		;sets a default bitmap to show behind all folders/subfolders
	DwarfEnableDrag			;enables dragging of Dwarfs
	DwarfDockPosition POS		;where on the active window you want your docked dwarfs to be
						;where POS is one of the positions below
	DwarfDockOffsetX ##		;offsets the horizontal position of the docked dwarfs by ##
	DwarfDockOffsetY ##		;offsets the vertical position of the docked dwarfs by ##

internal bang commands:

	!DwarfCloseFolder		;can only be used by a dwarf tile in a folder/subfolder to close the folder it is in

bang commands:

	!DwarfShow #			;shows group #
	!DwarfHide #			;hides group #
	!DwarfToggleShow #		;toggles show/hide for group #
	!DwarfToggleTopmost #		;toggles topmost/not topmost for group #
	!DwarfToggleDrag		;toggles enable/disable of dragging

Docking Positions:

	POS	DESCRIPTION
	---------------------------------
	These positions are on the outer edge of the active window:
	LT	left side top edge
	LB	left side bottom edge
	RT	right side top edge
	RB	right side bottom edge
	TL	top side left edge
	TR	top side right edge
	BL	bottom side left edge
	BR	bottom side right edge
		
	These positions are in the titlebar of the active window:
	TBL	titlebar left edge
	TBR	titlebar right edge

4. Known Problems
~~~~~~~~~~~~~~~~~~

	- Some modules do not work in folders/subfolders. This is a problem with the module not Dwarf.dll.
	- LSTime.dll is not transparent in a Dwarf. Have not figured this one out yet.
 
5. Bug reports/suggestions
~~~~~~~~~~~~~~~~~~~~~~~~~~~

	You can email me at crouson@inreach.com with bugs and suggestions or comments.

6. Future Plans
~~~~~~~~~~~~~~~~

	Your comments and suggestions are welcome.

7. Credits/Thanks
~~~~~~~~~~~~~~~~~~

	Thanks to the LSDEV team for LITESTEP and releasing the source, since Dwarf.dll is 
	a major tweak of the wharf.dll.
	Thanks to the guys on IRC channel #ls_help for their input on version 0.7, you know
	who you are :)
	Thanks to dissipate for the dock to active window idea and his input.

8. Contact
~~~~~~~~~~~

	Jeb Crouson (aka TrOgI)
	http://desktopsource.mindjunction.com
	email - crouson@inreach.com

( source: Dwarf.txt )