Deranged Coder's DeskMate v1.0
What is it?
This application displays a floating image on your desktop.
How do I use it?
To start it, in Windows Explorer double-click on DeskMate.exe or from a command prompt, change directory into the directory that contains the DeskMate files and type DeskMate.exe.
Keyboard shortcuts:
- Ctrl + O: Open an image
- Ctrl + D: Decrease transparency
- Ctrl + I: Increase transparency
- Ctrl + X: Exit the application
- Ctrl + F: Toggle fit image to screen
- Ctrl + E: Enlarge image
- Ctrl + S: Shrink image
- Ctrl + R: Restore image to original size
- Ctrl + T: Toggle click through
- Ctrl + N: Bring up the settings page
- F1: Bring up the About box
Mouse shortcuts
- Right-click: Bring up a popup menu
- Click and drag: Move the application to another spot of your desktop
- Double-click: Open an image
- Scroll wheel up: Decrease transparency
- Scroll wheel down: Increase transparency
- Shift + Scroll wheel up: Enlarge
- Shift + Scroll wheel down: Shrink
- Drag-drop an image from Windows Explorer: Open the dropped image
Note that if "click through" is enabled, then the application will no longer respond to mouse or keyboard input and the only way to gain access to these commands is through the popup menu of the system tray icon. The system tray icon will only be shown if "click through" is active, unless AlwaysShowTrayIcon is set to True in the .ini file.
Can I create/use my own images?
To load an image, either drag-drop it from Windows explorer, or bring up the Open Picture dialog to select an image to load by double-clicking on the application, entering Ctrl + O from the keyboard or right-clicking and selecting 'Open Image' from the popup menu.
When creating an image for use with DeskMate, be aware that the application uses the color of the upper-left most pixel of the image and selects that as the 'transparent' color so for best results, make sure that the selected image has a solid color background and the background color is distinct from the rest of the image. For maximum compatibility, the 'transparent' color (i.e. background color) should be a basic color. A color is considered a "basic" color if the R, G and B values are either 0x00 or 0xFF. Thus, the colors recommended for use for the background are:
- Black - 0x000000
- Red - 0xFF0000
- Lime - 0x00FF00
- Blue - 0x0000FF
- Yellow - 0xFFFF00
- Fuchsia - 0xFF00FF
- Aqua - 0x00FFFF
- White - 0xFFFFFF
Bitmap (*.bmp) and Portable Network Graphics (*.png) images are supported.
What other settings can I modify?
The default settings for this application can be changed going to the Settings page from the popup menu or by directly modifying the accompanying .ini file.
Supported Operating Systems
This program is designed to run on Windows 2000 and higher. On older versions of Windows operating systems, the program will still run but transparency will not be supported.
Frequently Asked Questions
Q. How can I move the image if 'click-through' is enabled?
A. Disable 'click-through', drag the image to the new location on screen, then re-enable 'click-through'.
Q. Will you add GIF support? JPEG support?
A. I don't want to add GIF support due to licensing issues associated with the LZW compression that is used in GIF images. I have no plans to add JPEG support due to the inherent lossy compression found in JPEG images that causes some ugly looking artifacting and wreaks havoc on transparency.
Disclaimer
The author makes no claims as to the stability and reliability of this
program. In short, use this program at your own risk. :-)
Credits
- All MegaTokyo™ characters are the copyrighted work of Fred "Piro" Gallagher. For more information on MegaTokyo™, visit http://www.megatokyo.com/.
- Thanks to Charlii on the Megatokyo™ forums (http://forums.megatokyo.com) for
giving me the idea of writing this in the first place.
- Thanks to all the Megatokyo™ forum members who have been giving me feedback. This program would not have evolved to the state it is now without the feedback that they have generously provided.
- This program was built using Borland Delphi 7 Enterprise Edition. PNG support added through a freely available Delphi PNG library hosted at http://pngdelphi.sourceforge.net/. Source for the TTrayNotifyIcon taken from Chapter 16 of the book, "Delphi 6 Developers Guide".
Revision history
- v1.0 - Cleaned up code, added some exception handlers, added About box, changed readme file from text to HTML format.
- v0.9 - Added a 'Settings' page to provide a GUI for changing settings (no need to manually change the DeskMate.ini file anymore).
- v0.8 - Improved the resize controls (shift + mouse scroll wheel to adjust). Current settings for loaded image, position, etc. are now persisted to the .ini file on application exit.
- v0.7b - Tweaked the click-through code.
- v0.7 - Click-through support added. Added a few more images.
- v0.6 - New icon for the executable. Added a tray icon.
- v0.5 - Added resizing and full screen options. Added more images (including some submissions from other users).
- v0.4b - Fixed a bug in the drag-n-drop support not adjusting the transparency properly. Rewrote the readme.txt file. Added more images.
- v0.4 - Added drag-n-drop file support. Added some more images.
- v0.3 - Added support for Portable Network Graphic (PNG) files.
- v0.2b - Added one more bitmap and included source code into the distribution archive.
- v0.2 - Added some bitmaps into the distribution archive.
- v0.1 - Initial release.