iconcopy 1.5

Short:        V1.5 of the shell command to copy icons
Author:       sebauer@t-online.de (Sebastian Bauer)
Uploader:     sebauer t-online de (Sebastian Bauer)
Type:         util/cli
Version:      1.5
Requires:     OS 2.0
Architecture: m68k-amigaos
Kurz:         V1.5 des Shell Befehls zum Iconkopieren

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...
   \ \/ /
    \__/