
    --------------------------------------------------------------

                           bbLeanSkin 1.16

            bbLeanSkin is a plugin for Blackbox for Windows.
      Copyright  2003 grischka <grischka@users.sourceforge.net>

                 http://bb4win.sourceforge.net/bblean
                    http://bb4win.sourceforge.net/

     bbLeanSkin is free for non commercial use and distribution.
                 The author disclaims all warranties.

    --------------------------------------------------------------

    Contents:
    ---------
    1) Upgrade notes
    2) Get it running
    3) Settings for the bbLeanSkin Engine
    4) Broadcast messages
    5) Excluding applications
    6) Known Restrictions
    7) Credits
    8) Disclaimer


    1) Upgrade notes
    ----------------

    Make shure to replace both bbLeanSkin.dll and bbLeanSkinEng.dll.
    Sometimes bbLeanSkinEng.dll is locked by the OS even when it's
    not loaded. In this case you need to reboot your system.

    The configuration file has been renamed to 'bbleanskin.rc'.

    The broadcast messages got a dot separator for consistency.
    Please update your menu.rc.

    The rollup (shade) style now defaults to the original blackbox 
    behaviour, but is still configurable.

    For the developer's convenience this works on bbLean only.


    2) Get it running
    -----------------

    To run bbLeanSkin, just load "bbLeanSkin.dll" from bbLean's
    plugin menu, or add it manually to plugins.rc.

    bbLeanSkin doesn't come with any visual elements. For
    configuration see and edit the included bbLeanSkin.rc.


    3) Settings for bbLeanSkinEng.dll
    ---------------------------------

    See 'bbLeanSkin.rc' for more info.


    4) Broadcast messages for bbLeanSkin
    ------------------------------------

    @bbLeanSkin.ToggleLog
    @bbLeanSkin.ToggleSkin
    @bbLeanSkin.About

    Snippet to be included into the menu:
    [submenu] (bbLeanSkin)
        [exec] (Toggle Log)         {@bbLeanSkin.ToggleLog}
        [exec] (Toggle Skin)        {@bbLeanSkin.ToggleSkin}
        [edit] (Edit Exclusions)    {plugins\bbleanskin\exclusions.rc}
        [edit] (Edit Settings)      {plugins\bbleanskin\bbleanskin.rc}
        [edit] (Readme)             {plugins\bbleanskin\readme.txt}
        [exec] (About)              {@bbLeanSkin.About}
    [end]


    5) Excluding applications from beeing skinned
    ---------------------------------------------

    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.

    With the menu from above:
        Click 'Toggle Log', then 'Toggle Skin' twice.

    Manually:
        In bbLeanSkin.rc, set: bbLeanSkin.option.enableLog: true
        Restart blackbox.

    Copy the appropriate information from the log-window
    into extensions.rc:

        program             to exclude all windows from 'program'
        program:classname   to exclude only that window from 'program'
        *:classname         to exclude all windows with 'classname'
        (Supported wildcards are ? and *)

    Restart the skinning engine to make the exclusions take effect.

    6) 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

    - Some windows are not skinned at all. (for example cmd.exe).


    7) 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.


    8) 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!
    27 Apr 2005 -- grischka

