home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / pmstars.zip / readme < prev   
Text File  |  1999-08-13  |  2KB  |  43 lines
  1. INTRODUCTION:
  2.   PMStars is a PM program that I wrote to learn about the OS/2 GPI
  3. and the PM timer function.  I thought I'd start with something simple,
  4. but kinda fun -- a simple starfield came mind.
  5.   PMStars is complete as-is, but could do with some programming
  6. polish.  The source code is included (see below).
  7.   Best of all:  PMStars is FREE !
  8.  
  9. INSTALLATION:
  10.   Copy the *.exe files to a directory of your choice.  If you want to
  11. view/edit the source code, copy the PMStars.c and PMStars.h files
  12. as well.
  13.  
  14. RUNNING THE PROGRAM:
  15.   Double click the PMStars.exe (or PMStarsd.exe) file to start:
  16.  
  17.   PMStars will display the starfield with either a single 'dot' or
  18. line for each star.  The line length depends on the stars speed.
  19.     -> Use LMB (left mouse button) to set the star's origin,
  20.        RMB (right mouse button) to switch between 'dot' and line.
  21.     Resize the window for some interesting (and intentional) effects !
  22.  
  23.   PMStarsd will display the starfield with either a line or a star
  24. number.
  25.     -> LMB will set the star's origin (and marker, if applic),
  26.        RMB will switch between line and star numbers.
  27.     This program varient was used during debugging, and I thought it
  28.       might be helpful to include it in the distribution.
  29.  
  30. ABOUT THE SOURCE:
  31.   I'm including the source because it's sooo simple but I couldn't find
  32. similar source in the usual places.
  33.   The code is documented well enough to (hopefully) make the source
  34. self-explanatory -- assuming a basic knowledge of c, PM and GPI.
  35. Much improvement is possible, and desired !
  36.   Both executables are produced from the same source; the DEBUG variable
  37. (see PMStars.h) was defined for PMStarsd, and undefined for PMStars.
  38.   I used the WATCOM 10.6 compiler to generate this program.
  39.  
  40. Don Moore
  41. moored@iname.com
  42. 12 Aug 99
  43.