home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: WPS_PM / WPS_PM.zip / ssok.zip / SSOK.DOC < prev    next >
Text File  |  1995-03-10  |  19KB  |  479 lines
  1. ╔═══════════════════╗
  2. ║README for SSOK.ZIP║
  3. ╚═══════════════════╝
  4.  
  5.  10-Mar-95
  6.  
  7. ┌────────┐
  8. │Contents│
  9. └────────┘
  10.  
  11.  File List
  12.  Revision History
  13.  General Remarks
  14.  Installation
  15.  The Modules
  16.    EXTERNAL.SSM
  17.    STICKS.SSM
  18.    TV.SSM
  19.    HOPOK.SSM
  20.    RAUPE.SSM
  21.  Disclaimer
  22.  Distribution
  23.  Support
  24.  Credits
  25.  Copyrights
  26.  
  27. ┌─────────┐
  28. │File List│
  29. └─────────┘
  30.  
  31.  SSOK.ZIP vs. 1.3a contains - EXTERNAL.SSM (the 'EXTERNAL' module)
  32.                               STICKS  .SSM (the 'Sticks' module)
  33.                               TV      .SSM (the 'TV' module)
  34.                               HOPOK   .SSM (the 'Hop-Pointer' module)
  35.                               RAUPE   .SSM (the 'raupe' module)
  36.  
  37.                               SSOK    .DOC (this file)
  38.  
  39. ┌────────────────┐
  40. │Revision History│
  41. └────────────────┘
  42.  
  43.  1.0  *** 06-Aug-94 *** Initial version of SSOK.ZIP
  44.  
  45.  1.1  *** 16-Aug-94 *** Two modules added: TV.SSM, HOPOK.SSM
  46.                         Improved SSOK.DOC
  47.  
  48.  1.2  *** 03-Sep-94 *** One new module: RAUPE.SSM, utilizing a poem
  49.                          by Ernst Jandl
  50.                         Changed SSOK.DOC
  51.  
  52.  1.3  *** 21-Sep-94 *** Bug fixed: Some module configuration screens didn't fit
  53.                                    into a standard VGA desktop
  54.  
  55.  1.3a *** 10-Mar-95 *** New compile with EMX, eliminating use of SSOKDLL.DLL
  56.                         Minor code changes
  57.                         (Thanks to Siegfried Hanisch for 'EMXing' SSOK!)
  58.                         Changed SSOK.DOC
  59.  
  60. ┌───────────────┐
  61. │General Remarks│
  62. └───────────────┘
  63.  
  64.  A. ScreenSaver
  65.  ──────────────
  66.  
  67.  SSOK.ZIP contains modules for "ScreenSaver", a shareware screen saver written
  68.  by Siegfried Hanisch. You can get "ScreenSaver" from:
  69.  
  70.   ftp://ftp.cdrom.com/pub/os2/2_x/graphics
  71.   ftp://hobbes.nmsu.edu/pub/os2/32bit/graphics
  72.  
  73.  Check also the appropriate incoming directories for new versions. "Screen-
  74.  Saver" is usually obtainable from CIS, OS2USER.
  75.  
  76.  Siegfried Hanisch's e-mail internet addresses are:
  77.  
  78.   siggih@ibm.net
  79.   ssaver@ibm.net
  80.   hanisch@ci.tuwien.ac.at
  81.  
  82.  His mail address is
  83.  
  84.   Dipl.-Ing. Siegfried Hanisch
  85.   Einsiedlergasse 6/16
  86.   A-1050 Vienna
  87.   Austria
  88.   Tel: +43-1-5520514
  89.  
  90.  
  91.  B. Blanker
  92.  ──────────
  93.  
  94.  Another Austria based author, Peter Wansch, offers another screensaver,
  95.  called "Blanker". "Blanker" is capable of utilizing "ScreenSaver" modules.
  96.  You can get "Blanker" from:
  97.  
  98.   ftp://hobbes.nmsu.edu/pub/os2/32bit/graphics
  99.  
  100.  and usually from CIS, OS2USER or OS2BVEN.
  101.  
  102.  Peter Wansch's e-mail internet addresses are:
  103.  
  104.   wansch@ci.tuwien.ac.at
  105.   pwansch@ieee.org
  106.  
  107.  His mail address is
  108.  
  109.   Dipl.-Ing. Peter Wansch
  110.   Hagenbachgasse 37
  111.   A-3423 St. Andrae-Woerdern
  112.   Austria
  113.   Tel: +43-2242-32124
  114.   Fax: +43-2242-31113 (April 1995)
  115.  
  116.  
  117.  C. ScreenSaver/Blanker & SSOK
  118.  ─────────────────────────────
  119.  
  120.  From March 1995 all five mnodules of SSOK are bundled with both screensavers.
  121.  The included modules are distributed free of charge.
  122.  
  123.  
  124. ┌────────────┐
  125. │Installation│
  126. └────────────┘
  127.  
  128.  You can substitute most references to "ScreenSaver" with "Blanker" if that is
  129.  your saver.
  130.  
  131.  - IF THE MODULES DIDN'T COME WITH YOUR FAVOURITE SCREENSAVER:
  132.    Unzip the SSOK.ZIP package into the SSAVER directory. Be sure to overwrite
  133.    files if you already have a previous version of SSOK.ZIP.
  134.  
  135.  - Start ScreenSaver, mark any of my modules in the right listbox,
  136.    and click once on "Configure module" to see and change the individual
  137.    settings. Please refer to the module specific explanation below.
  138.  
  139.  - You'll find a special profile file, SSAVEROK.INI, in the "ScreenSaver"
  140.    directory. I use it instead of OS2.INI to store the parameters for all
  141.    my modules.
  142.  
  143. ┌───────────┐
  144. │The Modules│
  145. └───────────┘
  146.  
  147.  EXTERNAL.SSM
  148.  ────────────
  149.  
  150.  A. Purpose and Configuration
  151.  
  152.     EXTERNAL.SSM is aimed at those people who want to start external programs
  153.     as screen saver modules. Imagine you have a DOS- or OS/2-fullscreen
  154.     graphics program which you would like to use as a blanker.
  155.  
  156.     Use "Configure module" to fill in
  157.       - the full path of the program you want to use as external module
  158.       - any useful parameters your program might expect
  159.       - and click on the appropriate box to mark the program as a DOS or
  160.         VIO-OS/2 or WIN-OS/2 or PM application.
  161.  
  162.  
  163.  B. Special considerations
  164.  
  165.     Be sure to run ScreenSaver always with "mouse sensing" enabled. EXTERNAL
  166.     is a somewhat dirty module that posts a mouse movement before shelling out
  167.     to the external program so that ScreenSaver minimizes itself upon exiting
  168.     the external program. Please keep in memory that there was no such thing
  169.     planned by the author of ScreenSaver and so he couldn't provide any means 
  170.     of communication between the external program and the ScreenSaver itself.
  171.     The communication between the module and ScreenSaver itself wasn't
  172.     designed for that purpose either.
  173.  
  174.     You will encounter the following phenomenon: After testing the external
  175.     module, that is: after exiting the called external program in testing 
  176.     mode, ScreenSaver will minimize itself as if the EXTERNAL module and the
  177.     external program would have been invoked by ScreenSaver during normal
  178.     operation after the usual timeout.
  179.  
  180.  
  181.  C. Revision History EXTERNAL.SSM
  182.  
  183.     1.0  *** 04-Aug-94 *** initial release
  184.  
  185.  
  186.  STICKS.SSM
  187.  ──────────
  188.  
  189.  A. Purpose and Configuration
  190.  
  191.     STICKS.SSM is just another screen saver module. It eats up your screen 
  192.     from behind. You can play with the self-explanatory parameters by using
  193.     the "Configure module" dialog. The different shapes of the sticks
  194.     "black hole" are quite interesting (IMHO <g>).
  195.  
  196.  B. Revision History STICKS.SSM
  197.  
  198.     1.0  *** 06-Aug-94 *** initial release
  199.     1.1  *** 21-Sep-94 *** module configuration screen fixed for VGA desktops
  200.  
  201.  
  202.  TV.SSM
  203.  ──────
  204.  
  205.  A. Purpose and Configuration
  206.  
  207.     TV.SSM is just another screen saver module. It draws black and white
  208.     circles on the screen. Just take it as a somewhat primitive imitation of
  209.     the TV snow you can see when your box gets no signal. There are no
  210.     parameters you can play with.
  211.  
  212.  B. Revision History TV.SSM
  213.  
  214.     1.0  *** 11-Aug-94 *** initial release
  215.     1.1  *** 21-Sep-94 *** module configuration screen fixed for VGA desktops
  216.  
  217.  
  218.  HOPOK.SSM
  219.  ─────────
  220.  
  221.  A. Purpose and Configuration
  222.  
  223.     HOPOK.SSM is NOT just another screen saver module. It's called
  224.     "Hop-Pointer", because it should make you aware of "HOP", a fractal image
  225.     generator utilizing the so-called "Hopalong" algorithms. HOP is written by
  226.     Michael Peters and located on CompuServe, forum GRAPHDEV, lib 4,
  227.     'Fractal Sources' (HOPZIP.EXE), and on the Internet. Please check HOP if
  228.     you're interested in fractal images. HOP itself includes a screensaver
  229.     for DOS and Windows and you can use it as OS/2 screensaver along with my
  230.     EXTERNAL module.
  231.  
  232.     HOP contains way more features than this very small module.
  233.  
  234.     Here is a quote from Michael's documentation to give us an impression what
  235.     HOP is:
  236.  
  237.     "
  238.  
  239.    ┌────────────────────────────────────────────────────────────────────────┐
  240.    │ WHAT DOES "HOP" MEAN ANYWAY ?                                          │
  241.    └────────────────────────────────────────────────────────────────────────┘
  242.  
  243.      Barry Martin from Aston University (Birmingham/England) discovered a
  244.      new fractal in the mid-80's. A. K. Dewdney presented Martin's first
  245.      images and the algorithm in his 'Computer Recreations' column in
  246.      Scientific American (Sept.1986). He called the new fractal HOPALONG,
  247.      referring to the unique way it grows on the screen. Unlike the famous
  248.      Mandelbrot fractals, here the pixels 'hop from one point to another'.
  249.      The fractal doesn't grow line by line, but rather emerges from the
  250.      whole of the screen.
  251.  
  252.      The character of the resulting images is quite different from what most
  253.      people associate with 'fractals'. Many Hopalongs have some mysterious
  254.      similarity to some biological forms such as diatoms, radiolarians, or
  255.      other unicellular microorganisms. (I strongly recommend to take a look
  256.      at Ernst Haeckel's famous 'Art Forms in Nature' drawings.) If you find
  257.      that the complexity and symmetry of such things fascinates you, you
  258.      will also like HOP's creations. Maybe they will even make you wonder
  259.      what the real connection is between nature, fractals, mind, and beauty.
  260.  
  261.      Hopalong fractals lack the deep complexity of the M-Set - it isn't
  262.      possible to infinitely zoom into the images without losing some of
  263.      their complexity. On the other hand, the way they are created is far
  264.      more interesting to watch in real-time than the (usually boring)
  265.      line-by-line growth of Mandelbrot fractals which results in utterly
  266.      amazing, but static images (unless your computer is extremely fast).
  267.  
  268.      Appendix C contains a short Pascal program which shows how the
  269.      Hopalong algorithm works.
  270.  
  271.                              ────────────────────────
  272.  
  273.      HOP is based on HOPALONG algorithms, but it introduces a lot of new
  274.      and unusual features:
  275.  
  276.      Martin's formula is accompanied by more than two dozen newly developed
  277.      formulas, all similar in structure, but different in detail. The result
  278.      is a wide variety of new fractals.
  279.  
  280.      Several new mathematical 'special effects' modify the shapes of the
  281.      'pure' fractals and introduce movement and 'Fractals in Motion'.
  282.  
  283.      A wide variety of graphic effects is available to manipulate the
  284.      images. Some of these effects are standard (VGA color scrolling is
  285.      done by most graphic programs), but many others are unique and were
  286.      designed for HOP.
  287.  
  288.    ┌────────────────────────────────────────────────────────────────────────┐
  289.    │ THE BASIC CONCEPT                                                      │
  290.    └────────────────────────────────────────────────────────────────────────┘
  291.  
  292.      HOP runs like an slideshow. While some of the images in the show are
  293.      more or less static, others contain wild or gentle movements and
  294.      animations, depending on dozens of interacting parameters all of which
  295.      you can control. Each of the slides runs endlessly or for a
  296.      predetermined number of pixels. The slides are either 'composed',
  297.      stored in a file, and can be exactly reproduced, or they are designed
  298.      on-the-fly (improvised) by HOP's random algorithms or by you, or both.
  299.  
  300.      When you run the demo, HOP plays back a parameter file containing a
  301.      series of 'composed' images and animations. (If you like HOP and learn
  302.      how to use it, you will very soon also come up with interesting
  303.      'compositions' which you can exchange with other HOP users or run
  304.      with the screensaver.)
  305.  
  306.      If HOP doesn't playback a file, it runs in an 'improvising' mode. Each
  307.      of the images will run for a certain number of pixels, then a new image
  308.      will come up, and so on. You have full control over all parameters, but
  309.      unless you want to explore a specific image, you don't have to enter
  310.      any numbers - everything will happen by itself! (Actually I started
  311.      writing HOP because I'm so lazy.)
  312.  
  313.      While some of the images might blow your mind, others might be boring.
  314.      The program juggles many variables, producing images that are based on
  315.      controlled randomness - unfortunately, the program can't watch the images
  316.      and decide if they are beautiful or not. The algorithms are blind.
  317.      (Maybe this will be different in a future version of HOP). It is as if
  318.      you took a snapshot of a random area of the Mandelbrot set - the chance
  319.      to get a boring image is quite high even if the M-set contains loads of
  320.      incredible sights.
  321.  
  322.      You have control over the decisions the program makes to some extent
  323.      though - this happens on the 'Tune' page of the user interface.
  324.  
  325.      Take the randomly generated images as suggestions. Throw them away, or
  326.      modify a nice image until you really like it. Then store it in your
  327.      'favorites' collection, and please exchange it with others.
  328.  
  329.      When you play with HOP's suggestions and learn to master all the
  330.      different parameters, you will find that there are a number of effects
  331.      that are almost never used in HOP's improvisations. They have to be
  332.      used like the special effects in a movie or in rock music: Overusing
  333.      them won't do any good, but using them thoughtfully can add spice and
  334.      interesting variations. Also, some of the effects slow down performance
  335.      or could easily make a boring picture if applied by a blind random
  336.      algorithm.
  337.  
  338.      Another thing you should be aware of is that when running in random
  339.      mode, HOP will try to automatically center and size the fractals. The
  340.      reason this is done is that without this automatic optimization (just
  341.      taking the naked random numbers and formulas and generating the images
  342.      as they come), many fractal images would be too small, or you would be
  343.      shown less interesting details, or the screen would be mostly blank
  344.      because the fractal would develop right outside of it.
  345.  
  346.      The positive effect of this optimizing is that most images will be more
  347.      or less interesting. You can sit and watch HOP design a neverending
  348.      series of fractals, like the shells you find whilst walking along an
  349.      ocean beach. But this is only one way of looking at them! Anyone
  350.      interested in shells would stop from time to time and pick one up to
  351.      look at its microstructure which - as we have learned from fractal
  352.      theory - is just as complex as the view from above. HOP cannot do this
  353.      for you automatically. It doesn't know where interesting details are
  354.      located. The incredible microstructure of HOP fractals has to be
  355.      studied manually. Try zooming in to interesting details and playing
  356.      with the many program features and parameters to manipulate your view.
  357.      HOP will reward you with an infinite world of complexity and beauty.
  358.  
  359.      "
  360.  
  361.     There are several settings you can play with, manipulating the size and
  362.     shape of the drawn pels, the size and shape of the fractal image and so
  363.     on. They are easy to understand by learning-by-doing.
  364.  
  365.  B. Revision History HOPOK.SSM
  366.  
  367.     1.0  *** 16-Aug-94 *** initial release
  368.     1.1  *** 21-Sep-94 *** module configuration screen fixed for VGA desktops
  369.  
  370.  
  371.  RAUPE.SSM
  372.  ─────────
  373.  
  374.  A. Purpose and Configuration
  375.  
  376.     RAUPE.SSM is a very special screen saver module. The German word 'raupe'
  377.     ('caterpillar') moves across the screen and blanks it subsequently.
  378.  
  379.     Be aware that "raupe" is a poem by the famous Austrian writer Ernst
  380.     Jandl. Please check the copyright section of this file below!
  381.  
  382.  B. Revision History RAUPE.SSM
  383.  
  384.     1.0  *** 03-Sep-94 *** initial release
  385.     1.1  *** 21-Sep-94 *** module configuration screen fixed for VGA desktops
  386.  
  387. ┌──────────┐
  388. │Disclaimer│
  389. └──────────┘
  390.  
  391.  The authors assume no responsibility for any damage or loss caused by
  392.  the use of this program. THIS PROGRAM IS PROVIDED AS IS WITHOUT ANY
  393.  WARRANTY, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO FITNESS
  394.  FOR A PARTICULAR PURPOSE.
  395.  
  396. ┌────────────┐
  397. │Distribution│
  398. └────────────┘
  399.  
  400.  As the sole copyright holders of these modules, Olaf Koch and Michael Peters,
  401.  reserve all rights to the program. However, this freeware version may be
  402.  freely distributed by commercial vendors, user groups, BBS operators,
  403.  or individuals, with the following restrictions:
  404.  
  405.  - SSOK.ZIP must be distributed in unmodified form in its entirety,
  406.    including all files that are listed in the 'File List' chapter of this
  407.    documentation. No other programs or files may be included. The
  408.    files may be distributed in a compressed or library format.
  409.  
  410.  - SSOK.ZIP may not be included in combination with any other software
  411.    or hardware product as an enticement or for any other reason,
  412.    without special permission from the authors.
  413.  
  414.    [Permission granted to Siegfried Hanisch (ScreenSaver), Peter Wansch
  415.    (Blanker).]
  416.  
  417.  - No fee or payment may be charged or accepted for SSOK.ZIP, other than
  418.    a small disk distribution fee. This is especially true for the module
  419.    RAUPE.SSM which is based on a copyrighted poem. It is a contractual
  420.    obligation to publish the poem 'raupe' without charging.
  421.  
  422.  - SSOK.ZIP cannot be rented or leased.
  423.  
  424.  - SSOK.ZIP may not be packaged or distributed with any of its supporting
  425.    documentation pre-printed for the end-user.
  426.  
  427. ┌───────┐
  428. │Support│
  429. └───────┘
  430.  
  431.  If you have any suggestions or questions please drop me a mail:
  432.  
  433.     100010.2732@compuserve.com
  434.     olafk@ibm.net
  435.  
  436.  Anyway, I provide the ScreenSaver modules "as is" and just for fun, so 
  437.  there's no "guaranteed support". I'll answer mail and may look into bugs.
  438.  But that it is.
  439.  
  440. ┌───────┐
  441. │Credits│
  442. └───────┘
  443.  
  444.  Siegfried Hanisch           - for giving us "ScreenSaver", "porting" my
  445.                                modules to EMX, and distributing them.
  446.  Michael Peters              - for giving us "Hop".
  447.  Luchterhand Literaturverlag - for allowing me to use Ernst Jandl's poem
  448.                                'raupe'. (At least it's not quite usual that
  449.                                publishers allow someone to place commercial
  450.                                and copyrighted material in the net!)
  451.  Peter Wansch                - for distributing my modules.
  452.  
  453. ┌──────────┐
  454. │Copyrights│
  455. └──────────┘
  456.  
  457.  All modules except HOPOK.SSM are Copyright (C) by Olaf Koch. All rights
  458.  reserved.
  459.  
  460.  *
  461.  
  462.  HOPOK.SSM is Copyright (C) by Michael Peters and Olaf Koch. All rights
  463.  reserved.
  464.  
  465.  *
  466.  
  467.  The poem 'raupe' on which the module RAUPE.SSM is based is Copyright (C)
  468.  1985, 1990 by Luchterhand Literaturverlag. All rights reserved.
  469.  
  470.  Quelle: Ernst Jandl "raupe" aus: ders. "der künstliche baum" in: "Gesammelte
  471.          Werke in 3 Bänden" Bd. 1 (hrsg. von Klaus Siblewski)
  472.  Source: Ernst Jandl "raupe" ('caterpillar') from: the same
  473.          "der kuenstliche baum" ('the artficial tree') in:
  474.          "Gesammelte Werke in 3 Bänden" ('Complete Works') Bd. 1
  475.          (hrsg. von/edited by Klaus Siblewski)
  476.  
  477.  RAUPE.SSM as a software module it still copyrighted by Olaf Koch.
  478.  
  479.