Short:        free icon.library in optimized ASM code
Author:       Peter Keunecke
Uploader:     pkeunecke alice-dsl net
Type:         util/libs
Version:      46.4.594
Requires:     68000 CPU or 68020+
Architecture: m68k-amigaos >= 3.0.0

 Latest changes:
 ~~~~~~~~~~~~~~

 The default classic tool icon images in IconEdit were
 assigned to the palette mapped images for ColorIcons,
 because in contrary to the OS my library tries to let
 all old programs display the new colorful images with
 Get(Def)DiskObject() instead of the old planar icons.
 All "IconEdit" tasks are handled as an exception now.

 Calls of DupLockFromFH() for the recognition of True-
 Color icons by their FileBlockNumber have caused 5-6%
 slowdowns, because the "Icon Format Change" requester
 tried to prevent an accidentally TrueColor reduction.
 Now, these calls only happen when "ConvertTrueColor"
 is activated as an option. Real TrueColor got faster!

 A cosmetic change was made to let dragged icons under 
 the mouse pointer stay in a consistent transparency.  

 Since my icon.library is slowly getting a bit too fat
 I've written some versions which were compressed with
 Shrinkler (Copyright by Aske Simon Christensen) and
 are 12-15 kB smaller to fit easier into a custom Rom
 or onto floppy disks. The internal default icons have
 also been replaced and got tiny images to save space.

 If you want to put "icon.library" as a module into a
 3.2 custom Rom then you have to rename the 2 strings
 in the system-startup module to avoid name conflicts.

 There are 4 new libraries: Pack, Lite, Dark and Mini
 with support for rendering in full TrueColor quality:

 Pack has the same features as TC020 but no requester. 
 Lite has further no DTtype, RLEjit, Chunky or FastWB.
 Dark is similar to Lite, but has BWswap + HalfBright.
 Mini is like Lite with HalfBright, but no v47 IDtype.

 Lean, Mean and Base are 3 new palette based libraries
 (17-19 kB). Base is the smallest icon.library and it
 uses the zlib inflate routine written by Keir Fraser,
 which is much shorter than my own code, but can still
 decode all OS4 and PNG icons like Lean and Mean, too.

 Lean has a ColorReduction requester, IDtype, WB47fix.
 Mean has none of that, but a Line by line Drawing and
 it never maps colors to pen 0 to support CopperFades.
 Base is the most reduced version made for custom Roms
 with little space, but it can still handle all icons.    
  

 Letzte Änderungen:
 ~~~~~~~~~~~~~~~~~

 Bei IconEdit wurden die klassischen Tool-Icon Bilder
 den paletten-basierten ColorIcon Bildern zugewiesen,
 weil meine Library im Gegensatz zum OS versucht, alle
 alten Programme neuere Farbbilder anzeigen zu lassen,
 wenn Get(Def)DiskObject() aufgerufen wird. Nun werden
 alle "IconEdit"-Tasks als Ausnahme anders behandelt.

 Aufrufe von DupLockFromFH() zur Wiedererkennung von
 TrueColor Icons mittels FileBlockNumber verursachten
 5-6% Verlangsamung, da die "Icon Format Change" Rück-
 frage versuchte, versehentliche Farbreduzierungen zu
 vermeiden. Diese Aufrufe erfolgen jetzt nur noch bei
 Verwendung der aktivierten Option "ConvertTrueColor".
 Die echte TrueColor-Anzeige ist jetzt noch schneller.

 Es gab eine kosmetische Änderung für eine konsistente
 Transparenz des selektierten Bilds beim Icon-Ziehen. 

 Da die icon.library langsam etwas zu fett wird, habe
 ich einige Versionen geschrieben, die mit Shrinkler
 (Copyright Aske Simon Christensen) komprimiert wurden
 und 12-15 kB kleiner sind, um sie leichter in ein Rom
 oder auf eine Diskette zu packen. Die internen Icons
 wurden auch ersetzt und erhielten sehr kleine Bilder.

 Wenn man eine "icon.library" als Modul in ein OS 3.2
 Rom integrieren möchte, muss man die zwei Strings mit
 dem selben Namen im system-startup Modul umbenennen. 

 Es gibt 4 neue Libraries: Pack, Lite, Dark und Mini,
 die alle die volle Unterstützung für TrueColor haben.

 Pack tut die gleichen Dinge wie TC020 ohne Requester.
 Lite fehlt auch DTtype, RLEjit, Chunky oder FastWB.
 Dark ist etwa wie Lite, aber mit BWswap + HalfBright.
 Mini ist wie Lite + HalfBright, aber ohne v47 IDtype.

 Lean, Mean und Base sind drei neue paletten-basierte
 Libraries (17-19 kB). Base ist am kleinsten und nutzt
 die zlib inflate Routine von Keir Fraser, die viel
 kürzer als mein eigener Code ist, aber dennoch alle
 OS4 und PNG Icons ebenso wie Lean und Mean dekodiert.

 Lean hat'ne Farbreduzierungswarnung, IDtype, WB47fix.
 Mean nichts davon, aber das Line by line Drawing und
 es weist Farben nie Pen 0 zu, unterstüzt CopperFades.
 Base wurde für Roms mit wenig Platz möglichst weit
 reduziert, kann aber immer noch alle Icons handhaben.



 Description:
 ~~~~~~~~~~~

 This is an optimized replacement for the icon.library
 of AmigaOS 3.0-3.9 or Aros 68k which can exist in the
 Kickstart ROM or is loaded from the LIBS: directory.

 This shared library offers several functions to load,
 decode, display and save icon images and to configure
 settings for the execution of the associated programs
 by storing tooltypes, a default tool, stacksize, icon
 position and drawer window data in the ".info" files. 

 Supported icon types are all old and MWB planar icons
 as well as color-mapped NewIcons or OS 3.5 ColorIcons
 and also OS4 and PNG TrueColor and merged Aros icons.

 All icons can be displayed either with the blitter or
 FBlit and the Amiga chipset or on a graphics card by
 P96 or CGX in their best quality as fast as possible.


 Beschreibung:
 ~~~~~~~~~~~~

 Dies ist ein optimierter Ersatz für die icon.library
 von AmigaOS 3.0-3.9 oder Aros 68k, die im Kickstart ROM
 existiert oder aus dem LIBS: Verzeichnis geladen wird.

 Diese Shared Library enthält die Funktionen zum Laden,
 Dekodieren, Anzeigen und Speichern von Piktogrammen und
 zum Verwalten von Einstellungen für die Ausführung der
 zugehörigen Programme durch Erfassen von Tooltypes, dem
 DefaultTool, der Stackgrösse, der Icon-Position und bei
 Verzeichnissen von Fensterdaten in den ".info"-Dateien. 

 Unterstützt werden alle alten planaren und MWB-Icons,
 sowie palettenbasierte NewIcons oder OS 3.5 ColorIcons,
 als auch OS4 oder PNG TrueColor-Icons und Aros Icons. 

 Alle Icons werden entweder per Blitter oder FBlit vom
 Amiga-Chipsatz oder mit P96 bzw CGX auf Grafikkarten in
 ihrer besten Qualität so schnell wie möglich angezeigt.


 Distribution:
 ~~~~~~~~~~~~

 This program is freeware. I don't give any warranties.
 You are using this program on your own risk and you
 are responsible for any damage it could cause to your
 system. This icon.library is completely independent
 and free of the AmigaOS copyright. :)

 It's not allowed to distribute or install the TrueColor
 versions of this icon.library with or on AmiKit X or XE
 or any other freeware distro or software package for
 more than 10 Euro. Any other bundling with commercial
 products is prohibited, too. This applies to the Aros-,
 LD020 and all v51 versions. But you can still use the
 new 68000 or 68020 versions, or any other versions of
 older releases up to Build #538 without restrictions.


 Verteilung:
 ~~~~~~~~~~

 Dieses Programm ist Freeware. Ich gebe keine Garantien.
 Die Benutzung erfolgt auf eigenes Risiko und der Nutzer
 trägt für jegliche Schäden an seinem System selbst die
 Verantwortung. Diese icon.library ist vollständig frei
 und unabhängig vom AmigaOS Copyright. :)

 Die Verteilung oder die Installation der TrueColor
 Versionen dieser icon.library mit oder auf AmiKit X,
 AmiKit XE oder einer anderen Freeware Distribution
 für mehr als 10 Euro sind nicht erlaubt. Jede Art der
 Bündelung mit kommerziellen Produkten ist verboten.
 Dies gilt für die Aros-, LD020 und alle v51 Versionen.
 Sie können aber weiterhin die neuen 68000 oder 68020
 Versionen oder andere Versionen von älteren Ausgaben
 bis hin zu Build #538 ohne Einschränkungen verwenden.


 Copyright 2007-2025:
 ~~~~~~~~~~~~~~~~~~~
   Peter Keunecke