BGImage (BackGround Image Changer)

IBM License Agreement for BGIMGE IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS. International Business Machines corporation grants you a license to use the Program only in the country where you acquired it. The Program is copyrighted and licensed (not sold). We do not transfer title to the Program to you. You obtain no rights other that those granted you under this license. Under this license, you may: 1. use the Program on one or more machines at a time; 2. make copies of the Program for use or backup purposes within your Enterprise; and 3. modify the Program and merge it into another program. You must reproduce the copyright notice and any other legend of ownership on each copy or partial copy, of the Program. Except as expressly provided in the DAPTOOLS LIBRARY License Agreement (TOOLIC.TXT), you may NOT: 1. distribute the program in any manner, including through electronic bulletin board systems or other means; 2. sublicense, rent, lease, or assign the Program; and 3. reverse assemble, reverse compile, or otherwise translate the object code of the Program. We do not warrant that the Program is free from claims by a third party of copyright, patent, trademark, trade secret, or any other intellectual property infringement. Under no circumstances are we liable for any of the following: 1. third-party claims against you for losses or damages; 2. loss of, or damage to, your records or data; or 3. economic consequential damages (including lost profits or savings) or incidental damages, even if we are informed of their possibility. Some jurisdictions do no allow these limitations or exclusions, so they may not apply to you. We do not warrant uninterrupted or error free operation of the Program. We have no obligation to provide service, defect correction, or any maintenance for the Program. We have no obligation to supply any Program updates or enhancements to you even in such are or later become available. IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS. THIS PROGRAM IS PROVIDED "AS IS" WITHOUT ANY WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. You may terminate this license at any time. We may terminate this license if you fail to comply with any of its terms. In either event, you must destroy all your copies of the Program. You are responsible for the payment of any taxes resulting from this license. You may not sell, transfer, assign, or subcontract any of your rights or obligations under this license. Any atdttempt to do so is void. Neither of us may bring a legal action more than two years after the cause of action arose. If you acquired the Program in the United States, this license is governed by the laws of the State of New York. If you acquired the Program in Canada, this license is governed by the laws of the Province of Ontario. Otherwise, this license is governed by the laws of the country in which you acquired the Program. ------------------------------------------------------------------------------ ***** BGIMAGE - A Background Image Selector ***** ***** Ver 2.0 September 8, 1993 ***** ***** ***** ***** IBM DAPTOOLS Use Only ***** ***** ***** ***** Author: Hideo Watanabe (WATANABE at TRL) ***** BGIMAGE is a REXX program to select an background image for OS/2 Workplace Shell Desktop. It has the following fuctionalities: - Dialog Box for selecting an image file - Automatic image file selection - Compression/Decompression support for LOADRAM2 and PKZIP2. - Periodical image replacement Image Selection --------------- Manual Selection: You can manually select an image file from image repository directories (-DLG option). A dialog box containing image files are presented, and you can select one of them. You can also specify an image file name by supplying it as an argument. Automatic Selection: Random Mode If -R is specified as an argument, then BGIMAGE automatically selects an image from image repositories. This selection is done randomly, so there might be a case such that the same image file is selected again in several executions. Shuffle Mode If -SH is specified as an argument, then BGIMAGE automatically selects an image from images which have not been selected in image repositories. Therefore, you can see all image files in image respositories by continuous execution. If all images have been selected, then they become candidates for selection again. Sequential Mode If -SQ is specified as an argument, then BGIMAGE sequentially selects an image so that you can see all images in image repositories by continuous execution. Periodical Image Replacement ---------------------------- BGIMAGE has an ability to replace an background image periodically. To use BGIMAGE in this mode, use -loop option. For instance, BGIMAGE -loop:120 replaces an background image in each 120 seconds. This package also has another program to replace an image periodically: NEWLOGO PACKAGE. If you like it, please use it with BGIMAGE. Automatic Image File Compression/Decompression: If you care about disk space occupied by image files, then execute BGIMAGE with -cmpr# or -cmpr$ option once, them BGIMAGE compresses all image files in image directories by SAVERAM2 when -cmpr# or by PKZIP2 when -cmpr$. Of course, you can manually compress image files by SAVERAM2 or PKZIP2. In this case, please follow the following filename extension convention. APOLLO.BMP -> APOLLO.BM# (when SAVERAM2) LDEF.BMP -> LDEF.BM$ (when PKZIP2) If BGIMAGE selects such a compressed file, it is automatically decompressed by LOADRAM2 or PKUNZIP2 depending on its file extension. Since the decompression takes much time, you don't have to do that, if you desire fast execution. Environment Variables --------------------- Be sure that the BGIMAGE_PATH environment variable is set to the directory containing the images for LogoBMP/PMLOGO, do this by adding a statement to your CONFIG.SYS as seen in the following example: e.g. SET BGIMAGE_PATH=D:\OS2TOOLS\BMPIMAGES If nothing is specified for BGIMAGE_PATH when running on OS/2 2.0, C:\OS2\BITMAP is used by default. BGIMAGE uses C:\ drive for compressing image files and store the info file, etc. If you want to change, set the BGIMAGE_WORK env. variable. e.g. SET BGIMAGE_WORK=D:\TMP If you want to change the info-file, set the BGIMAGE_INFO env. variable. The default info-file is <workdir>\bgimage.inf. e.g. SET BGIMAGE_INFO=D:\MYINFO.INF To get further information, type BGIMAGE -h. If you find any bug or have any suggestion, please post to BGIMAGE FORUM in IBMPC. Required Software ----------------- LOGOBMP PACKAGE (when -nowps option is used) VREXX PACKAGE (when a dialog box selection is desired) SAVERAM2.EXE and LOADRAM2.EXE, or PKZIP2.EXE and PKUNZIP2.EXE (when automatic decompression is desired) HISTORY ------- Ver 2.0 September 8, 1993 - Release special version only supporting OS/2 2.X Workplace Shell - Dialog Box is implemented by using VREXX instead of DBOXMGR. - List selection mode is no longer supported. According to this change, -l and -ld options are obsolete. Use -dlg option instead of -ld. Ver 1.6a July 7, 1992 - Bug of version check routine is fixed. - New options -wps and -nowps are supported. Ver 1.6 June 30, 1992 - OS/2 2.0 is supported. - Periodical image replacement is supported. Ver 1.5c May 12, 1992 - A tentative solution is added for use in OS/2 2.0. Ver 1.5b October 24, 1991 - A problem that the same image as the previous one is selected when all images has been used, was resolved. Ver 1.5a October 14, 1991 - Automatic Compression of image files is supported. - PKZIP/PKUNZIP is also supported as a compression tool. - BGIMAGE_WORK and BGIMAGE_INFO env. variables are added. Ver 1.5 October 11, 1991 - Automatic Decompression of compressed image files is supported. - BGIMAGE.INF file is created in C:\ directory. Ver 1.4 August 30, 1991 - Shuffle and Sequential Selection modes are added. - Default mode is changed from Random Selection to Shuffle Selection. - No filesystem type specification is required in BGIMAGE_PATH. Ver 1.3a December 25, 1990 - You can choose CALL or START to execute Logobmp.exe. - Multiple image directories are supported. Ver 1.2b June 5, 1990 - The problem when starting from program selector is fixed. - Internal OS/2 command executions are masked. Ver 1.2a May 7, 1990 - Several fixes concerning HPFS. Ver 1.2 April 20, 1990 - HPFS support code is added. Ver 1.1b April 19, 1990 - fixed a bug which causes an error if you do not have DBOXMGR. - new option -ld is added. Ver 1.1a April 2, 1990 - very minor change (message change, etc.) Ver 1.1 March 29, 1990 - added dialog box presentation to select an image file if dBoxMgr is in one of directories of PATH. This original code is a contribution of Ron Lovchik. Ver 1.0 March 16, 1990 - Initial version.