home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / screen / wbverl19.lha / WBVerlauf.doc < prev    next >
Text File  |  1993-05-19  |  4KB  |  94 lines
  1. WBVerlauf                                                           WBVerlauf
  2.  
  3.    NAME
  4.     WBVerlauf - Create background copper list on the Workbench screen
  5.  
  6.    SYNOPSIS
  7.     WBVerlauf Startcolor,Endcolor,ColorNumber/N,Step/N,Info/S
  8.  
  9.     The AGA chipset and Kickstart 3.0 are required.
  10.     All options are available from icon tooltypes or as command line
  11.     arguments.
  12.  
  13.    DESCRIPTION
  14.     WBVerlauf lets you create nice color effects for a selectable
  15.     pen color number on the Workbench screen, using the whole
  16.     16 million color range of the AGA chips.
  17.     It works in Workbench and shell environments, and can be put in the
  18.     WBStartup drawer.
  19.     You specify the color of the first and the last line of the screen,
  20.     and WBVerlauf will make a smooth color change by setting a new
  21.     color value on every scanline.
  22.     If started from a shell, you can hit Ctrl-C or use the "Break"
  23.     command to quit. If started from Workbench, double-clicking the
  24.     program icon again forces the running copy to self-terminate.
  25.  
  26.     Example: I have an 8 color Workbench, and I set the Workbench's
  27.              background color to color 4 (using the WBPattern prefs
  28.              editor). Then I set the COLORNUMBER tooltype to 4, so
  29.              only the Workbench's color gets changed by WBVerlauf.
  30.              This looks very nice (the icon is designed for this case).
  31.  
  32.    INPUTS
  33.     STARTCOLOR    - A six digit hexadecimal number specifying the
  34.               color of the first line of the screen. The first
  35.               two digits select the red level, the next two
  36.               digits the green and the last two digits the blue
  37.               level. So a startcolor of 0xF765E3 would give you
  38.               a nice pink (0xF7 for red, 0x65 for green and
  39.               0xE3 for blue; 00 is dark and FF is bright).
  40.               If you specify the string "RANDOM", a random value
  41.               will be used.
  42.  
  43.     ENDCOLOR    - A six digit hexadecimal number specifying the
  44.               color of the last line of the screen.
  45.               If you specify the string "RANDOM", a random value
  46.               will be used.
  47.  
  48.     COLORNUMBER/N    - Pen number of the color to change. A value of
  49.               0 means background color, 1 is normally the
  50.               text color, 3 is for window borders, etc.
  51.               Must be in the range of 0 to 255.
  52.  
  53.     STEP/N        - Number of lines between color changes. Defaults
  54.               to 1. If you have a slow processor, you may wish
  55.               to set this to a higher value, so the screens
  56.               will scroll faster.
  57.  
  58.     INFO/S        - Display a short info message and return to shell
  59.  
  60.    WARNINGS
  61.     - This program makes use of undocumented hardware components of the
  62.       AGA chips, and is not programmed according to Commodore rules.
  63.       It will not work with future hardware or software versions.
  64.       You must NOT use this code in professional applications.
  65.  
  66.    BUGS
  67.     Tell me about any you find!
  68.  
  69.    AUTHOR
  70.     Christian A. Weber
  71.  
  72.     Internet:    weber@amiga.physik.unizh.ch
  73.     UUCP:        chris@mighty.adsp.sub.org
  74.     Snail mail:  Bruggerweg 2, CH-8037 Zürich, Switzerland.
  75.  
  76.    RELEASE
  77.     30-Nov-92    V1.4    Initial release
  78.     07-Dec-92    V1.5    Bug fixes:
  79.                 - Horizontal mouse pointer resolution change
  80.                   works correctly (with a slight delay..)
  81.                 - Colornumbers above 32 work correctly now
  82.     15-Dec-92    V1.6    Copper list optimized for better performance
  83.     09-Mar-93    V1.7    RANDOM parameter for colors added
  84.     05-Apr-93    V1.8    Enforcer hit in copperlist routine removed
  85.     19-May-93    V1.9    WBVerlauf no longer locks the WB screen, so
  86.                 you can change screen modes while the
  87.                 program is running.
  88.  
  89.    LEGAL STUFF
  90.     Copyright © 1992, 1993 by Christian A. Weber.
  91.     This program may be distributed for non-profit purpose only.
  92.     No Warranty. Use at your own risk.
  93.  
  94.