HoverDesk Tutorial - The Command Line Plugin
Back to Contents Page

The Command Line Plugin.

Well unless you've skipped ahead you should notice we started with the easiest plugin and we'll end with the most difficult(ish) plugin to skin.
Next we'll skin the command line.


The command line is a simple plug which acts the same way your run.exe works in windows.

Type a URL into it, hit return and it will open your web browser at that page.
Type a folder path, hit return and it will open the folder for you.
Type an application path (e.g.. explorer.exe) hit return and it will open Windows Explorer for you.

To skin this we have to drop a texture on it then configure the modules.ini file to make the plugin fit the texture.
Rather than dropping a texture on it we will use the .ini file to configure every part of the plugin (including the textures). We need all the practice we can get!! =]


OK, so first right click the main tile and from the pop up menu select plugins then HoverCommand (HDCMD.dll)
The command plugin will appear on the desktop in position 0,0 (top left corner) in it's default state.



Right click the main tile again and from the pop up menu select plugins then HoverCommand (HDCMD.dll) again.
This will unload the plugin and write the necessary information to the modules.ini file.

Once more right click the main tile and from the pop up menu select plugins then HoverCommand (HDCMD.dll)
The command plugin will appear on the desktop in position 0,0 (top left corner) in it's default state again.

Configuring the modules.ini File


Shift and drag the command line to an area we can work with it.
Now navigate to the Pixel Perfect theme folder and open the file called modules.ini

It's simply a matter of filling and adjusting the modules.ini file to make the plugin fit the texture.

Please use the settings in the screenshots.
Save the file after each screenshot then right click the plugin and select reload settings.


arrowbmp = the name of the file to be used for the menu arrow
posx = the offset position horizontally of the text area
posy = the offset position vertically of the text area
cmdwidth = the width the text area will occupy
CMDColor = background color for the text area *NOTE the text area for the command plugin must be one solid color. HoverCommand (HDCMD.dll) does not support 'transparent' text areas (to the bmp) Think of it like QuickNotes ;)
BorderColor = a one pixel border around the text area
FontColor = specifies the color to be used for the font.

trans = select 0 if your bmp does not contain any pink, select 1 if it does contain pink.
texture = the name of the bmp file to be used for the command background.


Move onto the next screenshot and repeat.

Your command line plugin should now be looking like the one below.
You can edit the modules.ini file to change the color of the font. Look for the line FntColor = 0,0,0 and change the 0,0,0 to reflect the color wish to apply.

Tip: You can make the command plugin 'popup' by attaching it to a predefined tile. Either attach it directly to the tile or use theme debug mode to make the plugin popup anywhere on the desktop.


Tip: When I have my plugin configured correctly I exit HVD then reopen it.
This ensures the settings are saved.