BBSoundFX v2
description
BBSoundFX is a Blackbox for Windows plugin that plays sound effects (.wav) for Blackbox events such as task switching, menu actions and reconfigure. It does this by subscribing to the applicable Blackbox messages, and then it lurks in the dark until it receives one of them... :) As of version 2, it can also play a sound each hour/half-hour, which is really useful during those pre-release coding sessions when time seems to stand still, but actually doesn't... <g>

Please note that BBSoundFX requires
Blackbox for Windows 0.0.70 or later.

Enjoy! :D

Today is yesterday's tomorrow.

qwilk

revision history
BBSoundFX v2 (2003-01-26) / qwilk
  • Added hour (hour.wav), half-hour (halfhour.wav)
          and windowshade (winshade.wav) sound effects
  • Added @bbsfxToggle broadcast message to
          enable/disable sound effects
  • Added @bbsfxAbout broadcast message to show
          version information
  • BBSoundFX v1 (2002-11-24) / qwilk

  • Original release
  • future releases?
  • Support for more events?
  • [your wish goes here - send me your ideas! :D ]
  • license information
    © 2002-2003 Karl-Henrik Henriksson [qwilk]

    BBSOUNDFX 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

    To load BBSoundFX 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 BBSoundFX.dll is located in c:\Blackbox\plugins\BBSoundFX, you should add the line...

    plugins\BBSoundFX\BBSoundFX.dll

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

    how to use bbsoundfx...

    Well, there's no actual configuration of this plugin. During startup/restart BBSoundFX will check if the following files are present in the same folder as the plugin:

    menu.wav Played when menus are opened (main, workspace, toolbar and plugin menus)
    submenu.wav Played when submenus are accessed
    restore.wav Played when tasks are restored (using the taskbar or the task switch buttons)
    minimize.wav Played when tasks are minimized (using the taskbar)
    workspace.wav Played when changing workspaces
    toggletray.wav Played when the system tray / taskbar is toggled (shown/hidden)
    reconfigure.wav Played when changing styles and on Blackbox reconfigure command
    hour.wav Played every hour
    halfhour.wav Played every half-hour (and full hours if hour.wav does not exist)
    winshade.wav Played when windows are shaded/unshaded

    If a specific file is present that sound event is enabled; if not it is disabled. If the sound event is enabled at startup/restart it is also possible to change sounds "on-the-fly" while running, i.e. by replacing the files with others (keeping the filenames above, of course).

    Finally, you can control BBSoundFX using the following broadcast messages (bro@ms):

    @bbsfxToggle Enable/disable sound effects
    @bbsfxAbout Show BBSoundFX version information

    Hmm, I guess that's it! :D