WBVerlauf                                                           WBVerlauf

   NAME
	WBVerlauf - Create background copper list on the Workbench screen

   SYNOPSIS
	WBVerlauf Startcolor,Endcolor,ColorNumber/N,Step/N,Info/S

	The AGA chipset and Kickstart 3.0 are required.
	All options are available from icon tooltypes or as command line
	arguments.

   DESCRIPTION
	WBVerlauf lets you create nice color effects for a selectable
	pen color number on the Workbench screen, using the whole
	16 million color range of the AGA chips.
	It works in Workbench and shell environments, and can be put in the
	WBStartup drawer.
	You specify the color of the first and the last line of the screen,
	and WBVerlauf will make a smooth color change by setting a new
	color value on every scanline.
	If started from a shell, you can hit Ctrl-C or use the "Break"
	command to quit. If started from Workbench, double-clicking the
	program icon again forces the running copy to self-terminate.

	Example: I have an 8 color Workbench, and I set the Workbench's
	         background color to color 4 (using the WBPattern prefs
	         editor). Then I set the COLORNUMBER tooltype to 4, so
	         only the Workbench's color gets changed by WBVerlauf.
	         This looks very nice (the icon is designed for this case).

   INPUTS
	STARTCOLOR	- A six digit hexadecimal number specifying the
			  color of the first line of the screen. The first
			  two digits select the red level, the next two
			  digits the green and the last two digits the blue
			  level. So a startcolor of 0xF765E3 would give you
			  a nice pink (0xF7 for red, 0x65 for green and
			  0xE3 for blue; 00 is dark and FF is bright).

	ENDCOLOR	- A six digit hexadecimal number specifying the
			  color of the last line of the screen.

	COLORNUMBER/N	- Pen number of the color to change. A value of
			  0 means background color, 1 is normally the
			  text color, 3 is for window borders, etc.
			  Must be in the range of 0 to 255.

	STEP/N		- Number of lines between color changes. Defaults
			  to 1. If you have a slow processor, you may wish
			  to set this to a higher value, so the screens
			  will scroll faster.

	INFO/S		- Display a short info message and return to shell

   WARNING
	This program makes use of undocumented hardware components of the
	AGA chips, and is not programmed according to Commodore rules.
	This program may break on future hardware or software versions.
	You must NOT use this code in professional applications.

   BUGS
	Changing horizontal mouse pointer resolution from Lo-Res to Hi-Res
	and back does not work while WBVerlauf is running. The cause for
	this is well known, but not fixed yet.

   AUTHOR
	Christian A. Weber

	Internet:    weber@amiga.physik.unizh.ch
	UUCP:        chris@mighty.adsp.sub.org
	Snail mail:  Bruggerweg 2, CH-8037 Zürich, Switzerland.

   RELEASE
	30-Nov-92	V1.4	Initial release

   LEGAL STUFF
	Copyright © 1992 by Christian A. Weber.
	This program may be distributed for non-profit purpose only.
	No Warranty. Use at your own risk.