bbLeanSkin 1.17 *************** bbLeanSkin is a plugin for Blackbox for Windows. Copyright © 2003-2009 grischka <grischka@users.sourceforge.net> http://bb4win.sourceforge.net/bblean http://bb4win.sourceforge.net/ This program is free software, released under the GNU General Public License (GPL version 2). For details see: http://www.fsf.org/licenses/gpl.html THIS PROGRAM IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT WITHOUT ANY WARRANTY, WITHOUT EVEN THE IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Get started ----------- To run bbLeanSkin, just load 'bbLeanSkin.dll' from bbLean's plugin menu, or add it manually to plugins.rc. Configuration ------------- bbLeanSkin doesn't come with any visual elements. For configuration edit bbLeanSkin.rc. Also you can ínsert a submenu for bbleanskin into your main menu using this line: [include] {plugins\bbLeanSkin\menu.rc} These are the broadcast messages that bbLeanSkin recognizes: @BBLeanSkin.ToggleLog @BBLeanSkin.ToggleSkin @BBLeanSkin.buttonOrder 400321 @BBLeanSkin.buttonGlyphs my_buttons.bmp @BBLeanSkin.About See 'bblsmenu.rc' for details. Button Glyphs ------------- You can now make and set your own button glyphs for the titlebar buttons. The bitmap image may be set up for glyphs from 9x9 to 17x17 max. The image size is calulated like: width: 6*(N+1)+1 height: 2*(N+1)+1 For example for 11x11 usuable area, the bitmap needs to be 73x25. Exclusion List -------------- bbLeanSkin is supposed to run fine with most programs, on all windows versions. But there are still chances that some applications dont like to be skinned. Some come with their own skins, others dont behave well for other reasons. To exclude a program, you need to add it's name to exclusions.rc. The names to put there are *not* always identic to the exe-names. For that reason bbLeanSkin comes with a built-in log window where it lists windows with their internal names. To enable the Log Window, either: - From the bbLeanSkin configuration menu click 'Toggle Log', then 'Toggle Skin' twice. - Or set the option in bbLeanSkin.rc manually and reconfigure blackbox: 'bbLeanSkin.option.enableLog: true' Best is to copy & paste the names directly from the log window into extensions.rc. To make the exclusions take effect, un/reload the plugin or restart blackbox, or click 'Toggle Skin' twice as above. Known Issues ------------ - With slim titlebars, there may be left some pixels space between maximized windows and the top of the screen. To avoid this, try this option. bbLeanSkin.option.adjustCaptionHeight: true Note however that this may effect to distortion with icons drawn within certain applications. (Because the caption size influences the system default icon size, and some apps use that size for their icons, and non-standard-sized icons generally don't look so good.) - When blackbox is run over explorer, the windows taskbar might have changed metrics afterwards. To fix this, reset your windows theme from the display properties. - Some windows are not skinned at all. (for example cmd.exe). - bbLeanSkin may cause conflicts with virus protection software (hanging of crashing applications). If you don't need it, uninstall that software, it will make your computer run faster and more stable anyway. Credits ------- - Thanks to the developer of CustomEyes, Didier Abderrahmane (http://dabder.free.fr/CE/), from his code I learned the principles. - To the developers of BBWinSkin, seeing their program running finally convinced me that the result makes it worth to start. - And to the makers of EFX, who proved, that a program like this can work reasonably stable. Disclaimer ---------- BBLEANSKIN IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE AUTHOR DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE AUTHOR OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF THE AUTHOR OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ************************************************************ Dont use bbLeanSkin, when you work on important data! ************************************************************ Okay, that's it. Now, enjoy! 20 May 2009 -- grischka