BBIcons 2.07
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  AND  Psy4

revision history

BBIcons 2.1 (2005-10-18) / Psy4

  • Completely rewrite to use GDI+ graphic library
  • Now also accespts BMP, GIF, JPG, TGA and PNG image formats
  • Perfect transparency handling
  • Added 'Saturation' and 'Hue' params
  • Added 'Rotate and Flip' param
  • New 'Optical Drive' handling (autodetected if drive root)
  • --> Eject tray by menu or [SHIFT+Right Click]
  • --> Define an icon to show when drive is empty
  • BBIcons 2.05b (2005-09) / Psy4

  • /!\Previous RC not compatible on icon sizes/!\
  • Unlimited icon size handling
  • Automatic icon definition (even on non-exe files)
  • Massive rewrite of the config menu
  • Can now add caption over icon
  • And a bounding box around caption
  • Read this file to find all the goodies!
  • 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 not supported anymore... sorry!

    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: 16 | 24| 32 | 48 | 64 | 96 | 128   Icon size: 16, 24, 32, 48, 64, 96, 128px or any!
    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?
    bbicons.icon[num].caption: text   Text over the icon...
    bbicons.icon[num].captionfont: false  Caption font.
    bbicons.icon[num].captionsize: false  Caption font size.

    bbicons.icon[num].captionweight: 40   Caption font weight
    bbicons.icon[num].caption.display: 0 | 1 | 2 | 3 | 4   Caption position Off | Bottom | Top | Right | Left
    bbicons.icon[num].caption.italic: 0 | 1   Caption is italic?
    bbicons.icon[num].caption.under: 0 | 1   Caption is underlined ?
    bbicons.icon[num].caption.strike: 0 | 1  Caption is striked-out ?
    bbicons.icon[num].caption.angle: 0   Caption angle (0-360)?
    bbicons.icon[num].caption.color: color  Caption color
    bbicons.icon[num].TypeCapcolor: 0 | 1 | 2 | 3 | 4   Caption color user defined or from style?
    bbicons.icon[num].RectDisp: 0 | 1  Display a bounding box aroud caption ?
    bbicons.icon[num].Rectcolor: color   Bounding box user-defined color
    bbicons.icon[num].TypeRectcolor: 0 |1 | 2 | 3 | 4  Bounding box color user defined or from style ?
    [NEW]
    bbicons.icon[num].ManageCDROM: 0 |1  Removable drive manager ?
    bbicons.icon[num].SecondIcon: C:\empty.ico  Icon when drive is empty
    bbicons.icon[num].Saturation: 0 | 255  Icon saturation
    bbicons.icon[num].Hue: 0 | 255  Icon hue (transparency if background disabled)
    bbicons.icon[num].RotateFlip: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8  Rotates & flips icon image
    [\NEW]


    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] 16 | 24 | 32 | 48 | 64 | 96 | 128 or ANY  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 Toggle [num] Slit  Toggle in Slit
    @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] Ico  Removes any custom icon you have set
    @BBIcons TypeRectColor [num] 0 | 1 | 2 | 3 | 4  Define style of bounding box 0=User defined
    @BBIcons RectDis [num]  Toggle visibility of bounding box
    @BBIcons CapDis [num] 0 | 1 | 2 | 3 | 4  Defines caption position 0=off
    @BBIcons TypeCapColor [num] 0 | 1 | 2 | 3 | 4  Defines caption color 0=user defined
    @BBIcons Cap [num] caption  Defines displayed caption
    @BBIcons CapFont [num] fontname  Defines font face
    @BBIcons CapSize [num] 1 | 30  Defines font size
    @BBIcons CapWeight [num] 10 | 200  Defines font weight 40=Bold
    @BBIcons CapAngle [num] -90 | 90  Defines font angle
    @BBIcons CapItalic [num]  Toggle italic font
    @BBIcons CapUnder [num]  Toggle underlined font
    @BBIcons CapStrike [num]  Toggle striked out font
    @BBIcons CDROM [num]  Toggle 'Manage as Optical Drice'
    @BBIcons CDROM_secondicon [num] path  Define the 'empty' icon image
    @BBIcons CDROM_Open [num]  Eject Optical Drice tray
    @BBIcons RnF [num] 0 | 1...6 | 7  Rotation & X flip
    @BBIcons Sat [num] 0 | 255  Defines Saturation
    @BBIcons Hue [num] 0 | 255  Defines Hue
    @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!