home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / xpipe / xpipe_readme.txt < prev    next >
Text File  |  1992-02-10  |  4KB  |  95 lines
  1.                       PIPE
  2.                 an X/Motif game
  3.  
  4.                  Michael Muller
  5.                   Version 2.2
  6.  
  7.     You have unbundled the sources for pipe.
  8.  
  9.     Included in this tar file with the sources are a makefile to build 
  10.     pipe and the vax-ultrix executables.
  11.  
  12.     The executables assume that the .uid, help, and high score files 
  13.     are in your present working directory.  To enable pipe to be run 
  14.     from a different directory, edit the makefile and re-compile.
  15.  
  16.     Disclaimer: This was my first program using X *or* Motif *or* 
  17.     an event-driven toolkit *or* C.  I learned a lot, but I now know 
  18.     that I did many things the hard way.  I've since gone back and fixed 
  19.     some of these oddities, but some are so entangled in the code 
  20.     that I don't have the time or patience to work them out.  For 
  21.     exmaple, I used global variables instead of passing values to 
  22.     callbacks.  This can be avoided, but it's a lot of work because 
  23.     Motif callbacks take only one parameter.
  24.  
  25.     Files in this save set:
  26.  
  27.       Makefile         -- The makefile to build pipe.
  28.       README           -- This file.
  29.       pipe.c           -- The C source.
  30.       pipe_widgets.uil -- The UIL containing the window, menus, etc...
  31.       pipe_icons.uil   -- The UIL containing pictures of pipes.
  32.       pipe_help        -- How to play.  Available on-line or "more" it.
  33.       pipe             -- The game compiled.
  34.       pipe_widgets.uid -- The window, menus, etc., compiled.
  35.       pipe_icons.uid   -- The pictures of pipes, compiled.
  36.  
  37.     This code has been tested and should work on ULTRIX, VMS, color, and 
  38.     black & white systems.  Please report any problems.
  39.  
  40.     Feel free to reuse, distribute (as long as you don't profit), 
  41.     or enhance this program.  Tell me if you do!
  42.  
  43.     History:
  44.     01-Oct-1990        Creation
  45.     18-Jun-1991        Version 1.0 (first stable version)
  46.     08-Jul-1991        Version 2.0 (major enhancements)
  47.     19-Jul-1991        Version 2.1 (bug fixes)
  48.     08-Feb-1992     Version 2.2 (small clean-ups for CD distribution)
  49.  
  50.     Done since V1.0:
  51.     o Reservoirs.
  52.     o Bonus pipes.
  53.         o Varying board width and height.
  54.     o Fast flow.
  55.     o Add a fluid flow countdown to the status panel.
  56.     o Created a speedometer for the fluid.
  57.     o Enable starting from a certain level.
  58.     o Implement abort game.
  59.     o On-line help.
  60.     o High Scores maintained.
  61.     o Weight the likelihood of each pipe appearing for each level.
  62.     o Clear the preview window before each game.
  63.         o The screen no longer flashes when the drawing area is [de]sensitized.
  64.         o RNG without modulus (doesn't seem to help, but thanks to Dave Miller)
  65.     o Change "bummer." to "psyche!" for level over.
  66.     o Add application icon (thanks to Dick Schoeller).
  67.     o You no longer lose your head start if you pause before flow begins.
  68.     o Unix-compatible (thanks to Paul Douglas).
  69.     o Stripes now visible in B&W
  70.     o B&W pixels returned correctly (thanks to JP Tessier)
  71.     o A number of unix bugs fixed (thanks to Marc Evans)
  72.     o Level increments *after* Psyche! is pressed.
  73.     o Tiles can't be placed out of bounds.
  74.         o One UIL file for icons -- b&w uses same as color!
  75.  
  76.     XUI window manager incompatibilties:
  77.         o The playingArea displays wherever it feels like. (XUI only)
  78.     o The pause menu option doesn't iconize. (XUI only)
  79.  
  80.     Bugs:
  81.     o The preview window is wider than the tiles. (used to be XUI only)
  82.  
  83.     Things to do/suggestions:
  84.     o Make fast flow flow faster (calling w/out timeouts doesn't work).
  85.     o Implement wrap-around edges in certain places for some levels.
  86.     o What about the bonus Tetris-like level?  (LucasFilms did it...)
  87.     o Create application resources for use with resource file
  88.     o Finish pipe ("drain")
  89.     o Two flows
  90.     o T pipes
  91.     o Customization (preferences)
  92.     o Level info read from file for customization
  93.     o Make erasing quicker on the starting levels
  94.     o Allow customization of pipe colors
  95.