CandyFolder

Ok, we did it again ;-). Netlabs brings you a new gadget to push your GHz Pentiathlon IX to the limit.

CandyFolder is an add on to CandyBarZ which brings you transparency for WPS-folders. It also works stand alone so you may use it with your prefered WPS-beautifier.

Contents


License

CandyFolder is released under the terms of the General Public License (GPL). See the file COPYING in the subdirectory Docs for more information.

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 2, 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; see the file COPYING.  If not, write to
the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.

Installation

First of all backup your INI files!

  1. Unzip the archive to a folder of your choice.
  2. Open an OS/2 command window and cd into the directory with the archive contents.
  3. Run install.cmd
  4. Restart the WPS

The install skript will register the new folder class CandyFolder. Afterwards it replaces the WPFolder class with this new class to give every folder on your system the transparency feature.

If your WPS hangs on startup boot to an OS/2 command window and delete the CANDYWPS.DLL.


Uninstallation

To uninstall simply run the uninstall script. It unreplaces the folder class and deregisters CandyFolder. After restarting the WPS you may delete the files.


Usage

Open the settings notebook of your desktop and go to the Background page. Select an image with 256 colors and the size of your screen. The image width will be checked against your physical resolution. The image will only be accepted if this check is passed. It's not possible to use tiled or stretched images!

Open the settings notebook of a folder on your system. On the background page you'll find a new checkbox Transparency to enable transparency for the particular folder. The next page lets you change the color shading.


Setup

To effectively use the new transparency feature a new setup string can be used.

Name Value Description
TRANSPARENCY E,R,G,B

E = 1/0,
1: Enable transparency
0: Disable transparency

R = -127...128. Color adaptation for red.
G = -127...128. Color adaptation for Green.
B = -127...128. Color adaptation for blue.

The range for the color adaptation is -127...0...128.
A negative value means decrease the color component of the image. 0 means do not change the color value. A positive value increases the component of the color.

Examples

Use the following snippet to change the settings of a folder:

/* Script to change the transparency settings of a folder */
call RxFuncAdd 'SysLoadFuncs', 'RexxUtil', 'SysLoadFuncs'
call SysLoadFuncs

rc=SysSetObjectData('d:\desktop\My-Folder', "TRANSPARENCY=1,0,-20,25")
IF rc= 1 THEN SAY "Settings changed!"

The settings for the desktop folder are handled in a special way. It's not possible to enable transparency for a desktop folder. But the color adaptation values are saved as default values for the color shading. These values are used if you click the Standard button on the transparency settings page.


Getting help

There's a mailing list on Yahoo-groups where you may post questions or bug reports. Go to the CandyBarZ project page at Netlabs to subscribe.

CandyFolder was brought to you by Chris Wohlgemuth. It's a project.