ICOBundle tool

Copyright 2003-7 Toby Thain, toby@telegraphics.com.au

Description

The "icobundle" utility copies Windows ICO format images from multiple input files, into a single output file, in ICO format. (Sometimes called an icon "suite").

This program can be used along with my Photoshop ICO file format plugin (also GPL).

Source code is supplied (under GPL) for Linux and other UNIX variants. Built executables are supplied for Mac OS (PowerPC and 68K) and Windows.

(For more information on ICO format, see MSDN.)

To use

Mac version

Simply drag the ICO files you wish to bundle on to the application. Name the output file and OK. The icons will be stored as a suite in the output file.

UNIX command line

The syntax is simply: 

./icobundle -o outputfile inputfile(s)
While icobundle is running, some text is printed explaining what's going on. icobundle will report any problems it encounters. Some integrity checks are done on input files.

To build

Command line tool - UNIX/Cygwin/MinGW

(N.B. Under Mac OS X, the Developer Tools must first be installed.) 

svn checkout http://telegraphics.com.au/svn/common/trunk common
svn checkout http://telegraphics.com.au/svn/icoformat/trunk icoformat
svn checkout http://telegraphics.com.au/svn/icobundle/trunk icobundle
cd icobundle
make
To build Windows "console" tools with MinGW hosted on Linux, check out the source archive using the first 4 lines above, then: 
make exe
This builds two executables, "icocheck.exe" and "icobundl.exe", which can be copied to Windows used on the CLI command line.

For more information on building for Windows, see Cygwin and MinGW.

Mac OS application - MPW

After checking out the source, the directory layout should be: 

icobundle/
   dist/
      ICOBundle.app/
         Contents/
            MacOS/
            MacOSClassic/
            Resources/
            Info.plist
         PkgInfo
   ...files...
common/
   tt/
      ...files...
icoformat/
   ...files...
In MPW,
  • change the current directory to the "icobundle" directory.
  • Choose "Build Program", enter "icobundle", and hit OK.

    This should build the two PowerPC binaries (Classic and Carbon) as an OS X bundle, "ICOBundle", and the 68K binary, "ICOBundle.68K".

    Still confused, or having trouble?

    Don't hesitate to write to us.