Short: Universal Installers for System icons Author: Roger Håseth Uploader: panterhz yahoo no (Roger Håseth) Type: util/wb Version: 1.0 Architecture: m68k-amigaos >= 2.0.4 --+ Introduction +-- This distribution includes some scripts that can be used for installing another set of System icons to your Amiga. The scripts works with every AmigaOS version from 2.0 - 3.9, and both icons in the OldIcons (planar), NewIcons and ColorIcons format is supported (stock OS 2.0 - 3.1 setups only supports OldIcons though). When the installer scripts are run, each Destination icon (TO) will end up in the same format as the Source icon (FROM). In other words, when Source is an OldIcon, Dest will also become an OldIcon regardless of its original icon format. Furthermore, it's usually only the icon _images_ that gets copied across, which in turn means that the Dest icon will still have its original icon data intact (like Default Tool, ToolTypes, Position, etc.). --+ Installer Scripts +-- The following installer scripts might be included here: Install_Icons - Main script for installing System icons to your Amiga. It looks for a "Icons" drawer in the same directory, and may then install all icons in there that also exists in the chosen destination dir (non-existing ones are skipped). Install_DefIcons - A script for installing DefIcons. Here it will look for a "Envarc/Sys/" or "Icons/Prefs/Env-Archive/Sys/" dir in the same place as the installer, and then install all icons found in there to the chosen dest directory. Install_Files - This one can install some of the files in the included C dir to the C dir present on your boot partition. Under AmigaOS 3.1 or lower, you can also install two DefIcons related files as well (required for proper functionality of DefIcons). Existing files will NOT be overwritten! Look further below for more information about the installer scripts. --+ Requirements +-- Any Amiga with Kickstart 2.04 or higher. The scripts uses the IconCopy and ProcessIcon commands, which is already included. They can also be found on Aminet under: util/cli/iconcopy.lha util/wb/ProcessIcon.lha --+ Distribution +-- The TRULS installation scripts is to be considered as Freeware. Everything in this distribution must be kept together, in original unmodified form. If you want to include the scripts in your own icon packs, you are allowed to do so, but then the conditions are a bit different and less restrictive. Check out the included Distribution.txt file for more information. --+ Preparing Installation +-- The installer scripts uses relative paths, which means that Install_Icons looks for a "Icons" drawer, and Install_DefIcons looks for a "Envarc/Sys/" or "Icons/Prefs/Env-Archive/Sys/" dir in the current directory. If these dirs are not found, the installers will exit with an error message. If the installer(s) are included with an icon package, the dir(s) should already include some icons. But if you have downloaded and extracted the original TRULS.lha distribution, they are by default empty. You will then have to copy the wanted icons into the dirs. These can be from other icon packs that lacks an installer for example. It is also possible to move and use the installers outside the standard dir, but then it's really recommended that you use the Install_Files script first. This to make sure that files required by the icon installers are found. --+ Using Install_Icons +-- Here is a more detailed explenation over how to use the Install_Icons script for installing a different set of System Icons to your Amiga: 1. After starting the installer, you will be asked to select the Destination Volume/Dir where the icons is to be installed to. Here you should normally choose your boot partition, but you can actually select any dir on any volume if you like (for testing purposes and such). 2. If your Amiga uses icon.library 44 or higher, one of the source icons to be installed will now be checked to see if it's in the NewIcons format. If this is the case, you will then be asked if the icons should be converted to ColorIcons before installation begins. 3. Next up, you may be asked if the original icons found in the destination Volume/Dir should be backed up to a lha archive (only if C:LhA is present). Backing up the original icons is highly recommended, especially if you want to answer Yes to the question that may be asked in point 5. 4. Upon clicking the Continue button in the next requester, the script will now examine the contents of the "Icons" drawer, where it makes a list over icons to install. When this is done, the installation begins. As previously mentioned, it's only the icon _images_ that gets copied across, and only if matching icons is found in the destination dir. Icons that exists in source dir but not in dest dir (and vice-versa) will mostly be skipped. 5. When main installation is done, you may be asked if any remaining old drawer icons in destination dir should be replaced. Be careful with your answer here, since this will replace ALL drawer icons that was previously skipped. You _might_ get more than you bargained for! This question will only be asked if a suitable drawer icon to be used as source can be found, here the Install_Icons script will look for one in the following order: Ram:Drawer.info Ram:def_drawer.info Icons/Prefs/Env-Archive/Sys/def_drawer.info Envarc/Sys/def_drawer.info Icons/Misc/Drawers/Drawer.info Icons/Misc/Drawer.info Icons/Drawer.info 6. The final thing to do, is perhaps to clean up and snapshot all icons that just have been installed to your system. --+ Using Install_DefIcons +-- Here is a more detailed explenation over how to use the Install_DefIcons script for installing a different set of DefIcons to your Amiga: 1. Upon starting the installer, you will be asked to select the Destination Volume/Dir where the icons is to be installed to. Here you should normally choose your boot partition, but you can actually select any dir on any volume if you like (for testing purposes). Do have in mind however, that the script expects to find a Prefs/Env-Archive/Sys/ dir in the chosen dest directory. 2. If your Amiga uses icon.library 44 or higher, one of the source icons to be installed will now be checked to see if it's in the NewIcons format. If this is the case, you will then be asked if the icons should be converted to ColorIcons before installation begins. 3. Next, some scripts will be prepared in T:, and the source icons will be copied to a T:DEFICINST/ dir. Here some workarounds regarding the icons may happen (explained further below). Have in mind that this might take a while. 4. After the above is done, just click the Continue button in the requester that pops up, and the installation will begin. Here things will be done in a different way than with Icon_Install: If both source and destination icon exists, the icon _images_ will be copied across. Otherwise, if source icon does exist, but the destination one doesn't, the source icon _file_ will be copied instead. 5. Next thing that _might_ happen is that you will be asked if a direct file copy should be done with all source Drawer and Disk icons. This can often be a good idea since they may often have window sizes best suited for the other DefIcons. This is especially true if icons meant for interlaced screens has been installed over icons meant for non-interlaced screens (or vice-versa). --+ OS2.0-3.1 vs OS3.5/3.9 DefIcons +-- The way DefIcons works is a bit different between AmigaOS 2.0-3.1 and 3.5/3.9, where some of the icons uses different names. The biggest difference though, has to do with all Disk icons except the "def_disk.info" one. Under AmigaOS 3.1 and lower, they can either be of the disk or drawer type, and the file names ends with "disk.info", just like this: def_CD0disk.info def_RAMdisk.info def_ZIP0disk.info With AmigaOS 3.5/3.9/3.1.4, Disk icons can only be of the disk type, and the file names just simply ends with ".info", like so: def_CD0.info def_RAM.info def_ZIP0.info The Install_DefIcons script includes some workarounds that ensures that Disk icons will get the most proper file names depending on what OS version they are going to be installed to (hence the reason for copying them to T: first). Another thing is that all Disk icons _might_ be converted to disk icon type. For more information about the DefIcons concept, take a look at the DefIcons section of the included Third_Party.doc file. --+ For Lower-end Amigas +-- If you are using the installer scripts on an Amiga with 2MB or less RAM, you may experience some "out of memory" situations. If this happens, an easy fix can be to first create a Temp drawer on your Work: partition, and then enter "Assign T: Work:Temp" in a Shell. This will just be a temporary solution, and everything will return to normal after a reboot. Installation will be a bit slower, but it should at least work. For more info about the TRULS installers and other stuff 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