IconCopy is a small and simple shell command to copy an icon image
from a source to a destination. No tooltypes will be overwritten if
there is already an icon at the destination. If it is not started on
a OS 3.5 system it uses the newicon.library if available.

I wrote it because I needed something like this for the Installation
Script of SimpleFind. The installer itself cannot do this at this
moment (I think) and so IconCopy was born.

Feel free to use and spread it.


Usage
~~~~~
Since IconCopy is a shell command (it is pure, so it can be made resident)
it can not be started from Workbench ;-) (but if you do it anywhy IconCopy
will do nothing) and so only a shell template exists:
  SOURCE/A,DEST,CHECK/S,CONVERTNEWICON/S,DROPPLANAR/S,FORCE/S,
  HOLDDESTPLANAR/S,UPDATE/S,VERBOSE/S

SOURCE/A
 The source icon (with or without ".info")

DEST
 The destination (with or without ".info")
 If there is already an icon, only the image is copied otherwise the
 complete icon is copied.
 Starting with version 1.5 you can omit this argument. Then the icon
 is written back to the SOURCE so IconCopy can also be used to be a
 converter.

CHECK/S
 If the DEST file (without .info) doesn't exists the icon is not copied.
 Ignored if no DEST icon is setted.

CONVERTNEWICON/S
 Every NewIcon which is copied by IconCopy is coverted to the OS3.5
 icon format. OS3.5 is required for this function.

DROPPLANAR/S
 The icon which is written doesn't contain the old (pre OS3.5) planar icon
 infomation. If the icon has only a planar image nothing will happen.
 OS3.5 is required for this function.

FORCE/S
 Overwrite the icon even if it is delete protected

HOLDDESTPLANAR/S
 Copies only the NewIcon or OS3.5 Icon but doesn't overwrite the old
 planar image.

UPDATE/S
 If dest icon exists, the tooltypes of the source icon, which don't
 exist on in the dest icon are also copied, but marked as deactivated
 (via the '()' pair).
 Ignored if no DEST icon is setted.

VERBOSE/S
 Prints some messages.

Example
~~~~~~~
IconCopy SYS:Prefs RAM:Test
(copies the SYS:Prefs icon to RAM:Test)

For a more complete example, look into the installation script for
SimpleFind3.

History
~~~~~~~
Version 1.5 (27.11.99)
 - changed DEST/A to DEST (suggested by by Rolf Max Rotvel)
 - added FORCE/S and VERBOSE/S argument (suggested by by Rolf Max Rotvel)
 - now it is possible also to use names with ".info"
   (suggested by Jürgen Urbanek)
 - added HOLDDESTPLANAR/S argument (Jürgen Urbanek)
 - included a shell script to convert all NewIcons to OS3.5 ones in
   a drawer and sub drawers (by Rolf Max Rotvel)

Version 1.4 (07.11.99)
 - added DROPPLANAR/S argument
 - if a dest icon existed the position information got overwritten on OS3.5
   (reported by Richard R. Baud)

Version 1.3 (31.10.99)
 - added CONVERTNEWICON/S argument

Version 1.2 (20.10.99)
 - supports the new icon.library version 44 API

Version 1.1 (02.01.99)
 - added UPDATE/S Argument (suggested by Nils Görs)
 - forgot to close the newicon.library

Version 1.0 (23.11.98)
 - first public release

Future
~~~~~~
Enough for my needs...but I'm open for suggestions
(however I think there is room for many improvments)


Notes
~~~~~
Since probably no normal person will install this command on
his/her system you must include it, if your installation script
use this command. However it's enough to include the binary only.


Visit my homepage
  http://home.t-online.de/home/sebauer/
  (german version)

  http://home.t-online.de/home/sebauer/english.html
  (english version)

Here you can find the latest version of my other programs
SimpleFind, SimpleHTML, SimplePac and of course IconCopy.
         __
        / /
   __  / /   Only Amiga makes it possible...
   \ \/ /
    \__/

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  278     632  44.0% -lh5- 12f7 Oct 31  1999 IconCopy.info
[generic]                  390     679  57.4% -lh5- a6b5 Nov 24  1999 IconCopy/converticons35
[generic]                  319     533  59.8% -lh5- 1d6a Nov 14  1999 IconCopy/converticons35.readme
[generic]                 2198    3296  66.7% -lh5- 8843 Nov 27  1999 IconCopy/IconCopy
[generic]                 1779    3981  44.7% -lh5- 61e4 Nov 27  1999 IconCopy/ReadMe
[generic]                  306     831  36.8% -lh5- 077e Nov 27  1999 IconCopy/ReadMe.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         6 files    5270    9952  53.0%            Nov 28  1999