PIconTools 1.5

Short:        Various GUIs for managing icons
Author:       Roger Haseth
Uploader:     panterhz yahoo no (Roger Haseth)
Type:         util/wb
Version:      1.5
Requires:     dev/gui/gui4cli-update.lha
Architecture: m68k-amigaos >= 3.0.0


   --+  Introduction  +--

PIconTools is a small collection of various GUIs for managing icons. They are
written in the Gui4Cli programming language, and thus requires AmigaOS 3.0 or
higher to work. Most of the Tools uses Sebastian Bauer's IconCopy and/or Dirk
Stoecker's ProcessIcon commands (plus maybe a few others) for managing the
icons, and this concept would not have been possible without them.

Compatibility has been a priority when making these tools, where they should
work fine even on basic Amiga setups.  Most of them allows for selecting an
icon by just dragging & dropping it onto the GUI. Both icons in the OldIcon,
NewIcon and ColorIcon (aka GlowIcon) format is supported, and it may also be
possible to convert between them now :-)


Currently PIconTools consists of the following:

PIconCopy     - A small GUI for copying icons by using drag & drop. The Dest
                icon will be in the same format as the Source icon, while the
                StackSize, ToolTypes, Default Tool, etc. will remain the same.

PIconSnap     - Snapshot your icons with precision by using this program. Just
                drag & drop an icon, then edit the X & Y positions and finally
                click the Snap button.

PIconGridSnap - Snapshot a bunch of icons by using an imaginary grid. Allows
                for better controlling the layout of the icons. Can be useful
                when dealing with icons of different sizes in the same dir.

PIconInfo     - Simple GUI that displays various info about an icon. Just like
                with the above ones, drag & drop can be used for choosing icon.

PIconBackup   - A small utility for backing up your icons, either to another
                drawer or to a lha archive (with or without compression).

PIconMenu     - Opens a small menu which allows you to select one of the above
                mentioned tools. Primarily meant for program launchers.

More PIconTools will come at a later date.


   --+  Requirements  +--

Any Amiga with Kickstart 3.0 or higher.

For full support of all possible combinations of icon converting (from/to
ColorIcon, NewIcon and OldIcon) though, the following is required:
  AmigaOS 3.1 or higher
  icon.library V46
  newicon.library V40

Gui4Cli 3.8.5, which can be found on Aminet under:
  dev/gui/gui4cli-update.lha

PIconTools uses the ProcessIcon, CreateDefaultIcon, KillNewIcon, IconCopy,
i2b and ConvertColorIcon commands, which is already included. They can also
be found on Aminet under the following:
  util/wb/ProcessIcon.lha
  util/wb/NewIcons46.lha
  util/cli/iconcopy.lha
  util/conv/i2b.lha
  util/sys/ConvColorIcon.lha


   --+  Installation  +--

If you haven't got them already, copy the Gui and Gui4Cli files from the
gui4cli-update.lha archive to the C: directory of your system partition.
Then copy the PIconTools drawer to wherever you like.


   --+  New in version 1.5  +--

* Only the IconCopy command is used for copying icon images now. The reason
  for this, is because it requires less workarounds than with ProcessIcon.
* PIconCopy will now auto-resize its window if the the selected icon is too
  large to fit properly in the box. There's also a new "Hold Planar images"
  mode, that skips the OldIcon images when copying from a NewIcon/ColorIcon.
* PIconCopy, PIconInfo and PIconSnap does now have a new "Edit" menu which
  allows for converting the selected icons format or type, removing/killing
  icon images, and for optimizing the icon (by removing unnecessary junk).
* Upon dragging a disk that haven't got an icon onto the above mentioned GUIs,
  the user is asked if the icon should be created. This actually works now!
* Gui4Cli programs cannot take a file as argument when they are run, but with
  PIconInfo there's now a workaround, where it can make a PIconInfo-SA script
  that can be used instead. Upon running this script with an icon as argument,
  it will then launch PIconInfo, which in turn chooses the icon.
* Another new feature of PIconInfo, is the possibility to snapshot the window
  position & size. Both this and the above are the results of a user request.
* The PIconTools are now more aware of hybrid icons (that has both ColorIcon
  and NewIcon data in them), and may give a warning when one is encountered.
* All readme files of the included third-party software has been merged into
  a single Third_Party.guide file.
* Various small improvements here and there.



For more information about PIconTools and other programs I have made, check
out my website at:   www.rhz1.com

In addition, there is also my Amiga911 Maker project related website, which
can be found here:   www.amiga911maker.site11.com