home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / wheel / read.me < prev    next >
Encoding:
Text File  |  1990-02-02  |  2.9 KB  |  78 lines
  1. WHEEL.ARC
  2. ---------
  3.  
  4. WHEEL.ARC contains the source and executables for these components:
  5.  
  6.   CRTLIB.DLL   : Reentrant C functions DLL
  7.   CRTLIB.LIB   : Reentrant C functions LIB
  8.   CRTEXE.OBJ   : Reentrant C start-up code for EXE
  9.   CRTLIB.OBJ   : Reentrant C start-up code for DLL
  10.   TELLUSER.DLL : Internal user notification DLL
  11.   ALLOCMEM.DLL : Internal memory management DLL
  12.   WHEEL.DLL    : Color Wheel DLL
  13.   TEST.EXE     : Test program
  14.  
  15. To install the executables, copy the DLLs to a directory referenced by
  16. LIBPATH then execute TEST. To compile, edit the following files to match
  17. your configuration:
  18.  
  19.   COMPILE.CMD  : Compile batch file
  20.   TELLUSER     : Internal user notification DLL MAKE file
  21.   ALLOCMEM     : Internal memory management DLL MAKE file
  22.   WHEEL        : Color Wheel DLL DLL MAKE file
  23.   TEST         : Test program MAKE file
  24.  
  25. Then, run COMPILE.CMD.
  26.  
  27. Note: the Color Wheel executables were compiled with the 1.2 bindings; they
  28. will need to be re-compiled with the 1.1 bindings in order to run under 1.1.
  29.  
  30.  
  31. User Interface
  32. --------------
  33.  
  34. 1) To select a displayed color, simply click a segment
  35.  
  36. 2) To fine tune a selection, click and drag the mouse anywhere
  37.    in the wheel until the desired color is displayed
  38.  
  39. 3) To display the grey scales of a particular hue, double-click the
  40.    desired pie; use (1) and (2) to select a color
  41.  
  42. 4) To return to polychrome mode, double-click anywhere in the wheel
  43.  
  44.  
  45. Programmer's Interface
  46. ----------------------
  47.  
  48. Refer to TEST.C and TEST.RC for a working example of how to code for the Color Wheel.
  49.  
  50. 1) All programs that use a Color Wheel must #include "WHEEL.H"
  51.  
  52. 2) Once per process, call ColorWheelInitialize (hab) [see Enhancements below]
  53.  
  54. 3) To create a Color Wheel, use WinCreateWindow specifying the window class
  55.    as COLOR_WHEEL_CLASS (#defined in WHEEL.H). The Color Wheel is drawn as a
  56.    circle centered in the window rectangle with min(cx,cy) as its diameter.
  57.  
  58. 4) Alternatively, a Color Wheel can be created using a CONTROL statement
  59.    within a dialog box defined to the resource compiler
  60.  
  61. 5) Similarly, a Color Wheel Sample can be created using techniques (4) and (5)
  62.    above. Use COLOR_WHEEL_SAMPLE_CLASS (#defined in WHEEL.H) as the window class.
  63.  
  64. 6) The Color Wheel owner will receive WM_CONTROL messages with the
  65.    COLOR_WHEEL_NOTIFY_NEWCOLOR (#defined in WHEEL.H) notification code whenever
  66.    a new color is selected; it is the responsibility of the owner to re-send this
  67.    message to any appropriate Color Wheel Sample window(s)
  68.  
  69.  
  70. Enhancements
  71. ------------
  72.  
  73. The COLOR_WHEEL_CLASS and COLOR_WHEEL_SAMPLE_CLASS window classes can be made
  74. public by removing the comments in the ColorWheelInitialize function in WHEEL.C.
  75. Then, use a utility such as INIEDIT (supplied as a sample program with OS/2)
  76. to add WHEEL.DLL to the SYSDLLS entry. Processes must not call ColorWheelInitialize;
  77. instead, OS/2 invokes the function at start up, registering the window classes.
  78.