home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 13 / AACD13.ISO / AACD / Programming / ColorWheel / readme < prev   
Encoding:
Text File  |  2000-08-23  |  4.0 KB  |  108 lines
  1.  
  2.                  colorwheel.gadget
  3.             AROS version by Georg Steger
  4.          AmigaOS® port by Stephan Rupprecht
  5.     
  6.  
  7. COPYRIGHT AND DISCLAIMER
  8.  The AROS colorwheel.gadget applies to the standard copyright
  9.  rules of the Amiga® Research OS. The authors are not
  10.  responsible for any damage caused by the use or misuse of
  11.  this documentation and/or the program(s) it describes.
  12.  
  13.  
  14. REQUIREMENTS
  15.  Any Amiga® (compatible) computer with AmigaOS® 3.x and 
  16.  68020+ (the faster, the better:) cpu.
  17.  
  18.  
  19. GENERAL DESCRIPTION 
  20.  "The color wheel gadget class provides the ability to create gadgets
  21.   enabling the user to control the hue and saturation components
  22.   of an HSB (Hue-Saturation-Brightness) color space." (description
  23.  was taken from the Autodocs, © Amiga Int,Inc.). It's used in
  24.  conjunction with the gradientslider.gadget by various programs
  25.  such as Palette and IconEdit v44.
  26.  
  27.  
  28. DESCRIPTION OF THIS SPECIAL VERSION
  29.  The colorwheel.gadget that comes along with this archive
  30.  was originally written by Georg Steger for the Amiga® Research
  31.  OS (AROS). It has been ported and optimized for the AmigaOS®
  32.  by Stephan Rupprecht. In opposite to the original gadget, this
  33.  one supports hi- and truecolor displays, giving you a nice looking
  34.  color gradient on high screen depths (CyberGFX compatible API re-
  35.  quired).
  36.  
  37.  
  38. KNOWN PROBLEMS  
  39.  - This gadget requires more cpu time to draw itself than the original
  40.    one does. So sometimes it may look like that your computer got 
  41.    deadlocked. After some secs your computer should work again. If you
  42.    have a 68060 cpu, you should install the appropiate version of the
  43.    gadget.
  44.  
  45.  
  46. INSTALLATION
  47.  Simply copy colorwheel.gadget to SYS:Classes/gadgets. A special version
  48.  for 68060 owners is also included into the archive (don't forget to
  49.  rename this version by removing the .060 suffix).
  50.  
  51.  
  52. SPECIAL THANKS GO TO
  53.  Matthias Bethke, Dominique Harelle, Marc Savart, Mario Cattaneo,
  54.  Martin McKenzie,  Wolfgang Krause, Matta, Jörg Deutschle,
  55.  Alexander Niven-Jenkins
  56.  
  57.  for bug-report, suggestions and testing
  58.  
  59.  
  60. HISTORY
  61.  44.0  first public release
  62.  44.1  a few optimiziations. the gadget size is limited to 440x440
  63.        pixels, now. added missing code that makes the gadget box
  64.        around the wheel transparent (aka grey bg instead of bg
  65.        image) <Marc Savart>.
  66.  44.2  now uses AllocRaster() to allocate memory for the mask, this
  67.        will fix the drawing problem when p96 is used <reported by
  68.        several users>.
  69.  44.2b (dated 06-Aug-00) changed a single byte:) blitting to an
  70.        interleaved bitmap didn't work correctly due to a wrong minterm.
  71.  44.3  seems that using AllocRaster() to allocate memory for the mask
  72.        wasn't a good idea. At least here, it always corrupts the 
  73.        memorylist. Don't know why but using AllocVec() seems to
  74.        fix the problem. A drawback of this is that the gadget will
  75.        use chipram even when not necessary but I don't care as long
  76.        as it works ;) Please report if you have any problems!
  77.  44.3b included special version for 060 cpus (faster!). Thanks to
  78.        Martin McKenzie for testing.
  79.  44.4  never updated a program that often within a single week, but
  80.        nobody is perfect;) the colortable passed to LoadRGB32()
  81.        wasn't terminated by a NULL, this could have lead to wrong
  82.        colors on <=8bit screens. there was a chance that WritePixelLine8/
  83.        WritePixelArray was invoked with a width parameter of 0, I hope
  84.        it didn't cause any trouble <Georg Steger>.
  85.  44.5  improved and bugfixed dithering code. Thanks to Georg for his
  86.        help.
  87.  44.6  various optimiziations, which helped to remove the size limit of 
  88.        the gadget. they also fix the inprecise working knob of the 68060
  89.        version. added EraseRect() where it was missing <Harry Sintonen>.
  90.  
  91.  
  92. AUTHOR
  93.  
  94. Please send bug reports and ideas to:
  95.  
  96.  Stephan Rupprecht, Apfeldweg 1
  97.  D44359 Dortmund, Germany
  98.  
  99.  info@stephan-rupprecht.de
  100.  http://stephan-rupprecht.de
  101.  
  102.  or
  103.  
  104.  Georg Steger, Hochlercher 30, 
  105.  I-39030 St. Johann/Ahrntal
  106.  
  107.  georg.steger@rolmail.net
  108.