home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / physcolo / physcolo.doc < prev    next >
Encoding:
Text File  |  1993-08-24  |  2.2 KB  |  52 lines
  1. PHYSCOLO.DOC
  2.  
  3. PhysColo version 2.0 and its source code are copyright (c) 1992, 1993
  4. by Raja Thiagarajan and Peter Nielsen. However, you may use them for
  5. any non-commercial purpose.
  6.  
  7. To run the program, simply type "physcolo" at an OS/2 prompt. The
  8. program requires the Palette Manager in order to work properly. If you
  9. run the program and its title reads "Physical Color Viewer," then the
  10. colors you see are the physical ones on your screen. If the word
  11. "Physical" is missing from the title, then the Palette Manager is NOT
  12. available in your current screen mode. You will see color bars
  13. representing the CLR_* constants at the left; I don't know what the
  14. rest of the window will show.
  15.  
  16. The program will display either as many onscreen colors as you have
  17. or 256, whichever is LESS.
  18.  
  19. The primary goal of earlier versions of this program was to demonstrate
  20. how to use the Palette Manager to access the physical screen colors in
  21. a device-independent way. In writing the code, I strived for maximum
  22. clarity rather than clever hacks. However, since I've documented this
  23. matter in my "Unofficial Guide to the Palette Manager" article, and
  24. since most people seem to use PhysColo itself rather than study its
  25. source code, this version puts a slightly greater emphasis on speed
  26. rather than clarity.
  27.  
  28. NOTE: Previous versions of this program had a dangerous bug!
  29. Specifically, when I queried for the existence of Palette Manager, I
  30. used -- and did not release -- a handle to the screen PS. Under OS/2
  31. 2.0, this was harmless. Under 2.1, it can cause screen corruption,
  32. requiring you to reboot the system. PLEASE DO NOT USE VERSIONS OF
  33. PHYSCOLO PRIOR TO THIS ONE!
  34.  
  35. The program should compile equally well under IBM C Set/2 (or CSet++)
  36. and Watcom C 386 9.0 (or greater). If you have to modify it to compile
  37. under other C compilers for OS/2 2.0, I'd appreciate knowing about it.
  38. Of course, the program cannot be compiled for OS/2 1.x because Palette
  39. Manager is a 2.x feature.
  40.  
  41. If you have any questions or comments, contact me at
  42.  
  43.    sthiagar@nickel.ucs.indiana.edu (internet)
  44.  
  45. Peter Nielsen did all the hard work to speed this program up under OS/2
  46. 2.1. He can be reached at
  47.  
  48.    pnielsen@finabo.abo.fi.
  49.  
  50. Raja Thiagarajan
  51. (sthiagar@bronze.ucs.indiana.edu)
  52.