ICON THEMES APPLET FOR OS/2 Version 2.2 Icon Themes is a program which allows the desktop icons used throughout the Workplace Shell to be changed, based on installable icon sets or 'themes'. A number of themes are included, and various others are available from third-party sources. INCLUDED THEMES Warp 4 : The standard OS/2 Warp 4 ('Merlin') icon set, extended somewhat with various icons in the same style. Warp 3: The class OS/2 Warp 3 icon set. Also somewhat extended although it has fewer custom icons than the Warp 4 theme. Warp Server: An icon set based on the replacement icons IBM provided for OS/2 Warp Server version 4. Old Style IBM: An icon set based on the old OS/2 2.1 icons. Very plain and simple; this is an older theme which does not support all icons. Retro WP: An icon set with a style reminiscent of the OS/2 2.1 style, but with a more modern appearance. This is an older theme which does not support all icons. REQUIREMENTS Icon Themes requires the following: * The IBM 16-bit resource compiler (RC.EXE or RC16.EXE) version 4.0x must be installed and available on your PATH. This program is available during OS/2 installation or through Selective Install as part of the 'Link Object Modules' component. * Resource Manager (RESMGR), by Martin Lafaix (with updates from various others); this must also be available on your PATH. The latest version only seems to be available as part of eComStation 2.x, but the version provided here should be sufficient to work with Icon Themes: http://home.clara.net/orac/os2.htm#resmgr (You should not, however, use any version dated prior to 2004.) * VROBJ.DLL (version 2.1d) must be installed. * VROBJEX.DLL (version 1.3 or later) must be installed. * RXUTILEX.DLL (version 0.1.5 or later) must be installed. With the above requirements in place, Icon Themes should be usable on any OS/2 version later than Warp 4 with FixPak 6 (or Warp 3 with FixPak 35). (ArcaOS 5.0 or later should meet all of the above requirements as-is.) LIMITATIONS * Default object-class icons, and icons for desktop objects which are part of a standard OS/2 installation, are updated. However, icons for most third-party applications (with a few exceptions) are not. * You have to reboot after selecting a new icon theme. This is because system DLLs are updated, and need to be re-loaded. Once you reboot, the desktop icons will be refreshed. * Icons for the Sounds and Movies folders under Multimedia may not be updated properly because not all OS/2 distributions assign object IDs to these folders. Advanced users who know how to manipulate object IDs can fix this issue by ensuring that the following folders to have the indicated object IDs: \MMPM\SOUNDS = subdir 'DESKTOP' = subdir 'GARDEN' = subdir 'OCEAN' = subdir 'SPACE' = \MMPM\MOVIES = ******** NOTICE FOR USERS UPGRADING FROM VERSION 2.0 ******** This release requires updated message files for all languages. Currently English and Japanese are provided. Support for other languages has not been updated to reflect the new features of this release; as a result, attempting to run this program under other languages may result in improper or missing text on certain dialogs. Users of other languages can force Icon Themes to run as English by forcing the program locale to any "en_XX" value, where XX is any two- letter country code (US, UK, CA, AU, etc.). This can be done in one of three ways: - Set the LANG environment variable (either globally or for the session under which ITHEME.EXE is run). - Use the Locale object under System Setup to create an object with the appropriate locale name, and drag it onto the main Icon Themes program window. (The change in locale will be saved and remembered the next time the program is loaded.) - Use the Language properties page of the Icon Themes program object to change the locale. (This page may not be available on all systems). ******** NOTICE FOR USERS UPGRADING FROM VERSION 1.x ******** Version 1.x (and earlier) of Icon Themes used a slightly different file structure. If you have one of these versions installed, you are strongly recommended to either uninstall it, or at the very least to install version 2.1 into a new directory. HISTORY OF VERSION 2.1 and up Program history for releases prior to version 2.1 have been moved into the file HISTORY.TXT. Version 2.23 - UI now uses system default window-text font. UI elements are rescaled to fit if necessary. Version 2.22 - Fixed error in identifying ArcaOS for default settings. - Fixed several bad icon definitions in REICON. Version 2.21 - Various improvements to ArcaOS desktop layout support. Version 2.2 - Added support for ArcaOS desktop layout. - Rewrote various DLL handling routines using RXUTILEX.DLL. - Progress bar now uses class from VROBJEX.DLL. - Improved error detection when applying themes. - Fixed some possible bugs when reading program settings. - Slightly better logging. - Themes (except for the [current] entry) are now sorted in the list. - Released under GNU GPL version 3. Version 2.11 - Display a warning if an active Sunny Icons installation is detected. Version 2.1 (2012-02-07) - Updated the remaining themes originally from David Graser. Version 2.1 beta 3 (2011-12-01) - Fixed bug preventing the preview DLL from being updated when upgrading an existing theme. - Installing a theme now updates the themes index for all languages, not just the current one. - Allow installing a theme by passing the .ITH filename on the command line. - Various message file improvements. - Redesigned the theme progress dialog to use a progress bar. - Added the newly-supported DLLs to the preferences dialog. - If the locale is changed by drag-and-drop, the new language is saved to the program INI file and restored on program startup. New controls were added to the preferences dialog related to this; see the online help for a description. - Other minor bug fixes. - Included updated versions of several themes containing the new icon support. Version 2.1 beta 2 (2011-11-23) - Major improvements to NLV handling: . Drag-and-drop of Locale objects now changes the program language on the fly. (This is not persistent between executions, and is mostly useful for testing.) . The Themes index file (formerly THEMES.LST) is now NLV-enabled. The program now attempts to load the file THEMES.xx, where 'xx' is the currently-selected language (EN, NL, DE, etc.). If the current language is not found, the program will fall back to THEMES.EN if it exists, or THEMES.LST as a last resort. . When installing a new theme from a .ITH package, the theme definition is searched for in the file xx.LST, where xx is the currently-selected language. If the current language is not found, 'EN.LST' is used if it exists; otherwise, the first file found with the extension .LST is used. - Fixed some minor message problems. - Updated the Japanese message file. Version 2.1 beta 1 (2011-11-21) - Added support for two new theme files: . mmedia3.itr (icons for MEDIAFLD.DLL) . desktop3.itr (icons for XWPRES.DLL) Existing themes which lack these files will still apply successfully, but a warning will be displayed. - Added new function to install a theme from the GUI. - Updated ICONS.LST with newly-defined icons, and a few previously- missing objects. - Some improvements to logfile and error message handling. NOTICES (C) 2011-2017 Alex Taylor (alex at altsan dot org). Written using Watcom VX-REXX v2.1d. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Icon Themes is part of the NetLabs 'VXApps' project. Source code is available from the http://trac.netlabs.org/vxapps/ repository. Thanks to Nick Morrow for help with VX-REXX. Thanks to Alessandro Cantatore for giving me the idea, and for providing MREPLMOD.EXE. The program layout is modelled after Alessandro's eComStation Window Themes applet. Thanks to David Graser for contributing many excellent themes. Finally, thanks to all of the hard-working translators who have enabled Icon Themes to support multiple languages.