BBTrans 0.5 [elephant]
description
BBTrans is a Blackbox for Windows plugin that adds transparency support to the Toolbar and Menus. Also allows the user to add transparency to any window they can place their mouse over.

Requires Windows 2000/XP
not sure what versions of BB4Win this will work on. Tested it with 0.0.82 and the nightlies.

Encouraging innovation through laziness for a better tomorrow.

Tres`ni

revision history

BBTrans 0.5 [elephant] (2003-06-15) / ironhead

  • Added support for BBSlit
  • BBTrans 0.4 [dingo] (2003-06-13) / Tres`ni

  • Added support for BBSystemBar
  • BBTrans 0.3 [cricket] (2003-06-03) / Tres`ni

  • Initial Public Release
  • Added bro@m support
  • Added support for "other" windows
  • Compiled a "lite" version for non-nightly users
  • BBTrans 0.2 [badger] (2003-??-??) / Tres`ni

  • First Beta
  • BBTrans 0.1 [alligator] (2003-??-??) / Tres`ni

  • First Alpha
  • future releases?
  • [your wish goes here - send me your ideas! :D ]
  • license information
    © 2003 Brian A. Hartvigsen [Tres`ni]

    BBTRANS IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE AUTHOR DISCLAIM 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.

    initial setup

    If your run:
      a nightly BBTrans.dll
      BB4Win .82 or earlier BBTrans_82.dll

    To load BBTrans you simply need to add the relative path of the plugin (from your Blackbox directory) to the Blackbox configuration file plugins.rc (located in the Blackbox directory). For example, if you installed Blackbox into c:\Blackbox, and BBTrans.dll is located in c:\Blackbox\plugins\BBTrans, you should add the line...

    plugins\BBTrans\BBTrans.dll

    ...to plugins.rc. Simple, eh? :)

    how to use BBTrans...

    BBTrans creates no window, is not slitable, and has no visual interface what-so-ever. Just add it to your plugins.rc and set it up (read below)

    BBTrans.rc settings

    Configuration goes in the BBTrans.rc file. If a configuration file for some reason (e.g. you deleted it <g>) can not be found at startup (BBTrans will first search for it in the same directory as the plugin, then in the Blackbox directory), BBTrans will load with default settings of all transperancy disabled.
    bbtrans.toolbar.alpha.value: 60  transparency level for the toolbar
    bbtrans.toolbar.alpha.enabled: false  transparency enabled for the toolbar
    bbtrans.systembar.alpha.value: 60  transparency level for BBSystemBar
    bbtrans.systembar.alpha.enable: true  transparency enabled for BBSystemBar
    bbtrans.menu.alpha.value: 60  transparency level for menus
    bbtrans.menu.alpha.enabled: false  transparency enabled for menus
    bbtrans.slit.alpha.value: 60  transparency level for BBSlit
    bbtrans.slit.alpha.enabled: false  transparency enabled for BBSlit
    bbtrans.window.alpha.value: 60  transparency level for "other" windows

    Systembar properties will default to the toolbar levels.

    If you are using a nightly then BBTrans will save any settings you change throught bro@m execution. Settings are not saved for BB4Win 0.82 or earlier.

    BBTrans bro@ms

    @BBTrans SystembarEnabled  Enable BBSystembar transparency
    @BBTrans SystembarDisabled  Disable BBSystembar transparency
    @BBTrans SystembarToggle  Toogle BBSystembar transparency
    @BBTrans SystembarAlpha [level]  Set BBSystembar transparency to [level]
    @BBTrans ToolbarEnabled  Enable Toolbar transparency
    @BBTrans ToolbarDisabled  Disable Toolbar transparency
    @BBTrans ToolbarToggle  Toogle Toolbar transparency
    @BBTrans ToolbarAlpha [level]  Set Toolbar transparency to [level]
    @BBTrans MenuEnabled  Enable Menu transparency
    @BBTrans MenuDisabled  Disable Menu transparency
    @BBTrans MenuToggle  Toggle Menu transparency
    @BBTrans MenuAlpha [level]  Set Menu transparency to [level]
    @BBTrans SlitEnabled  Enable BBSlit transparency
    @BBTrans SlitDisabled  Disable BBSlit transparency
    @BBTrans SlitToggle  Toggle BBSlit transparency
    @BBTrans SlitAlpha [level]  Set BBSlit transparency to [level]

    These bro@ms apply to the window you have your mouse over:
    @BBTrans WindowEnabled  Enable transparency on window
    @BBTrans WindowDisabled  Disable transparency on window
    @BBTrans WindowToggle  Toggle transparency on window
    @BBTrans WindowAlpha [level]  Set "other" window transparency level to [level]

    acknowledgements
    It's my birthday yesterday..