home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: WPS_PM / WPS_PM.zip / blit55gr.zip / DISK.ZIP / MODULES.DOC < prev    next >
Text File  |  1995-11-27  |  6KB  |  135 lines
  1. This is the description of the screensaver modules
  2. 4colprob.ssm, bounce.ssm, golife.ssm, numlock.ssm and space.ssm.
  3.  
  4. I release these modules as FreeWare and without any warranty
  5. of any kind and so on. Please read the note below concerning
  6. the module numlock.ssm (Numlock Blinker), and please don't tell me
  7. that I haven't warned you!
  8.  
  9. If anybody is interested in the sources, please feel free to
  10. contact me.
  11.  
  12. Any comments, suggestions or bug reports are welcome. You can
  13. contact me as follows:
  14.  
  15. eMail (InterNet): Nicole.Greiber@Fernuni-Hagen.de
  16.  
  17. or Snail Mail:
  18.  
  19. Nicole Greiber
  20. Brueningstr. 6
  21. 42119 Wuppertal
  22. Germany
  23.  
  24. Below you find a short description of the modules. Please read at least
  25. the first one (Numlock Blinker) because it's a bit tricky to handle.
  26.  
  27.  
  28. numlock.ssm (Numlock Blinker):
  29.     When this module is active, you will not see anything on the screen -
  30.     but watch your keyboard!
  31.  
  32.     CAUTION: 
  33.     You should not stop this module by pressing Num Lock, Scroll
  34.     Lock or Shift because then the key may change its mode. This is not
  35.     my fault because when the module is started, it saves the state of
  36.     the lamps, and before it exits it restores this state. But when the
  37.     state of a key is changed in between, the module will still restore 
  38.     the lamp's state as it was at start time because the main ssaver 
  39.     program only notifies the module that a key was pressed but not 
  40.     which one.
  41.     If you already ran into trouble due to this problem, you can do the
  42.     following:
  43.     If you have problems with the Caps lock key, just toggle it one or two
  44.     times. It will then work fine.
  45.     If one of the two other keys causes a problem, just run the module
  46.     and stop it with that key once again. The procedure will
  47.     be reverted and everything's fine again.
  48.     (This worked at least in my case. If it doesn't help you, 
  49.     re-IPL and pray :-) )
  50.  
  51. golife.ssm    (Game Of Life):
  52.     This module displays the game of life. You can either select
  53.     a random population to start with, or a "Gleiterkanone".
  54.     The principle is that the screen is divided into cells. In the
  55.     "Module Configuration" window you can select how many cells will
  56.     be displayed in the horizontal direction. The more cells there
  57.     are, the slower the animation will be. Every cell has 8 neighbors,
  58.     like this:
  59.                     NNN
  60.                     NCN
  61.                     NNN
  62.  
  63.     where C is the cell and N are the neighbors. When a dead cell has
  64.     three neighbors that are "alive" (displayed white), it will
  65.     also come to life. If a living cell has two or three living neighbors,
  66.     it will stay alive. If there are more or less living neighbors, it 
  67.     will stay dead or die.
  68.  
  69.     The "Gleiterkanone" (glider cannon) is a special kind of "animal": 
  70.     It always returns to its original shape, and it produces little
  71.     "gliders" that flap across the screen.
  72.     
  73.     When the random screen becomes static, i. e. there is no movement
  74.     except for objects that repeat within two or three cycles,
  75.     living cells will be "injected" randomly after 100 redraws 
  76.     to bring the picture to life again.
  77.     Note: Up to now I'm only checking for objects that repeat in two
  78.     or three cycles. If anybody finds objects that repeat with a 
  79.     different number of cycles, let me know, and I will check 
  80.     this number too.
  81.  
  82.  
  83. 4colprob.ssm (4 Colour-Problem):
  84.     This module was inspired by the article "Dreiecksgeschichten" 
  85.     by Dr.-Ing. Reinhard Ludwig, which was published in the german 
  86.     computer magazine "c't", April 1994, pp. 220. The article included a 
  87.     Pascal program. I translated it to C and modified it slightly.
  88.  
  89.     This module represents a well-known mathematical problem: to colour
  90.     a given map with 4 colours so that two neighbouring fields always
  91.     have different colours. 
  92.     For this problem a map is needed, therefore several steps are necessary:
  93.  
  94.     First, a number of random points is created (the number can be varied
  95.     between 5 and 75 in the "Module Configuration" window). Then the
  96.     screen is triangulated, that means the given points are used to
  97.     create triangles (this is called Delaunay-Triangulation). 
  98.  
  99.     After that the screen is divided into sections, of which every 
  100.     section encloses one of the random points and every pel on the screen 
  101.     that is closer to the random point than to any of the other random points 
  102.     (this is called a Voronj-diagram). This diagram represents the map to be
  103.     coloured. 
  104.  
  105.     You will notice that there may be five colours: red, blue, green,
  106.     yellow and light blue. The light blue fields are "wrongly-coloured" 
  107.     fields, and after all fields have been coloured, the light blue 
  108.     fields will be eliminated one after the other by swapping colours with
  109.     one of their neighbouring fields and thus finding a field where only three
  110.     colours are represented in the neighbouring fields. Then this field
  111.     can get the fourth colour, and the light blue colour is no longer
  112.     needed. When all "wrong" fields have changed their colours, the process
  113.     is terminated and you can see a map that is coloured according to the
  114.     4 colour-problem. 
  115.     Sometimes the light blue can't be eliminated at the first attempt. 
  116.     Then the whole map is coloured anew, and the program tries again.
  117.  
  118. bounce.ssm (Bouncing Line):
  119.     Here you see a bouncing line that changes its colours. You can select
  120.     how many lines will be visible and how many lines will be coloured in
  121.     the same colour. On startup, the screen can be painted black or left
  122.     as it is.
  123.  
  124. space.ssm (Space Flight):
  125.     You will fly through space, the final frontier! Choose speed and
  126.     star density as you like. When this module is run with
  127.     "Low Priority" unchecked, the animation will be smoother.
  128.  
  129.  
  130. Enjoy!
  131.  
  132. Nicole Greiber
  133.  
  134.  
  135.