BBIcons 2.00
description
BBIcons is a Blackbox for Windows plugin that creates desktop icons/shortcuts to you favorite programs.

Requires Blackbox for Windows 0.0.81

Encouraging innovation through laziness for a better tomorrow.

Tres`ni

revision history

BBIcons 2.00 / Tres`ni

  • Massive rewrite
  • No icon limit!
  • Read this file to find all the goodies!
  • BBIcons 0.90c (2003-01-30) / Tres`ni

  • Fixed non-drawn bug (actually ironhead fixed it cause I couldn't see my own mistake)
  • Correctly executes commands with arguments
  • BBIcons 0.90b (2003-01-30) / Tres`ni

  • Fixed command parsing..
  • Loads Icons
  • Should show windows correctly
  • BBIcons 0.90a (2003-01-30) / Tres`ni

  • Original release
  • future releases?
  • Tooltips
  • Pressed State for Icons
  • [your wish goes here - send me your ideas! :D ]
  • license information
    © 2003 Brian A. Hartvigsen [Tres`ni]

    BBICONS 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:
      Windows 2000/XP use BBIcons.dll
      Windows 95/98/ME use BBIcons_LE.dll (no transparency support)!

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

    plugins\BBIcons\BBIcons.dll

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

    how to use BBIcons...

    First you will need to set up the BBIcons.rc (or BBIconsrc) file. Without putting settings into here BBIcons is utterly useless. Once an Icon is loaded the following Mouse Commands work:

  • Right Click for settings Menu
  • Left Click to Execute Shortcut [this can be changed to a double click]
  • CTRL + Left Click to Move
  • BBIcons.rc settings

    I have included a default configuration file (BBIcons.rc) in the .zip. If a configuration file for some reason (e.g. you deleted it <g>) can not be found at startup (BBIcons will first search for it in the same directory as the plugin, then in the Blackbox directory), BBIcons will load no icons! (go figure) Icons can be added through bro@m execution..

    Applies to all Icons:
    bbicons.transparency.enabled: false  transparency enabled
    bbicons.transparency.level: 50  transparency level
    bbicons.dblclick: false  double click to execute?
    bbicons.snapicons: false   snap icons together?
    bbicons.snapicons.distance: 8  distance at which icons should snap

    Replace [num] with a number starting at 1 and going to as many as you want ;)
    bbicons.icon[num].cmd: notepad.exe  Command to execute on Left Click (can be a bro@m)
    bbicons.icon[num].arguments: c:\autoexec.bat  arguments to send command (except bro@ms)
    bbicons.icon[num].workingdir: C:\  working directory for command (except bro@ms)
    bbicons.icon[num].ico: path_to_icon  Should we use a differant icon?
    bbicons.icon[num].size: small (default) | medium | large | xlarge  Icon size: 16, 32, 42, 64
    bbicons.icon[num].x: 100  X position
    bbicons.icon[num].y: 100  Y position
    bbicons.icon[num].alwaysontop: false  Always On Top?
    bbicons.icon[num].snapwindow: false  Snap to Screen Edges?
    bbicons.icon[num].transback: false  Should the icon have a transparent backing?

    Please note that BBIcons automatically saves the current running configuration when you quit or restart Blackbox, overwriting the previous contents of the file. So if you have made changes to your BBIcons.rc you want to keep, make sure to do a "Read Settings" before exiting Blackbox.

    BBIcons bro@ms

    Replace [num] with the number of the icon you want to send the message to.
    @BBShowPlugins  Standard BB bro@m
    @BBHidePlugins  Standard BB bro@m
    @BBIcons About  About BBIcons
    @BBIcons AddIcon  Add a default icon
    @BBIcons DelIcon [num]  Delete icon [num]
    @BBIcons Alpha  Toggle Alpha Transparency
    @BBIcons SnapIcons  Toggle Snapping icons together
    @BBIcons Size [num] small | medium | large | xlarge  Change Icon Size
    @BBIcons Toggle [num] Trans  Toggle styled box background (2K/XP ONLY)
    @BBIcons Toggle [num] OnTop  Toggle Ontop
    @BBIcons Toggle [num] Snap  Toggle Snap to Desktop
    @BBIcons Set [num] cmd  Opens a Find File dialog so you can set the command
    @BBIcons Set [num] ico  Opens a Find File dialog so you can select an icon
    @BBIcons Clear [num] Ico  Removes any custom icon you have set
    @BBIcons Clear [num] Args  Removes any command arguments you have set
    @BBIcons RC Read  Reread the BBIcons.rc
    @BBIcons RC Write  Write the BBIcons.rc with current settings
    @BBIcons RC Edit  Open the BBIcons.rc in default editor

    acknowledgements
    I would like to thank NC-17 and ironhead for their help when I got lost. Also qwilk for writing the help file for BBbin (which I hacked and slashed to make my help file ;) and for being full of good examples!