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

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

 The transparency mask for planar icons with one image
 only and when "Backfill" mode is enabled uses Flood()
 from border pixels again to make color 0 transparent.
 All other pixels with color 0 are remaining gray now.

 #592: Fixed an uncritical bug of #591, the Open-count
 of cybergraphics.library was increased for every Open
 of icon.library due to tests with an outdated offset.

 The MakePlanarMask code has been optimized and needs
 no ReadPixel() calls anymore and only one Flood() to
 reach all transparent pixels from a temporary border.
 The new code is smaller and 8-9% faster without Jit.
 Updated 68000 and 68020 libraries are also included. 

 Unfortunately, WB 3.0/3.1 will never use blit-masks.


 There is another new special version "BWswap" which
 can swap pen 1 and 2 with "BWswappingOnOff" in order
 to exchange Black and White in a dark theme by force,
 because some programs don't allow to configure their
 colors by user defined settings as it is possible in
 the WB assignments in palette and font preferences.
 Tell me your opinion, whether I should integrate it?
  

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

 Bei planaren Icons mit nur einem Bild und aktiviertem
 "Backfill" Modus wird die Transparenzmaske nun wieder
 mit Flood() nur von Rand-Pixeln mit Farbe 0 erstellt.
 Alle anderen Pixel mit Farbe 0 bleiben jetzt grau.

 #592: Ein unkritischer Fehler in #591 wurde behoben,
 wo der Open-Count der CGX-Library bei jedem Open der
 IconLib erhöht wurde, da Tests alte Offsets prüften.

 Der MakePlanarMask Code wurde optimiert und braucht
 nun keine ReadPixel()-Calls mehr und nur ein Flood(),
 um von einem temporären Rand alle transparenten Pixel
 zu erreichen. Der Code ist kürzer und 8-9% Schneller.
 Aktuelle 68000 und 68020 Libraries sind jetzt dabei.

 Leider wird WB 3.0/3.1 niemals Blitter-Masken nutzen.


 Es gibt noch eine weitere neue Version "BWswap", bei
 der mittels "BWswappingOnOff" die Farbstifte 1 und 2
 vertauscht werden können, um in einem Dark Theme die
 Farben Schwarz und Weiß zwangsweise zu wechseln, denn
 bei einigen Programmen können die Farben nicht vom
 Anwender konfiguriert werden, wie in den Preferences
 für Palette und Fonts mit entsprechnden Zuweisungen.
 Sagt mir eure Meinung, ob ich dies integrieren soll?


 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