BitWise Theme Specifications
by Kevin Hock, BitWise Client Programmer
Document Revision 2.0, June 14th, 2005

Overview

BitWise versions 1.0.0 and higher can be themed, allowing users to change 
almost all of the icons used in BitWise.  The theme format was overhauled for 
version 1.0.5 to allow for more icons in more sizes, so earlier versions will 
not be able to use themes created for 1.0.5.  This document provides all the 
information needed to create a theme for version 1.0.5 or higher.

Theme File Format

A BitWise theme is contained within one zip file.  Zip files are universally 
understood and the tools for creating and reading zip files are available on 
all platforms.  A total of 29 icons can be changed in BitWise, each of which 
are needed in one, two or three different sizes.  A complete theme zip file 
will contain 73 separate images files.

Icon Specifications

 * Icons may be created in any of the following formats: bmp, png, jpg/jpeg, 
gif, and xpm.
 * All icons in a theme do not need to be in the same image format.
 * Icons are created in one or more of three sizes: 16 x 16, 32 x 32 and 24 x 
24.  Each image file should have its dimension appended to the icon name (e.g. 
Logs16.jpg).
 * The 24 x 24 icons are used on toolbars and in the Linux system tray.
 * Alpha transparency is not yet supported, and should not be used.
 * BitWise ignores capitalization when loading icons from a zip file.
 * The default icons will be used for icons not specified in the theme.

Finished Themes

When you have finished a theme, please post it in the Themes area of our online 
forums, allowing other BitWise users to enjoy your theme.  We will also be 
happy to add your theme to the official theme download list.

General Comments

Different icons can have different appearances depending on OS capability and 
colors used. For best results, we recommend using small palettes of 256 colors 
or less. For maximum compatibility, the 16 x 16 status icons should be made in 
the standard Windows 16 color palette to prevent sub-optimal display in the 
system tray area on Windows 98 and 2000.

Icon Name and Size Table

The table on the next page provides the names of all the icons and lists the 
sizes needed, indicated by a Y. Name your files using the icon name and size 
(e.g. ContactOnline32.png).

Status Icons    16  32  24  Notes / Description
ContactGroup    Y           Contact group icon in the contact list.
ContactOnline   Y   Y   Y   
ContactAway     Y   Y   Y   
ContactOffline  Y   Y       
ContactDetached Y   Y   Y   
ContactChatty   Y   Y   Y   
ContactMessaged Y   Y   Y   
ContactAlert    Y   Y   Y   Flashed when your attention is need.
ContactBitWise  Y   Y       Represents the *BitWise* system user.
File Icons      16  32  24  Notes / Description
File            Y   Y       Used as an alternate "flash" icon.
FileIn          Y   Y       Incoming file.
FileOut         Y   Y   Y   Outgoing file.
FileManager     Y   Y   Y   
FileShared      Y   Y   Y   
Voice Icons     16  32  24  Notes / Description
Voice           Y   Y   Y   
VoiceTwo        Y   Y       Flashed when a voice window needs attention.
VoiceSettings   Y   Y       
Window Icons    16  32  24  Notes / Description
Conference      Y   Y       
Whiteboard      Y   Y   Y   
WhiteboardTwo   Y   Y       Flashed when a whiteboard has new/updated material.
Preferences     Y   Y   Y   
Logs            Y   Y   Y   
URLHistory      Y   Y       
DirectoryInfo   Y   Y   Y   
StatusProfile   Y   Y   Y   
Add             Y   Y   Y   Add Contact / Group.
Remove          Y   Y       Remove Contact / Group.
Question        Y   Y       For windows that ask the user a question.
Info            Y   Y       Shown on windows that present information.